.alter query acceleration policy コマンド (プレビュー)
特定の外部デルタ テーブルの query アクセラレーション ポリシー を変更します。
制限事項については、「 Limitations」を参照してください。
アクセス許可
このコマンドを実行するには、少なくとも Database Admin アクセス許可が必要です。
構文
.alter
external
table
ExternalTableName policy
query_acceleration
'JSON シリアル化ポリシー'
パラメーター
件名 | タイプ | Required | 説明 |
---|---|---|---|
ExternalTableName | string |
✔️ | 外部デルタ テーブルの名前。 |
JSON シリアル化されたポリシー | string |
✔️ | JSON プロパティ バッグを保持する文字列リテラル。 |
JSON プロパティ バッグ
プロパティ | タイプ | Required | 説明 |
---|---|---|---|
IsEnabled | Boolean |
✔️ | ポリシーが有効かどうかを示します。 |
ホット | Timespan |
✔️ | クエリ 高速化ポリシーで定義されているホット期間。 最小値 = 1 d。 |
Note
クエリ アクセラレーションは、timespan
として定義された特定の期間内のデータに適用されます。これは、delta ログ内の各ファイルに記載されているmodificationTime
から開始。
例
{"IsEnabled": true, "Hot": "1.00:00:00"}
返品
このコマンドは、変更されたポリシー オブジェクトを含む 1 つのレコードを含むテーブルを返します。
列 | タイプ | 説明 |
---|---|---|
PolicyName | string |
ポリシーの名前 - QueryAcceleration |
EntityName | string |
エンティティの完全修飾名: [DatabaseName].[ExternalTableName] |
ポリシー | string |
外部デルタ テーブルに設定されているクエリ 高速化ポリシーの JSON シリアル化 |
ChildEntities | string |
このポリシーが影響を受ける子エンティティ - null |
EntityType | string |
ポリシーが適用されるエンティティの型 - ExternalTable |
例
.alter external table MyExternalTable policy query_acceleration '{"IsEnabled": true, "Hot": "1.00:00:00"}'