建立或更改連續匯出
建立或更改連續匯出工作。
權限
您必須至少有 Database 管理員 許可權才能執行此命令。
Syntax
.create-or-alter
continuous-export
continuousExportName [over
(
T1, T2)
] to
table
externalTableName [with
(
propertyName=
propertyValue [,
...])
] <|
查詢
深入瞭解 語法慣例。
參數
名稱 | 類型 | 必要 | Description |
---|---|---|---|
continuousExportName | string |
✔️ | 連續導出的名稱。 資料庫內必須是唯一的。 |
externalTableName | string |
✔️ | 外部數據表匯出目標的名稱。 |
查詢 | string |
✔️ | 要導出的查詢。 |
T1、 T2 | string |
查詢中事實數據表的逗號分隔清單。 如果未指定,則會假設查詢中參考的所有資料表都是事實資料表。 如果指定, 不在 這份清單中的數據表會被視為維度數據表,而且不會設定範圍,因此所有記錄都會參與所有匯出。 如需詳細資料,請參閱連續資料匯出概觀。 | |
propertyName, propertyValue | string |
選擇性 屬性的逗號分隔清單。 |
注意
如果目標外部數據表使用 模擬 驗證,您必須指定受控識別來執行連續匯出。 如需詳細資訊,請參閱 使用受控識別來執行連續匯出作業。
支援的屬性
屬性 | 類型 | Description |
---|---|---|
intervalBetweenRuns |
Timespan |
連續匯出執行之間的時間範圍。 必須大於 1 分鐘。 |
forcedLatency |
Timespan |
一段選用的時間,可將查詢限制在僅於此期間擷取的記錄 (相對於目前的時間)。 例如,如果查詢會執行一些彙總/聯結,而您想要確定在執行匯出之前已擷取所有相關的記錄,則此屬性會很有用。 |
sizeLimit |
long |
要寫入的單一儲存體成品的大小限制 (以位元組為單位,壓縮之前)。 有效範圍:100 MB (預設) 為 1 GB。 |
distributed |
bool |
停用/啟用分散式匯出。 將設定為 false 相當於 single 散發提示。 預設值為 true。 |
parquetRowGroupSize |
int |
只有當資料格式為 Parquet 時才相關。 控制匯出檔案中的資料列群組大小。 默認數據列群組大小為100,000筆記錄。 |
useNativeParquetWriter |
bool |
匯出至 Parquet 時,請使用新的匯出實作,此實作是更具效能的資源光線導出機制。 請注意,Synapse SQL 'COPY' 目前不支持導出的 'datetime' 資料行。 預設值為 false。 |
managedIdentity |
string |
代表連續匯出作業執行的受控識別。 受控識別可以是物件標識碼或 system 保留字。 如需詳細資訊,請參閱 使用受控識別來執行連續匯出作業。 |
isDisabled |
bool |
停用/啟用連續匯出。 預設值為 false。 |
範例
.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 } |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應