Configura la località di dati con endpoint a livello di regione

Questa pagina descrive come configurare le librerie client di Firestore in modalità Datastore per utilizzare un endpoint regionale.

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 richieste API a un endpoint di servizio globale denominato datastore.googleapis.com. L'endpoint del servizio globale indirizza 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 posizione del database.

  • Endpoint a livello di regione: un endpoint a livello di regione applica limitazioni regionali, garantendo che i dati vengano archiviati ed elaborati in una regione specificata. Per garantire che l'endpoint del servizio elabori le richieste di Firestore in modalità Datastore della tua app nella stessa regione del database, specifica un endpoint regionale nella libreria client.

Impostare un endpoint a livello di regione

Gli esempi riportati di seguito mostrano come impostare un endpoint regionale quando inizili un client Firestore in modalità Datastore.

Java

Per scoprire come installare e utilizzare la libreria client per la modalità Datastore, consulta Librerie client per la modalità Datastore. Per ulteriori informazioni, 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 maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale. 


import com.google.cloud.datastore.Datastore;
import com.google.cloud.datastore.DatastoreOptions;

public class RegionalEndpoint {

  public Datastore createClient() throws Exception {
    // Instantiates a client
    DatastoreOptions options =
        DatastoreOptions.newBuilder().setHost("https://nam5-datastore.googleapis.com").build();
    Datastore datastore = options.getService();
    return datastore;
  }
}

Python

Per scoprire come installare e utilizzare la libreria client per la modalità Datastore, consulta Librerie client per la modalità Datastore. Per ulteriori informazioni, consulta API Python della modalità Datastore documentazione di riferimento.

Per autenticarti alla modalità Datastore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale. 

ENDPOINT = "https://eur3-datastore.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
client = datastore.Client(client_options=client_options)

query = client.query(kind="Task")
results = list(query.fetch())
for r in results:
    print(r)

semantica dell'endpoint a livello di regione

Firestore in modalità Datastore supporta endpoint a livello di regione per località sia a livello di regione che a livello di 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 completo di https sia impostato come endpoint regionale.

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 degli host name multiregionali e regionali, consulta Località di Firestore in modalità Datastore.

Passaggi successivi