.create または alter continuous-export
連続エクスポート ジョブを作成または変更します。
アクセス許可
このコマンドを実行するには、少なくとも Database Admin アクセス許可が必要です。
構文
.create-or-alter
continuous-export
continuousExportName [over
(
T1, T2)
] to
table
externalTableName [with
(
propertyName=
propertyValue [,
...])
] <|
クエリ
構文規則について詳しく知る。
パラメーター
件名 | タイプ | Required | 説明 |
---|---|---|---|
continuousExportName | string |
✔️ | 連続エクスポートの名前。 データベース内で一意である必要があります。 |
externalTableName | string |
✔️ | エクスポート先の 外部テーブル 名前。 |
クエリ | string |
✔️ | エクスポートするクエリ。 |
T1、 T2 | string |
クエリ内のファクト テーブルのコンマ区切りのリスト。 指定しない場合、クエリ*で参照されるすべてのテーブル*がファクトテーブル*と見なされます。 指定した場合、この一覧 されていないテーブルはディメンション テーブルとして扱われ、スコープは設定されないため、すべてのレコードがすべてのエクスポートに参加します。 詳細については、「継続的なデータ* エクスポート*の概要」を参照してください。 | |
propertyName, propertyValue | string |
省略可能な プロパティのコンマ区切りリスト。 |
Note
ターゲット外部テーブルで 権限借用 認証を使用する場合は、継続的エクスポートを実行するマネージド ID を指定する必要があります。 詳細については、「 マネージド ID を使用して連続エクスポート ジョブを実行するを参照してください。
サポートされるプロパティ
プロパティ | タイプ | 説明 |
---|---|---|
intervalBetweenRuns |
Timespan |
連続エクスポート*実行の間隔。 1分よりも大きい値にする必要があります。 |
forcedLatency |
Timespan |
現在の時刻を基準にして、指定した期間より前に取り込まれたレコードにクエリを制限する、省略可能な期間。 このプロパティは、たとえば、クエリが一部の集計や結合を実行し、エクスポートを実行する前に関連するすべてのレコードが取り込まれたことを確認する場合に便利です。 |
sizeLimit |
long |
圧縮前に書き込まれた 1 つのストレージ 成果物のサイズ制限 (バイト単位)。 有効な範囲: 100 MB (既定値) から 1 GB。 |
distributed |
bool |
分散エクスポートを無効または有効にします。 false に設定*することは、single distribution ヒント*と同じことを意味します。 既定値は True です。 |
parquetRowGroupSize |
int |
データ形式が Parquet の場合にのみ関連します。 エクスポート*されたファイル*内の行*グループ*のサイズを制御します。 既定の行グループ サイズは 100,000 レコードです。 |
managedIdentity |
string |
連続エクスポート ジョブが実行されるマネージド ID。 マネージド ID には、オブジェクト ID または system 予約語を指定できます。 詳細については、「 マネージド ID を使用して連続エクスポート ジョブを実行するを参照してください。 |
isDisabled |
bool |
連続エクスポートを無効または有効にします。 既定値は False です。 |
例
次の例では、T
テーブルから ExternalBlob
にデータをエクスポートする連続エクスポート MyExport
を作成または変更します。 データのエクスポートは 1 時間ごとに行われ、ストレージ成果物あたりの強制待機時間とサイズ制限が定義されています。
.create-or-alter continuous-export MyExport
over (T)
to table ExternalBlob
with
(intervalBetweenRuns=1h,
forcedLatency=10m,
sizeLimit=104857600)
<| T
件名 | ExternalTableName | クエリ | ForcedLatency | IntervalBetweenRuns | CursorScopedTables | ExportProperties |
---|---|---|---|---|---|---|
MyExport | ExternalBlob | S | 00:10:00 | 01:00:00 | [ "['DB'].['S']" ] |
{ "SizeLimit": 104857600 } |
関連コンテンツ
- 連続エクスポートの概要
- 外部テーブル を
する - 連続エクスポート を無効または有効にする
- .show continuous-exports
- .show continuous-export
- .drop 連続エクスポート を
する - .show continuous-export failures