Conectar-se ao SQL Workbench/J

  • Artigo

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

Nota

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

Requisitos

  • SQL Workbench/J.

  • O driver JDBC Databricks. Faça o download do Databricks JDBC Driver em sua máquina de desenvolvimento local, extraindo o DatabricksJDBC42.jar arquivo do arquivo baixado DatabricksJDBC42-<version>.zip .

    Nota

    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 disponíveis do Azure Databricks, consulte Configurações de autenticação para o driver JDBC do Databricks.

  • Um cluster ou armazém SQL no seu espaço de trabalho do Azure Databricks.

  • Os detalhes de conexão para seu cluster ou 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 de ID do Microsoft Entra (anteriormente Azure Ative Directory). Para criar um token de acesso pessoal, faça o seguinte:

    1. No seu espaço de trabalho do Azure Databricks, clique no seu nome de utilizador do Azure Databricks na barra superior e, em seguida, selecione Definições na lista pendente.
    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 o ajude 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 Generate (Gerar).
    7. Copie o token exibido para um local seguro e clique em Concluído.

    Nota

    Certifique-se de salvar o token copiado em um local seguro. Não partilhe o seu token copiado com outras pessoas. Se você perder o token copiado, não poderá regenerar exatamente o mesmo token. Em vez disso, você deve repetir esse procedimento para criar um novo token. Se você perder o token copiado ou acreditar que o token foi comprometido, o Databricks recomenda que você exclua imediatamente esse token do seu espaço de trabalho clicando no ícone da lixeira (Revogar) ao lado do token na página de tokens do Access.

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

    Nota

    Como prática recomendada de segurança, quando você se autentica com ferramentas, sistemas, scripts e aplicativos automatizados, o Databricks recomenda que você use tokens de acesso pessoal pertencentes a entidades de serviço em vez de usuários do espaço de trabalho. 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 a janela File > Connect.
  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 o(s) arquivo(s) JAR. Navegue até o diretório onde você extraiu o DatabricksJDBC42.jar arquivo do arquivo baixado DatabricksJDBC42-<version>.zip 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 ícone Criar um novo perfil de conexão.
    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 para seu recurso Azure Databricks. Para obter a sintaxe do campo URL para URLs JDBC, consulte Configurações de autenticação para o driver JDBC Databricks.
    4. Clique em Testar.
    5. Clique em OK duas vezes.

Recursos adicionais