Compartir a través de

Azure 机器学习 SDK 和 CLI (v1)

APPLIES TO:Azure CLI ml extension v1Python SDK azureml v1

Important

本文中的一些 Azure CLI 命令使用适用于 Azure 机器学习的 azure-cli-ml 或 v1 扩展。 对 v1 扩展的支持将于 2025 年 9 月 30 日结束。 在该日期之前，你能够安装和使用 v1 扩展。

建议在 2025 年 9 月 30 日之前转换为 ml 或 v2 扩展。 有关 v2 扩展的详细信息，请参阅 Azure 机器学习 CLI 扩展和 Python SDK v2。

Important

本文提供有关使用 Azure 机器学习 SDK v1 的信息。 SDK v1 自 2025 年 3 月 31 日起弃用。 对它的支持将于 2026 年 6 月 30 日结束。 可以在该日期之前安装和使用 SDK v1。

建议在 2026 年 6 月 30 日之前过渡到 SDK v2。 有关 SDK v2 的详细信息，请参阅 什么是 Azure 机器学习 CLI 和 Python SDK v2？ 以及 SDK v2 参考。

本部分中的所有文章都记录了第一版 Azure 机器学习 Python SDK (v1) 或 Azure CLI ml 扩展 (v1) 的使用情况。 有关当前 SDK 和 CLI 的信息，请参阅 Azure 机器学习 SDK 和 CLI v2。

SDK v1

本部分文章中的 Azure SDK 示例需要 azureml-core 或用于 Azure 机器学习的 Python SDK v1。 Python SDK v2 现已发布。

v1 和 v2 Python SDK 包不兼容，v2 编码样式不适用于此目录下的文章。 但是，机器学习工作区和所有基础资源均可彼此交互，这意味着一个用户可以使用 SDK v1 创建工作区，而另一个用户可以使用 SDK v2 将作业提交到相同的工作区。

建议不要在同一环境中安装这两个版本的 SDK，因为这可能会导致代码冲突和混淆。

如何知道现有的是哪个 SDK 版本？

  • 若要确定是否有 Azure 机器学习 Python SDK v1，请运行 pip show azureml-core。 （或在 Jupyter Notebook 中使用 %pip show azureml-core）
  • 若要确定是否有 Azure 机器学习 Python SDK v2，请运行 pip show azure-ai-ml。 （或在 Jupyter Notebook 中使用 %pip show azure-ai-ml）

根据 pip show 的结果，可确定你拥有的 SDK 版本。

CLI v1

The Azure CLI commands in articles in this section require the azure-cli-ml, or v1, extension for Azure Machine Learning. 使用 ml 扩展的增强型 v2 CLI 现已可用并推荐使用。

这些扩展不兼容，因此 v2 CLI 命令不适用于此目录下的文章。 但是，机器学习工作区和所有基础资源均可彼此交互，这意味着一个用户可以使用 v1 CLI 创建工作区，而另一个用户可以使用 v2 CLI 将作业提交到相同的工作区。

如何知道现有的是哪种 CLI 扩展？

若要查看已安装了哪些扩展，请使用 az extension list。

  • If the list of Extensions contains azure-cli-ml, you have the v1 extension.
  • 如果该列表包含 ml，则你拥有 v2 扩展。

Next steps

有关安装和使用不同扩展的详细信息，请参阅以下文章：

若要详细了解如何安装和使用不同 SDK 版本，请参阅以下内容：