Driver JDBC do Databricks legado

Observação

As informações a seguir se aplicam ao driver Databricks JDBC legado 2.6.22 e abaixo.

Para obter informações sobre o Databricks JDBC Driver 2.6.25 e acima, consulte Databricks JDBC Driver.

Para usar uma URL de conexão JDBC para autenticar usando um access token pessoal do Databricks, defina a seguinte coleção de propriedades, substituindo <personal-access-token> pelo seu access token pessoal do 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 um access token pessoal do Databricks, defina a seguinte coleção de propriedades, substituindo <personal-access-token> pelo seu access token pessoal do Databricks:

// ...
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 do Databricks herdado requer a configuração das propriedades transportMode e SSL . A Databricks recomenda que você 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 conexão de um cluster do Databricks:

  1. Faça login no seu espaço de trabalho do Databricks.

  2. Na barra lateral, clique em Calcular.

  3. Na lista de clusters disponíveis, clique no nome do cluster de destino.

  4. Na Configuração tab, expanda Opções avançadas.

  5. Clique na JDBC/ODBC tab.

  6. Copie os detalhes de conexão necessários, como Server hostname, Port e HTTP Path.

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 armazéns disponíveis, clique no nome do armazém de destino.

  4. Na Detalhes da conexão tab, copie os detalhes da conexão necessários, como do servidor hostname, Porta e Caminho HTTP.

Para usar o driver com clusters do Databricks, há duas permissões que o usuário chamador ou a entidade de serviço precisa ter ao se conectar ou reiniciar os clusters:

  • O senhor tem permissão para se conectar aos clusters em execução.

  • A permissão CAN RESTART aciona automaticamente o início dos clusters 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.

Observação

Os armazéns Databricks SQL são recomendados ao usar o Microsoft Power BI no modo DirectQuery .