Compartilhar via


Configurações de computação para o Driver JDBC do Databricks (Simba)

Observação

Esta página se aplica a versões de driver JDBC do Databricks inferiores a 3. Para o driver JDBC do Databricks versão 3 e superior, consulte o Driver JDBC do Databricks.

Esta página descreve como definir as configurações de recurso de computação do Azure Databricks para o Driver JDBC do Databricks.

Observação

O driver JDBC não dá suporte à conexão com clusters de trabalho.

Configurações necessárias

Defina as seguintes configurações para se conectar a um recurso de computação do Azure Databricks:

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.
Catalog (opcional) O nome do catálogo padrão.

Formato de URL de conexão

Use o seguinte formato para a URL de conexão JDBC:

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>[;<setting1>=<value1>;<setting2>=<value2>;<settingN>=<valueN>]

Exemplo de Java

O exemplo a seguir mostra como estabelecer uma conexão usando Java:

// ...
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 completo, consulte as configurações de Autenticação para o Simba (Driver JDBC) do Databricks.

Substitua os <setting> e <value> espaços reservados pelas suas configurações de autenticação e quaisquer configurações de capacidade do driver.

Para obter os valores para <server-hostname> e <http-path>, consulte as seções 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.