R から JDBC 経由でCventののデータを分析

Jerod Johnson
Jerod Johnson
Senior Technology Evangelist
CData JDBC Driver for Cvent を使って、お好みの開発環境と標準的な R 関数でCvent のデータを分析できます。

R と Java がインストールされている環境であれば、純粋な R スクリプトと標準的な SQL を使用してCvent のデータにアクセスできます。CData JDBC Driver for Cvent と RJDBC パッケージを使えば、R からリモートのCvent のデータを操作できます。CData Driver を使用することで、業界で実績のある標準規格に準拠したドライバーを活用し、人気のオープンソース言語 R でデータにアクセスできます。この記事では、ドライバーを使ってCventに SQL クエリを実行し、標準的な R 関数を呼び出してCvent のデータを可視化する方法を説明します。

R のインストール

マルチスレッドとマネージドコードによるドライバーのパフォーマンス向上を最大限に活かすには、マルチスレッド対応の Microsoft R Open を使用するか、BLAS/LAPACK ライブラリとリンクされたオープンソース R を使用します。この記事では Microsoft R Open 3.2.3 を使用しています。このバージョンは、2016年1月1日時点の CRAN リポジトリのスナップショットからパッケージをインストールするように事前設定されており、再現性が確保されています。

RJDBC パッケージの読み込み

ドライバーを使用するには、RJDBC パッケージをダウンロードしてください。 RJDBC パッケージをインストールしたら、以下のコードでパッケージを読み込みます。 

library(RJDBC)

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

Cventに JDBC データソースとして接続するには、以下の情報が必要です。

  • Driver Class: cdata.jdbc.cvent.CventDriver に設定します。
  • Classpath: ドライバー JAR ファイルの場所を設定します。デフォルトでは、インストールフォルダの lib サブフォルダです。

dbConnect や dbSendQuery などの DBI 関数は、R でデータアクセスコードを記述するための統一されたインターフェースを提供します。以下のコードで、CData JDBC Driver for Cvent に JDBC リクエストを行う DBI ドライバーを初期化します。 

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

これで DBI 関数を使用してCventに接続し、SQL クエリを実行できます。dbConnect 関数で JDBC 接続を初期化します。

Cvent への認証を行う前に、ワークスペースとOAuth アプリケーションを作成する必要があります。

ワークスペースの作成

ワークスペースを作成するには：

  1. Cvent にサインインし、App Switcher（ページ右上の青いボタン） -> Admin に移動します。
  2. Admin メニューから、Integrations -> REST API に移動します。
  3. Developer Management の新しいタブが立ち上がります。新しいタブでManage API Access をクリックします。
  4. Workspace を作成し、名前を付けます。開発者にアクセスさせたいスコープを選択します。スコープは、開発者がアクセスできるデータドメインを制御します。
    • All を選択すると、開発者は任意のスコープ、およびREST API にこれから追加されるスコープを選択できます。
    • Custom を選択すると、開発者がOAuth アプリで選択できるスコープを、選択したスコープに制限できます。CData 製品によって公開されるすべてのテーブルにアクセスするには、次のスコープを設定する必要があります。
      event/attendees:readevent/attendees:writeevent/contacts:read
      event/contacts:writeevent/custom-fields:readevent/custom-fields:write
      event/events:readevent/events:writeevent/sessions:delete
      event/sessions:readevent/sessions:writeevent/speakers:delete
      event/speakers:readevent/speakers:writebudget/budget-items:read
      budget/budget-items:writeexhibitor/exhibitors:readexhibitor/exhibitors:write
      survey/surveys:readsurvey/surveys:write

OAuth アプリケーションの作成

Workspace を設定して招待すると、開発者はサインアップしてカスタムOAuth アプリを作成できます。手順については、ヘルプドキュメントのカスタムOAuth アプリケーションの作成を参照してください。

Cvent への接続

OAuth アプリケーションを作成したら、次の接続プロパティを設定してCvent に接続します。

  • InitiateOAuth：GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
  • OAuthClientId：OAuth アプリケーションに関連付けられたClient ID。これは、Cvent Developer Portal のApplications page ページにあります。
  • OAuthClientSecret：OAuth アプリケーションに関連付けられたClient secret。これは、Cvent Developer Portal のApplications page ページにあります。

組み込みの接続文字列デザイナー

JDBC URL の構築には、Cvent JDBC Driver に組み込まれている接続文字列デザイナーが便利です。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

java -jar cdata.jdbc.cvent.jar

接続プロパティを入力し、接続文字列をクリップボードにコピーします。

以下は、一般的な JDBC 接続文字列を含む dbConnect 呼び出しの例です。

conn <- dbConnect(driver,"jdbc:cvent:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;")

スキーマの検出

このドライバーは、Cvent API をリレーショナルテーブル、ビュー、ストアドプロシージャとしてモデル化します。以下のコードでテーブルの一覧を取得できます。 

dbListTables(conn)

SQL クエリの実行

dbGetQuery 関数を使用して、Cvent API でサポートされている任意の SQL クエリを実行できます。 

events <- dbGetQuery(conn,"SELECT Id, Title FROM Events WHERE Virtual = 'true'")

以下のコマンドで、結果をデータビューアウィンドウに表示できます。 

View(events)

Cvent のデータのプロット

これで、CRAN リポジトリで利用可能なデータ可視化パッケージを使ってCvent のデータを分析できます。組み込みのバープロット関数でシンプルな棒グラフを作成できます。 

par(las=2,ps=10,mar=c(5,15,4,2))
barplot(events$Title, main="Cvent Events", names.arg = events$Id, horiz=TRUE)

はじめる準備はできましたか？

Cvent Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

Cvent Icon Cvent JDBC Driver お問い合わせ

Cvent データと連携するパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

この記事の内容

関連記事