Conectar-se ao SQL Workbench/J

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

Requirements

• 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 disponíveis do Azure Databricks, consulte as configurações de autenticação do Simba (Driver JDBC) do Databricks.

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

  • Referência de configuração de computação.
  • Crie um Armazém de Dados SQL.

• Os detalhes da conexão para seu cluster ou SQL Warehouse, especificamente os valores do nome de host do servidor, porta e caminho HTTP.

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

• Um token de acesso pessoal do Azure Databricks ou um token de ID do Microsoft Entra (antigo Azure Active Directory). Para criar um token de acesso pessoal, siga as etapas em Criar tokens de acesso pessoal para usuários do workspace.

  Observação

  Como prática recomendada de segurança, quando você se autentica com ferramentas automatizadas, sistemas, scripts e aplicativos, o Databricks recomenda que você use tokens de acesso pessoal pertencentes a entidades de serviço em vez de 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 , escreva 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 a sintaxe do campo URL para URLs JDBC, consulte configurações de autenticação para o Driver JDBC do Databricks (Simba).
   4. Clique em Teste.
   5. Clique em OK duas vezes.

Recursos adicionais

• SQL Workbench/J