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

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

Quando utilizzi le librerie client di Firestore in modalità Datastore, puoi utilizzare uno qualsiasi 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 server in una località diversa da quella del tuo database.

  • Endpoint regionale: un endpoint regionale applica restrizioni che garantiscono che i dati vengano trasmessi, archiviati ed elaborati in una Google Cloud 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 regionale nella libreria client.

  • Endpoint multiregionale: un endpoint multiregionale applica restrizioni che garantiscono che i dati vengano trasmessi, archiviati ed elaborati in una Google Cloud multi-regione specificata. Per assicurarti che l'endpoint di servizio elabori le richieste Firestore in modalità Datastore della tua app nella stessa multiregione del tuo database, specifica un endpoint multiregionale nella libreria client.

Imposta un endpoint regionale o multiregionale

Il metodo per configurare un endpoint regionale o multiregionale è lo stesso: fornisci la stringa dell'endpoint durante l'inizializzazione della libreria client. Gli esempi seguenti mostrano come impostare la stringa dell'endpoint utilizzando un endpoint regionale (datastore.us-central1.rep.googleapis.com). Per utilizzare un endpoint multiregionale, fornisci una stringa dell'endpoint multiregionale corrispondente alla posizione del database (ad esempio, datastore.us.rep.googleapis.com per nam5).

Java

Per scoprire come installare e utilizzare la libreria client per la modalità Datastore, consulta 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 saperne di più, consulta Configura 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://datastore.us-central1.rep.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 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 saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale. 

from google.cloud import datastore
from google.api_core.client_options import ClientOptions

ENDPOINT = "https://datastore.africa-south1.rep.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 degli endpoint regionali e multiregionali

Endpoint regionali (REP):

Firestore in modalità Datastore supporta gli endpoint regionali per le località regionali elencate qui: Località di Firestore in modalità Datastore.

Utilizza il seguente formato per definire gli endpoint regionali:

Java

    datastore.REGION_NAME.rep.googleapis.com:443

Assicurati che il numero di porta sia definito insieme all'endpoint.

Python

    datastore.REGION_NAME.rep.googleapis.com

Go

    datastore.REGION_NAME.rep.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.

Ecco alcuni esempi di nomi host:

  • datastore.us-central1.rep.googleapis.com
  • datastore.europe-west1.rep.googleapis.com

Endpoint multiregionali (MREP)

Per gli endpoint multiregionali, utilizza us per le località nam5 e nam7 e eu per la località eur3 (vedi Località multiregionali).

Java

    datastore.us.rep.googleapis.com:443
    datastore.eu.rep.googleapis.com:443

Assicurati che il numero di porta sia definito insieme all'endpoint.

Python

    datastore.us.rep.googleapis.com
    datastore.eu.rep.googleapis.com

Go

    datastore.us.rep.googleapis.com:443
    datastore.eu.rep.googleapis.com:443

Assicurati che il numero di porta sia definito insieme all'endpoint.

Endpoint di localizzazione (ritirati)

Gli endpoint basati sulla posizione sono ora deprecati. Utilizza invece endpoint regionali o multiregionali.

In precedenza, Firestore in modalità Datastore supportava endpoint di localizzazione con il seguente formato:

Java

  https://REGION_NAME-datastore.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-datastore.googleapis.com

Assicurati che l'URL https completo sia impostato come endpoint di geolocalizzazione.

Go

  REGION_NAME-datastore.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.

Limita l'utilizzo degli endpoint API globali

Per contribuire a imporre l'utilizzo di endpoint regionali e multiregionali, utilizza il vincolo delle policy dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per saperne di più, consulta Limitazione dell'utilizzo degli endpoint.

Passaggi successivi