Variables del sistema

El MongoDB Connector for Business Intelligence para Atlas y en instalaciones locales alcanza el final de su vida útil (EOL) y ya no será compatible después de septiembre de 2026. Para todos los nuevos proyectos, recomendamos utilizar la nueva Interfaz SQL de MongoDB para conectarse a Atlas o a implementaciones de Enterprise Advanced. La Interfaz SQL ofrece un rendimiento mejorado, una configuración simplificada y funcionalidades mejoradas. Para aprender más, consulta Conéctate con SQL.

Overview

BI Connector proporciona las siguientes variables de entorno:

Variable del sistema	Tipo de dato	Descripción	Valor por defecto
`full_pushdown_exec_mode`	booleano	Especifica si se devuelve un error de consulta en consultas con cláusulas que no están completamente traducidas al lenguaje de consulta de MongoDB. Los predicados de consulta SQL se utilizan para filtrar los datos devueltos por la consulta.	`0 (false)`
`log_level`	entero	Especifica el nivel de registro para BI Connector: `-1`No iniciar sesión. `0`Registra solo mensajes para los usuarios de la base de datos, como eventos básicos de `mongosqld` y cambios de estado. `1`: Mensajes de registro para los usuarios de bases de datos y los administradores de `mongosqld`. `2`: Solo para uso interno.	`2 (Atlas-hosted) and 0 (self-managed)`
`max_nested_table_depth`	entero	Especifica el número máximo de rutas de campo anidadas únicas que `mongosqld` mapea a una tabla relacional para una colección.	`50`
`max_num_global_tables`	entero	El número máximo de tablas permitidas en una implementación de MongoDB con un esquema generado automáticamente.	`4000`
`max_num_tables_per_collection`	entero	El número máximo de tablas permitidas en una colección dentro de una tabla con un esquema generado automáticamente.	`200`
`max_nested_table_depth`	entero	El límite por defecto para la profundidad de anidamiento en tablas de arreglos que MongoDB traduce a tablas, en una colección con un esquema generado automáticamente.	`10`
`max_num_fields_per_collection`	entero	El número máximo de campos examinados por colección en una tabla con un esquema generado automáticamente.	`2000`
`mongodb_max_varchar_length`	entero	Especifica la longitud máxima de string devuelta para las columnas que utilizan el tipo de datos `VARCHAR`. Un valor de `0` especifica que no hay límite.	`0`
`polymorphic_type_conversion_mode`	string	Determina cómo BI Connector evalúa los campos de documento especificados con varios tipos de datos. Por ejemplo, `count` podría ser un número en un documento y una cadena en otro. El tipo de dato que BI Connector selecciona depende del valor de la variable de sistema `schema_mapping_mode`. Un valor de `majority` hace que BI Connector seleccione el tipo que aparece en la mayoría de los campos de documento, mientras que un valor de `lattice` haría que BI Connector seleccionara una cadena como tipo de dato para `count`. Consulte Muestreo en caché para obtener más información. Establezca `polymorphic_type_conversion_mode` en uno de los siguientes valores: `off`: Es posible que las consultas fallen si no lanza explícitamente campos de documentos que se hayan especificado con múltiples tipos de datos. `fast`: BI Connector convierte únicamente los campos de documentos que aparecieron como varios tipos de datos durante el muestreo. `safe`:BI Connector convierte todos los campos del documento al tipo de datos descubierto durante el muestreo, incluso si los campos no aparecen como múltiples tipos de datos.	`off`
`reconcile_arithmetic_agg_functions`	booleano	Permite elegir el comportamiento en el que MongoDB no convierte automáticamente los tipos en algunas consultas que utilizan funciones de agregación aritmética. En MongoDB 3.6 y versiones anteriores, este comportamiento mejora el rendimiento, en comparación con las conversiones de tipos implícitas para funciones de agregación aritmética en versiones posteriores. Consulta Modos de conversión de tipo para obtener más información.	`true`
`sample_refresh_interval_secs`	entero	Especifica con qué frecuencia, en segundos, se actualiza el esquema del BI Connector. Un valor de `0` indica que el esquema no se actualiza después de que se inicia el BI Connector. Consulte Muestreo en caché para obtener más información.	`0`
`sample_size`	entero	Especifica cuántos documentos BI Connector toma como muestra al generar su esquema. Un valor de `0` especifica que BI Connector realiza un escaneo de colección en todas las muestras `namespaces`. Consulte Muestreo en caché para obtener más información.	`100`
`schema_mapping_mode`	string	Especifica cómo se transforma el esquema de MongoDB en un esquema relacional: `lattice`Consulta Conflictos de Tipo de Muestreo para obtener más información. `majority`BI Connector asigna el tipo de datos más común para un campo que se encuentra en una muestra.	`lattice`
`type_conversion_mode`	string	Especifica la semántica que utiliza BI Connector para las conversiones de tipo, como la función `CAST`. `mysql` `mongosql`	`mongosql`

Configuración de variables del sistema

Debes tener el rol de base de datos atlasAdmin para establecer variables de entorno en un BI Connector alojado en Atlas. Para establecerlas en un BI Connector autogestionado, debes tener el privilegio inprog en la base de datos MongoDB a la que hayas conectado el BI Connector.

Utiliza cualquier cliente SQL conectado a BI Connector para configurar estas variables. El siguiente ejemplo establece mongodb_max_varchar_length en 100:

SET GLOBAL mongodb_max_varchar_length = 100

Debe iniciar una nueva conexión al BI Connector después de establecer una variable del sistema. La conexión que usaste para establecer la variable del sistema no se ve afectada.

Volver

Modelo de autorización del usuario

Problemas conocidos para BI Connector