コピー アクティビティで Dataverse を構成する

この記事では、データ パイプラインのコピー アクティビティを使用して、Dataverse との間でデータをコピーする方法について説明します。

前提条件

このコネクタを Microsoft Entra サービス プリンシパル認証で使用するには、Dataverse でサーバー間 (S2S) 認証を設定する必要があります。 最初に、アプリケーション ユーザー (サービス プリンシパル) を Microsoft Entra に登録します。 詳細については、「リソースにアクセスできる Microsoft Entra アプリケーションとサービス プリンシパルを作成する」を参照してください。

アプリケーションの登録中に、Dataverse 内にそのユーザーを作成し、アクセス許可を付与する必要があります。 これらのアクセス許可は、直接付与することも、Dataverse でアクセス許可が付与されているチームにアプリケーション ユーザーを追加することで間接的に付与することもできます。 Dataverse で認証するアプリケーション ユーザーを設定する方法の詳細については、「単一テナント型のサーバー間認証の使用」を参照してください。

サポートされている構成

Copy アクティビティの下の各タブの構成については、それぞれ次のセクションを参照してください。

• 全般
• ソース
• Destination (公開先)
• マッピング
• [設定]

全般

[全般] タブ構成のために、全般設定に移動します。

ソース

[ソース] タブに移動して、コピー アクティビティのソースを構成します。 詳細な構成については、次の内容を参照してください。

次のプロパティは必須です。

• [データ ストアの種類]: [外部] を選択します。
• 接続: 接続リストから既存の Dataverse 接続を選択します。 接続が存在しない場合は、[新規] を選択することで新しい Dataverse 接続を作成します。
• 接続の種類: [Dataverse] を選択します。
• クエリの使用: データの読み取りに使用する方法を指定します。 [エンティティ名] を選択してエンティティ名を使用しデータを読み取るか、[クエリ] を選択してクエリを使用しデータを読み取ることができます。

  • エンティティ名: ドロップダウン リストからエンティティ名を選択するか、[編集] を選択して手動で入力します。 これは取得するエンティティの論理名です。

  • クエリ: FetchXML を使用して Dataverse からデータを読み取ります。 FetchXML は、オンラインおよびオンプレミスの Dynamics で使用される独自のクエリ言語です。 次の例を参照してください。 詳細については、「FetchXML を使用したクエリの構築」を参照してください。

    FetchXML クエリの例:

    <fetch>
      <entity name="account">
        <attribute name="accountid" />
        <attribute name="name" />
        <attribute name="marketingonly" />
        <attribute name="modifiedon" />
        <order attribute="modifiedon" descending="false" />
        <filter type="and">
          <condition attribute ="modifiedon" operator="between">
            <value>2017-03-10 18:40:00z</value>
            <value>2017-03-12 20:40:00z</value>
          </condition>
        </filter>
      </entity>
    </fetch>
    

[詳細設定] では、次のフィールドを指定できます。

• [追加の列]: ソース ファイルの相対パスまたは静的値を格納するための追加のデータ列を追加します。 後者では式がサポートされています。 詳細については、「コピー中に列を追加する」を参照してください。

宛先

[コピー先] タブに移動して、コピー アクティビティのコピー先を構成します。 詳細な構成については、次の内容を参照してください。

次のプロパティは必須です。

• [データ ストアの種類]: [外部] を選択します。
• 接続: 接続リストから既存の Dataverse 接続を選択します。 接続が存在しない場合は、[新規] を選択することで新しい Dataverse 接続を作成します。
• 接続の種類: [Dataverse] を選択します。
• エンティティ名: データを書き込むエンティティの名前を指定します。 ドロップダウン リストからエンティティ名を選択するか、[編集] を選択して手動で入力します。 これは取得するエンティティの論理名です。

[詳細設定] では、次のフィールドを指定できます。

• 書き込み動作: 操作の書き込み動作。 このプロパティは必須であり、[アップサート] を選択する必要があります。 [動的コンテンツの追加] を使用する場合は、アップサートする値を指定します。
• 代替キー名: レコードをアップサートするためにエンティティ上で定義された代替キー名を指定します。
• null 値を無視する: 書き込み操作中に入力データの null 値を無視するかどうかを示します。 これは既定で選択されています。
  • 選択されている場合: アップサート/更新操作の実行時にはコピー先オブジェクト内のデータを変更せず、挿入操作の実行時には定義済みの既定値を挿入します。
  • 選択されていない場合: アップサート/更新操作の実行時にはコピー先オブジェクト内のデータを NULL に更新し、挿入操作の実行時には NULL 値を挿入します。
• 書き込みバッチ サイズ: 各バッチで Dataverse に書き込まれるデータの行数を指定します。
• [最大コンカレント接続数]: アクティビティの実行中にデータ ストアに対して確立されるコンカレント接続数の上限。 コンカレント接続を制限する場合にのみ、値を指定します。

マッピング

[マッピング] タブの構成については、「[マッピング] タブでマッピングを構成する」を参照してください。ファイル形式として [バイナリ] を選択した場合、マッピングはサポートされません。

設定

[設定] タブの構成については、「[設定] タブで他の設定を構成する」を参照してください。

テーブルの概要

Dataverse のコピー アクティビティの概要と詳細については、次の表を参照してください。

ソース情報

名前	Description	Value	必須	JSON スクリプト プロパティ
データ ストアの種類	データ ストアの種類。	外部	はい	/
接続	ソースの Dataverse への接続。	<実際の接続>	はい	つながり
接続の種類	実際の接続の種類。	Dataverse	はい	型 (typeProperties ->source ->datasetSettings の下): CommonDataServiceForAppsEntity
[クエリの使用]	Dataverse からデータを読み取る方法	* テーブル * クエリ	はい	/
エンティティ名	取得するエンティティの論理名。	< エンティティ名 >	はい	entityName
クエリ	FetchXML を使用して Dataverse からデータを読み取ります。 FetchXML は、オンラインおよびオンプレミスの Dynamics で使用される独自のクエリ言語です。 詳細については、「FetchXML を使用したクエリの構築」を参照してください。	< クエリ >	はい	query
追加の列	ソース ファイルの相対パスまたは静的値を格納するための追加のデータ列を追加します。 後者では式がサポートされています。 詳細については、「コピー中に列を追加する」を参照してください。	* 名前 * 値	いいえ	additionalColumns: * name * value

コピー先の情報

名前	Description	Value	必須	JSON スクリプト プロパティ
データ ストアの種類	データ ストアの種類。	外部	はい	/
接続	コピー先 Dataverse への接続。	<実際の接続>	はい	つながり
接続の種類	実際の接続の種類。	Dataverse	はい	型 (typeProperties ->sink ->datasetSettings の下): CommonDataServiceForAppsEntity
エンティティ名	取得するエンティティの論理名。	< エンティティ >	はい	entityName
[Write behavior](書き込み動作)	操作の書き込み動作。 この値はアップサートにする必要があります。	Upsert	はい	writeBehavior: upsert
代替キー名	レコードをアップサートするためにエンティティ上で定義された代替キー名。	< 代替キー名 >	いいえ	alternateKeyName
null 値を無視する	書き込み操作時に入力データからの null 値を無視するかどうかを示します。 - 選択 (true): アップサート/更新操作の実行時にはコピー先オブジェクト内のデータを変更せず、挿入操作の実行時には定義済みの既定値を挿入します。 - 非選択 (false): アップサート/更新操作の実行時にはコピー先オブジェクト内のデータを NULL に更新し、挿入操作の実行時には NULL 値を挿入します。	選択または非選択 (既定値)	いいえ	ignoreNullValues: true または false (既定値)
[Write batch size](書き込みバッチ サイズ)	各バッチで Dataverse に書き込まれるデータの行数。	< 書き込みバッチのサイズ > 既定値は 10 です	いいえ	writeBatchSize
最大コンカレント接続数	アクティビティの実行中にデータ ストアに対して確立されたコンカレント接続数の上限。 コンカレント接続を制限する場合にのみ、値を指定します。	< 最大コンカレント接続数 >	いいえ	maxConcurrentConnections

関連するコンテンツ

• Dataverse コネクタの概要