共用方式為

建立連線 (預覽)

  • 發行項

適用於：Azure CLI ml 延伸模組 v2 (目前)Python SDK azure-ai-ml v2 (目前)

在本文中，了解如何連線至位於 Azure 外部的資料來源，以便資料供 Azure Machine Learning 服務使用。 Azure 連線可作為金鑰保存庫 Proxy，而與連線的互動是與 Azure 金鑰保存庫的直接互動。 Azure Machine Learning 連線安全地將使用者名稱和密碼資料資源作為秘密儲存在金鑰保存庫中。 金鑰保存庫 RBAC 可控制對這些資料資源的存取。 針對此資料可用性，Azure 支援下列外部來源的連線：

  • Snowflake DB
  • Amazon S3
  • Azure SQL DB

重要

此功能目前處於公開預覽。 此預覽版本沒有服務等級協定，不建議用於處理生產工作負載。 可能不支援特定功能，或可能已經限制功能。

如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

必要條件

重要

Azure Machine Learning 連線將連線建立期間傳遞的認證安全地儲存在工作區 Azure Key Vault 中。 連線會參考金鑰保存庫儲存位置的認證，以供進一步使用。 將認證儲存在金鑰保管庫之後，您無須直接處理認證。 您可以選擇將認證儲存在 YAML 檔案中。 CLI 命令或 SDK 可以覆寫它們。 建議您避免將認證儲存在 YAML 檔案中，因為安全性缺口可能會導致認證洩漏。

注意

若要成功匯入資料，請確認您已安裝適用於 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)

建立 Snowflake DB 連線

此 YAML 檔案會建立 Snowflake DB 連線。 請務必更新適當的值：

# my_snowflakedb_connection.yaml
$schema: http://azureml/sdk-2-0/Connection.json
type: snowflake
name: my-sf-db-connection # add your datastore name here

target: jdbc:snowflake://<myaccount>.snowflakecomputing.com/?db=<mydb>&warehouse=<mywarehouse>&role=<myrole>
# add the Snowflake account, database, warehouse name and role name here. If no role name provided it will default to PUBLIC
credentials:
    type: username_password
    username: <username> # add the Snowflake database user name here or leave this blank and type in CLI command line
    password: <password> # add the Snowflake database password here or leave this blank and type in CLI command line

在 CLI 中建立 Azure Machine Learning 連線：

選項 1：使用 YAML 檔案中的使用者名稱和密碼

az ml connection create --file my_snowflakedb_connection.yaml

選項 2：覆寫命令列的使用者名稱和密碼

az ml connection create --file my_snowflakedb_connection.yaml --set credentials.
username="<username>" credentials.
password="<password>"

建立使用 OAuth 的 Snowflake DB 連線

本節中的資訊說明如何建立使用 OAuth 進行驗證的 Snowflake DB 連線。

重要

在遵循本節的步驟之前，您必須先設定 Azure 以代表用戶端發出 OAuth 權杖。 此組態會建立 OAuth 連線所需的服務主體。 您需要下列資訊才能建立連線：

  • 用戶端識別碼：服務主體的識別碼
  • 用戶端密碼：服務主體的密碼
  • 租用戶識別碼：Microsoft Entra ID 租用戶的識別碼

此 YAML 檔案會建立使用 OAuth 的 Snowflake DB 連線。 請務必更新適當的值：

# my_snowflakedb_connection.yaml
name: snowflake_service_principal_connection
type: snowflake
# Add the Snowflake account, database, warehouse name, and role name here. If no role name is provided, it will default to PUBLIC.
target: jdbc:snowflake://<myaccount>.snowflakecomputing.com/?db=<mydb>&warehouse=<mywarehouse>&scope=<scopeForServicePrincipal>
credentials:
  type: service_principal
  client_id: <client-id>          # The service principal's client id
  client_secret: <client-secret>  # The service principal's client secret
  tenant_id: <tenant-id>          # The Microsoft Entra ID tenant id

在 CLI 中建立 Azure Machine Learning 連線：

az ml connection create --file my_snowflakedb_connection.yaml

您也可以在命令列覆寫 YAML 檔案中的資訊：

az ml connection create --file my_snowflakedb_connection.yaml --set credentials.client_id="my-client-id" credentials.client_secret="my-client-secret" credentials.tenant_id="my-tenant-id"

建立 Azure SQL DB 連線

此 YAML 指令碼會建立 Azure SQL DB 連線。 請務必更新適當的值：

# my_sqldb_connection.yaml
$schema: http://azureml/sdk-2-0/Connection.json

type: azure_sql_db
name: my-sqldb-connection

target: Server=tcp:<myservername>,<port>;Database=<mydatabase>;Trusted_Connection=False;Encrypt=True;Connection Timeout=30
# add the sql servername, port addresss and database
credentials:
    type: sql_auth
    username: <username> # add the sql database user name here or leave this blank and type in CLI command line
    password: <password> # add the sql database password here or leave this blank and type in CLI command line

在 CLI 中建立 Azure Machine Learning 連線：

選項 1：使用 YAML 檔案中的使用者名稱/密碼

az ml connection create --file my_sqldb_connection.yaml

選項 2：覆寫 YAML 檔案中的使用者名稱和密碼

az ml connection create --file my_sqldb_connection.yaml --set credentials.
username="<username>" credentials.
password="<password>"

建立 Amazon S3 連線

使用下列 YAML 檔案建立 Amazon S3 連線。 請務必更新適當的值：

# my_s3_connection.yaml
$schema: http://azureml/sdk-2-0/Connection.json

type: s3
name: my_s3_connection

target: <mybucket> # add the s3 bucket details
credentials:
    type: access_key
    access_key_id: bbbbbbbb-1c1c-2d2d-3e3e-444444444444 # add access key id
    secret_access_key: H4iJ5kL6mN7oP8qR9sT0uV1wX2yZ3a # add access key secret

在 CLI 中建立 Azure Machine Learning 連線：

az ml connection create --file my_s3_connection.yaml

非資料連接

您可以使用這些連線類型來連線至 Git：

  • Python 摘要
  • Azure Container Registry
  • 使用 API 金鑰的連線

這些連線不是資料連線，而是用來連線到外部服務以用於程式碼。

Git

使用下列其中一個 YAML 檔案建立 Git 連線。 請務必更新適當的值：

  • 使用個人存取權杖 (PAT) 連接：

    #Connection.yml
name: test_ws_conn_git_pat
type: git
target: https://github.com/contoso/contosorepo
credentials:
    type: pat
    pat: dummy_pat

  • 連線到公用存放庫 (無認證)：

    #Connection.yml

name: git_no_cred_conn
type: git
target: https://https://github.com/contoso/contosorepo

在 CLI 中建立 Azure Machine Learning 連線：

az ml connection create --file connection.yaml

Python 摘要

使用下列其中一個 YAML 檔案建立 Python 摘要的連線。 請務必更新適當的值：

  • 使用個人存取權杖 (PAT) 連接：

    #Connection.yml
name: test_ws_conn_python_pat
type: python_feed
target: https://test-feed.com
credentials:
    type: pat
    pat: dummy_pat

  • 透過使用者名稱和密碼連線：

    name: test_ws_conn_python_user_pass
type: python_feed
target: https://test-feed.com
credentials:
    type: username_password
    username: <username>
    password: <password>

  • 連線到公用摘要 (無認證)：

    name: test_ws_conn_python_no_cred
type: python_feed
target: https://test-feed.com3

在 CLI 中建立 Azure Machine Learning 連線：

az ml connection create --file connection.yaml

Container Registry

使用下列其中一個 YAML 檔案建立 Azure Container Registry 的連線。 請務必更新適當的值：

  • 透過使用者名稱和密碼連線：

    name: test_ws_conn_cr_user_pass
type: container_registry
target: https://test-feed.com2
credentials:
    type: username_password
    username: <username>
    password: <password>

在 CLI 中建立 Azure Machine Learning 連線：

az ml connection create --file connection.yaml

API 金鑰

下列範例會建立 API 金鑰連線：

from azure.ai.ml.entities import WorkspaceConnection
from azure.ai.ml.entities import UsernamePasswordConfiguration, ApiKeyConfiguration


name = "my_api_key"

target = "https://L6mN7oP8q.core.windows.net/mycontainer"

wps_connection = WorkspaceConnection(
    name=name,
    type="apikey",
    target=target,
    credentials=ApiKeyConfiguration(key="9sT0uV1wX"),    
)
ml_client.connections.create_or_update(workspace_connection=wps_connection)

一般 Azure Container Registry

使用 GenericContainerRegistry 工作區連線，您可以指定映像組建的外部登錄，例如 Nexus 或 Artifactory。 環境映像會從指定的登錄推送，而先前的快取會被忽略。

使用下列 YAML 檔案建立連線。 請務必更新適當的值：

#myenv.yml
$schema: https://azuremlschemas.azureedge.net/latest/environment.schema.json 
name: docker-image-plus-conda-example 
image: mcr.microsoft.com/azureml/openmpi4.1.0-ubuntu20.04
type: python_feed
conda_file: conda_dep.yml
description: Environment created from a Docker image plus Conda environment

#conda_dep.yml
name: project_environment
dependencies:
  - python=3.10
  - pip:
    - azureml-defaults
channels:
  - anaconda
  - conda-forge

#connection.yml
name: ws_conn_generic_container_registry
type: container_registry
target: https://test-registry.com
credentials:
  type: username_password
  username: <username>
  password: <password>

#hello_world_job.yml
$schema: https://azuremlschemas.azureedge.net/latest/commandJob.schema.json
command: echo "hello world"
environment: azureml:<env name>@latest

使用您的認證從 YAML 檔案建立連線:

az ml connection create --file connection.yaml --credentials username=<username> password=<password> --resource-group my-resource-group --workspace-name my-workspace

建立環境

az ml environment create --name my-env --version 1 --file my_env.yml  --conda-file conda_dep.yml --image mcr.microsoft.com/azureml/openmpi4.1.0-ubuntu20.04 --resource-group my-resource-group --workspace-name my-workspace

您可以確認已成功建立環境

az ml environment show --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace

相關內容

如果您使用資料連線 (Snowflake DB、Amazon S3 或 Azure SQL DB)，這些文章提供詳細資訊：