适用范围：
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 arc | 用于将 Azure Arc 用于 Azure 数据服务的命令。 |
| azdata sql | SQL DB CLI 允许用户通过 T-SQL 与 SQL Server 交互。 |
| azdata login | 登录到群集的控制器终结点，并将其命名空间设置为活动上下文。 若要在登录时使用密码，必须设置AZDATA_PASSWORD环境变量。 |
| azdata logout | 注销群集。 |
| azdata context | 上下文管理命令。 |
| azdata bdc | 选择、管理和操作 SQL Server 大数据群集。 |
| azdata extension | 管理和更新 CLI 扩展。 |
| azdata app | 创建、删除、运行和管理应用程序。 |
| azdata postgres | Postgres 查询运行程序和交互式 shell。 |
| azdata notebook | 用于从终端查看、运行和管理笔记本的命令。 |
azdata login
部署群集后，它会在部署期间列出控制器终结点，该终结点应该用于登录。 如果不知道控制器终结点，可以通过在用户主页>/.kube/config 的默认位置在系统上配置群集的 <kube 配置登录，或使用 KUBECONFIG env var，即导出 KUBECONFIG=path/to/.kube/config。登录时，此群集的命名空间将设置为活动上下文。
azdata login [--auth]
[--endpoint -e]
[--accept-eula -a]
[--namespace -ns]
[--username -u]
[--principal -p]
示例
使用基本身份验证登录。
azdata login --auth basic --username johndoe --endpoint https://<ip or domain name>:30080
使用 Active Directory 登录。
azdata login --auth ad --endpoint https://<ip or domain name>:30080
使用具有显式主体的 Active Directory 登录。
azdata login --auth ad --principal johndoe@COSTOSO.COM --endpoint https://<ip or domain name>:30080
以交互方式登录。 如果未指定为参数，将始终提示群集名称。 如果系统上设置了AZDATA_USERNAME、AZDATA_PASSWORD和ACCEPT_EULA env 变量，则不会提示这些变量。 如果系统上具有 kube 配置，或者正在使用 KUBECONFIG env var 指定配置的路径，则交互式体验将首先尝试使用配置，然后在配置失败时提示你。
azdata login
登录（非交互方式）。 使用群集名称、控制器用户名、控制器终结点和 EULA 验收集作为参数登录。 必须设置环境变量AZDATA_PASSWORD。 如果不想指定控制器终结点，请在用户 home>/.kube/config 的默认位置<拥有计算机上的 kube 配置，或使用 KUBECONFIG env var，即导出 KUBECONFIG=path/to/.kube/config。
azdata login --namespace ClusterName --username johndoe@contoso.com --endpoint https://<ip or domain name>:30080 --accept-eula yes
在计算机上使用 kube 配置登录，并为 AZDATA_USERNAME、AZDATA_PASSWORD 和 ACCEPT_EULA 设置 env var。
azdata login -n ClusterName
可选参数
--auth
身份验证策略。 基本身份验证或 Active Directory 身份验证。 默认值为“基本”身份验证。
--endpoint -e
群集控制器终结点“https://host:port"。 如果不想使用此参数，则可以在计算机上使用 kube 配置。 请确保配置位于用户主页>/.kube/config 的默认位置<，或使用 KUBECONFIG env var。
--accept-eula -a
是否接受许可条款？ [是/否]。 如果不想使用此参数，可以将环境变量ACCEPT_EULA设置为“yes”。 可在以下位置 https://aka.ms/eula-azdata-en查看该产品的许可条款。
--namespace -ns
群集控制平面的命名空间。
--username -u
帐户用户。 如果不想使用此参数，则可以AZDATA_USERNAME设置环境变量。
--principal -p
Kerberos 领域。 在大多数情况下，Kerberos 领域是域名，以大写字母表示。
全局参数
--debug
提高日志记录详细程度以显示所有调试日志。
--help -h
显示此帮助消息并退出。
--output -o
输出格式。 允许的值：json、jsonc、table、tsv。 默认值：json。
--query -q
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
--verbose
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
azdata logout
注销群集。
azdata logout
示例
注销此用户。
azdata logout
全局参数
--debug
提高日志记录详细程度以显示所有调试日志。
--help -h
显示此帮助消息并退出。
--output -o
输出格式。 允许的值：json、jsonc、table、tsv。 默认值：json。
--query -q
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
--verbose
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
后续步骤
有关其他 azdata 命令的详细信息，请参阅 azdata 参考。
有关如何安装 azdata 工具的详细信息，请参阅安装 azdata。