ファイルの列を使用して、指定された最大サイズまでのファイルデータを保存することができます。 ファイル列は、バイナリ データを格納するために最適化されています。 Dataverse は、このデータをリレーショナル データ ストア に保存しません。これにより、パフォーマンスが向上し、容量の使用量が削減されます。 ストレージ容量の詳細を確認します。
カスタムまたはカスタマイズ可能なテーブルには、0 個以上のファイル列を含めることができます。 この記事では、コード内の列定義の操作について説明します。 これらの列に格納されたデータを使用するには、ファイルの列データを使用するを参照してください。
ファイルの列の作成
ファイル列を作成するには、 Power Apps を使用し、デザイナーを使用して列を定義することをお勧めします。 詳細については、「 ファイル列」を参照してください。
注意
ファイル列を作成する際に考慮すべき重要な点は、プロパティMaxSizeInKBに格納されている最大ファイルサイズです。 このプロパティの既定の設定は、 32768または 32 MB です。 最大値は10485760 KB (10 GB) です。 API は最大 10 GB のサイズのファイルを処理できますが、要求はチャンクする必要があります。 1 つの要求を送信するためのサイズ制限は 128 MB です。 クライアント アプリケーションが 1 つの要求で 128 MB を超えるファイルを送信しようとすると、エラーがスローされます。
ファイルのアップロード方法を学ぶ。
ファイル列を作成した後、デザイナーを使用して MaxSizeInKB の値を変更することはできません。
API を使用して MaxSizeInKB プロパティを更新することができます。 詳細については、「 Web API を使用して列を更新する 」および「 SDK を使用して列を更新する」を参照してください。
Dataverse SDK for .NET を使用するか、Web API を使用して、ファイル列を作成することもできます。 次の例は、ファイル列を作成する方法を示しています。
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 プロパティで最大サイズを設定します。
詳細については、以下を参照してください:
ブロックされたファイルの種類
ファイル拡張子や MIME のタイプに基づいて、ファイル列に保存できないファイルの種類を制御することができます。
詳細については、以下を参照してください:
セルフマネージドキー (BYOK) の制限
重要
いくつかの制限は、Dataverse のファイルおよび拡張イメージ データ型を使用する際に適用されます。 テナント で自己管理キー (BYOK) が有効になっている場合、IoT データ型はテナントの組織では使用できません。 除外されたデータ型を含むソリューションはインストールされません。 これらのデータ型を使用するには、BYOK をオプトアウトする必要があります。
バージョン: 9.2.21052.00103 現在のすべての BYOK 組織は、Dataverse ファイルと画像のデータ型をサポートできます。 BYOK 組織内のファイルは、ファイルあたり最大 128MB のサイズに制限されています。 BYOK 組織内のすべてのファイルとイメージは、Dataverse File Blob Storage ではなく Dataverse リレーショナル ストレージに格納されます。 その他の制限事項:
- ユーザー委任 SAS ダウンロードはサポートされていません
- チャンクのアップロードとダウンロードは 1 つのチャンクに制限されています