本記事では CData サポート担当からこんなことを聞かれたらどこを確認すべきか?という観点で、よく頂くお問合せ内容をご紹介します。
記事はこちら →Pure R スクリプトおよび 標準SQL を使って、R およびJava をインストール可能なあらゆるマシン上でBasecamp にアクセス。CData JDBC Driver for Basecamp とRJDBC package を使って、R でリモートBasecamp data を利用できます。CData Driver を使うことで、業界が認めた基準で書かれたドライバーを活用して、オープンソースでポピュラーなR 言語のデータにアクセスできます。この記事では、ドライバーを使ってBasecamp にSQL クエリを実行する方法、および標準R 関数を呼び出してBasecamp をビジュアライズする方法について説明します。
マルチスレッドのMicrosoft R Open を実行すること、またはBLAS/LAPACK ライブラリにリンクされたオープン R を実行することによって、マルチスレッドおよびマネージドコードから利益を得られたドライバーのパフォーマンスにマッチできます。ここでは、Microsoft R Open 3.2.3 を使用します。CRAN レポジトリのJan. 1, 2016 snapshot からパッケージをインストールするために事前設定されています。このsnapshot は再現性を保証します。
ドライバーを使うにはRJDBC パッケージをダウンロードします。RJDBC パッケージをインストールしたら、次のコードを入力してパッケージをロードします。
library(RJDBC)
下記の情報を使いBasecamp にJDBC データソースとして接続します。
dbConnect やdbSendQuery のようなDBI 関数は、R にデータアクセスコードを書くための統一インターフェースを提供します。
driver <- JDBC(driverClass = "cdata.jdbc.basecamp.BasecampDriver", classPath = "MyInstallationDir\lib\cdata.jdbc.basecamp.jar", identifier.quote = "'")
これで、DBI 関数を使ってBasecamp に接続しSQL クエリを実行する準備が整いました。dbConnect 関数を使ってJDBC 接続を初期化します。一般的なJDBC 接続文字列は次のとおりです。
conn <- dbConnect(driver,"User=test@northwind.db;Password=test123;")
Basecamp はBasic 認証もしくはOAuth 2.0 認証を使います。Basic 認証を使用するには、Basecamp へのログインに使用するuser およびpassword が必要です。OAuth 2.0 を使用して認証するには、Basecamp にアプリを登録してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。
詳しくは、ヘルプドキュメントの「はじめに」セクションを参照してください。
さらに、AccountId 接続プロパティを設定する必要があります。これはBasecamp にログイン後にURL で確認できます。
ドライバーはBasecamp API をリレーショナルデータベース、ビュー、ストアドプロシージャとしてモデルします。次のコードを使ってテーブルリストを検出します。
dbListTables(conn)
dbGetQuery 関数を使ってBasecamp API がサポートするすべてのSQL クエリを実行できます:
projects <- dbGetQuery(conn,"SELECT Name, DocumentsCount FROM Projects")
次のコマンドを使って、結果を[data viewer]ウィンドウで見ることができます。
View(projects)
CRAN レポジトリで利用可能なあらゆるデータ初期化パッケージを使ってBasecamp を分析する準備が整いました。ビルトインバーのplot 関数を使って簡単なバーを作成できます。
par(las=2,ps=10,mar=c(5,15,4,2)) barplot(projects$DocumentsCount, main="Basecamp Projects", names.arg = projects$Name, horiz=TRUE)