Share via


Implantar um espaço de trabalho com o PowerShell

Este artigo explica como criar um espaço de trabalho 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 se conecte à sua conta do Azure usando o cmdlet Connect-AzAccount . Para obter mais informações sobre como instalar o módulo Az PowerShell, consulte Instalar o Azure PowerShell.

Para se conectar à sua conta do Azure como usuário, consulte Logon 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.

Nota

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

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

  Register-AzResourceProvider -ProviderNamespace Microsoft.Databricks

Utilizar o Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Pode utilizar os comandos pré-instalados do Cloud Shell para executar o código neste artigo sem ter de instalar nada no ambiente local.

Para iniciar o Azure Cloud Shell:

  • Selecione Experimentar no canto superior direito de um bloco de código. Selecionar Experimentar não copia automaticamente o código para o Cloud Shell.
  • Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser.
  • Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure.

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

  • Inicie o Cloud Shell.
  • Selecione o botão Copiar num bloco de código para copiar o código.
  • Cole o código na sessão do Cloud Shell ao selecionar Ctrl+Shift+V no Windows e Linux ou Cmd+Shift+V no macOS.
  • Selecione Introduzir para executar o código.

Se você tiver várias assinaturas do Azure, escolha a assinatura apropriada na qual os recursos devem ser cobrados. 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 contentor lógico no qual os recursos do Azure são implementados e geridos 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

Criar uma área de trabalho do Azure Databricks

Nesta seção, você cria um espaço de trabalho 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
Name Indique um nome para a sua área de trabalho do Databricks
ResourceGroupName Especificar um nome de grupo de recursos existente
Location Selecione E.U.A. Oeste 2. Para outras regiões disponíveis, consulte Serviços do Azure disponíveis por região
ManagedResourceGroupName Especifique se deseja criar um novo grupo de recursos gerenciados ou usar um existente.
Sku Escolha entre Standard, Premium ou Trial. Para obter mais informações sobre esses níveis, consulte Preços do Databricks

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

Nota

Quando uma implantação de espaço de trabalho falha, o espaço de trabalho ainda é criado em um estado de falha. Exclua o espaço de trabalho com falha e crie um novo espaço de trabalho que resolva os erros de implantação. Quando você exclui o espaço de trabalho com falha, o grupo de recursos gerenciados e todos os recursos implantados com êxito também são excluídos.

Determinar o estado de provisionamento de um espaço de trabalho Databricks

Para determinar se um espaço de trabalho Databricks foi provisionado com êxito, você pode usar o Get-AzDatabricksWorkspace cmdlet.

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