管理命令概述

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

本文介绍用于管理 Kusto 的管理命令(也称为控制命令)。 管理命令是发送给服务的请求,用于检索数据库表中不一定是数据的信息,或者用于修改服务状态等等。

区分管理命令和查询

Kusto 使用三种机制来区分查询和管理命令:语言级别机制、协议级别机制和 API 级别机制。 这样做是为了安全。

在语言级别,可以通过请求文本的第一个字符来确定该请求是管理命令还是查询。 管理命令必须以点 (.) 字符开头,而查询则不能以该字符开头。

在协议级别,可以将不同的 HTTP/HTTPS 终结点用于控制命令而不是查询。

在 API 级别,可以将不同的函数用于发送管理命令而不是查询。

组合使用查询和管理命令

管理命令可以引用查询(反之则不行)或其他管理命令。 有几个支持的方案:

  • AdminThenQuery:执行某个管理命令,其结果(以临时数据表的形式呈现)充当某个查询的输入。
  • AdminFromQuery:执行某个查询或 .show 管理命令,其结果(以临时数据表的形式呈现)充当某个管理命令的输入。

请注意,不管什么情况,整个组合从技术上来说是一个管理命令,而不是一个查询,因此请求的文本必须以点 (.) 字符开头,而且请求必须发送到服务的管理终结点。

另请注意,查询语句出现在文本的查询部分(不能将它们置于命令本身之前)。

注意

建议限制 AdminThenQuery 操作的使用

AdminThenQuery 以下述两种方式之一进行指示:

  • 如果使用竖线 (|) 字符,则查询可以将管理命令的结果视为与任何其他的数据生成查询运算符的结果一样。
  • 如果使用分号 (;) 字符,则会将管理命令的结果引入名为 $command_results 的特殊符号中,该符号随即可以用在查询中,不限次数。

例如:

// 1. Using pipe: Count how many tables are in the database-in-scope:
.show tables
| count

// 2. Using semicolon: Count how many tables are in the database-in-scope:
.show tables;
$command_results
| count

// 3. Using semicolon, and including a let statement:
.show tables;
let useless=(n:string){strcat(n,'-','useless')};
$command_results | extend LastColumn=useless(TableName)

AdminFromQuery 通过 <| 字符组合进行指示。 例如,在下面的代码中,我们先执行一个查询,生成一个包含单个列(名称为 str,类型为 string)和单个行的表,并将其以表名 MyTable 写入数据库的上下文中:

.set MyTable <|
let text="Hello, World!";
print str=text