コードを使ってファイル列定義を操作する

ファイルの列を使用して、指定された最大サイズまでのファイルデータを保存することができます。 ファイル列は、バイナリ データを格納するために最適化されています。 Dataverse は、このデータをリレーショナル データ ストア に保存しません。これにより、パフォーマンスが向上し、容量の使用量が削減されます。 ストレージ容量の詳細

カスタムまたはカスタマイズ可能なテーブルには、0 個以上のファイル列を含めることができます。 この記事では、コード内の列定義の操作について説明します。 これらの列に格納されたデータを使用するには、ファイルの列データを使用するを参照してください。

ファイルの列の作成

ファイル列を作成するための推奨される方法は、Power Apps を使用し、デザイナーを使用して列を定義する方法です。 詳細については、ファイルの列を参照してください。

注意

ファイル列を作成する際に考慮すべき重要な点は、MaxSizeInKB プロパティに格納されている 最大ファイルサイズ です。 このプロパティの既定の設定は、32768 または 32 MB です。 最大値は10485760 KB (10 GB) です。 API は最大 10 GB のサイズのファイルを処理できますが、要求は "チャンク" する必要があります。 1 つの要求を送信するためのサイズ制限は 128 MB です。 クライアント アプリケーションが 1 回の要求で 128 MB を超えるファイルを送信しようとすると、エラーがスローされます。 ファイルのアップロード方法を学ぶ。

MaxSizeInKB の値は、ファイル列を作成した後、デザイナーを使用して Power Apps で変更することはできません。 API を使用して MaxSizeInKB プロパティを更新することができます。 詳細情報: Web API を使用して列を更新する、SDK を使用して列を更新する

Dataverse SDK for .NET や Web API を使用してファイル列を作成することも可能です。 以下の例では、その方法を紹介しています:

.NET 用 SDK

FileAttributeMetadata Class を CreateAttributeRequest Class と一緒に使って、ファイル列を作成します。

public static void CreateFileColumn(
   IOrganizationService service, 
   string entityLogicalName, 
   string fileColumnSchemaName) 
{

    FileAttributeMetadata fileColumn = new()
    {
        SchemaName = fileColumnSchemaName,
        DisplayName = new Label("Sample File Column", 1033),
        RequiredLevel = new AttributeRequiredLevelManagedProperty(
                AttributeRequiredLevel.None),
        Description = new Label("Sample File Column for FileOperation samples", 1033),
        MaxSizeInKB = 30 * 1024 // 30 MB

    };

    CreateAttributeRequest createfileColumnRequest = new() {
        EntityName = entityLogicalName,
        Attribute = fileColumn                   
    };

    service.Execute(createfileColumnRequest);

}

FileAttributeMetadata.MaxSizeInKB プロパティで最大サイズを設定します。

詳細情報:

• .NET 用 SDK とは
• IOrganizationService.Execute

Web API

テーブルの Attributes コレクションに FileAttributeMetadata EntityType を POST します。

要求:

POST [Organization Uri]/api/data/v9.2/EntityDefinitions(LogicalName='account')/Attributes HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
Content-Type: application/json; charset=utf-8

{
  "@odata.type": "Microsoft.Dynamics.CRM.FileAttributeMetadata",
  "AttributeTypeName": {
    "Value": "FileType"
  },
  "SchemaName": "sample_FileColumn",
  "MaxSizeInKB": 30720,
  "Description": {
    "@odata.type": "Microsoft.Dynamics.CRM.Label",
    "LocalizedLabels": [
      {
        "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
        "Label": "Sample File Column for FileOperation samples",
        "LanguageCode": 1033,
        "IsManaged": false
      }
    ]
  },
  "DisplayName": {
    "@odata.type": "Microsoft.Dynamics.CRM.Label",
    "LocalizedLabels": [
      {
        "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
        "Label": "Sample File Column",
        "LanguageCode": 1033,
        "IsManaged": false
      }
    ]
  }
}

FileAttributeMetadata.MaxSizeInKB プロパティで最大サイズを設定する。

応答:

HTTP/1.1 204 NoContent
Location: [Organization Uri]/api/data/v9.2/EntityDefinitions(LogicalName='account')/Attributes(9554c5f9-8c51-ed11-bba1-000d3a9933c9)
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/EntityDefinitions(LogicalName='account')/Attributes(9554c5f9-8c51-ed11-bba1-000d3a9933c9)

詳細情報:

• Web API を使用したテーブル定義の作成および更新
• Web API テーブル スキーマ操作サンプル (C#)

ブロックされたファイルの種類

ファイル拡張子や MIME のタイプに基づいて、ファイル列に保存できないファイルの種類を制御することができます。

詳細情報:

• 拡張子でファイルをブロックする
• 特定の MIME タイプをブロックまたは許可する

セルフマネージドキー キー (BYOK) の制限

重要

いくつかの制限は、Dataverse のファイルおよび拡張イメージ データ型を使用する際に適用されます。 テナントでセルフマネージドキー キー (BYOK) の制限が有効になっている場合、テナントの組織は IoT データ型を使用できません。 除外されたデータ型を含むソリューションはインストールされません。 これらのデータ型を使用するには、顧客が BYOK をオプトアウトする必要があります。

バージョン: 9.2.21052.00103 現在のすべての BYOK 組織は、Dataverse ファイルと画像のデータ型をサポートできます。 BYOK 組織内のファイルは、ファイルあたり最大 128MB のサイズに制限されています。 BYOK 組織内のすべてのファイルと画像は、Dataverse ファイル Blob Storage の代わりに Dataverse に保存されます。 その他の制限事項:

• ユーザー委任 SAS ダウンロードはサポートされていません
• チャンクのアップロードとダウンロードは 1 つのチャンクに制限されています

関連情報

ファイル列のデータを使用する
コードを使って画像列定義を操作する

注意

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

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