azdata context

适用范围:Azure Data CLI (azdata)

以下文章提供了 azdata 工具中 sql 命令的参考。 有关其他 azdata 命令的详细信息,请参阅 azdata 参考

命令

命令 描述
azdata context list 列出用户配置文件中的可用上下文。
azdata context delete 从用户配置文件中删除具有给定命名空间的上下文。
azdata context set 将具有给定命名空间的上下文设置为用户配置文件中的活动上下文。

azdata context list

可以通过 azdata context setazdata context delete 来设置或删除任何上下文。 要登录到新的上下文,请使用 azdata login

azdata context list [--active -a] 
                    

示例

列出用户配置文件中的所有可用上下文。

azdata context list

列出用户配置文件中的活动上下文。

azdata context list --active

可选参数

--active -a

仅列出当前处于活动状态的上下文。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--output -o

输出格式。 允许的值:json、jsonc、table、tsv。 默认值:json。

--query -q

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

azdata context delete

如果已删除的上下文处于活动状态,则用户需要设置新的活动上下文。 查看可用于设置或删除 azdata context list 的上下文。 当提供与多个上下文命名空间匹配的命名空间时,必须提供所有 [--namespace --username --endpoint] 以指示唯一性,才能删除该上下文。

azdata context delete --namespace -ns 
                      [--endpoint -e]  
                      
[--username -u]

示例

基于唯一命名空间删除用户配置文件中的上下文。

azdata context delete --namespace contextNamespace

基于命名空间、用户名和控制器终结点删除用户配置文件中的上下文。

azdata context set --namespace contextNamespace --username johndoe --endpoint https://<ip or domain name>:30080

必需的参数

--namespace -ns

要删除的上下文的命名空间。

可选参数

--endpoint -e

群集控制器终结点“https://host:port"”。

--username -u

帐户用户。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--output -o

输出格式。 允许的值:json、jsonc、table、tsv。 默认值:json。

--query -q

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

azdata context set

查看可用于设置 azdata context list 的上下文。 如果未列出上下文,则需要登录才能在用户配置文件 azdata login 中创建上下文。 登录到的内容将成为活动上下文。 如果登录到多个实体,则可以通过此命令在活动上下文间切换。 查看当前活动上下文 azdata context list --active。 当提供与多个上下文命名空间匹配的命名空间时,必须提供所有 [--namespace --username --endpoint] 以指示唯一性,才能设置活动上下文。

azdata context set --namespace -ns 
                   [--endpoint -e]  
                   
[--username -u]

示例

基于唯一命名空间设置用户配置文件中的活动上下文。

azdata context set --namespace contextNamespace

基于命名空间、用户名和控制器终结点,设置用户配置文件中的活动上下文。

azdata context set --namespace contextNamespace --username johndoe --endpoint https://<ip or domain name>:30080     

必需的参数

--namespace -ns

要设置的上下文的命名空间。

可选参数

--endpoint -e

群集控制器终结点“https://host:port"”。

--username -u

帐户用户。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--output -o

输出格式。 允许的值:json、jsonc、table、tsv。 默认值:json。

--query -q

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

后续步骤

有关其他 azdata 命令的详细信息,请参阅 azdata 参考

有关如何安装 azdata 工具的详细信息,请参阅安装 azdata