导入数据资产（预览）

项目
08/17/2023

适用范围：Azure CLI ml 扩展 v2（当前版本）Python SDK azure-ai-ml v2（当前版本）

本文介绍如何将数据从外部源导入 Azure 机器学习平台。如果导入成功，则会自动使用导入期间提供的名称创建并注册 Azure 机器学习数据资产。 Azure 机器学习数据资产类似于 Web 浏览器书签（收藏夹）。无需记住指向最常用的数据的长存储路径 (URI)。相反，你可以创建数据资产，然后使用友好名称访问该资产。

数据导入会创建源数据和元数据的缓存，以便在 Azure 机器学习训练作业中更快、更可靠地访问数据。数据缓存可避免网络和连接约束。对缓存的数据进行版本控制以支持可重现性。这为从 SQL Server 源导入的数据提供版本控制功能。此外，缓存的数据还提供数据世系来审核任务。数据导入在后台使用 ADF（Azure 数据工厂管道），这意味着用户可以避免与 ADF 进行复杂的交互。在后台，Azure 机器学习还会处理 ADF 计算资源池大小的管理、计算资源预配和清理，以便通过确定适当的并行化来优化数据传输。

传输的数据已分区，并作为 parquet 文件安全地存储在 Azure 存储中。这样做可在训练期间提高处理速度。 ADF 计算成本仅涉及用于数据传输的时间。存储成本仅涉及缓存数据所需的时间，因为缓存的数据是从外部源导入的数据副本。 Azure 存储托管该外部源。

缓存功能涉及前期计算和存储成本。但是，与在训练期间直接连接到外部源数据相比，它可自行付费，并且能够节省资金，因为它降低了经常性的训练计算成本。它将数据缓存为 parquet 文件，这使得作业训练更快、更可靠，从而防止大型数据集出现连接超时。这可以减少重新运行次数和训练失败次数。

可以从 Amazon S3、Azure SQL 和 Snowflake 导入数据。

重要

此功能目前处于公开预览状态。此预览版在提供时没有附带服务级别协议，我们不建议将其用于生产工作负荷。某些功能可能不受支持或者受限。

有关详细信息，请参阅适用于 Azure 预览版的补充使用条款。

先决条件

若要创建和使用数据资产，需要做好以下准备：

Azure 订阅。如果没有 Azure 订阅，请在开始前创建一个试用版订阅。尝试试用版订阅。
Azure 机器学习工作区。创建工作区资源。
已安装 Azure 机器学习 CLI/SDK。
已创建工作区连接

注意

要成功导入数据，请验证是否已安装适用于 SDK 的最新 azure-ai-ml 包（版本 1.5.0 或更高版本以及 ml 扩展（版本 2.15.1 或更高版本）。

如果有较旧的 SDK 包或 CLI 扩展，请删除旧包，并使用选项卡部分中显示的代码安装新包。按照如下所示的 SDK 和 CLI 说明进行操作：

代码版本

az extension remove -n ml
az extension add -n ml --yes
az extension show -n ml #(the version value needs to be 2.15.1 or later)

pip uninstall azure-ai-ml
pip show azure-ai-ml #(the version value needs to be 1.5.0 or later)

从外部数据库作为 mltable 数据资产导入

注意

外部数据库可以具有 Snowflake、Azure SQL 等格式。

以下代码示例可以从外部数据库导入数据。负责处理导入操作的 connection 将确定外部数据库数据源元数据。在此示例中，代码从 Snowflake 资源导入数据。连接指向 Snowflake 源。稍加修改，连接即可指向 Azure SQL 数据库源和 Azure SQL 数据库源。从外部数据库源导入的资产 type 为 mltable。

创建 YAML 文件 <file-name>.yml：

$schema: http://azureml/sdk-2-0/DataImport.json
# Supported connections include:
# Connection: azureml:<workspace_connection_name>
# Supported paths include:
# Datastore: azureml://datastores/<data_store_name>/paths/<my_path>/${{name}}


type: mltable
name: <name>
source:
  type: database
  query: <query>
  connection: <connection>
path: <path>

接下来，在 CLI 中运行以下命令：

> az ml data import -f <file-name>.yml


from azure.ai.ml.entities import DataImport
from azure.ai.ml.data_transfer import Database
from azure.ai.ml import MLClient

# Supported connections include:
# Connection: azureml:<workspace_connection_name>
# Supported paths include:
# path: azureml://datastores/<data_store_name>/paths/<my_path>/${{name}}

ml_client = MLClient.from_config()

data_import = DataImport(
    name="<name>",
    source=Database(connection="<connection>", query="<query>"),
    path="<path>"
    )
ml_client.data.import_data(data_import=data_import)

注意

此处的示例描述了 Snowflake 数据库的过程。但是，此过程涵盖其他外部数据库格式，如 Azure SQL 等。

导航到 Azure 机器学习工作室。
在左侧导航栏的“资产”下，选择“数据”。接下来，选择“数据导入”选项卡。然后选择“创建”，如下方的屏幕截图所示：
在“数据源”屏幕上，选择“Snowflake”，然后选择“下一步”，如下方的屏幕截图所示：
在“数据类型”屏幕上填写值。 “类型”值默认为“表(mltable)”。然后选择“下一步”，如下方的屏幕截图所示：
在“创建数据导入”屏幕上填写值，然后选择“下一步”，如下方的屏幕截图所示：
在“选择要输出的数据存储”屏幕上填写值，然后选择“下一步”，如下方的屏幕截图所示。默认选择“工作区托管数据存储”；选择托管数据存储时，系统会自动分配路径。如果选择“工作区托管数据存储”，将显示“自动删除设置”下拉列表。默认情况下会提供 30 天的数据删除时段，如何管理导入的数据资产说明了如何更改此值。

注意

若要选择自己的数据存储，请选择“其他数据存储”。在此情况下，必须选择数据缓存位置的路径。

可以添加计划。选择“添加计划”，如下方的屏幕截图所示：

此时会打开一个新面板，可在其中定义“定期”计划或“Cron”计划。下方的屏幕截图显示“定期”计划的面板：

名称：工作区中计划的唯一标识符。
说明：计划说明。
触发器：计划的定期模式，包括以下属性。
- 时区：触发时间是基于此时区计算的；默认情况下为 (UTC) 协调世界时。
- 重复或 Cron 表达式：选择“重复”以指定重复模式。在“定期”下，可以指定定期频率 - 按分钟、小时、天、周或月。
- 开始：计划在此日期首次变为活动状态。默认为此计划的创建日期。
- 结束：计划在此日期之后将变为非活动状态。默认情况下为“无”，表示计划将始终处于活动状态，直到你手动禁用它。
- 标记：所选计划标记。

注意

“开始日期”使用计划的时区指定开始日期和时间。如果省略开始日期，则开始时间等于计划创建时间。如果开始时间在过去，则第一个作业将在下一个计算的运行时间运行。

下一个屏幕截图显示此过程的最后一个屏幕。检查选择，然后选择“创建”。在此屏幕和此过程的其他屏幕上，选择“返回”可移动到之前的屏幕，以更改值选择。

下方的屏幕截图显示“Cron”计划的面板：

名称：工作区中计划的唯一标识符。
说明：计划说明。

触发器：计划的定期模式，包括以下属性。

时区：触发时间是基于此时区计算的；默认情况下为 (UTC) 协调世界时。
重复或 Cron 表达式：选择 cron 表达式以指定 cron 详细信息。

（必需）expression 使用标准 crontab 表达式来表示一个定期计划。单个表达式由 5 个空格分隔的字段组成：

MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK

单个通配符 (*) 涵盖字段的所有值。 *（以日为单位）表示一个月中的全部天数（因月份和年份而异）。
上例中的 expression: "15 16 * * 1" 表示每周一下午 16:15。

下表列出了每个字段的有效值：

字段	范围	注释
`MINUTES`	0-59	-
`HOURS`	0-23	-
`DAYS`	-	不支持。该值将被忽略并视为 `*`。
`MONTHS`	-	不支持。该值将被忽略并视为 `*`。
`DAYS-OF-WEEK`	0-6	零 (0) 表示星期日。也接受天的名称。

要详细了解 crontab 表达式，请参阅 GitHub 上的 Crontab 表达式 wiki。

重要

不支持 DAYS 和 MONTH。如果传递这些值其中之一，则会将其忽略并视为 *。

开始：计划在此日期首次变为活动状态。默认为此计划的创建日期。
结束：计划在此日期之后将变为非活动状态。默认情况下为“无”，表示计划将始终处于活动状态，直到你手动禁用它。
标记：所选计划标记。

注意

从外部文件系统将数据作为文件夹数据资产导入

注意

Amazon S3 数据资源可用作外部文件系统资源。

负责处理数据导入操作的 connection 将确定外部数据源的详细信息。连接将 Amazon S3 存储桶定义为目标。连接需要有效的 path 值。从外部文件系统源导入的资产值的 type 为 uri_folder。

下一个代码示例从 Amazon S3 资源导入数据。

创建 YAML 文件 <file-name>.yml：

$schema: http://azureml/sdk-2-0/DataImport.json
# Supported connections include:
# Connection: azureml:<workspace_connection_name>
# Supported paths include:
# path: azureml://datastores/<data_store_name>/paths/<my_path>/${{name}}


type: uri_folder
name: <name>
source:
  type: file_system
  path: <path_on_source>
  connection: <connection>
path: <path>

接下来，在 CLI 中执行以下命令：

> az ml data import -f <file-name>.yml


from azure.ai.ml.entities import DataImport
from azure.ai.ml.data_transfer import FileSystem
from azure.ai.ml import MLClient

# Supported connections include:
# Connection: azureml:<workspace_connection_name>
# Supported paths include:
# path: azureml://datastores/<data_store_name>/paths/<my_path>/${{name}}

ml_client = MLClient.from_config()

data_import = DataImport(
    name="<name>",
    source=FileSystem(connection="<connection>", path="<path_on_source>"),
    path="<path>"
    )
ml_client.data.import_data(data_import=data_import)

导航到 Azure 机器学习工作室。
在左侧导航栏的“资产”下，选择“数据”。接下来，选择“数据导入”选项卡。然后选择“创建”，如下方的屏幕截图所示：
在“数据源”屏幕上，选择“S3”，然后选择“下一步”，如下方的屏幕截图所示：
在“数据类型”屏幕上填写值。 “类型”值默认为“文件夹(uri_folder)”。然后选择“下一步”，如下方的屏幕截图所示：
在“创建数据导入”屏幕上填写值，然后选择“下一步”，如下方的屏幕截图所示：
在“选择要输出的数据存储”屏幕上填写值，然后选择“下一步”，如下方的屏幕截图所示。默认选择“工作区托管数据存储”；选择托管数据存储时，系统会自动分配路径。如果选择“工作区托管数据存储”，将显示“自动删除设置”下拉列表。默认情况下会提供 30 天的数据删除时段，如何管理导入的数据资产说明了如何更改此值。
可以添加计划。选择“添加计划”，如下方的屏幕截图所示：
此时会打开一个新面板，可在其中定义“定期”计划或“Cron”计划。下方的屏幕截图显示“定期”计划的面板：
- 名称：工作区中计划的唯一标识符。
- 说明：计划说明。
- 触发器：计划的定期模式，包括以下属性。
  - 时区：触发时间是基于此时区计算的；默认情况下为 (UTC) 协调世界时。
  - 重复或 Cron 表达式：选择“重复”以指定重复模式。在“定期”下，可以指定定期频率 - 按分钟、小时、天、周或月。
  - 开始：计划在此日期首次变为活动状态。默认为此计划的创建日期。
  - 结束：计划在此日期之后将变为非活动状态。默认情况下为“无”，表示计划将始终处于活动状态，直到你手动禁用它。
  - 标记：所选计划标记。
注意

“开始日期”使用计划的时区指定开始日期和时间。如果省略开始日期，则开始时间等于计划创建时间。如果开始时间在过去，则第一个作业将在下一个计算的运行时间运行。
如下一个屏幕截图所示，在此过程的最后一个屏幕中检查选择，然后选择“创建”。在此屏幕和此过程的其他屏幕上，如果要更改值选择，可选择“返回”移动到之前的屏幕。