行を参照する代替キーの定義を定義する

[アーティクル]
12/01/2023

代替キーは、外部システムとデータを統合するための効率のよい正確な方法を提供します。これは外部システムが、Microsoft Dataverse 内の行を一意に識別するグローバル一意識別子 (GUID) ID を格納していない場合に不可欠となります。

データ統合システムは、代替キーを使用し、固有の組み合わせを表す 1 つ以上のテーブル列の値を使用して行を一意に識別します。各代替キーには一意の名前があります。

たとえば、代替キーを使用してアカウント行を識別するには、変更しない値を持つ他の列と組み合わせて、取引先企業番号または取引先企業番号列を使用できます。

注意

Power Apps で代替キーを定義することができますが、これらはコード内のプログラムでのみ使用することができます。プログラムで代替キーを使用する場合の詳細については、以下を参照してください。

代替キーの機能の利点には、次のものが含まれます。

行のより迅速な検索。
より堅牢なデータの一括操作。
行 ID を使用せずに、外部システムからのデータによる簡易なプログラミング。

代替キーの作成

代替キーを作成するために使用できる 2 人のデザイナーがいます。

デザイナー	説明
Power Apps ポータル	簡単な優れたエクスペリエンスを提供しますが、一部のオプションは使用できません。詳細については次を参照してください: Power Apps ポータルを使用して代替キーを定義する
ソリューションエクスプローラー	簡単ではありませんが、一般的な要件が少ない割に柔軟性が高くなっています。詳細: ソリューションエクスプローラーを使用した代替キーの定義

注意

以下を使用して、お客様の環境に代替キーを作成することもできます。

代替キーの定義を含むソリューションをインポートします。
開発者はコードを記述して作成することもできます。詳細: 開発者向けドキュメント: テーブルの代替キーの定義

この記事の情報は、使用できるデザイナーの選択に役立ちます。

次のいずれかの要件に対処する必要がない限り、Power Apps ポータルを使用して代替キーを作成する必要があります。

Common Data Service の既定ソリューション以外のソリューション内で代替キーを作成します。
サポートインデックスの作成の進行状況を追跡するシステムジョブを簡単に追跡します。

代替キーを作成する際の制限

代替キーの作成には制約があります。

代替キーに使用できるフィールド

これらの種類の列のみ代替キーを作成するために使用することができます。

10 進
整数
1 行テキスト (文字列)
日時
参照
選択肢

注意

列のセキュリティを有効化する プロパティが有効になっている列は、代替キーとして使用できません。詳細情報: フィールドセキュリティテーブル
代替キー列で NULL 値が使用されている場合、一意性は強制されません。レコードの重複を避けるため、代替キーの一意の制約で定義された列では null 値を使用しないでください。

キーの番号

1 つのテーブルに対して最大 10 の異なるキーを定義できます。

有効なキーのサイズ

キーの作成時に、合計のキーサイズが、キー当たり 900 バイト、キー当たり 16 列などの SQL ベースのインデックスの制約に違反しないことを含め、キーがプラットフォームによってサポートされることの確認が行われます。キーサイズがその制約に適合しない場合は、エラーメッセージが表示されます。

キー値内の Unicode 文字

代替キーで使用される列内のデータに <、>、*、%、&、:、/、\\、# のいずれかが含まれる場合、(PATCH) アクションの更新または upset は機能しません。

一意性のみを必要とする場合はこの方法も使用することができますが、これらのキーをデータ統合の一部として使用する必要がある場合は、これらの文字を持つデータを持たない列上でキーを作成するのが最善です。

代替キーの作成状態を追跡する

代替キーが作成されると、システムジョブが開始され、データベーステーブルにインデックスが作成され、代替キーによって使用される列に一意の制約が適用されます。代替キーは、これらのインデックスが作成されるまで有効ではありません。これらのインデックスの作成には、システム内のデータ量に応じて時間がかかることがあります。

システムジョブの状態によって代替キーの状態が決まります。代替キーは次の状態を持つことができます。

保留
処理中
Active
失敗

システムジョブが完了すると、代替キーの状態は アクティブ になり使用可能になります。

システムジョブが失敗した場合は、システムジョブを見つけてエラーを表示します。システムジョブでは、以下のパターンに従う名前があります。Create index for {0} for table {1} ここで 0 は代替キーの 表示名 であり、1 はテーブルの名前です。

注意

システムジョブの状態を監視するには、ソリューションエクスプローラーを使用してインデックスを作成する必要があります。それを監視できるように、システムジョブへのリンクを含みます。詳細: (任意) インデックスのシステムジョブ追跡の作成を表示

次の方法で共有