Solo es relevante para la edición Enterprise de Cloud Firestore. |
Aprende a crear una base de datos de Cloud Firestore con compatibilidad con MongoDB y a conectarte a ella con la herramienta mongosh
.
Antes de comenzar
- Si aún no lo hiciste, crea un proyecto de Firebase. Para ello, en Firebase console, haz clic en Agregar proyecto y, luego, sigue las instrucciones en pantalla para crear un proyecto de Firebase o agregar servicios de Firebase a un proyecto de Google Cloud existente.
- Instala la herramienta
mongosh
Crea una base de datos de Cloud Firestore con compatibilidad con MongoDB y recupera la cadena de conexión
En la consola de Firebase, crea una base de datos nueva de la edición de Firestore Enterprise. Cloud Firestore con compatibilidad con MongoDB requiere la edición Enterprise de Firestore:-
En la consola Firebase, ve a la página Base de datos de Firestore:
- Haz clic en la base de datos que deseas autenticar.
- En el panel Explorador, haz clic en Ver más.
- Selecciona Conectarse con las herramientas de MongoDB.
- Copia la cadena de conexión.
La cadena de conexión depende del UID de la base de datos (generado por el sistema) y de la ubicación de la base de datos:
UID.LOCATION.firestore.goog
Crea un usuario para la autenticación SCRAM
En la consola de Google Cloud, crea un usuario de base de datos nuevo y asígnale permisos de Identity and Access Management.
-
En la consola de Google Cloud, ve a la página Bases de datos.
- Selecciona la base de datos de la lista.
- En el menú de navegación, haz clic en Auth.
- Haz clic en Agregar usuario.
- Ingresa un nombre de usuario.
- Selecciona un rol de Identity and Access Management para el usuario.
- Haz clic en Crear. La base de datos crea un usuario y te muestra la contraseña generada. Copia y guarda esta contraseña. No podrás recuperar esta contraseña más adelante.
Conectar a través de mongosh
Usa la cadena de conexión, el nombre de usuario y la contraseña para conectarte a tu base de datos y ejecutar mongosh
de forma local con las siguientes opciones de configuración.
mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'
Reemplaza lo siguiente:
- USERNAME: Es el nombre del usuario de la base de datos que creaste.
- PASSWORD: Es la contraseña generada para el usuario de la base de datos que creaste.
- CONNECTION_STRING: Es la cadena de conexión de la base de datos.
- DATABASE_ID: Es un ID de base de datos.
Una vez que se conecte, podrá crear y leer datos, por ejemplo:
db.pages.insertOne({ message: "Hello World!"}) db.pages.find({}) exit
¿Qué sigue?
- Consulta la lista de funciones compatibles
- Obtén información sobre las diferencias de comportamiento en Cloud Firestore con compatibilidad con MongoDB
- Obtén más información sobre otros métodos de autenticación