Atualizar o gerenciamento do workspace para o SDK v2

O workspace permanece inalterado funcionalmente com a plataforma de desenvolvimento V2. No entanto, há alterações relacionadas à rede sobre as quais você deve estar ciente. Para obter detalhes, confira Alteração de isolamento de rede com nossa nova plataforma de API no Azure Resource Manager

Este artigo fornece uma comparação de cenários no SDK v1 e no SDK v2.

Criar um workspace

• SDK v1

  from azureml.core import Workspace
  
  ws = Workspace.create(
      name='my_workspace',
      location='eastus',
      subscription_id = '<SUBSCRIPTION_ID>'
      resource_group = '<RESOURCE_GROUP>'
  )
  

• SDK v2

  from azure.ai.ml import MLClient
  from azure.ai.ml.entities import Workspace
  from azure.identity import DefaultAzureCredential
  
  # specify the details of your subscription
  subscription_id = "<SUBSCRIPTION_ID>"
  resource_group = "<RESOURCE_GROUP>"
  
  # get a handle to the subscription
  ml_client = MLClient(DefaultAzureCredential(), subscription_id, resource_group)
  
  # specify the workspace details
  ws = Workspace(
      name="my_workspace",
      location="eastus",
      display_name="My workspace",
      description="This example shows how to create a workspace",
      tags=dict(purpose="demo"),
  )
  
  ml_client.workspaces.begin_create(ws)
  

Criar um workspace para uso com pontos de extremidade de Link Privado do Azure

• SDK v1

  from azureml.core import Workspace
  
  ws = Workspace.create(
      name='my_workspace',
      location='eastus',
      subscription_id = '<SUBSCRIPTION_ID>'
      resource_group = '<RESOURCE_GROUP>'
  )
  
  ple = PrivateEndPointConfig(
      name='my_private_link_endpoint',
      vnet_name='<VNET_NAME>',
      vnet_subnet_name='<VNET_SUBNET_NAME>',
      vnet_subscription_id='<SUBSCRIPTION_ID>', 
      vnet_resource_group='<RESOURCE_GROUP>'
  )
  
  ws.add_private_endpoint(ple, private_endpoint_auto_approval=True)
  

• SDK v2

  from azure.ai.ml import MLClient
  from azure.ai.ml.entities import Workspace
  from azure.identity import DefaultAzureCredential
  
  # specify the details of your subscription
  subscription_id = "<SUBSCRIPTION_ID>"
  resource_group = "<RESOURCE_GROUP>"
  
  # get a handle to the subscription
  ml_client = MLClient(DefaultAzureCredential(), subscription_id, resource_group)
  
  ws = Workspace(
      name="private_link_endpoint_workspace,
      location="eastus",
      display_name="Private Link endpoint workspace",
      description="When using private link, you must set the image_build_compute property to a cluster name to use for Docker image environment building. You can also specify whether the workspace should be accessible over the internet.",
      image_build_compute="cpu-compute",
      public_network_access="Disabled",
      tags=dict(purpose="demonstration"),
  )
  
  ml_client.workspaces.begin_create(ws)
  

Carregar/conectar ao workspace usando os parâmetros

• SDK v1

  from azureml.core import Workspace
  ws = Workspace.from_config()
  
  # specify the details of your subscription
  subscription_id = "<SUBSCRIPTION_ID>"
  resource_group = "<RESOURCE_GROUP>"
  
  # get handle on the workspace
  ws = Workspace.get(
      subscription_id='<SUBSCRIPTION_ID>',
      resource_group='<RESOURCE_GROUP>',
      name='my_workspace',
  )
  

• SDK v2

  from azure.ai.ml import MLClient
  from azure.ai.ml.entities import Workspace
  from azure.identity import DefaultAzureCredential
  
  # specify the details of your subscription
  subscription_id = "<SUBSCRIPTION_ID>"
  resource_group = "<RESOURCE_GROUP>"
  
  # get handle on the workspace
  ws = MLClient(
      DefaultAzureCredential(),
      subscription_id='<SUBSCRIPTION_ID>',
      resource_group_name='<RESOURCE_GROUP>',
      workspace_name='my_workspace'
  )
  

Carregar/conectar ao workspace usando o arquivo de configuração

• SDK v1

  from azureml.core import Workspace
  
  ws = Workspace.from_config()
  ws.get_details()
  

• SDK v2

  from azure.ai.ml import MLClient
  from azure.ai.ml.entities import Workspace
  from azure.identity import DefaultAzureCredential
  
  ws = MLClient.from_config(
      DefaultAzureCredential()
  )
  

Mapeamento da funcionalidade de chave no SDK v1 e no SDK v2

Funcionalidade no SDK v1	Mapeamento aproximado no SDK v2
Método/API no SDK v1 (use links para documentos de referência)	Método/API no SDK v2 (use links para documentos de referência)

Documentos relacionados

Para obter mais informações, consulte:

• O que é um workspace?