Lokasi Cloud Firestore

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

Jika project Anda menggunakan paket harga Blaze bayar sesuai penggunaan, 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 Cloud Firestore default Anda memiliki dependensi pada "lokasi resource Google Cloud default". Artinya, saat Anda menyediakan database Cloud Firestore default, lokasinya mungkin telah ditetapkan, baik selama pembuatan project atau saat menyiapkan layanan lain yang memiliki dependensi lokasi tersebut.

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

Jenis lokasi

Anda dapat menyimpan data Cloud 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.

Cloud 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)

Perlu diperhatikan bahwa jika project Anda sudah memiliki aplikasi App Engine dengan lokasi us-central atau europe-west, database Cloud 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.

Cloud 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	Iowa
	northamerica-northeast1	Montréal
	northamerica-northeast2	Toronto
	us-east1	Carolina Selatan
	us-east4	Northern Virginia
	us-east5	Columbus
	us-south1	Dallas
Amerika Selatan
	southamerica-west1	Santiago
	southamerica-east1	São Paulo
Eropa
	europe-west2	London
	europe-west1	Belgia
	europe-west4	Belanda
	europe-west8	Milan
	europe-southwest1	Madrid
	europe-west9	Paris
	europe-west12	Turin
	europe-west10	Berlin
	europe-west3	Frankfurt
	europe-north1	Finlandia
	europe-central2	Warsawa
	europe-west6	Zürich
Timur Tengah
	me-central1	Doha
	me-central2	Dammam
	me-west1	Tel Aviv
Asia
	asia-south1	Mumbai
	asia-south2	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	Melbourne
Afrika
	africa-south1	Johannesburg

SLA Lokasi

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

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

Harga lokasi

Lokasi Cloud Firestore Anda menentukan biaya operasi database.

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

Melihat lokasi database Anda

Di Firebase console, buka tab Data Cloud 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 Cloud Firestore default
• Cloud Storage default untuk bucket Firebase dengan format nama *.appspot.com
• Cloud Scheduler Google yang digunakan secara khusus dengan fungsi terjadwal generasi ke-1

Catatan: Tidak ada resource lain dalam project Anda yang memiliki dependensi lokasi ini, termasuk: instance Realtime Database, instance Cloud 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 Cloud Storage default yang baru disediakan untuk bucket Firebase memiliki format nama *.firebasestorage.app, dan tidak terkait dengan App Engine.

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

Berikut detail perubahan dalam kemungkinan dependensi lokasi:

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

  • Penyediaan instance Cloud 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 Cloud Firestore default mendatang.

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

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

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

  • Saat bucket Cloud Storage default (*.appspot.com) disediakan, aplikasi App Engine juga disediakan, sehingga lokasi instance Cloud Firestore default mendatang ditetapkan pada saat yang bersamaan. Meskipun bucket *.appspot.com dihapus, Anda tidak dapat menghapus aplikasi App Engine, sehingga setelan lokasi instance Cloud 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.

Perlu diperhatikan 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 Cloud Firestore di lokasi tertentu, buka Memulai Cloud Firestore.

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