Accede a tu base de datos

En esta página, se describe cómo acceder a la base de datos de Firestore en modo Datastore desde diferentes plataformas, cómo habilitar la facturación y cómo establecer un límite de gasto.

Antes de comenzar

En esta página, se da por sentado que ya creaste una base de datos en modo Datastore. Para crear una base de datos, completa la guía de inicio rápido de Firestore en modo Datastore.

Accede a tu base de datos desde App Engine

A fin de comenzar con el modo Datastore y App Engine, consulta una de las siguientes páginas específicas para cada lenguaje:

Entorno estándar de App Engine Entorno flexible de App Engine

Permisos del modo Datastore para App Engine

Las apps de App Engine pueden acceder a una base de datos en modo Datastore en el mismo proyecto de forma predeterminada. Cada app de App Engine usa una cuenta de servicio predeterminada de App Engine para administrar el acceso a los servicios de GCP, como Firestore. Por defecto, la cuenta de servicio predeterminada de App Engine tiene la función de IAM de editor de proyectos, que incluye acceso completo de lectura y escritura al modo Datastore.

Puedes modificar los permisos de IAM de la cuenta de servicio predeterminada de App Engine, pero la app puede perder el acceso a Firestore, a menos que asignes una función de IAM con los permisos requeridos de Firestore. Las funciones de IAM propietario de Datastore y usuario de Datastore, por ejemplo, otorgan acceso de lectura y escritura a Firestore en modo Datastore.

Si inhabilitas o borras la cuenta de servicio predeterminada de App Engine, tu app de App Engine perderá el acceso a la base de datos en modo Datastore. Si inhabilitaste la cuenta de servicios de App Engine, puedes volver a habilitarla; consulta Habilita una cuenta de servicio. Si borraste tu cuenta de servicio de App Engine dentro de los últimos 30 días, puedes restablecerla; consulta recupera una cuenta de servicio.

Accede a tu base de datos desde una instancia de Compute Engine

En esta sección, se muestra cómo activar y acceder a una base de datos en modo Datastore desde una instancia de VM de Compute Engine en un proyecto nuevo o existente.

  1. Habilita la API de Google Compute Engine para tu proyecto.
    Habilita la API de Compute Engine
  2. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  3. Crea una instancia de Compute Engine.

Console

  1. En Google Cloud Console, ve a la página Instancias de VM.
  2. Haz clic en el botón Crear instancia.
  3. En la sección Identidad y acceso a la API, configura Alcance del acceso para proporcionar acceso a Datastore. Haz clic en Permitir el acceso total a todas las API de Cloud a fin de otorgar acceso a todas las API de Google Cloud o haz clic en Configurar el acceso para cada API, haz clic en el menú desplegable Datastore y, luego, en Habilitado si quieres otorgar acceso a Datastore.
  4. Haz clic en el botón Crear para crear la instancia.
  5. Confirma que tu instancia se esté ejecutando.
  6. Para usar esta nueva instancia de Compute Engine, conéctate a ella mediante tu navegador.

gcloud

  1. Si aún no lo hiciste, instala la herramienta de línea de comandos de gcloud y configura gcloud compute.
  2. Para agregar una instancia de Google Compute Engine, sigue las instrucciones sobre cómo iniciar una instancia en la documentación de Google Compute Engine. Especifica el ID del proyecto, el nombre de la instancia y el alcance de datastore como se muestra aquí, en el que [YOUR_PROJECT_ID] es el ID del proyecto que creaste antes y [YOUR_INSTANCE_NAME] es el nombre que deseas usar para tu instancia de Compute Engine:

    export PROJECT_ID=[YOUR_PROJECT_ID]
    export INSTANCE_NAME=[YOUR_INSTANCE_NAME]
    gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore
    
  3. Confirma que tu instancia se esté ejecutando.

  4. Para usar esta nueva instancia de Compute Engine, conéctate a ella mediante ssh.

Ahora, todos los servicios y las autorizaciones están configurados para tu proyecto y puedes comenzar a escribir código o explorar la API.

Accede a tu base de datos desde otra plataforma

En esta sección, se muestra cómo acceder a la base de datos en modo Datastore desde una aplicación externa que se ejecuta en una plataforma fuera de Google Cloud.

  1. Ve a la página Crea la clave de la cuenta de servicio en Google Cloud Console.

    Ir a la página Crear clave de la cuenta de servicio

  2. Haz clic en el cuadro desplegable situado debajo de Cuenta de servicio, luego haz clic en Nueva cuenta de servicio.

  3. Ingresa un nombre para la cuenta de servicio en Nombre de la cuenta de servicio.

  4. En el menú desplegable Función, selecciona una función de IAM que otorgue acceso a tu base de datos, como Propietario de Cloud Datastore.

  5. Usa el ID de la cuenta de servicio predeterminado o genera otro.

  6. Selecciona JSON en Tipo de clave.

  7. Haz clic en Crear.

  8. Tras la creación exitosa, tu navegador descargará la clave privada. Cloud Console muestra un mensaje con el nombre del archivo de claves privadas. Anota el nombre del archivo a fin de poder ubicarlo y haz clic en Cerrar para descartar el mensaje.

  9. Tu Cuenta de servicio es la Dirección de correo electrónico que se muestra en la sección Cuenta de servicio.

  10. Tu Clave privada es el archivo que acabas de descargar.

Usa esta cuenta de servicio para configurar las credenciales de tu código de la aplicación, como se describe en la página sobre cómo proporcionar credenciales de cuenta de servicio.

Cuotas y facturación

Ofrecemos determinado valor de cuota gratuita, como se describe en Precios y cuota. Esto significa que no tienes que habilitar la facturación a fin de comenzar o para usar Firestore en modo Datastore si te mantienes dentro de los límites de cuota gratuita. Sin embargo, si necesitas más recursos de los que proporciona la cuota gratuita, debes habilitar la facturación y establecer un límite de gasto para tu proyecto.

Cómo habilitar la facturación y establecer un límite de gasto

El límite de gasto es un límite diario: establece la cantidad máxima de recursos (en dólares) que se te cobrará por día. Después de alcanzar este límite, no se incurrirá en ningún otro costo, pero tampoco se permitirá ninguna otra operación facturable de Firestore en modo Datastore. Es necesario que especifiques un límite de gasto porque el límite de gasto inicial predeterminado es siempre 0, lo que significa que, de forma predeterminada, no puedes exceder la cuota gratuita, incluso si la facturación está habilitada.

Los recursos de Firestore son parte de los recursos de App Engine. El límite de gasto para los recursos de App Engine se establece en la configuración de la aplicación de App Engine.

Para habilitar la facturación:

  1. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

Para establecer un límite de gasto:

  1. Ve a la configuración de la aplicación.
    Ir a la configuración de la aplicación
  2. Haz clic en Editar y especifica un límite de gasto.
  3. Haz clic en Guardar.

El límite de gasto solo se aplica a los recursos de App Engine, incluido Firestore, para el proyecto seleccionado:

  • Es posible que aún se te cobre por otros recursos de Google Cloud Platform.
  • Si tienes varios proyectos, es recomendable que establezcas el límite de gasto de cada uno.

Cuando aumentas el límite de inversión diaria, el nuevo límite entra en vigencia inmediatamente.

Para obtener más información, consulta Límites de gasto.