適用於: ✅Microsoft網狀架構✅Azure 數據總管
建立或改變連續匯出作業。
權限
您必須至少有 Database Admin 許可權才能執行此命令。
語法
.create-or-alter
continuous-export
continuousExportName [over( T1, T2)] totable externalTableName [ propertyNamewith( [=, ...]] )<|查詢
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| continuousExportName | string |
✔️ | 連續導出的名稱。 資料庫內必須是唯一的。 |
| externalTableName | string |
✔️ | 外部數據表匯出目標的名稱。 |
| query | string |
✔️ | 要導出的查詢。 |
| T1、 T2 | string |
查詢中以逗號分隔的事實數據表清單。 如果未指定,則會假設查詢中參考的所有數據表都是事實數據表。 如果指定,此列表中的數據表 未 會被視為維度數據表,而且不會設定範圍,因此所有記錄都會參與所有匯出。 如需詳細資訊,請參閱 連續數據導出概觀 。 | |
| propertyName、 propertyValue | string |
選擇性 屬性的逗號分隔清單。 |
注意
如果目標外部數據表使用 模擬 驗證,您必須指定受控識別來執行連續匯出。 如需詳細資訊,請參閱 使用受控識別來執行連續匯出作業。
支援的屬性
| 屬性 | 類型 | 描述 |
|---|---|---|
intervalBetweenRuns |
Timespan |
連續匯出執行之間的時間範圍。 必須大於 1 分鐘。 |
forcedLatency |
Timespan |
選擇性的期間,將查詢限制為相對於目前時間的指定期間之前內嵌的記錄。 例如,如果查詢會執行一些匯總或聯結,而且您想要在執行匯出之前,確定已內嵌所有相關記錄,這個屬性就很有用。 |
sizeLimit |
long |
壓縮之前寫入之單一記憶體成品的大小限制,以位元組為單位。 有效範圍:100 MB(預設值) 到 1 GB。 |
distributed |
bool |
停用或啟用分散式匯出。 將 設定為 false 相當於 single 散發提示。 預設為 true。 |
distribution |
string |
分佈提示 (single, per_node, per_shard)。 請參閱 分發設定中的更多詳細資訊。 預設值為 per_node |
distributionKind |
string |
選擇性地在外部資料表依字串分割區分割時切換至統一配送。 有效值為 uniform 或 default。 請參閱分發設定中的更多詳細資訊 |
parquetRowGroupSize |
int |
只有在數據格式為 Parquet 時才相關。 控制匯出檔案中的數據列群組大小。 默認數據列群組大小為100,000筆記錄。 |
managedIdentity |
string |
執行連續匯出作業的受控識別。 受控識別可以是物件標識碼或 system 保留字。 如需詳細資訊,請參閱 使用受控識別來執行連續匯出作業。 |
isDisabled |
bool |
停用或啟用連續匯出。 預設為 False。 |
| 屬性 | 類型 | 描述 |
|---|---|---|
intervalBetweenRuns |
Timespan |
連續匯出執行之間的時間範圍。 必須大於 1 分鐘。 |
forcedLatency |
Timespan |
選擇性的期間,將查詢限制為相對於目前時間的指定期間之前內嵌的記錄。 例如,如果查詢會執行一些匯總或聯結,而且您想要在執行匯出之前,確定已內嵌所有相關記錄,這個屬性就很有用。 |
sizeLimit |
long |
壓縮之前寫入之單一記憶體成品的大小限制,以位元組為單位。 有效範圍:100 MB(預設值) 到 1 GB。 |
distributed |
bool |
停用或啟用分散式匯出。 將 設定為 false 相當於 single 散發提示。 預設為 true。 |
distribution |
string |
分佈提示 (single, per_node, per_shard)。 請參閱 分發設定中的更多詳細資訊。 預設值為 per_node |
distributionKind |
string |
選擇性地在外部資料表依字串分割區分割時切換至統一配送。 有效值為 uniform 或 default。 請參閱分發設定中的更多詳細資訊 |
parquetRowGroupSize |
int |
只有在數據格式為 Parquet 時才相關。 控制匯出檔案中的數據列群組大小。 默認數據列群組大小為100,000筆記錄。 |
isDisabled |
bool |
停用或啟用連續匯出。 預設為 False。 |
範例
下列範例會建立或改變連續匯出 MyExport,以將資料從 T 數據表匯出至 ExternalBlob。 數據匯出會每小時發生,併為每個記憶體成品定義強制延遲和大小限制。
.create-or-alter continuous-export MyExport
over (T)
to table ExternalBlob
with
(intervalBetweenRuns=1h,
forcedLatency=10m,
sizeLimit=104857600)
<| T
| 姓名 | ExternalTableName | Query | ForcedLatency | IntervalBetweenRuns | CursorScopedTables | ExportProperties |
|---|---|---|---|---|---|---|
| MyExport | ExternalBlob | S | 00:10:00 | 01:00:00 | [ “['DB']。['S']” ] |
{ “SizeLimit”: 104857600 } |