製品をチェック

Confluence Driver の30日間無償トライアルをダウンロード

 30日間の無償トライアルへ

製品の詳細

Confluence アイコン Confluence JDBC Driver 相談したい

Confluence に連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。

Confluence データをR で分析

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

加藤龍彦
デジタルマーケティング

最終更新日:2023-09-21
confluence ロゴ

CData

jdbc ロゴ画像
R ロゴ

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Pure R スクリプトおよび 標準SQL を使って、R およびJava をインストール可能なあらゆるマシン上でConfluence にアクセス。CData JDBC Driver for Confluence とRJDBC package を使って、R でリモートConfluence データ を利用できます。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 データ をプロット

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) A basic bar plot. (Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。