Accesso al database

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

Prima di iniziare

Questa pagina presuppone che tu abbia già creato un database in modalità Datastore. Puoi creare un database completando la Guida rapida di Firestore in modalità Datastore.

Accesso al database da App Engine

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

Ambiente standard di App Engine Ambiente flessibile di App Engine

Autorizzazioni della modalità Datastore per App Engine

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

Puoi modificare le autorizzazioni IAM del tuo account di servizio predefinito App Engine, ma la tua app potrebbe perdere l'accesso a Firestore, a meno che non assegni un ruolo IAM con le autorizzazioni Firestore necessarie. I ruoli IAM Proprietario Datastore e Utente Datastore, ad esempio, consentono di accedere in lettura e scrittura a Firestore in modalità Datastore.

Se disabiliti o elimini il tuo account di servizio predefinito App Engine, l'app App Engine perderà l'accesso al tuo database in modalità Datastore. Se hai disabilitato il tuo account di servizio App Engine, puoi riattivarlo, consulta Attivare un account di servizio. Se hai eliminato il tuo account di servizio App Engine negli ultimi 30 giorni, puoi ripristinarlo, vedi Annullamento dell'eliminazione di un account di servizio.

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

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

  2. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.

  3. Creare un'istanza Compute Engine.

Console

  1. Nella console Google Cloud, vai alla pagina Istanze VM.
  2. Fai clic sul pulsante Crea istanza.
  3. Nella sezione Identità e accesso API, imposta gli 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 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 la tua istanza sia in esecuzione.
  6. Per utilizzare questa nuova istanza VM di Compute Engine, connettila con il browser.

gcloud

  1. Se non lo hai già fatto, installa Google Cloud CLI e configura gcloud compute.

  2. Aggiungi un'istanza VM di Compute Engine e avviala, seguendo le istruzioni per l'avvio di un'istanza nella documentazione di Compute Engine. Specifica l'ID progetto, il nome dell'istanza VM e cloud-platform o l'ambito 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 creato in precedenza e [YOUR_INSTANCE_NAME] con il nome che vuoi utilizzare per l'istanza VM.

  3. Verifica che la tua istanza sia in esecuzione.

  4. Per utilizzare questa nuova istanza VM, connettila VM.

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

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

Per prima cosa, crea un account di servizio:

  1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

    Vai a Crea account di servizio

  2. Seleziona un progetto.

  3. Inserisci un nome nel campo Service account name (Nome account di servizio). La console Google Cloud compila il campo ID account di servizio in base a questo nome.

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

  5. Fai clic su Crea.

  6. Fai clic sul campo Seleziona un ruolo.

    In Tutti i ruoli, seleziona un ruolo che concede accesso al tuo database, ad esempio Datastore > Utente Cloud Datastore.

  7. Fai clic su Continua.

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

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

Quindi, crea una chiave dell'account di servizio:

  1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
  2. Fai clic su Chiavi.
  3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
  4. Fai clic su Crea. Sul computer viene scaricato un file della chiave JSON.
  5. Fai clic su Chiudi.

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

Quote e fatturazione

È disponibile un determinato importo di quota gratuita, come descritto in Prezzi e quota. Questo significa che non devi abilitare la fatturazione per iniziare o utilizzare Firestore in modalità Datastore fino ai limiti di quota gratuiti. Tuttavia, se hai bisogno di più risorse di quelle fornite dalla quota gratuita, devi abilitare la fatturazione.

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