适用于：✅Azure 数据资源管理器
此命令在特定数据库的上下文中运行。 它将更改查询返回的所有盘区指定的标记。
使用 Kusto 查询指定要更改其标记的盘区，该查询将返回一个包含名为“ExtentId”的列的记录集。
注意
在 Kusto 中，数据分片被称为“盘区”，所有命令都将“extent”或“extents”作为同义词使用。 有关盘区的详细信息，请参阅盘区（数据分片）概述。
权限
你必须至少具有表管理员权限才能运行此命令。
语法
.alter [async] table“TableName”extent tags (标记) with ( extentCreatedOnFrom=“FromDate”, extentCreatedOnTo=“ToDate”)<|查询
.alter-merge [async] table“TableName”extent tags (标记) with ( extentCreatedOnFrom=“FromDate”, extentCreatedOnTo=“ToDate”)<|查询
.alter将盘区的标记集合设置为指定的标记，同时重写盘区的现有标记。.alter-merge将盘区的标记集合设置为指定标记和盘区现有标记的并集。
注意
为了提高性能，请将 extentCreatedOnFrom 和 extentCreatedOnTo 参数设置为尽可能小的范围
详细了解语法约定。
参数
| 客户 | 类型 | 必需 | 说明 |
|---|---|---|---|
async |
string |
如果指定此项，命令将以异步方式运行。 使用 async 运行时的返回输出是可用于监视操作状态的操作 ID (guid)。 使用 .show operations 或 .show operation details。 |
|
| 标记 | string |
✔️ | 一个或多个逗号分隔的盘区标记。 每个标记都应使用单引号 (') 引起来。 |
| 查询 | string |
✔️ | 指定应更改其标记的盘区。 |
限制
所有盘区都必须在上下文数据库中，并且必须属于同一个表。
返回
| 输出参数 | 类型 | 说明 |
|---|---|---|
| OriginalExtentId | string |
原始盘区的唯一标识符 (GUID)，其标记已修改。 此盘区在操作过程中被删除。 |
| ResultExtentId | string |
结果盘区的唯一标识符 (GUID)，其标记已修改。 此盘区在操作过程中创建和添加。 失败时 -“已失败”。 |
| ResultExtentTags | string |
结果盘区的标记的集合，如果操作失败，则为“null”。 |
| 详细信息 | string |
包括失败详细信息（如果操作失败）。 |
示例
更改标记
将表 MyTable 中指定创建时间范围内的所有盘区的标记更改为 MyTag
.alter table MyTable extent tags ('MyTag') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| .show table MyTable extents
更改特定盘区的标记
将表 MyTable 中指定创建时间范围内的所有盘区的标记（标为 drop-by:MyTag）更改为 drop-by:MyNewTag 和 MyOtherNewTag
.alter table MyTable extent tags ('drop-by:MyNewTag','MyOtherNewTag') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| .show table MyTable extents where tags has 'drop-by:MyTag'
更改并合并特定盘区的标记
将表 MyTable 中指定创建时间范围内所有带 drop-by:MyTag 标记的盘区的标记更改并合并为 drop-by:MyNewTag 和 MyOtherNewTag，方法是将 2 个新标记追加到这些盘区的现有标记集合
.alter-merge table MyTable extent tags ('drop-by:MyNewTag','MyOtherNewTag') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| .show table MyTable extents where tags has 'drop-by:MyTag'
示例输出
| OriginalExtentId | ResultExtentId | ResultExtentTags | 详细信息 |
|---|---|---|---|
| e133f050-a1e2-4dad-8552-1f5cf47cab69 | 0d96ab2d-9dd2-4d2c-a45e-b24c65aa6687 | drop-by:MyNewTag MyOtherNewTag | |
| cdbeb35b-87ea-499f-b545-defbae091b57 | a90a303c-8a14-4207-8f35-d8ea94ca45be | drop-by:MyNewTag MyOtherNewTag | |
| 4fcb4598-9a31-4614-903c-0c67c286da8c | 97aafea1-59ff-4312-b06b-08f42187872f | drop-by:MyNewTag MyOtherNewTag | |
| 2dfdef64-62a3-4950-a130-96b5b1083b5a | 0fb7f3da-5e28-4f09-a000-e62eb41592df | drop-by:MyNewTag MyOtherNewTag |