Pular para o conteúdo principal

Configurações de capacidade do driver para o Databricks ODBC Driver

Este artigo descreve como configurar os recursos especiais e avançados do driver para o driverDatabricks ODBC.

O driver ODBC da Databricks fornece as seguintes configurações especiais e avançadas de recursos do driver.

Definir o esquema inicial no ODBC​

O driver ODBC permite a você especificar o esquema definindo o Schema=<schema-name> como uma configuração de conexão. Isso é equivalente a executar USE <schema-name>.

tags de consulta para acompanhamento​

info

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 na configuração da sua conexão ODBC:

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, ssp_query_tags=team:engineering,env:prod.

Suporte a consultas ANSI SQL-92 em ODBC​

O driver ODBC aceita consultas SQL no dialeto ANSI SQL-92 e traduz as consultas para o dialeto Databricks SQL. 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.

Extrair grandes resultados de consultas em ODBC​

Para obter o melhor desempenho ao extrair grandes resultados de consultas, use a versão mais recente do driver ODBC que inclui as seguintes otimizações.

Serialização de setas no ODBC​

ODBC A versão 2.6.15 do driver 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 ODBC para Windows, defina os seguintes campos no ODBC fonte de dados Administrator para o DSN relacionado:

  • Defina o campo Log Level (nível de registro ) de FATAL para log apenas eventos graves por meio de TRACE para log toda a atividade do driver.
  • Defina o campo Log Path (Caminho do registro) como o caminho completo para a pasta onde deseja salvar os arquivos log.
  • Defina o campo Max Number Files (Número máximo de arquivos) como o número máximo de arquivos log a serem mantidos.
  • Defina o campo Max File Size como o tamanho máximo de cada arquivo log em megabytes.

Para ativar o registro em log no driver ODBC para um computador que não seja Windows, defina as seguintes propriedades nas cadeias de conexão DSN ou DSN-less relacionadas:

  • Defina a propriedade LogLevel de 1 para log apenas eventos graves até 6 para log toda a atividade do motorista.
  • Defina a propriedade LogPath como o caminho completo para a pasta onde o senhor deseja salvar os arquivos log.
  • Defina a propriedade LogFileCount como o número máximo de arquivos log a serem mantidos.
  • Defina a propriedade LogFileSize como o tamanho máximo de cada arquivo log em bytes.

Para obter mais informações, consulte as seções Configuring Logging Options on Windows e Configuring Logging Options on a Non-Windows Machine no guia do driverDatabricks JDBC.

Última atualização em