Guía de inicio rápido: Crea una base de datos y conéctate a ella
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 de
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:
Ir a la base de datos de Firestore
- Haz clic en la base de datos que deseas autenticar.
- En el panel Explorador, haz clic en more_vert 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.
Ir a 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.
Conéctate con 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?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-29 (UTC)
[null,null,["Última actualización: 2025-08-29 (UTC)"],[],[],null,["\u003cbr /\u003e\n\n\n|--------------------------------------------------------|\n| *Relevant to Cloud Firestore Enterprise edition only.* |\n\n\u003cbr /\u003e\n\nLearn how to create a Cloud Firestore with MongoDB compatibility database and connect to it with the\n`mongosh` tool.\n\nBefore you begin\n\n1. If you haven't already, create a Firebase project: In the [Firebase console](//console.firebase.google.com/), click **Add project** , then follow the on-screen instructions to create a Firebase project or to add Firebase services to an existing Google Cloud project.\n2. [Install the `mongosh` tool](https://www.mongodb.com/docs/mongodb-shell/install/)\n\n\u003cbr /\u003e\n\nCreate a Cloud Firestore with MongoDB compatibility database and retrieve the connection string In the Firebase console, create a new Firestore Enterprise edition database. Cloud Firestore with MongoDB compatibility requires Firestore Enterprise edition:\n1. In the Firebase console, go to the **Firestore Database** page.\n\n [Go to Firestore Database](//console.firebase.google.com/project/_/firestore/databases/-default-/data/)\n2. Click the database that you want to authenticate.\n3. In the **Explorer** panel, click more_vert **View more**.\n4. Select **Connect using MongoDB tools**.\n5. Copy the connection string.\n\n\u003cbr /\u003e\n\nThe connection string depends on the UID of the database (system-generated)\nand the location of database: \n\n```text\nUID.LOCATION.firestore.goog\n```\n\nCreate a user for SCRAM authentication\n\nIn the Google Cloud console, create a new database user and assign\nthe user Identity and Access Management permissions.\n\n1. In the Google Cloud console, go to the **Databases** page.\n\n [Go to Databases](https://console.cloud.google.com/firestore/databases)\n2. Select the database from the list of databases.\n3. In the navigation menu, click **Auth**.\n4. Click **Add User**.\n5. Enter a username.\n6. Select an Identity and Access Management role for the user.\n7. Click create. The database creates a user and shows you the user's generated password. **Copy and save this password. You will not be able to retrieve\n this password later.**.\n\nConnect using `mongosh`\n\nUse the connection string, username, and password to connect to your\ndatabase, run `mongosh` locally with the following configuration options. \n\n```gdscript\nmongosh 'mongodb://\u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e:\u003cvar translate=\"no\"\u003ePASSWORD\u003c/var\u003e@\u003cvar translate=\"no\"\u003eCONNECTION_STRING\u003c/var\u003e:443/\u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eUSERNAME\u003c/var\u003e: the name of the database user you created.\n- \u003cvar translate=\"no\"\u003ePASSWORD\u003c/var\u003e: the generated password for the database user you created.\n- \u003cvar translate=\"no\"\u003eCONNECTION_STRING\u003c/var\u003e: the database connection string.\n- \u003cvar translate=\"no\"\u003eDATABASE_ID\u003c/var\u003e: a database ID\n\nOnce connected, you can create and read data, for example: \n\n```text\ndb.pages.insertOne({ message: \"Hello World!\"})\ndb.pages.find({})\nexit\n```\n\nWhat's next\n\n- [See a list of supported features](/docs/firestore/enterprise/supported-data-types-drivers)\n- [Learn about behavior differences in Cloud Firestore with MongoDB compatibility](/docs/firestore/enterprise/behavior-differences)\n- [Learn about additional authentication methods](/docs/firestore/enterprise/connect)"]]