Conectar-se ao SQL Workbench/J

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.

  • Referência de configuração de computação.
  • Criar um SQL warehouse.

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

  • Obter detalhes de conexão para um recurso de computação do Azure Databricks.

• 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, siga as etapas em Tokens de acesso pessoal do Azure Databricks para usuários do workspace.

  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

• SQL Workbench/J
• Suporte