.alter table policy ingestionbatching コマンド
テーブルの バッチ処理ポリシーを設定します データ集計が停止し、バッチがシールされて取り込まれるタイミングを決定します。
ポリシーがテーブルに対して設定されていない場合は、データベース レベルのポリシーが適用されます。 これも設定されていない場合は、既定値が適用されます。
アクセス許可
このコマンドを実行するには、少なくとも Table 管理者 アクセス許可が必要です。
既定値と制限
「既定値と制限」を参照してください。
構文
.altertable [ DatabaseName.]TableName policy ingestionbatching PolicyObject
.altertables (Table1 , Table2 [,...]) policy ingestionbatching PolicyObject
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| TableName | string |
✔️ | 変更するテーブルの名前。 |
| DatabaseName | string |
データベースの名前。 変更するテーブルを含むデータベース コンテキストからコマンドを実行する場合、 DatabaseName は必要ありません。 | |
| PolicyObject | string |
✔️ | シリアル化された JSON ポリシー オブジェクト。 バッチ処理ポリシーを参照してください。 |
例
次のコマンドは、500 ファイルまたは 1 GBのいずれか早い方に対して、30 秒のバッチ入力データ時間を設定します。
.alter table MyDatabase.MyTable policy ingestionbatching
```
{
"MaximumBatchingTimeSpan" : "00:00:30",
"MaximumNumberOfItems" : 500,
"MaximumRawDataSizeMB": 1024
}
```
次のコマンドは、20 ファイルまたは 300 MBのいずれか早い方に対して、1 分のバッチ入力データ時間を設定します。
.alter tables (MyTable1, MyTable2, MyTable3) policy ingestionbatching
```
{
"MaximumBatchingTimeSpan" : "00:01:00",
"MaximumNumberOfItems" : 20,
"MaximumRawDataSizeMB": 300
}
```
Note
PolicyObjectのすべてのパラメーターを指定しない場合、指定されていないパラメーターは既定の値設定されます。 たとえば、"MaximumBatchingTimeSpan" のみを指定すると、"MaximumNumberOfItems" と "MaximumRawDataSizeMB" が既定値に設定されます。 一部のパラメーターのみをオーバーライドするには、 alter-merge コマンド コマンドを使用します。