Pular para o conteúdo principal

Driver JDBC do Legacy Databricks

nota

Este artigo se aplica ao driver Databricks JDBC Simba. Para o driver JDBC desenvolvido pela Databricks, consulte Databricks JDBC Driver (OSS).

As informações a seguir se aplicam ao legado Databricks JDBC Driver 2.6.22 e abaixo. Para obter informações sobre Databricks JDBC Driver 2.6.25 e acima, consulte Databricks JDBC Driver.

Para usar um URL de conexão JDBC para autenticar usando tokens de acesso pessoal Databricks, defina a seguinte coleção de propriedades, substituindo <personal-access-token> pelos tokens de acesso pessoal Databricks:

jdbc:spark://<server-hostname>:443;httpPath=<http-path>;transportMode=http;SSL=1;UID=token;PWD=<personal-access-token

A Databricks recomenda que o senhor use o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste artigo traz riscos que não estão presentes em outros fluxos. O senhor só deve usar esse fluxo quando outros fluxos mais seguros, como identidades gerenciais, não forem viáveis.

Para usar o código Java para autenticar usando tokens de acesso pessoal Databricks, defina a seguinte coleção de propriedades, substituindo <personal-access-token> por seus tokens de acesso pessoal Databricks:

Java
// ...
String url = "jdbc:spark://<server-hostname>:443;httpPath=<http-path>;transportMode=http;SSL=1";
Properties p = new java.util.Properties();
p.put("UID", "token");
p.put("PWD", "<personal-access-token>");
// ...
DriverManager.getConnection(url, p);
// ...
  • O driver JDBC antigo da Databricks exige a configuração das propriedades transportMode e SSL . A Databricks recomenda que o senhor defina esses valores como http e 1, respectivamente.
  • Para obter um exemplo completo de código Java que o senhor pode adaptar conforme necessário, consulte o início das Configurações de autenticação para o driver JDBC da Databricks.
  • Para obter os valores de <server-hostname> e <http-path>, consulte os procedimentos a seguir.

Para obter os detalhes da Databricks conexão de um clustering:

  1. Faça login no seu espaço de trabalho do Databricks.
  2. Na barra lateral, clique em Compute .
  3. Na lista de clustering disponíveis, clique no nome do clustering de destino.
  4. Em Configuration (Configuração ) tab, expanda Advanced options (Opções avançadas ).
  5. Clique no link JDBC/ODBC tab.
  6. Copie os detalhes da conexão que você precisa, como nome de host do servidor , porta e caminho HTTP .

Para obter os detalhes da conexão de um Databricks SQL depósito, faça o seguinte:

  1. Faça login no seu espaço de trabalho do Databricks.
  2. Na barra lateral, clique em SQL > SQL Warehouses .
  3. Na lista de depósitos disponíveis, clique no nome do depósito de destino.
  4. Em Connection Details (Detalhes da conexão ) tab, copie os detalhes da conexão de que o senhor precisa, como Server hostname (Nome do host do servidor ), Port ( Porta ) e HTTP path (Caminho HTTP ).

Para usar o driver com um Databricks cluster, há duas permissões que o usuário ou a entidade de serviço que está fazendo a chamada precisa ao se conectar ou reiniciar o cluster:

  • CAN ATTACH TO permissão para se conectar aos clusters em execução.
  • CAN RESTART para acionar automaticamente o início do clustering se seu estado for encerrado durante a conexão.

Para usar o driver com um Databricks SQL armazém, o usuário ou a entidade de serviço que o chama precisa da permissão CAN USE. O armazém Databricks SQL começará automaticamente se for interrompido.

nota

Databricks SQL são recomendados ao usar o site Microsoft Power BI no modo DirectQuery .

Última atualização em