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. Verify 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 Otorgar acceso.

    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 uno.
    6. Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega uno más.
    7. Haz clic en Guardar.
  5. Instala la herramienta 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 base de datos nueva 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.

    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?