Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Observação
Esta página se aplica às versões do driver JDBC (Herdado) abaixo da versão 3. Para o driver JDBC do Databricks versão 3 e superior, consulte o Driver JDBC do Databricks.
Esta página descreve como definir configurações de funcionalidade de driver especiais e avançadas para o Driver JDBC do Databricks.
O driver JDBC do Databricks fornece as seguintes configurações de funcionalidade de driver especiais e avançadas.
- Suporte a consultas ANSI SQL-92 no JDBC
- Catálogo e esquema padrão
- Marcas de consulta para acompanhamento
- Extrair grandes resultados de consultas no JDBC
- Serialização de seta no JDBC
- Busca na Nuvem no JDBC
- Habilitar o registro em log
Suporte a consultas ANSI SQL-92 no JDBC
Os drivers JDBC herdados do Spark aceitam consultas SQL no dialeto ANSI SQL-92 e os convertem no SQL do Databricks antes de enviá-las para o servidor.
Se o aplicativo gerar o SQL do Databricks diretamente ou usar uma sintaxe SQL-92 não ANSI específica para Azure Databricks, defina UseNativeQuery=1 na configuração de conexão. Essa configuração passa consultas SQL verbatim para Azure Databricks sem tradução.
Catálogo e esquema padrão
Para especificar o catálogo e o esquema padrão, adicione ConnCatalog=<catalog-name>;ConnSchema=<schema-name> à URL de conexão JDBC.
Marcas de consulta para acompanhamento
Importante
Este recurso está em Versão prévia privada. Para solicitar acesso, entre em contato com sua equipe de conta.
Anexe marcas chave-valor às suas consultas SQL para fins de acompanhamento e análise. As tags de consulta aparecem na system.query.history tabela para identificação e análise.
Para adicionar marcas de consulta à sua conexão, inclua o ssp_query_tags parâmetro na URL de conexão JDBC:
jdbc:databricks://<server-hostname>:443;httpPath=<http-path>;ssp_query_tags=key1:value1,key2:value2
Defina marcas de consulta como pares chave-valor separados por vírgulas, em que cada chave e valor é separada por dois pontos. Por exemplo, key1:value1,key2:value2.
Extrair resultados de consultas grandes no JDBC
Para obter o melhor desempenho ao extrair resultados de consultas grandes, use a última versão do driver JDBC, que inclui as otimizações a seguir.
Serialização de seta no JDBC
A versão 2.6.16 e versões posteriores do driver JDBC dá suporte a um formato otimizado de serialização de resultados de consulta que usa o Apache Arrow.
Observação
O Cloud Fetch está disponível apenas para workspaces AWS e Azure.
Busca na Nuvem no JDBC
O driver JDBC versão 2.6.19 e superior dá suporte ao Cloud Fetch, uma funcionalidade que busca resultados de consulta por meio do armazenamento em nuvem configurado em sua implantação de Azure Databricks.
Quando você executa uma consulta, Azure Databricks armazena os resultados no armazenamento em nuvem do workspace como arquivos serializados por seta de até 20 MB. Após a conclusão da consulta, o driver envia solicitações de busca e Azure Databricks retorna urls SAS (assinatura de acesso compartilhado) compartilhada para os arquivos de resultados. Em seguida, o driver usa essas URLs para baixar resultados diretamente do armazenamento de Azure.
O Busca na Nuvem aplica-se apenas a resultados de consulta maiores que 1 MB. O driver recupera resultados menores diretamente de Azure Databricks.
Azure Databricks coleta automaticamente arquivos acumulados, marcando-os para exclusão após 24 horas e excluindo-os permanentemente após mais 24 horas.
Habilitar o registro em log
Para habilitar o registro em log no driver JDBC, defina a LogLevel propriedade como um valor entre 1 (somente eventos graves) e 6 (todas as atividades do driver). Defina a LogPath propriedade como o caminho completo da pasta em que você deseja salvar arquivos de log.
Para obter mais informações, consulte Configurando o registro em log no Guia do Driver JDBC do Databricks.