Questa pagina descrive come configurare le librerie client Firestore in modalità Datastore per utilizzare un endpoint geografico.
Quando utilizzi le librerie client di Firestore in modalità Datastore, puoi utilizzare uno dei seguenti endpoint:
Endpoint globale: per impostazione predefinita, le librerie client di Firestore in modalità Datastore inviano richieste API a un endpoint di servizio globale denominato
datastore.googleapis.com
. L'endpoint di servizio globale instrada la richiesta al tuo database. Durante il routing, la richiesta potrebbe passare attraverso un endpoint del servizio di localizzazione in una località diversa da quella del database.Endpoint basato sulla località: un endpoint basato sulla località applica restrizioni regionali, garantendo che i dati vengano archiviati ed elaborati in una regione specificata. Per garantire che l'endpoint di servizio elabori le richieste Firestore in modalità Datastore della tua app nella stessa regione del tuo database, specifica un endpoint di localizzazione nella libreria client.
Impostare un endpoint basato sulla posizione
Gli esempi riportati di seguito mostrano come impostare un endpoint geografico quando inizializzi un client Firestore in modalità Datastore.
Java
Per scoprire come installare e utilizzare la libreria client per la modalità Datastore, consulta la pagina Librerie client della modalità Datastore. Per saperne di più, consulta la documentazione di riferimento dell'API Java in modalità Datastore.
Per eseguire l'autenticazione in modalità Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per la modalità Datastore, consulta la pagina Librerie client della modalità Datastore. Per saperne di più, consulta la documentazione di riferimento dell'API Python in modalità Datastore.
Per eseguire l'autenticazione in modalità Datastore, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Semantica degli endpoint basati sulla posizione
Firestore in modalità Datastore supporta gli endpoint di località sia per le regioni che per le località multiregionali.
Utilizza il seguente formato per definire gli endpoint di localizzazione:
Java
https://REGION_NAME-firestore.googleapis.com:443
Assicurati che venga utilizzato l'URL https
completo e che il numero di porta sia definito insieme all'endpoint.
Python
https://REGION_NAME-firestore.googleapis.com
Assicurati che l'URL https
completo sia impostato come endpoint di localizzazione.
Vai
REGION_NAME-firestore.googleapis.com:443
Assicurati che il numero di porta sia definito insieme all'endpoint.
Sostituisci REGION_NAME con il nome di un nome host regionale o multiregionale.
Ecco alcuni esempi di nomi host:
eur3-datastore.googleapis.com
nam5-datastore.googleapis.com
europe-west6-datastore.googleapis.com
asia-northeast2-datastore.googleapis.com
Per un elenco completo dei nomi host multiregionali e regionali, consulta Località di Firestore in modalità Datastore.
Passaggi successivi
- Scopri di più sul modello dei dati di Firestore in modalità Datastore. Consulta Entità, proprietà e chiavi.
- Consulta le best practice per Firestore in modalità Datastore.