Skip to main content

Cadenas de conexión avanzadas de MongoDB

Para la persistencia del controlador y de la interfaz de usuario de Alteryx Server puedes utilizar cadenas de conexión avanzadas para conectarte a MongoDB. Utiliza cadenas de conexión avanzadas si necesitas ayuda con lo siguiente:

  • TLS/SSL

  • Conjuntos de réplicas

  • Fragmentación

  • MongoDB Atlas

Importante

Si usabas conjuntos de réplicas antes de que la opción de cadena de conexión estuviera disponible (versión 2020.1), debes cambiar a una cadena de conexión.

Cadenas de conexión únicas para los trabajadores

Cada trabajador puede tener una cadena de conexión única que determina cómo se conecta a la base de datos. Esto permite que los nodos de trabajador remotos utilicen conexiones que difieren del controlador para definir credenciales u opciones específicas de un trabajador en particular.

Para definir cadenas de conexión únicas para un trabajador:

  1. Inicia sesión en el trabajador para el que deseas establecer una cadena de conexión MongoDB diferente a la de controlador.

  2. Abre el símbolo del sistema o PowerShell (como administrador).

  3. En el símbolo del sistema, ve a C:\Program Files\Alteryx\bin.

  4. Ingresa este comando: AlteryxService.exe setmongoconnectionworker="{mongoConnectionString}".

  5. Sustituye {mongoConnectionString} por la cadena de conexión adecuada para tu entorno. Esta cadena de conexión debe conectarse a la misma base de datos que tu controlador. Desplázate hacia abajo para ver ejemplos de varios formatos de cadena de conexión en la sección Ejemplos de persistencia del controlador.

  6. Para aplicar la configuración, reinicia el servicio Alteryx:

    1. Navega hasta la aplicación de servicios de Windows en tu equipo.

    2. Busca el servicio llamado AlteryxService.

    3. Selecciona el botón Reiniciar el servicio.

Sugerencias y ejemplos de cadenas de conexión

  • Los parámetros de cadenas de conexión compatibles dependen del controlador. Para utilizarlos en una cadena de conexión, los parámetros deben ser compatibles con todos los controladores admitidos que se enumeran a continuación. Las versiones de controladores compatibles incluyen las siguientes opciones:

    • c 1.17 (mongoc)

    • c++ 3.6 (mongocxx)

    • c# 2.12 (mongoc#)

  • Los caracteres especiales de los nombres de usuario, contraseñas o valores de parámetros deben estar codificados con URL.

Ve a la documentación de Cadena de conexión de MongoDB a fin de obtener ayuda para formatear la cadena de conexión.

Ejemplo local (on-premise) de un solo nodo con SSL/TLS:

mongodb://username:P%40ssw0rd@hostname.domain.tld:27017/AlteryxService?authSource=databasename&ssl=true

Ejemplo local (on-premise) de conjunto de réplicas con SSL/TLS:

mongodb://username:P%40ssw0rd@host01.domain.tld:27017,host02.domain.tld:27017,host03.domain.tld:27017/AlteryxService?authSource=databasename&replicaSet=rs0&ssl=true

Ejemplo de Atlas:

mongodb+srv://username:P%40ssw0rd@host-0-1mngx.mongodb.net/AlteryxService?retryWrites=true&w=majority

Ejemplo local (on-premise) de un solo nodo con SSL/TLS:

mongodb://username:P%40ssw0rd@hostname.domain.tld:27017/AlteryxGallery?authSource=databasename&ssl=true

Ejemplo local (on-premise) de conjunto de réplicas con SSL/TLS:

mongodb://username:P%40ssw0rd@host01.domain.tld:27017,host02.domain.tld:27017,host03.domain.tld:27017/AlteryxGallery?authSource=databasename&replicaSet=rs0&ssl=true

Ejemplo de Atlas:

mongodb+srv://username:P%40ssw0rd@host-0-1mngx.mongodb.net/AlteryxGallery?retryWrites=true&w=majority

Ejemplo local (on-premise) de un solo nodo con SSL/TLS:

mongodb://username:P%40ssw0rd@hostname.domain.tld:27017/AlteryxGallery_Lucene?authSource=databasename&ssl=true

Ejemplo local (on-premise) de conjunto de réplicas con SSL/TLS:

mongodb://username:P%40ssw0rd@host01.domain.tld:27017,host02.domain.tld:27017,host03.domain.tld:27017/AlteryxGallery_Lucene?authSource=databasename&replicaSet=rs0&ssl=true

Ejemplo de Atlas:

mongodb+srv://username:P%40ssw0rd@host-0-1mngx.mongodb.net/AlteryxGallery_Lucene?retryWrites=true&w=majority