Comparteix via


Configuración de la funcionalidad del controlador para el controlador ODBC de Databricks (Simba)

En esta página se describe cómo configurar opciones de funcionalidad de controlador especiales y avanzadas para el controlador ODBC de Databricks.

El controlador ODBC de Databricks proporciona la siguiente configuración de capacidad de controlador especial y avanzada.

Establecimiento del esquema inicial en ODBC

El controlador ODBC permite especificar el esquema estableciendo Schema=<schema-name> como una configuración de conexión. Equivale a ejecutar USE <schema-name>.

Etiquetas de consulta para el seguimiento

Importante

** Esta característica está disponible en versión preliminar privada. Para solicitar acceso, póngase en contacto con el equipo de su cuenta.

Adjunte etiquetas clave-valor a las consultas SQL con fines de seguimiento y análisis. Las etiquetas de consulta aparecen en la system.query.history tabla para la identificación y el análisis de consultas.

Para agregar etiquetas de consulta a la conexión, incluya el parámetro ssp_query_tags en la configuración de conexión ODBC.

Defina etiquetas de consulta como pares clave-valor separados por comas, donde cada clave y valor están separados por dos puntos. Por ejemplo: ssp_query_tags=team:engineering,env:prod.

Compatibilidad con consultas SQL-92 de ANSI en ODBC

Los controladores ODBC de Spark heredados aceptan consultas SQL en el dialecto ANSI SQL-92 y los traducen a Databricks SQL antes de enviarlos al servidor.

Si la aplicación genera Databricks SQL directamente o usa sintaxis no ANSI SQL-92 específica de Azure Databricks, establezca UseNativeQuery=1 en la configuración de conexión. Esta configuración pasa consultas SQL textuales a Azure Databricks sin traducción.

Extracción de resultados de consultas grandes en ODBC

Para lograr el mejor rendimiento al extraer resultados de consultas grandes, use la versión más reciente del controlador ODBC, que incluye las siguientes optimizaciones.

Serialización de Arrow en ODBC

La versión 2.6.15 y las versiones posteriores del controlador ODBC admiten un formato de serialización de resultados de consulta optimizado que usa Apache Arrow.

Captura en la nube en ODBC

La versión 2.6.17 y posteriores del controlador ODBC admite Cloud Fetch, una funcionalidad que captura los resultados de la consulta a través del almacenamiento en la nube configurado en la implementación de Azure Databricks.

Al ejecutar una consulta, Azure Databricks carga los resultados en una ubicación de almacenamiento de DBFS interna como archivos serializados con flecha de hasta 20 MB. Una vez completada la consulta, el controlador envía solicitudes de captura y Azure Databricks devuelve firmas de acceso compartido a los archivos cargados. A continuación, el controlador usa estas direcciones URL para descargar los resultados directamente desde DBFS.

Cloud Fetch solo se aplica a los resultados de la consulta de más de 1 MB. El controlador recupera resultados más pequeños directamente de Azure Databricks.

Azure Databricks realiza la recolección de basura de los archivos acumulados automáticamente, marcándolos para su eliminación después de 24 horas y eliminándolos permanentemente tras 24 horas adicionales.

Para más información sobre la arquitectura de Cloud Fetch, vea Cómo logramos la conectividad de ancho de banda alto con las herramientas de BI.

Habilitar registro

Para habilitar el registro en el controlador ODBC, establezca la LogLevel propiedad en un valor entre 1 (solo eventos graves) y 6 (toda la actividad del controlador). Establezca la LogPath propiedad en la ruta de acceso completa de la carpeta donde desea guardar los archivos de registro.

Para obtener más información, consulte Configuración de opciones de registro en una máquina que no sea Windows en la Guía del controlador ODBC de Databricks.