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.
Esta página descreve como definir configurações de funcionalidade de driver especiais e avançadas para o Driver ODBC do Databricks.
O driver ODBC do Databricks oferece as seguintes configurações de capacidade de drivers especiais e avançadas.
- Definir o esquema inicial no ODBC
- Marcas de consulta para acompanhamento
- Suporte a consultas ANSI SQL-92 no ODBC
- Extrair resultados de consultas grandes no ODBC
- Serialização de seta no ODBC
- Busca na nuvem no ODBC
- Habilitar o registro em log
Definir o esquema inicial no ODBC
O driver ODBC permite que você especifique o esquema definindo Schema=<schema-name> como uma configuração de conexão. Isso é equivalente à execução de USE <schema-name>.
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 configuração de conexão ODBC:
Defina marcas de consulta como pares chave-valor separados por vírgulas, em que cada chave e valor é separada por dois pontos. Por exemplo, ssp_query_tags=team:engineering,env:prod.
Suporte à consulta ANSI SQL-92 no ODBC
Os drivers ODBC 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.
Extrair resultados de consultas grandes no ODBC
Para obter o melhor desempenho ao extrair resultados de consulta grandes, use a versão mais recente do driver ODBC, que inclui as otimizações a seguir.
Serialização de seta no ODBC
A versão 2.6.15 e superior do driver ODBC dá suporte a um formato de serialização otimizada dos resultados de consultas que usa o Apache Arrow.
Busca na nuvem no ODBC
O driver ODBC versão 2.6.17 e posterior 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 ODBC, 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 Configuração de opções de log em um computador que não seja Windows no Guia do Driver ODBC do Databricks.