Configurações de computação para o driver JDBC do Databricks
Este artigo descreve como definir as configurações de recursos de computação do Azure Databricks para o driver JDBC do Databricks.
O driver requer as seguintes definições de configuração de recursos de computação:
| Configuração | Descrição |
|---|---|
Host |
O valor do nome do Host do servidor do recurso de computação do Azure Databricks. |
Port |
443 |
HTTPPath |
Valor do Caminho HTTP do recurso de computação do Azure Databricks. |
SSL |
1 |
Schema (opcional) |
O nome do esquema padrão a ser usado. |
Catalog (opcional) |
O nome do catálogo padrão a ser usado. |
Uma URL de conexão JDBC que usa as configurações anteriores tem o seguinte formato:
jdbc:databricks://<server-hostname>:443;httpPath=<http-path>[;<setting1>=<value1>;<setting2>=<value2>;<settingN>=<valueN>]
O código Java que usa as configurações anteriores tem o seguinte formato:
// ...
String url = "jdbc:databricks://<server-hostname>:443";
Properties p = new java.util.Properties();
p.put("httpPath", "<http-path>");
p.put("<setting1>", "<value1");
p.put("<setting2>", "<value2");
p.put("<settingN>", "<valueN");
// ...
Connection conn = DriverManager.getConnection(url, p);
// ...
- Para obter um exemplo de código Java completo que você pode adaptar conforme necessário, confira o início das Configurações de autenticação para o Driver JDBC do Databricks.
- Substitua
<setting>e<value>conforme necessário, para cada uma das configurações de autenticação do Azure Databricks de destino e quaisquer configurações de funcionalidades de driver especiais ou avançadas. - Para obter os valores de
<server-hostname>e<http-path>, confira os procedimentos a seguir.
Para obter os detalhes da conexão de um cluster do Azure Databricks:
- Faça login no workspace do Azure Databricks.
- Na barra lateral, clique em Computação.
- Na lista de clusters disponíveis, clique no nome do cluster de destino.
- Na guia Configuração, expanda Opções avançadas.
- Clique na guia JDBC/ODBC.
- Copie os detalhes de conexão necessários, como Nome do Host do Servidor, Porta e Caminho HTTP.
Para obter os detalhes de conexão de um SQL warehouse do Databricks, faça o seguinte:
- Faça login no workspace do Azure Databricks.
- Na barra lateral, clique em SQL > SQL Warehouses.
- Na lista de warehouses disponíveis, clique no nome do warehouse de destino.
- Na guia Detalhes da Conexão, copie os detalhes de conexão necessários, como Nome do Host do Servidor, Porta e Caminho HTTP.
Para usar o driver com um cluster do Azure Databricks, há duas permissões que a entidade de serviço ou o usuário efetuando a chamada precisam para se conectar ou reiniciar o cluster:
- A permissão PODE ANEXAR A para se conectar ao cluster em execução.
- A permissão PODE REINICIAR para disparar o cluster e iniciá-lo automaticamente se o estado for encerrado durante a conexão.
Para usar o driver com um warehouse SQL do Databricks, a entidade de serviço ou o usuário que estiverem efetuando a chamada precisam da permissão PODE USAR. O warehouse SQL do Databricks será iniciado automaticamente se tiver sido interrompido.
Observação
Os SQL warehouses do Databricks são recomendados quando você estiver usando o Power BI da Microsoft no modo DirectQuery.