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