Conectar-se ao SQL Workbench/J

  • Artigo

Este artigo descreve como usar o SQL Workbench/J com o Azure Databricks.

Observação

Este artigo aborda o SQL Workbench/J, que não é fornecido nem tem suporte do Databricks. Para entrar em contato com o provedor, use o fórum de suporte do SQL Workbench/J nos Grupos do Google.

Requisitos

  • SQL Workbench/J.

  • O Driver JDBC do Databricks. Baixe o Driver JDBC do Databricks no computador de desenvolvimento local, extraindo o arquivo DatabricksJDBC42.jar do arquivo DatabricksJDBC42-<version>.zip baixado.

    Observação

    Este artigo foi testado com macOS, SQL Workbench/J Build 130, Zulu OpenJDK 21.0.1 e Databricks JDBC Driver 2.6.36.

    Para autenticação do Azure Databricks, se você não estiver usando a autenticação de token de acesso pessoal do Azure Databricks, poderá ignorar a geração de um token de acesso pessoal posteriormente nesses requisitos. Para obter mais informações sobre os tipos de autenticação do Azure Databricks disponíveis, confira Configurações de autenticação para o Driver de JDBC do Databricks.

  • Um cluster ou SQL warehouse do workspace do Azure Databricks.

  • Os detalhes da conexão do cluster ou do SQL warehouse, especificamente os valores nome do Host do Servidor, Porta e Caminho HTTP.

  • Um token de acesso pessoal do Azure Databricks ou um token do Microsoft Entra ID (antigo Azure Active Directory). Para criar um token de acesso pessoal, faça o seguinte:

    1. No workspace do Azure Databricks, clique no nome de usuário do Azure Databricks na barra superior e selecione Configurações na lista suspensa.
    2. Clique em Desenvolvedor.
    3. Ao lado de Tokens de acesso, clique em Gerenciar.
    4. Clique em Gerar novo token.
    5. (Opcional) Insira um comentário que ajude você a identificar esse token no futuro e altere o tempo de vida padrão do token de 90 dias. Para criar um token sem tempo de vida (não recomendado), deixe a caixa Tempo de vida (dias) vazia (em branco).
    6. Clique em Gerar.
    7. Copie o token exibido para um local seguro e clique em Concluído.

    Observação

    Lembre-se de salvar o token copiado em um local seguro. Não compartilhe seu token copiado com outras pessoas. Se você perder o token copiado, não poderá regenerar exatamente aquele mesmo token. Em vez disso, será necessário repetir esse procedimento para criar um novo token. Caso você tenha perdido o token copiado ou acredite que ele tenha sido comprometido, o Databricks recomenda que você exclua imediatamente esse token do seu workspace clicando no ícone de lixeira (Revogar) ao lado do token na página de Tokens de acesso.

    Se você não conseguir criar ou usar tokens em seu workspace, isso pode ocorrer porque o administrador do workspace desabilitou tokens ou não deu permissão para criar ou usar tokens. Consulte o administrador do espaço de trabalho ou os seguintes tópicos:

    Observação

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

Etapas para se conectar ao Workbench/J

Para se conectar ao Workbench/J, faça o seguinte:

  1. Inicie o SQL Workbench/J.
  2. Selecione Arquivo > Conectar janela.
  3. Na caixa de diálogo Selecionar Perfil de Conexão, clique em Gerenciar Drivers.
    1. No campo Nome, digite Databricks.
    2. No campo Biblioteca, clique no ícone Selecionar os arquivos JAR. Navegue até o diretório em que você extraiu o arquivo DatabricksJDBC42.jar do arquivo DatabricksJDBC42-<version>.zip baixado e selecione o arquivo JAR. Em seguida, clique em Escolher.
    3. Verifique se o campo Nome da classe está preenchido com com.databricks.client.jdbc.Driver.
    4. Clique em OK.
  4. Clique no botão Criar um perfil de conexão ícone.
    1. Digite um nome para o perfil.
    2. No campo Driver, selecione Databricks (com.databricks.client.jdbc.Driver).
    3. No campo URL, insira a URL JDBC do recurso do Azure Databricks. Para obter a sintaxe do campo URL para as URLs do JDBC, confira Configurações de autenticação para o Driver de JDBC do Databricks.
    4. Clique em Testar.
    5. Clique duas vezes em OK .

Recursos adicionais