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

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 de código Java completo que você pode adaptar o código anterior às suas próprias necessidades, consulte o início das configurações de autenticação para o driver ODBC do Databricks.

  • Para obter os valores de <server-hostname> e <http-path>, consulte os procedimentos a seguir.

Para obter os detalhes da conexão para clusters do Databricks, faça o seguinte:

  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 .