.创建或更改连续导出

使用 “版本 ”下拉列表切换服务。 了解有关导航的详细信息。
适用于:✅ Azure Data Explorer

创建或更改连续导出作业。

权限

必须至少具有 Database Admin 权限才能运行此命令。

语法

.create-or-alter continuous-export continuousExportName [over(T1, T2)] totableexternalTableName [with(propertyName=propertyValue [, ...])] <|查询

详细了解语法约定。

参数

客户 类型 必需 说明
continuousExportName string ✔️ 连续导出的名称。 在数据库中必须唯一。
externalTableName string ✔️ 外部表导出目标的名称。
查询 string ✔️ 要导出的查询。
T1、 T2 string 查询中以逗号分隔的事实数据表列表。 如果不指定此项,将假定查询中引用的所有表都是事实数据表。 如果指定,则不在此列表中的表将被视为维度表并且不受范围限制,因此所有记录都会参与所有导出。 有关详细信息,请参阅连续数据导出概述。
propertyName、propertyValue string 可选属性的逗号分隔列表。

注意

如果目标外部表使用 impersonation 身份验证,则必须指定托管标识来运行连续导出。 有关详细信息,请参阅使用托管标识运行连续导出作业。

支持的属性

属性 类型 说明
intervalBetweenRuns Timespan 连续导出执行之间的时间跨度。 必须大于 1 分钟。
forcedLatency Timespan 可选的时间段,用于将查询限制为相对于当前时间的指定时间段之前提取的记录。 例如,如果查询执行某些聚合或联接,并且想要确保在运行导出之前已提取所有相关记录,则此属性很有用。
sizeLimit long 压缩之前写入的单个storage项目的大小限制(以字节为单位)。 有效范围: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。
managedIdentity string 连续导出所代表的托管标识。 托管标识可以是对象 ID,也可以是 system 保留字。 当外部表使用模拟身份验证或查询引用其他数据库中的表,或者查询引用启用了 行级别安全策略的表时,必须使用托管标识配置连续导出。 有关详细信息,请参阅使用托管标识运行连续导出作业。

示例

以下示例创建或更改连续导出 MyExport,将数据从 T 表导出到 ExternalBlob。 数据导出每小时发生一次,每个storage项目都有一个定义的强制延迟和大小限制。

.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
}