Prepare-se para executar o coletor de Databricks

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 3 min. de leitura

    • Conclua as tarefas de configuração de autenticação e permissão antes de executar o coletor de metadados Databricks.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Gerar credenciais de Databricks.

      Para obter instruções detalhadas, consulte Gerar credenciais.

    2. Configure permissões.

      Para obter instruções detalhadas, consulte Configuração de permissões.

    Gerar credenciais

    Gere um token de acesso pessoal ou segredo principal de serviço para autenticar a conexão do Databricks.

    Antes de Iniciar

    Função necessária: Administrador da conta

    Importante:
    Você deve ser um administrador de conta no Databricks para criar e gerenciar principais de serviço.

    Por Que e Quando Desempenhar Esta Tarefa

    Configure essas credenciais para habilitar a autenticação para o coletor de Databricks. Você pode usar um Token de acesso pessoal (PAT) ou uma entidade de serviço OAuth.

    Procedimento

    Gere as credenciais necessárias com base no seu método de autenticação.

    • Para gerar um Token de acesso pessoal (PAT):

      1. No espaço Databricks, selecione seu nome de usuário na barra superior e selecione Configurações .
      2. Selecione Desenvolvedor .
      3. Ao lado de Tokens de acesso , selecione Gerenciar .
      4. Selecione Gerar novo token .
      5. Insira um comentário para identificar o token.
      6. Mude o. Vida útil (dias) se necessário.
        Nota:
        Para criar um token com duração máxima de 730 dias, deixe o campo Duração vazio.
      7. Selecione Gerar.
      8. Copie o token exibido e selecione Concluído . Salve este token com segurança para uso futuro.
      9. Como alternativa, use API de token Para gerar um PAT.

    • Para gerar um segredo principal de serviço:

      1. No espaço Databricks, selecione seu nome de usuário na barra superior e selecione Configurações .
      2. Navegue até Identidade e acesso .
      3. Ao lado de Principais de serviço , selecione Gerenciar .
      4. Selecione Adicione entidade de serviço .
      5. Selecione Adicionar novo , forneça um nome para a entidade de serviço e selecione Adicionar .
      6. Selecione a entidade de serviço recém-criada e navegue até Segredos .
      7. Selecione Gerar segredo .
      8. Insira o tempo de vida do segredo e selecione Gerar .
      9. Copie o. ID do cliente e. Segredo do cliente na caixa de diálogo.

    Configuração de permissões

    Conceda as permissões necessárias para o Catálogo do Unity, trabalhos e tabelas do sistema.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    No Catálogo do Unity, os dados são seguros por padrão. Conceda permissões ao usuário que está executando o coletor para colher recursos. Os objetos protegíveis no Catálogo do Unity são hierárquicos e os privilégios são herdados para baixo.

    Procedimento

    1. Conceda permissões do Catálogo do Unity.
      O usuário requer USAR CATÁLOGO , USAR ESQUEMA e. SELECIONE permissões no catálogo para acessar dados.
      Nota:
      Um usuário com USAR CATÁLOGO e. PROCURAR as permissões podem acessar dados, mas não podem recuperar estatísticas de coluna, funções do sistema ou determinados metadados de tabela adicionais. Consulte Documentação de Databricks para obter detalhes sobre essas permissões.
      1. Selecione o catálogo ao qual você deseja conceder acesso.
      2. Selecione Permissões e selecione Concessão .
      3. Selecione o usuário e as permissões apropriadas e, em seguida, selecione Concessão .
    2. Conceda permissões de recurso de computação.
      O usuário deve ter Pode usar No cluster existente ou depósito SQL ou pode criar seus próprios recursos de computação.
      1. Selecione Mais opções no recurso e selecione Permissões .
      2. Adicione o usuário e selecione Pode usar permissão.
    3. Conceda permissões para trabalhos.
      Para colher trabalhos, o usuário que executa o coletor deve ter Pode exibir Permissões nos trabalhos de destino. Para obter detalhes sobre como definir permissões de trabalho, consulte Documentação de Databricks .
    4. Habilite a colheita de linhagem das tabelas do sistema.
      Trabalhe com o administrador do Databricks para habilitar o. acesso.sistema esquema.
      1. Faça uma solicitação PUT à API para habilitar o esquema. 
        curl -X PUT -H "Authorization: Bearer <PAT_Token>" https://<databricks-host>/api/2.1/unity-catalog/metastores/<metastore_id>/systemschemas/access

        Para encontrar o. metastore_id , navegue até Catálogo > Configurações E exibir a seção Informações do Metastore.

      2. Conceda as seguintes permissões ao usuário que está executando o coletor.
        • USAR ESQUEMA ativado acesso.sistema
        • SELECIONE ativado access.table_lineage
        • SELECIONE ativado access.column_lineage

        Comandos SQL de exemplo:

        GRANT USE SCHEMA ON SCHEMA system.access to `<userid>`;
           GRANT SELECT on TABLE system.access.table_lineage to `<userid>`;
           GRANT SELECT on TABLE system.access.column_lineage to `<userid>`;