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 do Databricks 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 o Azure Databricks, defina UseNativeQuery=1 na configuração de conexão. Essa configuração passa consultas SQL verbatim para o 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.
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 do Azure Databricks.
Quando você executa uma consulta, o Azure Databricks carrega os resultados em um local de armazenamento interno do DBFS como arquivos serializados por seta de até 20 MB. Após a conclusão da consulta, o driver envia solicitações de busca e o Azure Databricks retorna assinaturas de acesso compartilhado aos arquivos carregados . Em seguida, o driver usa essas URLs para baixar resultados diretamente do DBFS.
O Busca na Nuvem aplica-se apenas a resultados de consulta maiores que 1 MB. O driver recupera resultados menores diretamente do Azure Databricks.
O Azure Databricks coleta automaticamente arquivos acumulados, marcando-os para exclusão após 24 horas e excluindo-os permanentemente após mais 24 horas.
Para saber mais sobre a arquitetura da Busca na Nuvem, confira Como atingimos a conectividade de alta largura de banda com as ferramentas de BI.
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.