Guía de inicio rápido: Crea una base de datos y conéctate a ella

Aprende a crear una base de datos de Firestore compatible con MongoDB y a conectarte a ella con la herramienta mongosh.

Antes de comenzar

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: roles/datastore.owner

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. 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.

    4. 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

    1. In the Google Cloud console, go to the IAM page.

      Ir a IAM
    2. Selecciona el proyecto.
    3. Haz clic en Grant access.

    4. En el campo Principales nuevas, ingresa tu identificador de usuario. Esta suele ser la dirección de correo electrónico de una Cuenta de Google.

    5. En la lista Seleccionar un rol, elige un rol.
    6. Para otorgar funciones adicionales, haz clic en Agregar otro rol y agrega cada rol adicional.
    7. Haz clic en Guardar.
  5. Instala la herramienta de mongosh

Crea una base de datos de Firestore compatible con MongoDB y recupera la cadena de conexión

En la consola de Google Cloud , crea una nueva base de datos de la edición de Firestore Enterprise. Firestore compatible con MongoDB requiere la edición empresarial de Firestore:

  1. En la Google Cloud consola, ve a la página Bases de datos.

    Ir a Bases de datos

  2. Haz clic en Crear una base de datos de Firestore.
  3. Ingresa un ID de base de datos.
  4. Selecciona Enterprise Edition.
  5. Selecciona una ubicación para tu base de datos.

  6. Haz clic en Crear base de datos.

    Cuando la base de datos complete la inicialización, la consola abrirá Firestore Studio para tu base de datos.

  7. En la sección Conéctate a Firestore con una herramienta externa 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 los permisos de administración de identidades y accesos.

  1. En la Google Cloud consola, ve a la página Bases de datos.

    Ir a Bases de datos

  2. Selecciona la base de datos de la lista.
  3. En el menú de navegación, haz clic en Auth.
  4. Haz clic en Agregar usuario.
  5. Ingresa un nombre de usuario.
  6. Selecciona un rol de Identity and Access Management para el usuario.
  7. Haz clic en Crear. La base de datos crea un usuario y te muestra la contraseña generada del usuario. 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 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&authMechanismProperties=ENVIRONMENT:gcp,TOKEN_RESOURCE:FIRESTORE&tls=true&retryWrites=false'

Reemplaza lo siguiente:

  • USERNAME: Es el nombre del usuario de la base de datos que creaste.
  • PASSWORD: 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: Un ID de base de datos

Una vez que te conectes, podrás crear y leer datos, por ejemplo:

db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit

Limpia

Para limpiar los recursos que se usan en esta página, borra el usuario de la base de datos y la base de datos.

Borra el usuario de la base de datos

Borra el usuario de la base de datos para quitarlo y los permisos de Identity and Access Management asignados.

  1. En la Google Cloud consola, ve a la página Bases de datos.

    Ir a Bases de datos

  2. Selecciona la base de datos de la lista.
  3. En el menú de navegación, haz clic en Auth.
  4. Haz clic en Acciones en la columna Acciones del usuario que quieres borrar. Haz clic en Borrar usuario. Aparecerá un cuadro de diálogo.
  5. Confirma la eliminación y haz clic en Borrar.
  6. En un diálogo, se muestra un vínculo a la página de IAM. Haz clic en el vínculo para borrar los permisos asignados al usuario de la base de datos.

  7. Busca la fila que contiene el principal cuyo acceso deseas revocar. Luego, haz clic en Editar principal en esa fila.

    El principal del usuario de la base de datos que creaste usa el siguiente formato de nombres:

    principal://firestore.googleapis.com/projects/PROJECT_NUMBER/name/databases/DATABASE_ID/userCreds/USER_ID
  8. Haz clic en el botón Borrar para el rol que deseas revocar y, luego, haz clic en Guardar.

Borra la base de datos

Completa lo siguiente para borrar la base de datos:

  1. En la Google Cloud consola, ve a la página Bases de datos.

    Ir a Bases de datos

  2. Haz clic en Ver más en la columna Acciones de la base de datos que quieres borrar. Haga clic en Borrar. Aparecerá un cuadro de diálogo.

  3. En el cuadro de diálogo ¿Quieres borrar la base de datos?, escribe el ID de la base de datos en el campo de texto para confirmar la eliminación. Haz clic en Borrar. La consola te informa sobre el éxito o el fracaso de la operación.

    Si la operación falla, consulta los detalles de la base de datos y verifica que la protección contra eliminaciones esté inhabilitada. Si quieres inhabilitar la protección contra eliminaciones, consulta Actualiza la configuración de la protección contra eliminaciones.

¿Qué sigue?