Guía de inicio rápido: Crear una base de datos y conectarse a ella
Consulta cómo crear una base de datos de Firestore con compatibilidad con MongoDB y conectarte a ella con la herramienta mongosh
.
Antes de empezar
-
In the Google Cloud console, go to the project selector page.
-
Select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Make sure that you have the following role or roles on the project: Cloud Datastore Owner
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
- For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Ir a IAM - Selecciona el proyecto.
- Haz clic en Conceder acceso.
-
En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.
- En la lista Selecciona un rol, elige un rol.
- Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
- Haz clic en Guardar.
- Instalar la herramienta
mongosh
Crear una base de datos de Firestore con compatibilidad con MongoDB y obtener la cadena de conexión
En la consola de Google Cloud , crea una base de datos de la edición Enterprise de Firestore. Para usar Firestore con compatibilidad con MongoDB, necesitas la edición Enterprise de Firestore:-
En la Google Cloud consola, ve a la página Bases de datos.
- Haz clic en Crear una base de datos de Firestore.
- Introduce un ID de base de datos.
- Selecciona Enterprise Edition.
- Selecciona una ubicación para tu base de datos.
Haz clic en Crear base de datos.
Cuando la base de datos termine de inicializarse, la consola abrirá Firestore Studio para tu base de datos.
-
En la sección Conectarse a Firestore mediante una herramienta externa de MongoDB, copie 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
Crear un usuario para la autenticación SCRAM
En la Google Cloud consola, crea un usuario de base de datos y asigna los permisos de gestión de identidades y accesos.
-
En la Google Cloud consola, 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 Autenticación.
- Haz clic en Add User (Añadir usuario).
- Introduce un nombre de usuario.
- Selecciona un rol de Gestión de Identidades y Accesos 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..
Conectarse con
mongosh
Usa la cadena de conexión, el nombre de usuario y la contraseña para conectarte a tu base de datos y ejecuta
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'
Haz los cambios siguientes:
- USERNAME: el nombre del usuario de la base de datos que has creado.
- PASSWORD: la contraseña generada para el usuario de la base de datos que has creado.
- CONNECTION_STRING: la cadena de conexión de la base de datos.
- DATABASE_ID: un ID de base de datos
Una vez que se haya conectado, podrá crear y leer datos. Por ejemplo:
db.pages.insertOne({ message: "Hello World!"}) db.pages.find({}) exit
Siguientes pasos
- Consulta una lista de las funciones admitidas.
- Información sobre las diferencias de comportamiento en Firestore con compatibilidad con MongoDB
- Información sobre métodos de autenticación adicionales
-