コードを使用した 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 に保存されます。
- EntityMetadata クラスは、.NET 用 SDK を定義します。
- EntityMetadata EntityType は、Web API 用に定義します。
テーブル定義には、次の情報が含まれています:
| データ | 内容 |
|---|---|
| プロパティ | 各エンティティには、どのように識別され、何ができるかを表示した 100 近くのプロパティがあります。 詳細: エンティティの定義 |
| 属性 | エンティティ Attributes プロパティは、属性または列のコレクションです。 各列には、識別方法、含まれるデータの種類、書式設定方法、および実行できる処理を記述する約 50 個のプロパティがあります。 詳細: 属性の定義 |
| 関係 | 3 つのエンティティ プロパティは、テーブル間の関係のコレクションです。 異なるタイプの関連付けをもつコレクション: 多対多、多対一、および一対多があります。 詳細: 関連付けの定義 |
| 特権 | 1 つのプロパティは、0 個から 8 個の権限のコレクションで、それぞれに関連付けられた一意識別子を使用して、そのテーブルで実行できるデータ操作の種類を指定します。 オペレーションには、追加、AppendTo、割り当て、作成、削除、読み取り、共有、および書き込みがあります。 |
| キー | 既定で、各テーブルには 1 つの GUID (グローバル一意識別子) 属性があり、Keys プロパティは空のコレクションです。 テーブルには代替キーを追加できます。 詳細: キー |
ヒント
システムのテーブル定義を理解することで、Dataverse の動作を理解することができます。 プロパティの多くは、モデル駆動型アプリで実行できるテーブルも制御します。 メタデータを編集できるデザイナーは、メタデータにあるすべての詳細を表示できません。 メタデータ ブラウザーと呼ばれるモデル駆動型アプリをインストールすると、システム内にあるすべての非表示テーブルとメタデータ プロパティを表示できます。 詳細: ご使用の環境でテーブル定義と列定義を参照する
非公開テーブル
Dataverse には、サードパーティの開発者が使用することを意図していないテーブルがいくつか含まれています。 これらのテーブルは、Microsoft が機能を有効にするために追加したものです。 非公開テーブルは、EntityMetadata.IsPrivate によって示されます プロパティに設定します。 これらのテーブルは、Web API CSDL $metadata ドキュメント に含まれていません。 ただし、エンティティ メタデータをクエリするときにそれらが表示されます。
注意事項
ソリューションで非公開テーブルを使用しないでください。 テーブルを非公開としてマークすることにより、Microsoft は、そのテーブルを使用する他のアプリをサポートしないことを明示的に示しています。 Microsoft は、いつでもテーブルを削除したり、破壊的変更を導入したりする場合があります。 Microsoft 以外によるこれらのテーブルの使用はサポートされていません。
関連項目
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。