适用范围：
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 notebook 视图 | 查看笔记本。 用于在首次单元格执行错误时停止的选项。 |
| azdata notebook run | 运行笔记本。 执行在第一个错误时停止。 |
azdata notebook 视图
此命令可以获取笔记本文件，并将 markdown、代码和输出转换为颜色终端格式。
azdata notebook view --path -p
[--continue-on-error -c]
示例
查看笔记本。 这会显示所有单元格。
azdata notebook view --path "/home/me/notebooks/demo_notebook.ipynb"
查看笔记本。 这会显示所有单元格，除非遇到输出中出错的单元格。 在这种情况下，输出将停止。
azdata notebook view --path "/home/me/notebooks/demo_notebook.ipynb" --stop-on-error
必需参数
--path -p
要查看的笔记本的路径。
可选参数
--continue-on-error -c
继续显示其他单元格，忽略笔记本输出中找到的任何单元格错误。 默认行为是出错时停止。 停止会使看到遇到错误的第一个单元格更容易。
全局参数
--debug
提高日志记录详细程度以显示所有调试日志。
--help -h
显示此帮助消息并退出。
--output -o
输出格式。 允许的值：json、jsonc、table、tsv。 默认值：json。
--query -q
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
--verbose
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
azdata notebook run
此命令将创建一个临时目录，并将其中给定的笔记本作为工作目录执行。
azdata notebook run --path -p
[--output-path]
[--output-html]
[--arguments -a]
[--interactive -i]
[--clear -c]
[--timeout -t]
[--env -e]
示例
运行笔记本。
azdata notebook run --path "/home/me/notebooks/demo_notebook.ipynb"
必需参数
--path -p
要运行的笔记本的文件路径。
可选参数
--output-path
用于笔记本输出的目录路径。 具有输出数据的笔记本和任何笔记本生成的文件都是相对于此目录生成的。
--output-html
可选标志，指示是否将输出笔记本转换为 HTML 格式。 创建第二个输出文件。
--arguments -a
用于注入笔记本执行的笔记本参数的可选列表。 编码为 JSON 字典。 示例：'{“name”：“value”， “name2”：“value2”}'
--interactive -i
在交互模式下运行笔记本。
--clear -c
在交互模式下，在呈现单元格之前清除控制台。
--timeout -t
等待执行完成的秒数。 值 -1 指示永远等待。
600
--env -e
环境的名称。
base
全局参数
--debug
提高日志记录详细程度以显示所有调试日志。
--help -h
显示此帮助消息并退出。
--output -o
输出格式。 允许的值：json、jsonc、table、tsv。 默认值：json。
--query -q
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
--verbose
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
后续步骤
有关其他 azdata 命令的详细信息，请参阅 azdata 参考。
有关如何安装 azdata 工具的详细信息，请参阅安装 azdata。