Conexión a una instancia de conjunto de réplicas mediante Mongo Shell
Mongo shell es el cliente por defecto para el servidor de base de datos MongoDB. Puede utilizar Mongo Shell para conectarse a instancias de base de datos y consultar, actualizar y gestionar datos en bases de datos. Para usar Mongo Shell, descargue e instale primero el cliente MongoDB y, a continuación, use el shell Mongo para conectarse a la instancia de base de datos.
De forma predeterminada, una instancia DDS proporciona una dirección IP privada. Si sus aplicaciones se implementan en un ECS y están en la misma región y VPC que las instancias DDS, puede conectarse a las instancias DDS mediante una dirección IP privada para lograr una velocidad de transmisión rápida y una alta seguridad.
En esta sección se describe cómo utilizar Mongo Shell para conectarse a una instancia de conjunto de réplicas a través de una red privada.
El cliente MongoDB puede conectarse a una instancia con una conexión no cifrada o una conexión cifrada (SSL). Para mejorar la seguridad de la transmisión de datos, conéctese a instancias mediante SSL.
Prerrequisitos
- Para obtener más información acerca de cómo crear e iniciar sesión en un ECS, consulte Comprar un ECS e iniciar sesión en un ECS.
- Instale el cliente MongoDB en el ECS. Para garantizar la autenticación correcta, instale el cliente MongoDB de la misma versión que la instancia de destino.
Para obtener más información sobre cómo instalar un cliente MongoDB, consulte ¿Cómo puedo instalar un cliente MongoDB?
- El ECS puede comunicarse con la instancia DDS. Para más detalles, consulte Configuración de reglas de grupo de seguridad.
Conexión de SSL
Si se conecta a una instancia a través de la conexión SSL, habilite SSL primero. De lo contrario, se notifica un error. Para obtener más información sobre cómo habilitar SSL, consulte Habilitación y deshabilitación de SSL.
- Inicie sesión en la consola de gestión.
- Haga clic
en la esquina superior izquierda y seleccione una región y un proyecto. - Haga clic
en la esquina superior izquierda de la página y elija Databases > Document Database Service. - En la página Instance Management, haga clic en el nombre de instancia.
- En el panel de navegación de la izquierda, elija Connections.
- En el área Basic Information, haga clic en
junto al campo SSL. - Cargue el certificado root al ECS para conectarse a la instancia.
A continuación se describe cómo cargar el certificado en un ECS de Linux y Windows:
- En Linux, ejecute el siguiente comando:
scp<IDENTITY_FILE><REMOTE_USER>@<REMOTE_ADDRESS>:<REMOTE_DIR>
- IDENTITY_FILE es el directorio donde reside el certificado root. El permiso de acceso al archivo es 600.
- REMOTE_USER es el usuario del sistema operativo ECS.
- REMOTE_ADDRESS es la dirección ECS.
- REMOTE_DIR es el directorio del ECS al que se carga el certificado root.
- En Windows, cargue el certificado root mediante una herramienta de conexión remota.
- En Linux, ejecute el siguiente comando:
- Conéctese a una instancia DDS.
Método 1: Conexión de alta disponibilidad (recomendado)
DDS proporciona la dirección de conexión HA. El uso de esta dirección para conectarse a una instancia de conjunto de réplicas mejora el rendimiento de lectura/escritura de datos y evita que se notifiquen errores cuando se escriben datos desde el cliente después de una conmutación principal/en espera.
Comando de ejemplo:
./mongo "<Private HA connection address>" --ssl --sslCAFile<FILE_PATH> --sslAllowInvalidHostnames
Descripción de parámetros:
- Dirección de conexión privada HA
En la página Instance Management, haga clic en la instancia para ir a la página Basic Information. Elija Connections . La dirección de conexión de la instancia actual se muestra en el campo Private HA Connection Address. El formato de la dirección no se puede cambiar.
Figura 1 Obtención de la dirección de conexión HA privada
El formato de la dirección de conexión HA privada obtenida es el siguiente:
mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica
Preste atención a los siguientes parámetros en la dirección HA privada:
Tabla 1 Descripción del parámetro Parámetro
Descripción
rwuser
Nombre de cuenta, es decir, el nombre de usuario de la base de datos.
<password>
Contraseña para la cuenta de la base de datos. Reemplácelo con la contraseña real.
Si la contraseña contiene signos (@), signos de exclamación o signos de porcentaje (%), reemplácelos con códigos URL hexadecimales (ASCII) %40, %21 y %25 respectivamente.
Por ejemplo, si la contraseña es de ****@ %***!, el código URL correspondiente es de **** %40%25*** %21.
192.168.xx.xx:8635,192.168.xx.xx:8635
Dirección IP y puerto del nodo de la instancia del conjunto de réplicas
test
Nombre de la base de datos
authSource=admin&replicaSet=replica
- authSource debe configurarse como admin. El formato de esta dirección es fijo y no se puede cambiar.
- replica en replicaSet=replica es el nombre de un conjunto de réplicas. El nombre de un conjunto de réplicas DDS es fijo y no se puede cambiar.
NOTA:Si utiliza una base de datos definida por el usuario para la verificación, cambie la base de datos de autenticación en la dirección de conexión HA por el nombre de la base de datos creada.
- FILE_PATH es la ruta para almacenar el certificado root.
- --sslAllowInvalidHostnames: El certificado del conjunto de réplicas se genera utilizando la dirección IP de gestión interna para garantizar que la comunicación interna no ocupe recursos como la dirección IP del usuario y el ancho de banda. --sslAllowInvalidHostnames es necesario para la conexión SSL a través de una red privada.
Ejemplo de comandos:
./mongo "mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica" --ssl --sslCAFile/tmp/ca.crt --sslAllowInvalidHostnames
- Si se conecta a una instancia a través de una dirección HA privada, agregue comillas dobles antes y después de la información de conexión.
- Para obtener más información sobre la conexión HA, consulte Conexión a una instancia de conjunto de réplicas para separación de lectura y escritura y alta disponibilidad.
Si se muestra la siguiente información, la instancia se conecta correctamente:replica:PRIMARY>
Método 2: Conectarse a un solo nodo.
También puede utilizar la dirección IP privada de un nodo primario o secundario para acceder a la instancia del conjunto de réplicas. Este método afecta al rendimiento de lectura/escritura cuando se produce una conmutación primaria/en espera.
Comando de ejemplo:
./mongo --host <DB_HOST> --port <DB_PORT> -u <DB_USER> -p --authenticationDatabase admin --ssl --sslCAFile<FILE_PATH> --sslAllowInvalidHostnames
Descripción de parámetros:
- DB_HOST es la dirección IP privada del nodo primario o en espera de la instancia que se va a conectar.
Nodo primario: Puede leer y escribir datos en él.
Nodo secundario: Solo puede leer datos de él.
En la página Instance Management, haga clic en la instancia para ir a la página Basic Information. Elija Connections. En la pestaña Private Connection, obtenga la dirección IP del nodo correspondiente.
Figura 2 Obtención de la dirección IP de un nodo
- DB_PORT es el puerto de la base de datos. El valor predeterminado es 8635.
Puede hacer clic en la instancia para ir a la página Basic Information. En el panel de navegación de la izquierda, elija Connections. En la página mostrada, haga clic en la pestaña Private Connection y obtenga el puerto del Database Port en el área Basic Information.
Figura 3 Obtención del puerto
- DB_USER es el usuario de la base de datos. El valor predeterminado es rwuser.
- FILE_PATH es la ruta para almacenar el certificado root.
- --sslAllowInvalidHostnames: El certificado del conjunto de réplicas se genera utilizando la dirección IP de gestión interna para garantizar que la comunicación interna no ocupe recursos como la dirección IP del usuario y el ancho de banda. --sslAllowInvalidHostnames es necesario para la conexión SSL a través de una red privada.
Introduzca la contraseña de la cuenta de la base de datos cuando se le solicite:
Enter password:
Ejemplo de comandos:
./mongo --host 192.168.xx.xx --port 8635 -u rwuser -p --authenticationDatabase admin --ssl --sslCAFile /tmp/ca.crt --sslAllowInvalidHostnames
Si se muestra la siguiente información, el nodo correspondiente se conecta correctamente:
- El nodo principal del conjunto de réplicas está conectado.
replica:PRIMARY>
- El nodo en espera del conjunto de réplicas está conectado.
replica:SECONDARY>
- Dirección de conexión privada HA
Conexión sin encriptar
Si se conecta a una instancia a través de una conexión no cifrada, deshabilite SSL primero. De lo contrario, se notifica un error. Para obtener más información sobre cómo deshabilitar SSL, consulte Habilitación y deshabilitación de SSL.
- Inicie sesión en el ECS.
- Conéctese a una instancia DDS.
Método 1: Conexión de alta disponibilidad (recomendado)
DDS proporciona la dirección de conexión HA. El uso de esta dirección para conectarse a una instancia de conjunto de réplicas mejora el rendimiento de lectura/escritura y evita que se notifiquen errores cuando se escriben datos desde el cliente después de una conmutación principal/en espera.
Comando de ejemplo:
./mongo "<Private HA Connection Address>"
Descripción de parámetros:
Private HA Connection Address: En la página Instance Management, haga clic en el nombre de la instancia. Se muestra Basic Information. Elija Connections . La dirección de conexión de la instancia actual se muestra en el campo Private HA Connection Address. El formato de la dirección no se puede cambiar.
Figura 4 Obtención de la dirección de conexión HA privada
El formato de la dirección de conexión HA privada obtenida es el siguiente:
mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica
Preste atención a los siguientes parámetros en la dirección HA privada:
Tabla 2 Descripción del parámetro Parámetro
Descripción
rwuser
Nombre de cuenta, es decir, el nombre de usuario de la base de datos.
<password>
Contraseña para la cuenta de la base de datos. Reemplácelo con la contraseña real.
Si la contraseña contiene signos (@), signos de exclamación o signos de porcentaje (%), reemplácelos con códigos URL hexadecimales (ASCII) %40, %21 y %25 respectivamente.
Por ejemplo, si la contraseña es de ****@ %***!, el código URL correspondiente es de **** %40%25*** %21.
192.168.xx.xx:8635,192.168.xx.xx:8635
Dirección IP y puerto del nodo de la instancia del conjunto de réplicas
test
Nombre de la base de datos
authSource=admin&replicaSet=replica
- authSource debe configurarse como admin. El formato de esta dirección es fijo y no se puede cambiar.
- replica en replicaSet=replica es el nombre de un conjunto de réplicas. El nombre de un conjunto de réplicas DDS es fijo y no se puede cambiar.
NOTA:Si utiliza una base de datos definida por el usuario para la verificación, cambie la base de datos de autenticación en la dirección de conexión HA por el nombre de la base de datos creada.
Ejemplo de comandos:
./mongo "mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica"
Si se muestra la siguiente información, la instancia se conecta correctamente:replica:PRIMARY>
Método 2: Conectarse a un solo nodo.
También puede utilizar la dirección IP privada de un nodo primario o secundario para acceder a la instancia del conjunto de réplicas. Este método afecta al rendimiento de lectura/escritura cuando se produce una conmutación primaria/en espera.
Comando de ejemplo:
./mongo --host <DB_HOST> --port <DB_PORT> -u <DB_USER> -p --authenticationDatabase admin
Descripción de parámetros:
- DB_HOST es la dirección IP privada del nodo primario o en espera de la instancia que se va a conectar.
Nodo primario: Puede leer y escribir datos en él.
Nodo secundario: Solo puede leer datos de él.
En la página Instance Management, haga clic en la instancia para ir a la página Basic Information. Elija Connections. En la pestaña Private Connection, obtenga la dirección IP del nodo correspondiente.
Figura 5 Obtención de la dirección IP de un nodo
- DB_PORT es el puerto de la base de datos. El valor predeterminado es 8635.
Puede hacer clic en la instancia para ir a la página Basic Information. En el panel de navegación de la izquierda, elija Connections. En la página mostrada, haga clic en la pestaña Private Connection y obtenga el puerto del Database Port en el área Basic Information.
Figura 6 Obtención del puerto
- DB_USER es el usuario de la base de datos. El valor predeterminado es rwuser.
Ejemplo de comandos:
./mongo --host 192.168.xx.xx --port 8635 -u rwuser -p --authenticationDatabase admin
Introduzca la contraseña de la cuenta de la base de datos cuando se le solicite:
Enter password:
Si se muestra la siguiente información, el nodo correspondiente se conecta correctamente:
- El nodo principal del conjunto de réplicas está conectado.
replica:PRIMARY>
- El nodo en espera del conjunto de réplicas está conectado.
replica:SECONDARY>
