Configurações de computação para o driver JDBC do Databricks

Observação

Este artigo se aplica ao driver do Databricks JDBC Simba. Para o driver JDBC desenvolvido pelo Databricks, consulte OsS (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	O 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:

1. Faça login no workspace do Azure Databricks.
2. Na barra lateral, clique em Computação.
3. Na lista de clusters disponíveis, clique no nome do cluster de destino.
4. Na guia Configuração, expanda Opções avançadas.
5. Clique na guia JDBC/ODBC.
6. 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:

1. Faça login no workspace do Azure 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 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 conectar-se 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 pessoa ou entidade de serviço que está fazendo a chamada precisa ter a permissão PODE USAR. O warehouse SQL do Databricks é iniciado automaticamente se estiver parado.

Observação

Os SQL warehouses do Databricks são recomendados quando você estiver usando o Power BI da Microsoft no modo DirectQuery.