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, ognuno con la propria impostazione di località.

Tieni presente che, una volta eseguito il provisioning di un'istanza di database, non puoi modificarne l'impostazione della località.

Tipi di località

Puoi archiviare i dati di Firestore in una località multi-regione o in una località regionale.

Località con più regioni

Seleziona una località multiregionale per massimizzare la disponibilità e la durabilità del 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 del database o una replica secondaria che non gestisce un set completo di dati, ma partecipa alla replica.

Replicando i dati tra più regioni, i dati possono continuare a essere pubblicati 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 di quella regione anche in caso di perdita di una zona.

Firestore supporta le seguenti località multiregionali:

Nome della regione	Descrizione multiregionale	Regioni di lettura/scrittura	Regione di replica
eur3	Europa	europe-west1 (Belgio), europe-west4 (Paesi Bassi)	europe-north1 (Finlandia)
nam5	Stati Uniti (centrale)	us-central1 (Iowa), us-central2 (Oklahoma, regione GCP privata)	us-east1 (Carolina del Sud)
nam7	Stati Uniti (centro ed est)	us-central1 (Iowa), us-east4 (Virginia del Nord)	us-central2 (Oklahoma, regione privata Google Cloud )

Località regionali

Una località a singola area geografica è 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.

Seleziona una località regionale per costi inferiori, per una latenza di scrittura inferiore se la tua applicazione è sensibile alla latenza o per la collocazione 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 una località diversa.	Iowa
	northamerica-northeast1	Montréal
	northamerica-northeast2 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Toronto
	northamerica-south1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	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 una località diversa.	Columbus
	us-south1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Dallas
Sud America
	southamerica-west1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	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 una località diversa.	Belgio
	europe-west4 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Paesi Bassi
	europe-west8 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Milano
	europe-southwest1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Madrid
	europe-west9 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Parigi
	europe-west12 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Torino
	europe-west10 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Berlino
	europe-west3	Francoforte
	europe-north1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Finlandia
	europe-north2 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Stoccolma
	europe-central2	Varsavia
	europe-west6	Zurigo
Medio Oriente
	me-central1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Doha
	me-central2 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Dammam
	me-west1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Tel Aviv
Asia
	asia-south1	Mumbai
	asia-south2 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	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 una località diversa.	Melbourne
Africa
	africa-south1 Questa località non supporta App Engine. Se prevedi di utilizzare App Engine, devi scegliere una località diversa.	Johannesburg

SLA (accordo sul livello del servizio) della località

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 la sezione Informazioni sulla fatturazione di Firestore.

Visualizzare la posizione dei database

Utilizza uno dei seguenti metodi per visualizzare l'impostazione della località 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 della posizione.

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

Possibili dipendenze dalla località dovute a "posizione per le risorse predefinite Google Cloud "

La "località per le risorse Google Cloud predefinite" è l'impostazione di località per qualsiasi risorsa del progetto associata a Google App Engine, tra cui le seguenti:

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

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

Tuttavia, con i numerosi cambiamenti apportati all'ecosistema Firebase e Google Cloud nel corso degli anni, le associazioni di risorse ad App Engine sono cambiate. In particolare, a partire dal 30 ottobre 2024, tutti i bucket Cloud Storage for Firebase predefiniti di cui è stato eseguito il provisioning di recente hanno il formato del nome *.firebasestorage.app e non sono associati ad App Engine.

Ecco i dettagli di ciò che è cambiato nelle possibili dipendenze dalla posizione:

• A partire dal 30 ottobre 2024, se l'istanza Firestore predefinita e il bucket Cloud Storage for Firebase predefinito 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 determina 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 località del bucket Cloud Storage predefinito non determina la località della futura istanza Firestore predefinita.

• A partire dal 30 ottobre 2024, se l'istanza Firestore predefinita è già stata sottoposta a provisioning, ma il bucket Cloud Storage for Firebase predefinito non è stato sottoposto a provisioning:

  • 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 è già stato eseguito il provisioning (in particolare, il bucket *.appspot.com), ma il provisioning dell'istanza Firestore predefinita non è stato eseguito:

  • Quando è stato eseguito il provisioning del bucket Cloud Storage predefinito (*.appspot.com), è stato eseguito il provisioning anche di un'app App Engine e quindi 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, quindi l'impostazione della località della futura istanza Firestore predefinita è già impostata.

Se hai utilizzato le funzioni pianificate di prima generazione, la loro posizione è impostata sulla posizione delle risorse Google Cloud predefinite. Questo perché Cloud Scheduler e App Engine avevano precedentemente un'associazione tra loro. Inoltre, se hai configurato le funzioni programmate di 1ª gen. prima di eseguire il provisioning di altre risorse che condividevano questa impostazione della posizione, devi impostare anche la loro posizione.

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

Passaggi successivi

• Per creare un database Firestore in una posizione specifica, consulta una delle guide introduttive di Firestore.

• Per saperne di più sulla creazione di applicazioni che soddisfino i requisiti di latenza, disponibilità e durabilità, consulta Geografia e regioni.