Configurações de capacidade do driver para o Databricks JDBC Driver
Este artigo se aplica ao driver Databricks JDBC Simba. Para o driver JDBC desenvolvido pela Databricks, consulte Databricks JDBC Driver (OSS).
Este artigo descreve como configurar os recursos especiais e avançados do driver para o driverDatabricks JDBC.
O driver JDBC da Databricks fornece as seguintes configurações especiais e avançadas de recursos do driver.
- Suporte a consultas ANSI SQL-92 em JDBC
- Catálogo e esquema padrão
- tags de consulta para acompanhamento
- Extrair grandes resultados de consultas em JDBC
- Serialização de setas em JDBC
- Ativar registro
Suporte a consultas ANSI SQL-92 em JDBC
Os drivers JDBC legacy do Spark aceitam consultas SQL no dialeto ANSI SQL-92 e convertem as consultas para o dialeto Databricks SQL antes de enviá-las ao servidor. No entanto, se seu aplicativo gera Databricks SQL diretamente ou seu aplicativo usa qualquer sintaxe SQL padrão não-ANSI SQL-92 específica para Databricks, Databricks recomenda que você defina UseNativeQuery=1
como uma configuração de conexão. Com essa configuração, o driver passa as consultas SQL verbatim para Databricks.
Catálogo e esquema padrão
Para especificar o catálogo e esquema padrão, adicione ConnCatalog=<catalog-name>;ConnSchema=<schema-name>
na URL de conexão JDBC.
tags de consulta para acompanhamento
Visualização
Este recurso está em Visualização Privada. Para solicitar acesso, entre em contato com sua equipe account .
Você pode anexar tags de key-valor às suas consultas SQL para fins de acompanhamento e análise. As tags de consulta aparecem na tabela system.query.history
para identificação e análise de consulta.
Para adicionar tags de consulta à sua conexão, inclua o parâmetro ssp_query_tags
no URL da sua conexão JDBC:
jdbc:databricks://<server-hostname>:443;httpPath=<http-path>;ssp_query_tags=key1:value1,key2:value2
Defina tags de consulta como par key-valor separados por vírgula, onde cada key e valor são separados por dois pontos, por exemplo, key1:value1,key2:value2
.
Extrair grandes resultados de consultas em JDBC
Para obter o melhor desempenho ao extrair resultados de consultas extensas, utilize a versão mais recente do driver JDBC, que incorpora as seguintes otimizações.
Serialização de setas em JDBC
JDBC O driver versão 2.6.16 e o acima oferecem suporte a um formato otimizado de serialização de resultados de consulta que usa Apache Arrow.
Ativar registro
Para ativar o registro no driver JDBC, defina a propriedade LogLevel
de 1
para log apenas eventos graves até 6
para log toda a atividade do driver. Defina a propriedade LogPath
como o caminho completo para a pasta onde o senhor deseja salvar os arquivos log.
Para obter mais informações, consulte a seção Configuring Logging
no guia do driverDatabricks JDBC.