Conectar-se ao SQL Workbench/J

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

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.

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

• Os detalhes de conexão para seu cluster ou SQL warehouse, especificamente os valores Nome do 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 (anteriormente Azure Ative Directory). Para criar um token de acesso pessoal, siga as etapas em Tokens de acesso pessoal do Azure Databricks para usuários do espaço de trabalho.

  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 > 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

• SQL Workbench/J
• Suporte