适用范围：
Azure Data CLI (azdata)
注释
以前由 Azure 数据 CLI （azdata） 处理的一些方案现在通过 Azure CLI （az） 扩展 和 基于 Azure Arc 的工作流进行管理。 所有命令均没有单个 1：1 的替换 azdata 项。 下表突出显示了常见相关的 Azure CLI 替代项，其中存在它们。
| azdata 命令区域 | Azure CLI 扩展/命令组 | Azure CLI 参考 |
|---|---|---|
azdata arc dc * |
az arcdata |
Azure Arc 数据 CLI 参考 |
azdata arc sql mi * |
az arcdata sql mi |
使用 CLI 管理 Azure SQL 托管实例 |
azdata arc postgres * |
az arcdata postgres |
使用 CLI 管理 PostgreSQL 服务器 |
azdata migrate * |
az datamigration |
使用 CLI 迁移 |
azdata extension * |
az extension * |
Azure CLI 扩展概述 |
azdata login |
az login |
az login |
azdata sql shell / azdata sql query |
没有 Azure CLI 等效项（使用 sqlcmd、SSMS 或其他 SQL 工具） |
sqlcmd 实用工具 SQL Server Management Studio |
对于新的自动化和管理方案，首选 Azure CLI（az）、 Azure CLI 扩展和 Azure Arc 门户体验。
以下文章提供了 azdata 工具中 sql 命令的参考。 有关其他 azdata 命令的详细信息，请参阅 azdata 参考
指令
| 命令 | 说明 |
|---|---|
| azdata context list | 列出用户配置文件中的可用上下文。 |
| azdata context delete | 从用户配置文件中删除具有给定命名空间的上下文。 |
| azdata context set | 将具有给定命名空间的上下文设置为用户配置文件中的活动上下文。 |
azdata context list
可以设置或删除其中任何一项， azdata context set 或者 azdata 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。