コードを使用した Dataverse テーブルの操作

  • [アーティクル]

データのストレージを提供することは Dataverse で最も重要な機能です。 Dataverse には、ビジネス アプリケーションによって使用されるデータの構造を提供するテーブルの基本セットが含まれます。

テーブルの基本セットは、Dataverse テーブル/エンティティ参照 で確認できます。

テーブルを変更する

テーブル デザインは、いくつかの方法で変更できます。

デザイナーを使用

デザイナーを使用してテーブル デザインを編集する方法はいくつかあります。

デザイナー 内容
make.powerapps.com スキーマを変更するための最も簡単で一般的な方法は、https://make.powerapps.com/ を使用して環境内の Dataverse テーブルを編集することです。 ここで申請された変更は、管理されていない Common Data Service の既定ソリューションのコンテキストで実行されます。
独自のソリューション エクスプローラー ソリューションを配布する場合は、アンマネージド ソリューションのコンテキストで、ソリューションの開発に使用する新しいテーブル、属性、または関係を作成する必要があります。
詳細 : ソリューション発行者
フォーム エディターから エンティティのモデル駆動型アプリ フォームを編集する場合、フィールド エクスプローラーで新しいフィールドボタンをクリックします。 検索フィールドを作成する場合は、それをサポートする新しい関係を作成します。

ソリューションのインポート

ソリューション には、テーブルとその他のカスタマイズされたコンポーネントを含めることができます。 マネージドまたはアンマネージド ソリューションを Dataverse 環境にインポートすると、これらのテーブルが含まれるか、既存のテーブルが含まれる新しいテーブルで拡張されます。

Power Query を使用するデータ ソースから

Power Query を使用して、新しいテーブルを作成してデータを入力できます。 詳細: Power Query を使用して Dataverse のテーブルにデータを追加する

Web サービスを使用したテーブル定義の操作

Dataverse で公開されている Web サービスには、テーブルを作成、読み取り、書き込み、および削除する機能があります。 これらのサービスは、データが実行時に環境のカスタマイズ方法をコードに通知できるため、読み取りに最も頻繁に使用されます。 詳細: コードを使用したテーブル定義の操作

テーブル定義

データ モデルは Dataverse に保存されます。

テーブル定義には、次の情報が含まれています:

データ​​ 内容
プロパティ​​ 各エンティティには、どのように識別され、何ができるかを表示した 100 近くのプロパティがあります。 詳細: エンティティの定義
属性 エンティティ Attributes プロパティは、属性または列のコレクションです。 各列には、識別方法、含まれるデータの種類、書式設定方法、および実行できる処理を記述する約 50 個のプロパティがあります。 詳細: 属性の定義
関係 3 つのエンティティ プロパティは、テーブル間の関係のコレクションです。 異なるタイプの関連付けをもつコレクション: 多対多、多対一、および一対多があります。 詳細: 関連付けの定義
特権 1 つのプロパティは、0 個から 8 個の権限のコレクションで、それぞれに関連付けられた一意識別子を使用して、そのテーブルで実行できるデータ操作の種類を指定します。 オペレーションには、追加、AppendTo、割り当て、作成、削除、読み取り、共有、および書き込みがあります。
キー 既定で、各テーブルには 1 つの GUID (グローバル一意識別子) 属性があり、Keys プロパティは空のコレクションです。 テーブルには代替キーを追加できます。 詳細: キー

ヒント

システムのテーブル定義を理解することで、Dataverse の動作を理解することができます。 プロパティの多くは、モデル駆動型アプリで実行できるテーブルも制御します。 メタデータを編集できるデザイナーは、メタデータにあるすべての詳細を表示できません。 メタデータ ブラウザーと呼ばれるモデル駆動型アプリをインストールすると、システム内にあるすべての非表示テーブルとメタデータ プロパティを表示できます。 詳細: ご使用の環境でテーブル定義と列定義を参照する

非公開テーブル

Dataverse には、サードパーティの開発者が使用することを意図していないテーブルがいくつか含まれています。 これらのテーブルは、Microsoft が機能を有効にするために追加したものです。 非公開テーブルは、EntityMetadata.IsPrivate によって示されます プロパティに設定します。 これらのテーブルは、Web API CSDL $metadata ドキュメント に含まれていません。 ただし、エンティティ メタデータをクエリするときにそれらが表示されます。

注意事項

ソリューションで非公開テーブルを使用しないでください。 テーブルを非公開としてマークすることにより、Microsoft は、そのテーブルを使用する他のアプリをサポートしないことを明示的に示しています。 Microsoft は、いつでもテーブルを削除したり、破壊的変更を導入したりする場合があります。 Microsoft 以外によるこれらのテーブルの使用はサポートされていません。

関連項目

Dataverse 開発者向けの概要

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。