今すぐお試しください!

製品の詳細CData JDBC Driver for Confluence を確認して、無償評価版をダウンロード:

今すぐダウンロード

Confluence データをR で分析

CData JDBC Driver for Confluenceで標準的なR 関数とお好みの開発環境を使って、 Confluence を分析。



Pure R スクリプトおよび 標準SQL を使って、R およびJava をインストール可能なあらゆるマシン上でConfluence にアクセス。CData JDBC Driver for Confluence とRJDBC package を使って、R でリモートConfluence data を利用できます。CData Driver を使うことで、業界が認めた基準で書かれたドライバーを活用して、オープンソースでポピュラーなR 言語のデータにアクセスできます。この記事では、ドライバーを使ってConfluence にSQL クエリを実行する方法、および標準R 関数を呼び出してConfluence をビジュアライズする方法について説明します。

R をインストール

マルチスレッドのMicrosoft R Open を実行すること、またはBLAS/LAPACK ライブラリにリンクされたオープン R を実行することによって、マルチスレッドおよびマネージドコードから利益を得られたドライバーのパフォーマンスにマッチできます。ここでは、Microsoft R Open 3.2.3 を使用します。CRAN レポジトリのJan. 1, 2016 snapshot からパッケージをインストールするために事前設定されています。このsnapshot は再現性を保証します。

RJDBC パッケージをロード

ドライバーを使うにはRJDBC パッケージをダウンロードします。RJDBC パッケージをインストールしたら、次のコードを入力してパッケージをロードします。

library(RJDBC)

JDBC データソースとしてConfluence に接続

下記の情報を使いConfluence にJDBC データソースとして接続します。

  • Driver Class:cdata.jdbc.confluence.ConfluenceDriver に設定。
  • Classpath:Driver JAR の場所を設定します。デフォルトではインストールディレクトリの[lib]サブフォルダです。

dbConnect やdbSendQuery のようなDBI 関数は、R にデータアクセスコードを書くための統一インターフェースを提供します。

driver <- JDBC(driverClass = "cdata.jdbc.confluence.ConfluenceDriver", classPath = "MyInstallationDir\lib\cdata.jdbc.confluence.jar", identifier.quote = "'")

これで、DBI 関数を使ってConfluence に接続しSQL クエリを実行する準備が整いました。dbConnect 関数を使ってJDBC 接続を初期化します。一般的なJDBC 接続文字列は次のとおりです。

conn <- dbConnect(driver,"User=admin;APIToken=myApiToken;Url=https://yoursitename.atlassian.net;Timezone=America/New_York;")

API Token を取得する方法

API token は、アカウントへの認証に必須です。トークンの生成には、Atlassian アカウントでサービスにログインし、API tokens > Create API token に進みます。生成されたトークンが表示されます。

Confluence Cloud Account への接続

Cloud アカウントへの接続には、以下のプロパティを設定します(Password は、Server Instance への接続時のみ必要で、Cloud Account への接続には不要になりました。):

  • User: Confluence サーバーに認証するユーザー名。
  • APIToken: 認証するユーザーに紐付けられたAPI Token。
  • Url: JIRA エンドポイントのURL。例: https://yoursitename.atlassian.net

Confluence Server Instance への接続

Server instance への接続には以下を設定します:

  • User: Confluence Instance に接続するユーザー名。
  • Password: Confluence Instance に接続するユーザーのパスワード。
  • Url: JIRA エンドポイントのURL。例: https://yoursitename.atlassian.net

スキーマ Discovery

ドライバーはConfluence API をリレーショナルデータベース、ビュー、ストアドプロシージャとしてモデルします。次のコードを使ってテーブルリストを検出します。

dbListTables(conn)

SQL クエリの実行

dbGetQuery 関数を使ってConfluence API がサポートするすべてのSQL クエリを実行できます:

pages <- dbGetQuery(conn,"SELECT Key, Name FROM Pages WHERE Id = '10000'")

次のコマンドを使って、結果を[data viewer]ウィンドウで見ることができます。

View(pages)

Confluence Data をプロット

CRAN レポジトリで利用可能なあらゆるデータ初期化パッケージを使ってConfluence を分析する準備が整いました。ビルトインバーのplot 関数を使って簡単なバーを作成できます。

par(las=2,ps=10,mar=c(5,15,4,2)) barplot(pages$Name, main="Confluence Pages", names.arg = pages$Key, horiz=TRUE)
 
 
ダウンロード