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 do Azure Databricks precisa estar no plano Premium.
• No locatário do Azure, você deve ter permissão para criar:
  • Uma conta de armazenamento a ser usada com o Azure Data Lake Storage. Confira Criar uma conta de armazenamento para uso com o 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 do Azure.

• Um usuário administrador de nível de conta na sua conta do Azure.

• No seu computador de desenvolvimento local, você precisa ter:

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

  • A CLI do Azure, conectada por meio do comando az login com um usuário que tenha direitos de Contributor ou Owner na sua assinatura. Consulte Como instalar a CLI do Azure. Para entrar com uma conta de usuário ou uma entidade de serviço, consulte Entrar com a CLI do Azure.

    Observação

    Quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, é uma prática recomendada de segurança entrar pelo comando az login com uma entidade de serviço do Microsoft Entra ID. Veja Conectar-se com uma entidade de serviço e Autenticar-se com uma entidade 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 seu computador de desenvolvimento local, você precisa ter:

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

  • Um dos seguintes:

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

      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.

    • A CLI do Azure, conectada por meio do comando az login. Consulte Como instalar a CLI do Azure. Para entrar com uma conta de usuário ou uma entidade de serviço, consulte Entrar com a CLI do Azure.

      Observação

      Quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, é uma prática recomendada de segurança entrar pelo comando az login com uma entidade de serviço do Microsoft Entra ID. Veja Conectar-se com uma entidade de serviço e Autenticar-se com uma entidade de serviço do Azure.

    • As duas variáveis de ambiente do 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
      • DATABRICKS_TOKEN, definido com o valor do token de acesso pessoal do Azure Databricks ou do token do Microsoft Entra ID (antigo 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.