Compartilhar via

Implantar um workspace com o PowerShell

  • Artigo

Este artigo explica como criar um workspace do Azure Databricks usando o Powershell.

Se você optar por usar o PowerShell localmente, este artigo exigirá que você instale o módulo Az PowerShell e conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount. Para obter mais informações sobre como instalar o módulo Az PowerShell, confira Instalar o Azure PowerShell.

Para se conectar à sua conta do Azure como usuário, consulte Iniciar sessão do PowerShell com uma conta de usuário do Azure Databricks. Para se conectar à sua conta do Azure como uma entidade de serviço, consulte logon do PowerShell com uma entidade de serviço do Microsoft Entra ID.

Observação

Se você quiser criar um workspace do Azure Databricks na Nuvem Comercial do Azure que contém certificações de conformidade do governo dos EUA, como FedRAMP High, entre em contato com sua equipe de conta da Microsoft ou do Azure Databricks para obter acesso a essa experiência.

Se esta for a primeira vez que você usa o Azure Databricks, deverá registrar o provedor de recursos Microsoft.Databricks.

  Register-AzResourceProvider -ProviderNamespace Microsoft.Databricks

Usar o Azure Cloud Shell

O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo sem precisar instalar nada no seu ambiente local.

Para iniciar o Azure Cloud Shell:

  • Selecione Experimente no canto superior direito de um bloco de código. Selecionar Experimentar não copia automaticamente o código para o Cloud Shell.
  • Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador.
  • Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure.

Para executar o código neste artigo no Azure Cloud Shell:

  • Inicie o Cloud Shell.
  • Clique no botão Copiar no bloco de código para copiá-lo.
  • Cole o código na sessão do Cloud Shell ao pressionar Ctrl+Shift+V no Windows e no Linux ou Cmd+Shift+V no macOS.
  • Pressione Enter para executar o código.

Se tiver várias assinaturas do Azure, escolha a que for adequada para cobrança do recurso. Selecione uma ID de assinatura específica usando o cmdlet Set-AzContext.

Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000

Criar um grupo de recursos

Crie um grupo de recursos do Azure usando o cmdlet New-AzResourceGroup. Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados como um grupo.

O exemplo a seguir cria um grupo de recursos chamado myresourcegroup na região Oeste dos EUA 2.

New-AzResourceGroup -Name myresourcegroup -Location westus2

Crie um workspace do Azure Databricks

Nesta seção, você criará um workspace do Azure Databricks usando o PowerShell.

New-AzDatabricksWorkspace -Name mydatabricksws -ResourceGroupName myresourcegroup -Location westus2 -ManagedResourceGroupName databricks-group -Sku standard

Forneça os seguintes valores:

Propriedade Descrição
Nome Forneça um nome para seu workspace do Databricks
ResourceGroupName Especificar um nome do grupo de recursos existente
Location Selecione Oeste dos EUA 2. Para outras regiões disponíveis, confira serviços do Azure disponíveis por região
ManagedResourceGroupName Especifique se deseja criar um grupo de recursos gerenciados ou usar um existente.
Sku Escolha entre o cluster Standard, Premium ou Avaliação. Para saber mais sobre essas camadas, confira Preço do Databricks

A criação do workspace leva alguns minutos. Quando esse processo for concluído, sua conta de usuário será adicionada automaticamente como um usuário administrador no workspace.

Observação

Quando a implantação de um workspace falha, ele ainda é criado com estado de falha. Exclua o workspace com falha e crie um que resolva os erros de implantação. Quando você exclui o workspace com falha, o grupo de recursos gerenciado e todos os recursos implantados com êxito também são excluídos.

Determinar o estado de provisionamento de um workspace do Databricks

Para determinar se um workspace do Databricks foi provisionado com êxito, você pode usar o cmdlet Get-AzDatabricksWorkspace.

Get-AzDatabricksWorkspace -Name mydatabricksws -ResourceGroupName myresourcegroup |
  Select-Object -Property Name, SkuName, Location, ProvisioningState

Name            SkuName   Location  ProvisioningState
----            -------   --------  -----------------
mydatabricksws  standard  westus2   Succeeded