Variables del sistema

El Conector MongoDB para Business Intelligence para Atlas y entornos locales llega al final de su vida útil (EOL) y dejará de recibir soporte después del 2026 de septiembre. Para todos los proyectos nuevos, recomendamos usar la nueva Interfaz SQL de MongoDB para conectarse a las implementaciones de Atlas o Enterprise Advanced. La Interfaz SQL ofrece un rendimiento mejorado, una configuración simplificada y funciones mejoradas. Para obtener más información, consulte Conectarse 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 de usuarios de la base de datos, como eventos básicos `mongosqld` y cambios de estado. `1`:Mensajes de registro para usuarios de la base de datos y administradores `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 campos anidados únicos que `mongosqld` asigna 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 en 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 la cadena que se devuelve para las columnas que utilizan el tipo de dato `VARCHAR`. Un valor de `0` no especifica ningún 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 múltiples 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 la versión 3.6 de MongoDB y 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. Consulte Modos de conversión de tipos para obtener más información.	`true`
`sample_refresh_interval_secs`	entero	Especifica la frecuencia, en segundos, con la que se actualiza el esquema de BI Connector. Un valor de `0` indica que el esquema no se actualiza después de iniciar BI Connector. Consulte Muestreo en caché para obtener más información.	`0`
`sample_size`	entero	Especifica cuántos documentos muestrea BI Connector al generar su esquema. Un valor de `0` especifica que BI Connector realiza un análisis de colección en todas las `namespaces` muestras. Consulte Muestreo en caché para obtener más información.	`100`
`schema_mapping_mode`	string	Especifica cómo el esquema MongoDB se transforma en un esquema relacional: `lattice`:Consulte Conflictos de tipos de muestreo para obtener más información. `majority`:BI Connector asigna el tipo de datos más común para un campo que aparece en una muestra.	`lattice`
`type_conversion_mode`	string	Especifica la semántica que BI Connector utiliza para las conversiones de tipos, como la función `CAST`. `mysql` `mongosql`	`mongosql`

Configuración de variables del sistema

Debe tener el rol de base de datos atlasAdmin para configurar variables de entorno en un Conector de BI alojado en Atlas. Para configurarlas en un Conector de BI autoadministrado, debe tener el inprog privilegio en la base de datos MongoDB a la que ha conectado el Conector de BI.

Utilice 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 Conector de BI después de configurar una variable del sistema. La conexión utilizada para configurar la variable del sistema no se verá afectada.

Volver

Modelo de autorización de usuario

Problemas conocidos del conector de BI