Partilhar via

Conectar-se ao SQL Workbench/J

  • Artigo

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

Nota

Este artigo aborda 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 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.

  • Os detalhes de conexão para seu cluster ou SQL warehouse, especificamente os valores Nome do host do servidor, Porta e Caminho HTTP.

  • 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 a janela 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