Automatizar a instalação do Catálogo do Unity usando o Terraform

Você pode automatizar a configuração do Catálogo do Unity usando o Provedor Databricks Terraform. Este artigo fornece links para o guia de implantação do Catálogo do Unity do provedor Terraform e a documentação de referência de recursos, juntamente com os requisitos ("Antes de começar") e dicas de validação e implantação.

Antes de começar

Para automatizar a configuração do Catálogo do Unity usando o Terraform, você deve ter o seguinte:

• Sua conta de Azure Databricks deve estar no plano Premium.
• Em seu locatário Azure, você deve ter permissão para criar:
  • Uma conta de armazenamento a ser usada com Azure Data Lake Storage. Consulte Criar uma conta de armazenamento para usar com Azure Data Lake Storage.
  • Um novo recurso para manter uma identidade gerenciada atribuída pelo sistema. Isso exige que você seja um Contributor ou um Owner de um grupo de recursos em qualquer assinatura no locatário.

Para usar o provedor Terraform do Databricks para configurar um metastore para o Catálogo do Unity, armazenamento para o metastore, qualquer armazenamento externo e todas as credenciais de acesso relacionadas, você deve ter o seguinte:

• Uma conta Azure.
• Um usuário administrador no nível da conta em sua conta do Azure.
• No computador de desenvolvimento local, você deve ter:

  • A CLI do Terraform. Veja Baixar o Terraform no site do Terraform.

  • O CLI do Azure se conectou por meio do comando az login com um usuário que possui Contributor ou Owner direitos em sua assinatura. Consulte Como instalar o CLI do Azure. Para fazer login com uma conta de usuário ou entidade de serviço, consulte Fazer login com o CLI do Azure.

    Observação

    Quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, é uma prática recomendada de segurança se autenticar através do comando az login com um principal de serviço do Microsoft Entra ID. Consulte Entrar com um principal de serviço e Autenticação com Principal de Serviço do Azure.

Para usar o provedor Terraform do Databricks para configurar todos os outros componentes de infraestrutura do Catálogo do Unity, você deve ter o seguinte:

• Um workspace do Azure Databricks.
• No computador de desenvolvimento local, você deve ter:
  • A CLI do Terraform. Veja Baixar o Terraform no site do Terraform.
  • Um dos seguintes:

    • A CLI do Databricks versão 0.205 ou superior, configurada com seu token de acesso Azure Databricks personal executando databricks configure --host <workspace-url> --profile <some-unique-profile-name>. Consulte Instalar ou atualizar a CLI do Databricks e autenticação com token de acesso pessoal (legado).

      Observação

      Como uma melhor prática de segurança, quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, o Databricks recomenda que você use tokens de acesso pertencentes às entidades de serviço em vez de aos usuários do workspace. Para criar tokens para entidades de serviço, consulte Gerenciar tokens para uma entidade de serviço.

    • O CLI do Azure, conectado por meio do comando az login. Consulte Como instalar o CLI do Azure. Para fazer login com uma conta de usuário ou um principal de serviço, consulte Entrar com o CLI do Azure.

      Observação

      Quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, é uma prática de segurança recomendada fazer login por meio do comando az login com um principal de serviço do Microsoft Entra ID. Consulte Entrar com um principal de serviço e Autenticando com Principal de Serviço do Azure.

    • As duas variáveis de ambiente Azure Databricks a seguir:

      • DATABRICKS_HOST, definida como o valor da URL da instância do workspace, por exemplo https://dbc-1234567890123456.cloud.databricks.com
      • , definido como o valor do token de acesso pessoal do Azure Databricks ou do token Microsoft Entra ID (anteriormente Azure Active Directory). Consulte também Monitorar e revogar tokens de acesso pessoal.

      Para definir essas variáveis de ambiente, consulte a documentação do sistema operacional.

      Observação

      Como uma melhor prática de segurança, quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, o Databricks recomenda que você use tokens de acesso pertencentes às entidades de serviço em vez de aos usuários do workspace. Para criar tokens para entidades de serviço, consulte Gerenciar tokens para uma entidade de serviço.

Guia de implantação do Catálogo do Unity do provedor Terraform e documentação de referência dos recursos

Para saber como implantar todos os pré-requisitos e habilitar o Catálogo do Unity para um workspace, consulte Implantando recursos de pré-requisito e habilitando o Catálogo do Unity na documentação do provedor do Databricks Terraform.

Se você já tiver alguns componentes de infraestrutura do Catálogo do Unity em vigor, poderá usar o Terraform para implantar componentes adicionais de infraestrutura do Catálogo do Unity conforme necessário. Veja cada seção do guia referenciado no parágrafo anterior e na seção do Catálogo do Unity da documentação do provedor Databricks Terraform.

Validar, planejar, implantar ou destruir os recursos

• Para validar a sintaxe das configurações do Terraform sem implantá-las, execute o comando terraform validate.
• Para mostrar as ações que o Terraform executaria para implantar as configurações, execute o comando terraform plan. Esse comando realmente não implanta as configurações.
• Para implantar as configurações, execute o comando terraform deploy.
• Para excluir os recursos implantados, execute o comando terraform destroy.