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 do Databricks. Faça o download do Databricks JDBC Driver na sua máquina de desenvolvimento local, extraindo o arquivo DatabricksJDBC42.jar do arquivo DatabricksJDBC42-<version>.zip baixado.

  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 Databricks JDBC Driver (Simba).

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

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

• Os detalhes de conexão para o seu cluster ou SQL warehouse, especificamente os valores de Nome de 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 de ID do Microsoft Entra (anteriormente Azure Ative Directory). Para criar um token de acesso pessoal, siga as etapas em Criar tokens de acesso pessoal 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 Ficheiro > 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 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 (Simba).
   4. Clique em Testar.
   5. Clique em OK duas vezes.

Recursos adicionais

• SQL Workbench/J
• Suporte