Località

Quando esegui il provisioning di un'istanza Firestore, devi scegliere una località per l'istanza. Per ridurre la latenza e aumentare la disponibilità, archivia i dati vicino agli utenti e ai servizi che ne hanno bisogno.

Se vuoi, puoi creare più database nel tuo progetto, ciascuno con la propria impostazione di posizione.

Tieni presente che, dopo aver eseguito il provisioning di un'istanza di database, non puoi modificare l'impostazione della località.

Tipi di località

Puoi archiviare i dati di Firestore in una località con più aree geografiche o in una località a singola area geografica.

Località con più regioni

Seleziona una località multi-regione per massimizzare la disponibilità e la durabilità del tuo database.

Una località multiregionale è costituita da un insieme definito di regioni in cui sono archiviate più repliche del database. Ogni replica è una replica di lettura/scrittura che contiene tutti i dati nel database o una replica di testimone che non gestisce un insieme completo di dati, ma partecipa alla replica.

Se replichi i dati tra più regioni, la loro pubblicazione può continuare anche in caso di perdita di un'intera regione. All'interno di una regione, i dati vengono replicati in varie zone in modo che possano continuare a essere pubblicati all'interno della regione anche in caso di perdita di una zona.

Firestore supporta le seguenti località multiregione:

Nome multiregione	Descrizione multiregione	Regioni di lettura/scrittura	Regione di testimonianza
eur3	Europa	europe-west1 (Belgio), europe-west4 (Paesi Bassi)	europe-north1 (Finlandia)
nam5	Stati Uniti	us-central1 (Iowa), us-central2 (Oklahoma, regione privata Google Cloud)	us-east1 (Carolina del Sud)

Tieni presente che se il tuo progetto ha già un'app App Engine con una località us-central o europe-west, il database Firestore predefinito verrà considerato multiregionale.

Località regionali

Una località a livello di regione è un luogo geografico specifico, ad esempio la Carolina del Sud. I dati in una località regionale vengono replicati in più zone all'interno di una regione. Tutte le sedi regionali sono separate da altre sedi regionali da almeno 160 km.

Seleziona una località a livello di regione per ridurre i costi, per una minore latenza di scrittura se la tua applicazione è sensibile alla latenza o per la co-locazione con altre risorse Google Cloud.

Firestore supporta le seguenti località risorsa di regione:

	Nome regione	Descrizione della regione
Nord America
	us-west1	Oregon
	us-west2	Los Angeles
	us-west3	Salt Lake City
	us-west4	Las Vegas
	us-central1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Iowa
	northamerica-northeast1	Montréal
	northamerica-northeast2 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Toronto
	northamerica-south1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Querétaro
	us-east1	Carolina del Sud
	us-east4	Virginia del Nord
	us-east5 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Columbus
	us-south1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Dallas
Sud America
	southamerica-west1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Santiago
	southamerica-east1	San Paolo
Europa
	europe-west2	Londra
	europe-west1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Belgio
	europe-west4 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Paesi Bassi
	europe-west8 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Milano
	europe-southwest1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Madrid
	europe-west9 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Parigi
	europe-west12 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Torino
	europe-west10 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Berlino
	europe-west3	Francoforte
	europe-north1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Finlandia
	europe-central2	Varsavia
	europe-west6	Zurigo
Medio Oriente
	me-central1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Doha
	me-central2 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Dammam
	me-west1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Tel Aviv
Asia
	asia-south1	Mumbai
	asia-south2 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Delhi
	asia-southeast1	Singapore
	asia-southeast2	Giacarta
	asia-east2	Hong Kong
	asia-east1	Taiwan
	asia-northeast1	Tokyo
	asia-northeast2	Osaka
	asia-northeast3	Seul
Australia
	australia-southeast1	Sydney
	australia-southeast2 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Melbourne
Africa
	africa-south1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere un'altra località.	Johannesburg

SLA (accordo sul livello del servizio) per le sedi

Il tipo di località Firestore determina la percentuale di uptime dell'accordo sul livello del servizio (SLA):

Servizio	Percentuale mensile di uptime
Firestore in più aree geografiche	>= 99,999%
Firestore a singola area geografica	>= 99,99%

Prezzi per ubicazione

La località di Firestore determina il costo delle operazioni sul database.

Per una spiegazione completa dei prezzi per regione e per tipo di regione, consulta Informazioni sulla fatturazione di Firestore.

Visualizzare la posizione dei database

Utilizza uno dei seguenti metodi per visualizzare l'impostazione della posizione per i tuoi database:

• Esegui il comando gcloud firestore databases list.

• Apri l'elenco dei database nella console Google Cloud. La posizione di ogni database si trova nella colonna Location.

• Nella Console Firebase, vai alla scheda Dati di Firestore per visualizzare l'elenco delle istanze del database e le relative posizioni.

Possibili dipendenze dalla località a causa della "località per le risorse Google Cloud predefinite"

La "località per le risorse Google Cloud predefinite" è l'impostazione della località per tutte le risorse del progetto associate a Google App Engine, tra cui:

• istanza del database Firestore predefinita
• bucket Cloud Storage for Firebase predefinito con il formato del nome *.appspot.com
• Google Cloud Scheduler utilizzato specificamente con le funzioni programmate di 1ª generazione

Questa "località per le risorse Google Cloud predefinite" è un'impostazione immutabile. Inoltre, quando imposti la posizione di una delle risorse associate, lo fai indirettamente per tutte a causa della loro associazione comune con App Engine.

Tuttavia, con molte modifiche all'ecosistema Firebase e Google Cloud nel corso degli anni, le associazioni delle risorse ad App Engine sono cambiate. In particolare, a partire dal 30 ottobre 2024, tutti i nuovi bucket Cloud Storage for Firebase preconfigurati hanno il formato del nome *.firebasestorage.app e non sono associati con App Engine.

Di seguito sono riportati i dettagli delle modifiche apportate alle possibili dipendenze dalla località:

• A partire dal 30 ottobre 2024, se l'istanza Firestore e il bucket Cloud Storage for Firebase predefiniti non sono ancora stati sottoposti a provisioning:

  • Il provisioning dell'istanza Firestore predefinita imposta la posizione per qualsiasi app App Engine futura di cui viene eseguito il provisioning nel progetto. Tuttavia, non indica la posizione del futuro bucket Cloud Storage predefinito.

  • Il provisioning del bucket Cloud Storage predefinito non esegue più il provisioning di un'app App Engine. Pertanto, la posizione del bucket Cloud Storage predefinito non determina la posizione della futura istanza Firestore predefinita.

• A partire dal 30 ottobre 2024, se è stato già eseguito il provisioning dell'istanza Firestore predefinita, ma non è stato eseguito il provisioning del bucket Cloud Storage for Firebase predefinito:

  • L'istanza Firestore predefinita esistente non determina la posizione del futuro bucket Cloud Storage predefinito (*.firebasestorage.app).

• A partire dal 30 ottobre 2024, se il bucket Cloud Storage for Firebase predefinito è stato già eseguito in provisioning (in particolare, il *.appspot.com), ma per l'esclusione dell'istanza Firestore predefinita:

  • Quando è stato eseguito il provisioning del bucket Cloud Storage predefinito (*.appspot.com), è stato eseguito il provisioning anche di un'app App Engine, pertanto la posizione della futura istanza Firestore predefinita è stata impostata in quel momento. Anche se elimini il bucket *.appspot.com, non puoi eliminare l'app App Engine, pertanto l'impostazione della posizione della futura istanza Firestore predefinita è già impostata.

Se hai utilizzato le funzioni programmate di 1ª gen., la loro posizione è impostata sulla località delle risorse Google Cloud predefinite. Questo accade perché Cloud Scheduler e App Engine erano precedentemente associati tra loro. Inoltre, se hai configurato le funzioni programmate di 1ª generazione prima di eseguire il provisioning di altre risorse che condividevano questa impostazione di località, hai impostato anche la loro località.

Tieni presente che se hai un'app App Engine con sede in us-central o europe-west, la sede per le risorse Google Cloud predefinite è considerata multi-regionale.

Passaggi successivi

• Per creare un database Firestore in una località specifica, consulta una delle guide iniziali di Firestore.

• Per ulteriori informazioni sulla creazione di applicazioni in grado di soddisfare i requisiti di latenza, disponibilità e durabilità, consulta Geografia e regioni.