JDBC で Microsoft Dataverse データソースから Informatica マッピングを作成

Jerod Johnson
Senior Technology Evangelist

標準の JDBC 接続プロセスを使用して、Informatica で Microsoft Dataverse データオブジェクトを作成します。JAR をコピーして接続するだけです。

Informatica は、データの転送と変換を行う強力でエレガントな手段を提供します。CData JDBC Driver for Microsoft Dataverse を使用することで、業界で実績のある標準に基づいたドライバーにアクセスでき、Informatica の強力なデータ転送および操作機能とシームレスに統合できます。このチュートリアルでは、Informatica PowerCenter で Microsoft Dataverse のデータを転送および参照する方法を説明します。

Microsoft Dataverse データ連携について

CData は、Microsoft Dataverse（旧 Common Data Service）のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています：

Dataverse エンティティと Dataverse システムテーブルの両方にアクセスし、必要なデータを正確に扱うことができます。
Azure Active Directory、Azure マネージドサービス ID 認証情報、クライアントシークレットまたは証明書を使用した Azure サービスプリンシパルなど、さまざまな方法で Microsoft Dataverse に安全に認証できます。
SQL ストアドプロシージャを使用して、Microsoft Dataverse エンティティを管理できます。エンティティ間の関連付けの一覧表示、作成、削除などが可能です。

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

はじめに

ドライバーのデプロイ

ドライバーを Informatica PowerCenter サーバーにデプロイするには、インストールディレクトリの lib サブフォルダにある CData JAR ファイルと .lic ファイルを、次のフォルダにコピーします：Informatica インストールディレクトリ\services\shared\jars\thirdparty。

Developer ツールで Microsoft Dataverse のデータを使用するには、インストールディレクトリの lib サブフォルダにある CData JAR ファイルと .lic ファイルを、次のフォルダにコピーする必要があります：

Informatica インストールディレクトリ\client\externaljdbcjars
Informatica インストールディレクトリ\externaljdbcjars

JDBC 接続の作成

Informatica Developer から接続するには、次の手順に従います：

Connection Explorer ペインで、ドメインを右クリックし、Create a Connection をクリックします。
表示される New Database Connection ウィザードで、接続の名前と ID を入力し、Type メニューで JDBC を選択します。
JDBC Driver Class Name プロパティに、次のように入力します：
```
cdata.jdbc.cds.CDSDriver
```
Connection String プロパティに、Microsoft Dataverse の接続プロパティを使用して JDBC URL を入力します。
ユーザー資格情報の接続プロパティを設定せずに接続できます。接続に最小限必要な接続プロパティは、以下のとおりです。
- InitiateOAuth: GETANDREFRESH に設定します。
- OrganizationUrl: 接続先の組織のURL、例えばhttps://organization.crm.dynamics.com などに設定。
- Tenant (optional): デフォルトと異なるテナントに認証したい場合は、これを設定します。これは、デフォルトのテナントに所属していない組織と連携するために必要です。
接続すると、CData 製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、CData 製品にアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。

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

JDBC URL の構築には、Microsoft Dataverse JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
java -jar cdata.jdbc.cds.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

一般的な接続文字列は次のとおりです：
```
jdbc:cds:OrganizationUrl=https://myaccount.crm.dynamics.com/
```

Microsoft Dataverse テーブルの参照

ドライバー JAR をクラスパスに追加し、JDBC 接続を作成したら、Informatica で Microsoft Dataverse エンティティにアクセスできます。Microsoft Dataverse に接続してテーブルを参照するには、次の手順に従います：

リポジトリに接続します。
Connection Explorer で、接続を右クリックし、Connect をクリックします。
Show Default Schema Only オプションのチェックを外します。

これで、Data Viewer で Microsoft Dataverse テーブルを参照できます。テーブルのノードを右クリックし、Open をクリックします。Data Viewer ビューで、Run をクリックします。

Data Viewer でのテーブルデータとメタデータ（Salesforce の例）

Microsoft Dataverse データオブジェクトの作成

プロジェクトに Microsoft Dataverse テーブルを追加するには、次の手順に従います：

Microsoft Dataverse でテーブルを選択し、テーブルを右クリックして Add to Project をクリックします。
表示されるダイアログで、各リソースに対してデータオブジェクトを作成するオプションを選択します。
Select Location ダイアログで、プロジェクトを選択します。
マッピングの作成

マッピングに Microsoft Dataverse ソースを追加するには、次の手順に従います：
1. Object Explorer で、プロジェクトを右クリックし、New -> Mapping をクリックします。
2. Microsoft Dataverse 接続のノードを展開し、テーブルのデータオブジェクトをエディターにドラッグします。
3. 表示されるダイアログで、Read オプションを選択します。
Microsoft Dataverse カラムをフラットファイルにマッピングするには、次の手順に従います：
1. Object Explorer で、プロジェクトを右クリックし、New -> Data Object をクリックします。
2. Flat File Data Object -> Create as Empty -> Fixed Width を選択します。
3. Microsoft Dataverse オブジェクトのプロパティで、必要な行を選択し、右クリックして copy をクリックします。フラットファイルのプロパティに行を貼り付けます。
4. フラットファイルデータオブジェクトをマッピングにドラッグします。表示されるダイアログで、Write オプションを選択します。
5. クリック＆ドラッグでカラムを接続します。
Microsoft Dataverse のデータを転送するには、ワークスペース内で右クリックし、Run Mapping をクリックします。