.replace extents 命令

适用于：✅Azure 数据资源管理器

此命令在特定数据库的上下文中运行。 它将指定的区从其源表移至目标表，然后从目标表中删除指定的区。 所有删除和移动操作都在单个事务中完成。

权限

对于源表和目标表，你必须至少具有表管理员权限。

限制

• 源表和目标表都必须位于上下文数据库中。
• ExtentsToDropQuery 指定的所有区都应属于目标表。
• 源表中的所有列均应以相同的名称和数据类型存在于目标表中。
• 如果目标表是具体化视图的源表，则命令可能会失败，因为具体化视图不会处理移动盘区中的记录。 在具体化视图限制页中查看更多详细信息。 可以通过在移动命令期间设置新的引入时间来解决此错误。 请参阅支持的属性中的 setNewIngestionTime。

语法

.replace [async] extents in table DestinationTableName [ with (PropertyName = PropertyValue [, ...])] <|{ExtentsToDropQuery},{ExtentsToMoveQuery}

详细了解语法约定。

参数

支持的属性

返回

同步运行此命令时，将返回具有以下架构的表。

异步运行此命令时，将返回操作 ID (GUID)。 使用 .show operations 命令监视操作的状态，使用 .show operation details 命令检索成功的执行的结果。

示例

从两个表移动指定创建时间范围内的所有盘区

将指定创建时间范围内的两个特定表（MyTable1、MyTable2）的所有盘区移至表 MyOtherTable，并删除 MyOtherTable 中标有 drop-by:MyTag 的所有盘区：

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        .show table MyOtherTable extents where tags has 'drop-by:MyTag'
    },
    {
        .show tables (MyTable1,MyTable2) extents
    }

示例输出

将指定创建时间范围内的所有盘区从一个表移到另一个表，删除特定盘区

将指定创建时间范围内的所有盘区从一个特定表 (MyTable1) 移到表 MyOtherTable，并通过 ID 删除 MyOtherTable 中的特定盘区：

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        print ExtentId = "2cca5844-8f0d-454e-bdad-299e978be5df"
    },
    {
        .show table MyTable1 extents 
    }

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        .show table MyOtherTable extents
        | where ExtentId == guid(2cca5844-8f0d-454e-bdad-299e978be5df) 
    },
    {
        .show table MyTable1 extents 
    }

实现幂等逻辑

实现幂等逻辑，以便 Kusto 仅在有区要从表 t_source 移至表 t_dest 的情况下才从表 t_dest 中删除区：

.replace async extents in table t_dest with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
{
    let any_extents_to_move = toscalar( 
        t_source
        | where extent_tags() has 'drop-by:blue'
        | summarize count() > 0
    );
    let extents_to_drop =
        t_dest
        | where any_extents_to_move and extent_tags() has 'drop-by:blue'
        | summarize by ExtentId = extent_id()
    ;
    extents_to_drop
},
{
    let extents_to_move = 
        t_source
        | where extent_tags() has 'drop-by:blue'
        | summarize by ExtentId = extent_id(), TableName = 't_source'
    ;
    extents_to_move
}