Cree un DSN del sistema

• Instale el conector de BI y configúrelo para conectarse a su conjunto 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.

• Instale el conector de BI y configúrelo para conectarse a su conjunto 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.

• Instale el conector de BI en Linux basado en Red Hat Enterprise o Linux basado en Debian y configúrelo para conectarse a su conjunto de réplicas.

  Nota

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

• Descargue y extraiga el controlador ODBC del conector MongoDB BI para su plataforma.

1. Inicie el programa Orígenes de datos ODBC de Microsoft.

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

2. Seleccione la pestaña System DSN.

3. Haga clic en el botón Add.

   

   haga clic para ampliar

4. Seleccione un controlador ODBC de MongoDB BI Connector de la lista de controladores 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. Llene los campos necesarios del formulario.

   Haga clic en el botón Details para exponer 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 mongosqld proceso.
   Database	El nombre de la base de datos a la que conectarse, por ejemplo test.

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

   Los siguientes campos son obligatorios cuando se ejecuta con habilitado o cuando se conecta a una instancia de BI Connector para --auth Atlas.

   Nombre de campo	Descripción
   User	Nombre de usuario del usuario MongoDB que está autenticado para utilizar su base de datos de destino. Puede especificar las siguientes opciones de autenticación después de su nombre de usuario como parámetros de consulta de estilo URI: Opción de conexión Descripción source Especifique el nombre de la base de datos que almacena las credenciales del usuario. Si no especifica esta opción, el Conector MongoDB para BI usará de forma predeterminada la base de datos actual asociada a la conexión MySQL. Para los mecanismos de autenticación como PLAIN (LDAP) o GSSAPI (Kerberos) que delegan el almacenamiento de credenciales a otros servicios, establezca el valor source en $external. No es necesario si defaultSource está configurado en el archivo de configuración de MongoDB Connector para BI. mechanism Especifique el mecanismo que el Conector 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ón de MongoDB Connector para BI. X.509 no es compatible. Nombre de usuario y contraseña LDAP Kerberos Por ejemplo, para autenticarse como usuario grace utilizando la base de datos admin y el mecanismo de autenticación de Desafío y Respuesta (SCRAM-SHA-1), escriba 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 escriba el nombre de usuario en este formato: grace?mechanism=PLAIN&source=$external Por ejemplo, para autenticarse como usuario grace en el EXAMPLE.COM dominio Kerberos con el mecanismo de autenticación Kerberos, escriba 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 predeterminado. Al usar el controlador ODBC del Conector MongoDB BI, este campo no es obligatorio. Para utilizar el complemento de autenticación junto con otro controlador ODBC, complete este campo con la mongosql_auth cadena.

7. (Opcional) Si TLS/SSL está habilitado, complete 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 de certificación de confianza.
   SSL Cipher	La ubicación del archivo que contiene una lista de cifrados permitidos.
   SSL Mode	Establézcalo en REQUIRED para requerir un canal cifrado. Si no se proporciona un canal cifrado, la conexión falla.
   RSA Public Key	La ubicación del archivo PEM que contiene la clave pública RSA.

   Nota

   El conector de BI para Atlas utiliza TLS/SSL pero no requiere que se configure ninguna configuración de TLS/SSL en el DSN de su sistema.

8. Haga 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. Inicie el Administrador ODBC.

   Nota

   El administrador ODBC está incluido con el controlador ODBC del conector MongoDB BI.

   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. Seleccione un controlador ODBC de MongoDB BI Connector de la lista de controladores 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. Añade 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
   SERVIDOR	El nombre de host o dirección IP del host del Connector de MongoDB para BI. IMPORTANTE: Use 127.0.0.1 para conectarse mediante TCP al host local. Si especifica un valor distinto de una dirección IP, el Conector de BI intentará conectarse mediante un socket Unix.
   PUERTO	El número de puerto IANApara el conector MongoDB para BI. El valor predeterminado 3307 es.
   DATABASE	La base de datos a utilizar después de la conexión. Debe utilizar esta palabra clave al conectarse con Microsoft Excel.

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

   Por ejemplo, la configuración de DSN de su usuario debería verse similar a la 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 a la base de datos activa del Conector MongoDB para BI. Puede especificar las siguientes opciones de autenticación después de su nombre de usuario como parámetros de consulta de estilo URI: Opción de conexión Descripción source Especifique el nombre de la base de datos que almacena las credenciales del usuario. Si no especifica esta opción, el Conector MongoDB para BI usará de forma predeterminada la base de datos actual asociada a la conexión MySQL. Para los mecanismos de autenticación como PLAIN (LDAP) o GSSAPI (Kerberos) que delegan el almacenamiento de credenciales a otros servicios, establezca el valor source en $external. No es necesario si defaultSource está configurado en el archivo de configuración de MongoDB Connector para BI. mechanism Especifique el mecanismo que el Conector 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ón de MongoDB Connector para BI. X.509 no es compatible. Nombre de usuario y contraseña LDAP Kerberos Por ejemplo, para autenticarse como usuario grace utilizando la base de datos admin y el mecanismo de autenticación de Desafío y Respuesta (SCRAM-SHA-1), escriba 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 escriba el nombre de usuario en este formato: grace?mechanism=PLAIN&source=$external Por ejemplo, para autenticarse como usuario grace en el EXAMPLE.COM dominio Kerberos con el mecanismo de autenticación Kerberos, escriba 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, consulte Parámetros de conexión ODBC/Conector.

   Por ejemplo, la configuración de DSN de su usuario debería verse similar a la 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 conector de BI para Atlas utiliza TLS/SSL pero no requiere que se configure ninguna configuración de TLS/SSL en el DSN de su 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 autoridad del certificado 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, consulte Parámetros de conexión ODBC/Conector.

   Por ejemplo, la configuración de DSN de su usuario debería verse similar a la 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;