Accedere al database

Questa pagina descrive come accedere a un database Firestore in modalità Datastore da piattaforme diverse.

Prima di iniziare

Questo documento presuppone che tu abbia già creato un database in modalità Datastore. Se non hai creato un database, segui le istruzioni riportate nella guida rapida di Firestore in modalità Datastore.

Accedere al database da App Engine

Per iniziare a utilizzare la modalità Datastore e App Engine, consulta una delle seguenti pagine specifiche per la lingua:

Ambiente standard di App Engine Ambiente flessibile di App Engine

Autorizzazioni della modalità Datastore per App Engine

Per impostazione predefinita, le app App Engine possono accedere a un database in modalità Datastore nello stesso progetto. Ogni app App Engine utilizza un service account predefinito di App Engine per gestire l'accesso a Google Cloudservizi come Firestore. Per impostazione predefinita, il account di servizio predefinito di App Engine ha il ruolo IAM Editor progetto, che include l'accesso completo in lettura e scrittura alla modalità Datastore.

Puoi modificare le autorizzazioni IAM del service account predefinito di App Engine , ma la tua app potrebbe perdere l'accesso a Firestore a meno che tu non assegni un ruolo IAM con le autorizzazioni Firestore richieste. I ruoli IAM Proprietario Datastore e Utente Datastore, for esempio, concedono l'accesso in lettura e scrittura a Firestore in modalità Datastore.

Se disabiliti o elimini il account di servizio predefinito di App Engine, la tua app App Engine perderà l'accesso al database in modalità Datastore. Se hai disattivato il account di servizio App Engine, puoi riattivarlo, consulta la sezione relativa all'attivazione di un service account. Se hai eliminato il account di servizio App Engine negli ultimi 30 giorni, puoi ripristinarlo. Per maggiori informazioni, consulta la sezione relativa all'annullamento dell'eliminazione di un service account.

Accedere al database da un'istanza Compute Engine

Questa sezione mostra come attivare e accedere a un database in modalità Datastore da un'istanza VM di Compute Engine in un progetto nuovo o esistente.

Autorizzazioni della modalità Datastore per Compute Engine

Per impostazione predefinita, le app Compute Engine possono accedere a un database in modalità Datastore nello stesso progetto. Ogni app Compute Engine utilizza un service account predefinito di Compute Engine per gestire l'accesso a Google Cloud servizi come Firestore. Per impostazione predefinita, il account di servizio predefinito di Compute Engine ha il ruolo IAM Editor progetto, che include l'accesso completo in lettura e scrittura alla modalità Datastore.

Per accedere al database da un'istanza Compute Engine:

  1. Abilita l'API Compute Engine per il tuo progetto.
    Abilitare l'API Compute Engine

  2. Verifica che la fatturazione sia abilitata per il tuo Google Cloud progetto.

  3. Crea un'istanza Compute Engine.

Console

  1. Nella Google Cloud console, vai alla pagina Istanze VM.
  2. Fai clic sul pulsante Crea istanza.
  3. Nella sezione Identità e accesso API, imposta Ambiti di accesso per fornire l'accesso a Datastore. Fai clic su Consenti l'accesso completo a tutte le API Cloud per concedere l'accesso a tutte le API Google Cloud oppure fai clic su Imposta l'accesso per ogni API, fai clic sul menu a discesa per Datastore e poi su Abilitato per concedere l'accesso a Datastore.
  4. Fai clic sul pulsante Crea per creare l'istanza VM.
  5. Verifica che l'istanza sia in esecuzione.
  6. Per utilizzare questa nuova istanza VM di Compute Engine, connettiti utilizzando il browser.

gcloud

  1. Se non l'hai ancora fatto, installa la Google Cloud CLI e configura gcloud compute.

  2. Aggiungi un'istanza VM di Compute Engine e avviala seguendo le istruzioni per avviare un'istanza nella documentazione di Compute Engine. Specifica l'ID progetto, il nome dell'istanza VM e l'ambito cloud-platform o datastore come mostrato nell'esempio seguente.

    export PROJECT_ID=[YOUR_PROJECT_ID]
export INSTANCE_NAME=[YOUR_INSTANCE_NAME]
gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore

    Sostituisci [YOUR_PROJECT_ID] con l'ID del progetto che hai creato in precedenza e [YOUR_INSTANCE_NAME] con il nome che vuoi utilizzare per l'istanza VM.

  3. Verifica che l'istanza sia in esecuzione.

  4. Per utilizzare questa nuova istanza VM, connettiti alla VM.

A questo punto, tutti i servizi e le autorizzazioni sono configurati per il tuo progetto e puoi iniziare a scrivere codice o a esplorare l'API.

Accedere al database da un'altra piattaforma

Questa sezione mostra come accedere al database in modalità Datastore da un'applicazione esterna in esecuzione su una piattaforma esterna a Google Cloud.

Crea innanzitutto un account di servizio:

  1. Nella Google Cloud console vai a Crea service account.

    Vai a Crea service account

  2. Seleziona un progetto.

  3. Nel campo Nome service account, inserisci un nome. La Google Cloud console compila il campo ID service account in base a questo nome.

  4. (Facoltativo) Nel campo Descrizione service account, inserisci una descrizione.

  5. Fai clic su Crea.

  6. Fai clic sul campo Seleziona un ruolo.

    In Tutti i ruoli, seleziona un ruolo che conceda l'accesso al database, ad esempio Datastore > Utente Cloud Datastore.

  7. Fai clic su Continua.

  8. Fai clic su Fine per completare la creazione del account di servizio.

    Non chiudere la finestra del browser. Lo utilizzerai nella procedura successiva.

Crea quindi una chiave del account di servizio:

  1. Nella Google Cloud console, fai clic sull'indirizzo email del service account che hai creato.
  2. Fai clic su Chiavi.
  3. Fai clic su Aggiungi chiave, poi su Crea nuova chiave.
  4. Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
  5. Fai clic su Chiudi.

Utilizza questo account di servizio per configurare le credenziali per il codice dell'applicazione come descritto in Fornire le account di servizio account.

Quote e fatturazione

È disponibile una determinata quantità di quota senza costi, come descritto in Prezzi e quote. Ciò significa che non è necessario abilitare la fatturazione per iniziare o utilizzare Firestore in modalità Datastore fino ai limiti della quota senza costi. Tuttavia, se hai bisogno di più risorse di quelle fornite dalla quota senza costi, devi abilitare la fatturazione.

Passaggi successivi

Per abilitare la fatturazione, vedi Abilitare la fatturazione per un progetto.