Conecte-se ao SQL Workbench/J

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

Observação

Este artigo abrange 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 do Databricks. downloads o driver JDBC do Databricks em sua máquina de desenvolvimento local, extraindo o arquivo DatabricksJDBC42.jar do arquivo DatabricksJDBC42-<version>.zip downloads .

    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 a autenticação do Databricks, se você não estiver usando a autenticação access token pessoal do Databricks, poderá ignorar a geração de um access token pessoal posteriormente nestes requisitos. Para obter mais informações sobre os tipos de autenticação do Databricks disponíveis, consulte Configurações de autenticação para o driver JDBC do Databricks.

  • Um clusters ou SQL warehouse em seu workspace do Databricks.

  • Os detalhes de conexão para seus clusters ou SQL warehouse, especificamente os valores Server hostname, Port e HTTP Path .

  • Um site pessoal da Databricks access token. Para criar um access token pessoal, faça o seguinte:

    1. No workspace do Databricks, clique no nome de usuário do Databricks na barra superior e selecione Configurações do usuário na lista suspensa.

    2. Clique em Desenvolvedor.

    3. Ao lado do access token, clique em gerenciar.

    4. Clique em Gerar novos tokens.

    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 vida útil (não recomendado), deixe a caixa Duração (dias) vazia (em branco).

    6. Clique em Gerar.

    7. Copie o token exibido em um local seguro e clique em Concluído.

    Observação

    Certifique-se de salvar os tokens copiados em um local seguro. Não compartilhe seus tokens copiados com outras pessoas. Se você perder os tokens copiados, não poderá regenerar exatamente os mesmos tokens. Em vez disso, você deve repetir este procedimento para criar novos tokens. Se você perder os tokens copiados ou acreditar que os tokens foram comprometidos, o Databricks recomenda fortemente que você exclua imediatamente esses tokens do seu workspace clicando no ícone da lixeira (Revogar) ao lado dos tokens na página access tokens .

    Se não for possível criar ou usar tokens no seu workspace, isso pode ocorrer porque o administrador do workspace desativou os tokens ou não lhe deu permissão para criar ou usar tokens. Consulte o administrador do workspace ou o seguinte:

    Observação

    Como prática recomendada de segurança ao se autenticar com ferramentas, sistemas, scripts e aplicativos automatizados, a Databricks recomenda que você use tokens OAuth.

    Se utilizar a autenticação access token pessoal, a Databricks recomenda a utilização access token pessoal pertencente à entidade de serviço em vez de utilizadores workspace . Para criar tokens para entidades de serviço, consulte gerenciar tokens para uma entidade de serviço.

passos 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 o(s) arquivo(s) JAR . Navegue até o diretório onde você extraiu o arquivo DatabricksJDBC42.jar do arquivo de downloads DatabricksJDBC42-<version>.zip e selecione o arquivo JAR. Em seguida, clique em Escolher.

    3. Verifique se o campo Classname 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 do seu recurso Databricks. Para obter a sintaxe do campo URL para URLs JDBC, consulte Configurações de autenticação para o driver JDBC do Databricks.

    4. Clique em Testar.

    5. Clique em OK duas vezes.

Recursos adicionais