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 query para queries con cláusulas que no están completamente traducidas al languaje del query de MongoDB. Los predicados de SQL query se utilizan para filtrar los datos devueltos por la query.	`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 que se especifican con múltiples tipos de datos. Por ejemplo, `count` podría ser un número en un documento y una string en otro. El tipo de datos que selecciona BI Connector depende del valor de la variable del sistema `schema_mapping_mode`. Un valor de `majority` hace que BI Connector seleccione el tipo que aparece en la mayoría de los campos del documento, mientras que un valor de `lattice` haría que BI Connector seleccione string como el tipo de dato para `count`. Ver 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 dato descubierto durante el muestreo, incluso si los campos no aparecen como varios tipos de datos.	`off`
`reconcile_arithmetic_agg_functions`	booleano	Permite elegir el comportamiento donde MongoDB no convierte automáticamente tipos para algunas consultas usando funciones agregadas aritméticas. En las versiones 3.6 de MongoDB y anteriores, este comportamiento resulta en un mejor rendimiento en comparación con las conversiones de tipo implícitas para las funciones de agregación aritmética en las versiones sucesivas. 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. Consulta Muestreo almacenado 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`. Consulta Muestreo almacenado 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