Configurare la località dei dati con endpoint regionali

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

Quando utilizzi le librerie client Firestore, puoi utilizzare uno dei seguenti endpoint:

  • Endpoint globale: per impostazione predefinita, le librerie client Firestore inviano le richieste API a un endpoint di servizio globale denominato firestore.googleapis.com. L'endpoint di servizio globale indirizza la richiesta al tuo database. Durante il routing, una richiesta potrebbe passare attraverso un server in una località diversa da quella del database.

  • Endpoint regionale: un endpoint regionale applica restrizioni che garantiscono che i dati vengano trasmessi, archiviati ed elaborati in una regione specificata Google Cloud . Per assicurarti che l'endpoint di servizio elabori le richieste Firestore della tua app nella stessa regione del 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 multiregione specificata. Per assicurarti che l'endpoint di servizio elabori le richieste Firestore della tua app nella stessa multiregione del database, specifica un endpoint multiregionale nella libreria client.

Impostare 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 (firestore.us-central1.rep.googleapis.com). Per utilizzare un endpoint multiregionale, fornisci una stringa dell'endpoint multiregionale corrispondente alla località del database (ad esempio, firestore.us.rep.googleapis.com per nam5).

Java

Per eseguire l'autenticazione in Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale. 


import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;
import com.google.cloud.firestore.FirestoreOptions;


/**
 * Demonstrate how to set a regional endpoint.
 */
public class RegionalEndpointSnippets {

  /**
   * Create a client with a regional endpoint.
   **/
  public Firestore regionalEndpoint(String projectId, String endpoint) throws Exception {
    FirestoreOptions firestoreOptions =
        FirestoreOptions.newBuilder()
            .setProjectId(projectId)
            .setCredentials(GoogleCredentials.getApplicationDefault())
            // set endpoint like firestore.us-central1.rep.googleapis.com:443
            .setHost(endpoint)
            .build();
    Firestore dbWithEndpoint = firestoreOptions.getService();

    return dbWithEndpoint;
  }

}

Python

Per eseguire l'autenticazione in Firestore, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale. 

ENDPOINT = "firestore.africa-south1.rep.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
db = firestore.Client(client_options=client_options)

cities_query = db.collection("cities").limit(2).get()
for r in cities_query:
    print(r)

Semantica degli endpoint regionali e multiregionali

Endpoint regionali (REP)

Firestore supporta gli endpoint regionali per le località regionali elencate qui Località Firestore.

Utilizza il seguente formato per definire gli endpoint regionali:

Java

    firestore.REGION_NAME.rep.googleapis.com:443

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

Python

    firestore.REGION_NAME.rep.googleapis.com

Vai

    firestore.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:

  • firestore.us-central1.rep.googleapis.com
  • firestore.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

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

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

Python

    firestore.us.rep.googleapis.com
    firestore.eu.rep.googleapis.com

Vai

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

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

Limitazioni

  • Gli endpoint regionali e multiregionali non supportano i listener in tempo reale.

Endpoint di località (ritirati)

Gli endpoint di località sono stati ritirati. Utilizza invece endpoint regionali o multiregionali.

In precedenza, Firestore supportava gli endpoint di località con il seguente formato:

Java

  REGION_NAME-firestore.googleapis.com:443

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

Python

  REGION_NAME-firestore.googleapis.com

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-firestore.googleapis.com
  • nam5-firestore.googleapis.com
  • europe-west6-firestore.googleapis.com
  • asia-northeast2-firestore.googleapis.com

Per un elenco completo dei nomi host multiregionali e regionali, vedi Località Firestore.

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ù, vedi Limitare l'utilizzo degli endpoint.

Passaggi successivi