.alter column policy encoding コマンド

[ バージョン ] ドロップダウン リストを使用してサービスを切り替えます。 ナビゲーションの詳細を確認します。
適用対象: Microsoft Fabric ✅ Azure Data Explorer ✅

エンコード ポリシーを変更します。 エンコード ポリシーの概要については、「 Encoding ポリシー」を参照してください。

Note

エンコード ポリシーの変更は、新しいインジェスト操作に適用されます。 既にインジェストされているデータは、再エンコードが行われることがありますが、これは保証されません。

アクセス許可

このコマンドを実行するには、少なくとも Table 管理者 アクセス許可が必要です。

構文

.alter column EntityIdentifierpolicyencoding [type=EncodingPolicyType]

Note

typeを省略すると、既存のエンコード ポリシー プロファイルが既定値にリセットされます。

構文規則について詳しく知る。

パラメーター

件名 タイプ Required 説明
EntityIdentifier string ✔️ 列の識別子。
EncodingPolicyType string 指定した列に適用するエンコード ポリシーの型。 使用可能な値についてはポリシーの種類のを参照してください。

エンコード ポリシーの種類

次の表に、 EncodingPolicyType パラメーターに使用できる値を示します。

エンコード ポリシー プロファイル 説明
Identifier ID に似た情報 (guid など) を表すデータを含む列に適しています。 このポリシーでは、この列に必要なインデックスを適用して、クエリのパフォーマンスとストレージのサイズの削減の両方を実現します。
BigObject ラージ オブジェクトを保持する動的または文字列型の列に適しています。 たとえば、集計関数の出力。 このポリシーは、この列のインデックスを無効にし、エンコード ポリシー MaxValueSize プロパティを 2 MB にオーバーライドします。
BigObject32 ターゲット シナリオの観点から BigObject に似ています。 エンコード ポリシー MaxValueSize プロパティを 32 MB にオーバーライドします。
BigObjectIndexed32 (プレビュー) ターゲット シナリオの観点から BigObject32 に似ています。 このポリシーにより、この列の大きなデータのインデックスが有効になります。
Vector16 このプロファイルは、既定の 64 ビットではなく、 Bfloat16 を使用して浮動小数点値のベクトルを 16 ビット精度で格納するように設計されています。 ML ベクター埋め込みを格納することを強くお勧めします。これは、ストレージ要件を 4 倍に減らし、 series_dot_product() や series_cosine_similarity()などのベクター処理関数を桁違いに高速化するためです。
Null 現在の既定のエンコード ポリシーを列に設定し、前のエンコード ポリシー プロファイルをクリアします。

Note

  • BigObjectIndexed32 エンコード ポリシーは現在プレビュー段階です。
  • BigObject、BigObject32、およびBigObjectIndexed32エンコード ポリシーは、文字列型または動的データ型の列に関連します。
  • BigObjectIndexed32 ポリシーを設定すると、その文字列または動的列の列ごとの最大値のサイズが、既定の 1 MB から 32 MB に上がります。 制限を超える値は引き続き上限に達します。 string 値は制限に切り捨てられます (既定のポリシーのプロパティMaxValueSize 1 MB)、 dynamic 値は null に置き換えられます。
  • このポリシーが設定されているかどうかに関係なく、レコード (行) の最大サイズは 64 MB のままです。

例

.alter column Logs.ActivityId policy encoding type='identifier'

関連するコンテンツ

  • Last updated on