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 con compatibilidad 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: Cloud 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

    6. Crea una base de datos de Firestore con compatibilidad 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 con compatibilidad con MongoDB requiere la edición Enterprise de Firestore:

    1. En la consola de Google Cloud , 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 la 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 se complete la inicialización de la base de datos, 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 permisos de Identity and Access Management.

    1. En la consola de Google Cloud , 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. 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

    Limpia

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

    Borra el usuario de la base de datos

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

    1. En la consola de Google Cloud , 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 deseas 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.

      La principal del usuario de la base de datos que creaste usa el siguiente formato de nombre:

      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 los siguientes pasos para borrar la base de datos:

    1. En la consola de Google Cloud , 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 quieras 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?