Lokasi

Lokasi

Saat menyediakan instance Firestore, Anda harus memilih lokasi untuk instance tersebut. Untuk mengurangi latensi dan meningkatkan ketersediaan, simpan data Anda dekat dengan pengguna dan layanan yang membutuhkannya.

Anda dapat secara opsional membuat beberapa database di project, masing-masing dengan setelan lokasinya sendiri.

Perlu diperhatikan bahwa Anda tidak dapat mengubah setelan lokasinya setelah menyediakan instance database.

Penting: Setelan lokasi untuk instance database Firestore default Anda memiliki dependensi pada "lokasi resource Google Cloud default". Artinya, saat Anda menyediakan database Firestore default, lokasinya mungkin telah ditetapkan, baik selama pembuatan project atau saat menyiapkan layanan lain yang memiliki dependensi lokasi tersebut.

Setiap instance database Firestore non-default di project Anda tidak memiliki dependensi lokasi ini.

Jenis lokasi

Anda dapat menyimpan data Firestore di lokasi multi-region atau lokasi regional.

Lokasi multi-region

Pilih lokasi multi-region untuk memaksimalkan ketersediaan dan ketahanan database Anda.

Lokasi multi-region terdiri dari kumpulan region yang ditentukan tempat beberapa replika database disimpan. Setiap replika adalah replika baca-tulis yang berisi semua data dalam database atau replika saksi yang tidak mempertahankan kumpulan data lengkap, tetapi berpartisipasi dalam replikasi.

Dengan mereplikasi data antara beberapa region, data dapat terus ditayangkan bahkan jika seluruh region hilang. Dalam satu region, data direplikasi melintasi berbagai zona sehingga data dapat terus ditayangkan di dalam region tersebut bahkan jika suatu zona hilang.

Firestore mendukung lokasi multi-region berikut:

Nama multi-region	Deskripsi multi-region	Region Baca-Tulis	Region Saksi
eur3	Eropa	europe-west1 (Belgia), europe-west4 (Belanda)	europe-north1 (Finlandia)
nam5	Amerika Serikat	us-central1 (Iowa), us-central2 (Oklahoma—region GCP pribadi)	us-east1 (South Carolina)

Perhatikan bahwa jika project Anda sudah memiliki aplikasi App Engine dengan lokasi us-central atau europe-west, database Firestore default Anda akan dianggap sebagai multi-regional.

Lokasi regional

Lokasi regional adalah tempat geografis tertentu, misalnya South Carolina. Data di lokasi regional direplikasi ke beberapa zona dalam satu region. Semua lokasi regional terpisah dari lokasi regional lainnya dalam jarak minimal 161 km (100 mil).

Pilih lokasi regional untuk biaya yang lebih rendah, latensi tulis yang lebih rendah jika aplikasi Anda sensitif terhadap latensi, atau untuk berbagi lokasi dengan resource Google Cloud lainnya.

Firestore mendukung lokasi resource regional berikut:

	Nama region	Deskripsi region
Amerika Utara
	us-west1	Oregon
	us-west2	Los Angeles
	us-west3	Salt Lake City
	us-west4	Las Vegas
	us-central1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Iowa
	northamerica-northeast1	Montréal
	northamerica-northeast2 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Toronto
	northamerica-south1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Queretaro
	us-east1	Carolina Selatan
	us-east4	Northern Virginia
	us-east5 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Columbus
	us-south1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Dallas
Amerika Selatan
	southamerica-west1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Santiago
	southamerica-east1	São Paulo
Eropa
	europe-west2	London
	europe-west1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Belgia
	europe-west4 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Belanda
	europe-west8 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Milan
	europe-southwest1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Madrid
	europe-west9 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Paris
	europe-west12 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Turin
	europe-west10 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Berlin
	europe-west3	Frankfurt
	europe-north1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Finlandia
	europe-central2	Warsawa
	europe-west6	Zürich
Timur Tengah
	me-central1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Doha
	me-central2 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Dammam
	me-west1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Tel Aviv
Asia
	asia-south1	Mumbai
	asia-south2 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Delhi
	asia-southeast1	Singapura
	asia-southeast2	Jakarta
	asia-east2	Hong Kong
	asia-east1	Taiwan
	asia-northeast1	Tokyo
	asia-northeast2	Osaka
	asia-northeast3	Seoul
Australia
	australia-southeast1	Sydney
	australia-southeast2 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Melbourne
Afrika
	africa-south1 Lokasi ini tidak mendukung App Engine. Jika berencana menggunakan App Engine, Anda harus memilih lokasi lain.	Johannesburg

SLA Lokasi

Jenis lokasi Firestore Anda menentukan persentase waktu beroperasi Perjanjian Tingkat Layanan (SLA):

Layanan yang tercakup	Persentase waktu beroperasi bulanan
Firestore Multi-Region	>= 99,999%
Firestore Regional	>= 99,99%

Harga lokasi

Lokasi Firestore Anda menentukan biaya operasi database.

Untuk mendapatkan penjelasan yang komprehensif tentang harga per region dan per jenis region, lihat Memahami penagihan Firestore.

Melihat lokasi database Anda

Gunakan salah satu metode berikut untuk melihat setelan lokasi untuk database Anda:

• Jalankan perintah gcloud firestore databases list.

• Buka daftar database di konsol Google Cloud. Lokasi untuk setiap database ada di kolom lokasi.

• Di Firebase console, buka tab Data Firestore untuk melihat daftar instance database Anda beserta lokasinya.

Kemungkinan dependensi lokasi karena "lokasi untuk resource Google Cloud default"

"Lokasi untuk resource Google Cloud default" adalah setelan lokasi untuk semua resource project yang terkait dengan Google App Engine, termasuk hal berikut:

• instance database Firestore default
• bucket Cloud Storage for Firebase default dengan format nama *.appspot.com
• Google Cloud Scheduler yang digunakan secara khusus dengan fungsi terjadwal generasi ke-1

Catatan: Tidak ada resource lain dalam project Anda yang memiliki dependensi lokasi ini, termasuk yang berikut: instance Realtime Database, instance Firestore non-default, bucket Cloud Storage non-default, bucket Cloud Storage default dengan format nama *.firebasestorage.app, fungsi non-terjadwal, dan fungsi terjadwal generasi ke-2.

"Lokasi untuk resource Google Cloud default" ini adalah setelan yang tidak dapat diubah. Selain itu, saat menetapkan lokasi untuk salah satu resource terkait, Anda secara tidak langsung menetapkan lokasi untuk semua resource karena keterkaitannya dengan App Engine.

Namun, dengan banyaknya perubahan pada ekosistem Firebase dan Google Cloud selama bertahun-tahun, pengaitan resource ke App Engine telah berubah. Terutama, mulai 30 Oktober 2024, semua bucket Cloud Storage default untuk Firebase yang baru disediakan memiliki format nama *.firebasestorage.app, dan tidak terkait dengan App Engine.

Poin Penting: Mulai 30 Oktober 2024, penyediaan bucket Cloud Storage default untuk Firebase tidak akan menetapkan "lokasi untuk resource Google Cloud default" (seperti lokasi untuk instance Firestore default project). Selain itu, penyediaan instance Firestore default tidak lagi menetapkan lokasi untuk bucket Cloud Storage for Firebase default baru (dengan format nama *.firebasestorage.app).

Berikut detail perubahan dalam kemungkinan dependensi lokasi:

• Mulai 30 Oktober 2024, jika instance Firestore default dan bucket Cloud Storage for Firebase default belum disediakan:

  • Penyediaan instance Firestore default akan menetapkan lokasi untuk aplikasi App Engine mendatang yang disediakan dalam project. Namun, hal ini tidak menentukan lokasi bucket Cloud Storage default mendatang.

  • Penyediaan bucket Cloud Storage default tidak lagi menyediakan aplikasi App Engine. Oleh karena itu, lokasi bucket Cloud Storage default tidak menentukan lokasi instance Firestore default mendatang.

• Mulai 30 Oktober 2024, jika instance Firestore default telah disediakan, tetapi bucket Cloud Storage for Firebase default belum disediakan:

  • Instance Firestore default yang ada tidak menentukan lokasi bucket Cloud Storage default mendatang (*.firebasestorage.app).

• Mulai 30 Oktober 2024, jika bucket Cloud Storage for Firebase default telah disediakan (khususnya, bucket *.appspot.com), tetapi instance Firestore default belum disediakan:

  • Saat bucket Cloud Storage default (*.appspot.com) disediakan, aplikasi App Engine juga disediakan, sehingga lokasi instance Firestore default mendatang ditetapkan pada saat yang bersamaan. Meskipun bucket *.appspot.com dihapus, Anda tidak dapat menghapus aplikasi App Engine, sehingga setelan lokasi instance Firestore default mendatang sudah ditetapkan.

Jika Anda menggunakan fungsi terjadwal generasi ke-1, lokasinya akan ditetapkan ke lokasi untuk resource Google Cloud default. Hal ini karena Cloud Scheduler dan App Engine sebelumnya memiliki hubungan satu sama lain. Selain itu, jika Anda menyiapkan fungsi terjadwal generasi ke-1 sebelum menyediakan resource lainnya dengan setelan lokasi yang sama, Anda juga perlu menetapkan lokasinya.

Perhatikan bahwa jika Anda memiliki aplikasi App Engine dengan lokasi us-central atau europe-west, lokasi untuk resource Google Cloud default akan dianggap sebagai multi-regional.

Langkah berikutnya

• Untuk membuat database Firestore di lokasi tertentu, buka salah satu panduan memulai Firestore.

• Untuk informasi lebih lanjut mengenai cara mem-build aplikasi yang memenuhi persyaratan latensi, ketersediaan, dan ketahanan, baca Geografi dan Region.