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

Este artigo descreve como definir configurações de capacidade de driver especiais e avançadas para o driver ODBC do Databricks.

Este artigo complementa as informações nos seguintes artigos do Databricks ODBC Driver:

Para configurar uma conexão do Databricks para o driver ODBC do Databricks, você deve combinar suas configurações de recurso compute , configurações de autenticação e qualquer uma das seguintes configurações de capacidade do driver em um nome de fonte de dados (DSN) ODBC ou em uma strings de conexão sem DSN.

O uso de strings de conexão DSN ou sem DSN dependerá dos requisitos do aplicativo, ferramenta, cliente, SDK ou API de destino. Para obter exemplos de DSNs e strings de conexão sem DSN, consulte Configurações de autenticação para o driver ODBC do Databricks.

O driver ODBC Datbricks fornece as seguintes configurações de capacidade de driver especiais e avançadas.

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>.

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 o seu aplicativo gerar o Databricks SQL diretamente ou se o seu aplicativo usar qualquer sintaxe SQL padrão que não seja a ANSI SQL-92 específica do Databricks, o 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.

Extraia grandes resultados de consultas no 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

O driver ODBC versão 2.6.15 e acima suporta um formato de serialização de resultados de consulta otimizado que usa Apache Arrow.

Ativar o 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 de FATAL para log apenas eventos graves até TRACE para log toda a atividade do driver.

  • Defina o campolog Path (Caminho ) como o caminho completo para a pasta onde o senhor 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 .