Questa pagina descrive come configurare le librerie client di Firestore in modalità Datastore per utilizzare un endpoint a livello di regione.
Quando utilizzi Firestore nelle librerie client in modalità Datastore, puoi utilizzare uno dei seguenti endpoint:
Endpoint globale: per impostazione predefinita, le librerie client di Firestore in modalità Datastore inviano le 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 di servizio a livello di regione in una località diversa dalla località del database.Endpoint a livello di regione: un endpoint a livello di regione applica limitazioni a livello di regione, garantendo che i dati vengano archiviati ed elaborati in una regione specificata. Per garantire che l'endpoint di servizio elabori le richieste Firestore della tua app in modalità Datastore nella stessa regione del database, specifica un endpoint a livello di regione nella libreria client.
Imposta un endpoint a livello di regione
Gli esempi seguenti mostrano come impostare un endpoint a livello di regione per inizializzare un client in modalità Datastore.
Java
Per scoprire come installare e utilizzare la libreria client per la modalità Datastore, consulta Librerie client in modalità Datastore. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java per la modalità Datastore.
Per eseguire l'autenticazione in modalità Datastore, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per la modalità Datastore, consulta Librerie client in modalità Datastore. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python per la modalità Datastore.
Per eseguire l'autenticazione in modalità Datastore, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Semantica degli endpoint a livello di regione
Firestore in modalità Datastore supporta gli endpoint a livello di regione sia per le località a livello di regione che per quelle a più regioni.
Utilizza il formato seguente per definire gli endpoint a livello di regione:
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 a livello di regione.
Go
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 a livello di una o più regioni.
Alcuni esempi di nomi host sono:
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 per più regioni e regioni, consulta Firestore nelle località in modalità Datastore.
Passaggi successivi
- Scopri di più sul modello dei dati Firestore in modalità Datastore. Consulta la sezione Entità, proprietà e chiavi.
- Consulta le best practice per Firestore in modalità Datastore.