Accedere al database

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

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 in Firestore in modalità Datastore Guida rapida.

Accedere al database da App Engine

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

Ambiente standard di App Engine Ambiente flessibile di App Engine

Autorizzazioni in modalità Datastore per App Engine

Le app di App Engine possono accedere a un database in modalità Datastore per impostazione predefinita. Ogni app di App Engine utilizza un servizio predefinito di App Engine account per gestire l'accesso a Google Cloud come Firestore. Per impostazione predefinita, l'account di servizio 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 servizio predefinito di App Engine account, ma la tua app potrebbe perdere l'accesso a Firestore se non assegni un ruolo IAM con il programma Firestore richiesto autorizzazioni. Lo Proprietario Datastore e Ruoli IAM Utente Datastore, per esempio, concedi l'accesso in lettura e scrittura a Firestore in modalità Datastore.

Se disabiliti o elimini il tuo account di servizio predefinito di App Engine, L'app App Engine perderà l'accesso al database in modalità Datastore. Se hai disabilitato il tuo account di servizio App Engine, puoi riabilitarlo. consulta l'articolo sull'attivazione di un account di servizio. Se hai eliminato il tuo account di servizio App Engine negli ultimi 30 giorni, puoi ripristinare l'account di servizio, l'annullamento dell'eliminazione di un account di servizio.

Accedi al tuo database da un'istanza Compute Engine

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

Autorizzazioni in modalità Datastore per Compute Engine

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

Per accedere al tuo database da un'istanza Compute Engine, completa questi passaggi:

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

  2. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  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 Ambiti di accesso in modo da per Datastore. Fai clic su Consenti l'accesso completo a tutte le API Cloud per concedi l'accesso a tutte le API Google Cloud oppure fai clic su Imposta l'accesso per ogni API, fai clic sul menu a discesa Datastore e poi su Attivato 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 il Google Cloud CLI e configurare gcloud compute.

  2. Aggiungi un'istanza VM di Compute Engine e avviala, seguendo le istruzioni per avvio di un'istanza nella documentazione di Compute Engine. Specifica l'ID progetto, nome dell'istanza VM e cloud-platform o datastore ambito 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 da utilizzare per la tua 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 progetto e potrai iniziare a scrivere codice o esplorare l'API.

Accedi al tuo 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.

Innanzitutto, 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. Nel campo Nome account di servizio, inserisci un nome. La 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 conceda l'accesso al tuo database, ad esempio come 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. Lo utilizzerai nella procedura successiva.

Quindi, crea una chiave dell'account di servizio:

  1. Nella console Google Cloud, fai clic sull'indirizzo email del 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 una certa quantità di quota gratuita, come descritto in Prezzi e quota. Ciò significa che non è necessario abilita la fatturazione per iniziare o per utilizzare Firestore in modalità Datastore fino al servizio limiti di quota. Tuttavia, se hai bisogno di più risorse rispetto a quelle fornite dai devi abilitare la fatturazione.

Passaggi successivi

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