Cree un DSN del sistema

• Instala el BI Connector y configúralo para conectarse a tu set de réplicas.

  Nota

  Este requisito previo no se aplica si está utilizando BI Connector para Atlas.

• Descargue e instale Visual C++ Redistributable para Visual Studio.2015

• Descargue e instale el controlador ODBC del conector MongoDB BI.

• Instala el BI Connector y configúralo para conectarse a tu set de réplicas.

  Nota

  Este requisito previo no se aplica si está utilizando BI Connector para Atlas.

• Descargue e instale el controlador ODBC del conector MongoDB BI.

• Instala el BI Connector en Linux basado en Red Hat Enterprise o Linux basado en Debian y configura el conector para conectarse a su set de réplicas.

  Nota

  Este requisito previo no se aplica si está utilizando BI Connector para Atlas.

• Descargue y extraiga el driver de BI Connector de MongoDB para su plataforma.

1. Inicia el programa Microsoft ODBC fuentes de datos.

   Elija la versión del programa (64 bits o 32 bits) que sea adecuada para su sistema y la versión del controlador ODBC.

2. Selecciona la pestaña System DSN.

3. Haga clic en el botón Add.

   

   haga clic para ampliar

4. Selecciona un MongoDB BI Connector ODBC Driver de la lista de drivers disponibles.

   Seleccione cualquiera de los dos MongoDB ODBC ANSI Driver o el MongoDB ODBC Unicode Driver, luego haga clic en OK.

   Nota

   El controlador ODBC ANSI ofrece el máximo rendimiento, pero tiene un conjunto de caracteres limitado. El controlador ODBC Unicode admite un conjunto de caracteres más amplio, pero, por lo tanto, su rendimiento puede ser ligeramente inferior.

5. Rellene los campos necesarios del formulario.

   Haz clic en el botón Details para mostrar la mitad inferior del formulario.

   Los siguientes campos del formulario son obligatorios:

   Nombre de campo	Descripción
   Data Source Name	Un nombre de tu elección.
   TCP/IP Server	Dirección del servidor donde se está ejecutando tu proceso mongosqld. Si tienes habilitado BI Connector en MongoDB Atlas, puedes localizar el nombre del host del servidor que ejecuta el mongosqld en la información de conexión de tu clúster.
   Port	Número de puerto de su proceso mongosqld.
   Database	El nombre de la base de datos a la que conectarse, por ejemplo test.

6. (Opcional) Si la autenticación está habilitada, proporciona información de conexión.

   Los siguientes campos son obligatorios al ejecutar con --auth activado o al conectar a una instancia de BI Connector for Atlas.

   Nombre de campo	Descripción
   User	Nombre de usuario del usuario MongoDB que está autenticado para utilizar su base de datos de destino. Puedes especificar las siguientes opciones de autenticación después de tu nombre de usuario como parámetros de query con estilo URI: Opción de conexión Descripción source Se debe especificar el nombre de la base de datos que almacena las credenciales del usuario. Si no especificas esta opción, el Conector MongoDB para BI tomará por defecto la base de datos actual asociada con la conexión MySQL. Para mecanismos de autenticación como PLAIN (LDAP) o GSSAPI (Kerberos) que delegan el almacenamiento de credenciales en otros servicios, establece el valor source en $external. No es necesario si defaultSource está configurado en el archivo de configuraciónde tu MongoDB Connector for BI. mechanism Especifica el mecanismo que el Connector de MongoDB para BI debe usar para autenticar la conexión. Los valores aceptados incluyen: SCRAM-SHA-1 (por defecto) SCRAM-SHA-256 PLAIN (SASL LDAP) GSSAPI (Kerberos) LDAP y Kerberos requieren MongoDB Enterprise. Configure el origen en $external al usar LDAP o Kerberos. No es necesario si defaultMechanism está configurado en el archivo de configuraciónde tu MongoDB Connector for BI. X.509 no es compatible. Nombre de usuario y contraseña LDAP Kerberos Por ejemplo, para autenticarte como usuario grace usando la base de datos admin y el mecanismo de autenticación desafío y Response (SCRAM-SHA-1), escribe el nombre de usuario en este formato: grace?source=admin Por ejemplo, para autenticarse como usuario grace con el mecanismo de autenticación LDAP (PLAIN), escribe el nombre de usuario en este formato: grace?mechanism=PLAIN&source=$external Por ejemplo, para autenticarse como el usuario grace en el EXAMPLE.COM realm Kerberos de Kerberos con el mecanismo de autenticación de Kerberos, escribe el nombre de usuario en este formato: grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external Para obtener más información sobre la configuración de Kerberos, consulte Configurar Kerberos para BI Connector.
   Password	La contraseña del usuario autenticado. No puedes usar llaves ({ }) en tu contraseña de base de datos porque son caracteres especiales en el driver ODBC.
   Authentication	El método de autenticación por defecto. Al utilizar el driver ODBC de MongoDB BI Connector, este campo no es obligatorio. Para usar el plugin de autenticación junto con otro driver ODBC, complete este campo con la string mongosql_auth.

7. (Opcional) Si TLS/SSL está habilitado, rellene los campos del formulario TLS/SSL.

   Acceda a los campos del formulario TLS/SSL haciendo clic en Details >> y luego en la pestaña SSL. Los siguientes parámetros están disponibles y pueden ser requeridos, dependiendo de tu configuración de TLS/SSL:

   Nombre de campo	Descripción
   SSL Key	La ubicación del archivo de clave cliente/servidor.
   SSL Cert	La ubicación del archivo de certificado cliente/servidor.
   SSL CA File	La ubicación del archivo que contiene una lista de autoridades certificadoras de confianza.
   SSL Cipher	La ubicación del archivo que contiene una lista de cifrados permitidos.
   SSL Mode	Configurar en REQUIRED para requerir un canal cifrado. Si no se proporciona un canal encriptado, la conexión fallará.
   RSA Public Key	La ubicación del archivo PEM que contiene la clave pública RSA.

   Nota

   El BI Connector para Atlas utiliza TLS/SSL, pero no requiere que ninguna configuración de TLS/SSL sea configurada en el DSN de tu sistema.

8. Haz clic en el botón Test para probar la conexión ODBC.

   Si la conexión es exitosa, haga clic en OK para agregar el DSN. Si la conexión falla, verifique que su usuario de MongoDB esté autenticado correctamente para la base de datos indicada en la conexión.

1. Lanza el Administrador ODBC.

   Nota

   ODBC administrador se incluye con el driver ODBC del BI Connector de MongoDB.

   Importante

   La edición 1.0.16 del Administrador de ODBC incluida con el Conector ODBC de BI Connector de MongoDB no es compatible con macOS Catalina ni con versiones posteriores de macOS. Si estás en Catalina o una versión posterior de macOS, descarga e instala la última versión (1.0.19) del administrador de ODBC.

2. Hacer clic en System DSN, luego hacer clic en Add.

   

3. Selecciona un MongoDB BI Connector ODBC Driver de la lista de drivers disponibles.

   Selecciona ya sea el driver MongoDB ANSI ODBC o el driver MongoDB Unicode ODBC, y luego haz clic en OK.

   Nota

   El controlador ODBC ANSI ofrece el máximo rendimiento, pero tiene un conjunto de caracteres limitado. El controlador ODBC Unicode admite un conjunto de caracteres más amplio, pero, por lo tanto, su rendimiento puede ser ligeramente inferior.

4. Introduce un Data Source Name (DSN).

   Opcionalmente, introduzca un Description.

   Nota

   No cierre la ventana de configuración. Continúe con el siguiente paso.

5. Agrega las palabras clave necesarias.

   1. Agregue un par de valores de palabras clave haciendo clic en el botón Add.

   2. Modifique el Keyword haciendo doble clic sobre él, ingresando la palabra clave deseada y luego presionando Enter.

   3. Modifique el Value haciendo doble clic sobre él, ingresando la palabra clave deseada y luego presionando Enter.

   Utilizando el procedimiento anterior, agrega las siguientes palabras clave:

   Keyword	Valor
   Server	El nombre de host o dirección IP del host del Connector de MongoDB para BI. IMPORTANTE: Usa 127.0.0.1 para conectar mediante TCP a localhost. Si especificas un valor diferente de una dirección IP, el BI Connector intenta conectar usando un socket Unix.
   Puerto	El IANA número de puerto para MongoDB Connector for BI. El valor por defecto es 3307.
   DATABASE	La base de datos a usar después de conectarte. Debes usar esta palabra clave al conectarte con Microsoft Excel.

   Para obtener la lista completa de parámetros ODBC, consulta Parámetros de conexión Connector/ODBC.

   Por ejemplo, la configuración de tu DSN de usuario debería verse similar a lo siguiente:

   

   Nota

   No cierre la ventana de configuración. Continúe con el siguiente paso.

6. (Opcional) Si la autenticación está habilitada, agregue las palabras clave de autenticación.

   1. Agregue un par de valores de palabras clave haciendo clic en el botón Add.

   2. Modifique el Keyword haciendo doble clic sobre él, ingresando la palabra clave deseada y luego presionando Enter.

   3. Modifique el Value haciendo doble clic sobre él, ingresando la palabra clave deseada y luego presionando Enter.

   Utilizando el procedimiento anterior, agrega las siguientes palabras clave:

   Keyword	Valor
   UID	El nombre de usuario del usuario que puede acceder al Conector activo de MongoDB para la base de datos BI. Puedes especificar las siguientes opciones de autenticación después de tu nombre de usuario como parámetros de query con estilo URI: Opción de conexión Descripción source Se debe especificar el nombre de la base de datos que almacena las credenciales del usuario. Si no especificas esta opción, el Conector MongoDB para BI tomará por defecto la base de datos actual asociada con la conexión MySQL. Para mecanismos de autenticación como PLAIN (LDAP) o GSSAPI (Kerberos) que delegan el almacenamiento de credenciales en otros servicios, establece el valor source en $external. No es necesario si defaultSource está configurado en el archivo de configuraciónde tu MongoDB Connector for BI. mechanism Especifica el mecanismo que el Connector de MongoDB para BI debe usar para autenticar la conexión. Los valores aceptados incluyen: SCRAM-SHA-1 (por defecto) SCRAM-SHA-256 PLAIN (SASL LDAP) GSSAPI (Kerberos) LDAP y Kerberos requieren MongoDB Enterprise. Configure el origen en $external al usar LDAP o Kerberos. No es necesario si defaultMechanism está configurado en el archivo de configuraciónde tu MongoDB Connector for BI. X.509 no es compatible. Nombre de usuario y contraseña LDAP Kerberos Por ejemplo, para autenticarte como usuario grace usando la base de datos admin y el mecanismo de autenticación desafío y Response (SCRAM-SHA-1), escribe el nombre de usuario en este formato: grace?source=admin Por ejemplo, para autenticarse como usuario grace con el mecanismo de autenticación LDAP (PLAIN), escribe el nombre de usuario en este formato: grace?mechanism=PLAIN&source=$external Por ejemplo, para autenticarse como el usuario grace en el EXAMPLE.COM realm Kerberos de Kerberos con el mecanismo de autenticación de Kerberos, escribe el nombre de usuario en este formato: grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external Para obtener más información sobre la configuración de Kerberos, consulte Configurar Kerberos para BI Connector.
   PWD	La contraseña asociada con UID. No puedes usar llaves ({ }) en tu contraseña de base de datos porque son caracteres especiales en el driver ODBC.

   Para obtener la lista completa de parámetros ODBC, consulta Parámetros de conexión Connector/ODBC.

   Por ejemplo, la configuración de tu DSN de usuario debería verse similar a lo siguiente:

   

7. (Opcional) Si TLS/SSL está habilitado, agregue las palabras clave TLS/SSL.

   1. Agregue un par de valores de palabras clave haciendo clic en el botón Add.

   2. Modifique el Keyword haciendo doble clic sobre él, ingresando la palabra clave deseada y luego presionando Enter.

   3. Modifique el Value haciendo doble clic sobre él, ingresando la palabra clave deseada y luego presionando Enter.

   Nota

   El BI Connector para Atlas utiliza TLS/SSL, pero no requiere que ninguna configuración de TLS/SSL sea configurada en el DSN de tu sistema.

   Usa el procedimiento anterior, para adicionar las siguientes palabras clave dependiendo de la configuración TLS/SSL:

   Keyword	Valor
   SSLKEY	La ruta al archivo .pem archivo clave.
   SSLCERT	La ruta al certificado SSL.
   SSLMODE	Se debe establecer en REQUIRED.
   SSLCA	La ruta al archivo de la autoridad certificadora SSL.
   SSLCIPHER	La ruta al archivo que contiene una lista de cifrados permitidos.
   RSAKEY	La ruta al archivo PEM que contiene la clave pública RSA.
   ENABLE_CLEARTEXT_PLUGIN	Establezca en 1 para habilitar la autenticación de texto sin formato.

   Nota

   Si se conecta con Microsoft Excel, los certificados deben estar ubicados en el directorio /Library/ODBC/.

   Para obtener la lista completa de parámetros ODBC, consulta Parámetros de conexión Connector/ODBC.

   Por ejemplo, la configuración de tu DSN de usuario debería verse similar a lo siguiente:

   

8. Haz clic en OK para terminar de crear el DSN.

El siguiente procedimiento se ha probado con Ubuntu y RHEL, y debería funcionar de manera similar con otras distribuciones de Linux.

[MongoDBODBC]
DESCRIPTION = ODBC for MongoDB BI Connector
DRIVER      = /usr/local/lib/libmdbodbcw.so
TRACE       = Off
TRACEFILE   = stderr
READONLY    = yes
SERVER      = <server address>
PORT        = <port number>
USER        = <username>
PASSWORD    = <password>
DATABASE    = <dbname>
; optional SSL configuration
SSLKEY      = </path/to/.pem-key-file>
SSLCERT     = </path/to/ssl-certificate>
SSLMODE     = DISABLED|PREFERRED|REQUIRED
SSLCA       = </path/to/ssl-ca-list-file>
SSLCAPATH   = </path/to/ssl-ca-file-directory>
SSLCIPHER   = </path/to/ssl-cipher-file>
RSAKEY      = </path/to/rsa-public-key-file>

sudo apt-get install unixodbc

sudo yum install unixODBC

iusql -v MongoDBODBC

SQL> use test;
SQL> show tables;