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

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

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

Dynamics 365 データ連携について

CData は、Microsoft Dynamics 365 のライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています：

  • Sales、Customer Service、Finance & Operations、Marketing など、Dynamics 365 エコシステム全体のデータの読み取りと書き込みができます。
  • カスタマイズ可能なキャッシュと、インテリジェントなクエリ集約・分離により、Dynamics CRM のネイティブ機能を拡張できます。
  • Azure Active Directory、Azure マネージド サービス ID 認証情報、クライアントシークレットまたは証明書を使用した Azure サービスプリンシパルなど、さまざまな方法で Dynamics 365 に安全に認証できます。
  • SQL ストアドプロシージャを使用して、Dynamics 365 エンティティを管理できます。エンティティ間の関連付けの一覧表示、作成、削除などが可能です。

CData のお客様は、データをデータウェアハウスにレプリケートしたい場合（他のデータソースと併せて）や、Microsoft エコシステム内のお気に入りのデータツール（Power BI、Excel など）または外部ツール（Tableau、Looker など）からライブ Dynamics 365 データを分析したい場合など、さまざまな理由で当社の Dynamics 365 接続ソリューションを使用しています。


はじめに


R のインストール

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

RJDBC パッケージの読み込み

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

library(RJDBC)

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

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

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

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

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

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

Dynamics 365 接続プロパティの取得・設定方法

Microsoft Dynamics 365 への接続

Microsoft Dynamics 365 ドライバーは、以下のMicrosoft Dynamics 365 エディションへの接続をサポートしています。

  • CustomerService
  • FieldService
  • FinOpsOnline （デフォルト）
  • FinOpsOnPremise
  • HumanResources
  • Marketing
  • ProjectOperations
  • Sales

Notes：

  • Supply Chain Management はFinance and Operations と同一です。これらのいずれかに接続するには、Edition をFinOpsOnline またはFinOpsOnPremise のいずれかに設定します。
  • Microsoft Dynamics 365 Business Central については、個別のMicrosoft Dynamics 365 Business Central ドライバーを使用してください。
サポートされているMicrosoft Dynamics 365 エディションのいずれか接続するには、次のパラメータを設定します。
  • OrganizationURL：お使いのMicrosoft Dynamics 365 組織のURL。例えば、https://orgcb42e1d0.crm.dynamics.com。
  • Edition：上記のエディション一覧に示すとおり。

Microsoft Dynamics 365 への認証

Microsoft Dynamics 365 は、Microsoft Entra ID（Azure AD）、Azure サービスプリンシパル、Azure マネージドID（MSI）を経由する認証をサポートします。これらはすべてOAuth 規格に基づきます。 認証方法の詳細は、ヘルプドキュメントを参照してください。

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

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

java -jar cdata.jdbc.dynamics365.jar

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

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

conn <- dbConnect(driver,"jdbc:dynamics365:OrganizationUrl=https://myaccount.operations.dynamics.com/;Edition=Sales;")

スキーマの検出

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

dbListTables(conn)

SQL クエリの実行

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

goalheadings <- dbGetQuery(conn,"SELECT GoalHeadingId, Name FROM GoalHeadings WHERE Name = 'MyAccount'")

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

View(goalheadings)

Dynamics 365 のデータのプロット

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

par(las=2,ps=10,mar=c(5,15,4,2))
barplot(goalheadings$Name, main="Dynamics 365 GoalHeadings", names.arg = goalheadings$GoalHeadingId, horiz=TRUE)

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

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

 ダウンロード

詳細：

Dynamics 365 Icon Dynamics 365 JDBC Driver お問い合わせ

Dynamics 365 データを組み込んだパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

この記事の内容

関連記事