Beberapa produk Firebase memerlukan setelan lokasi:
Google Analytics — Jika mengaktifkan Google Analytics di project Firebase, Anda akan diminta untuk memilih lokasi pelaporan Analytics. Lokasi ini berupa negara atau region organisasi Anda. Lokasi Analytics akan menentukan mata uang dalam laporan pendapatan.
Cloud Firestore dan Cloud Storage — Jika mulai menggunakan salah satu produk tersebut, Anda akan diminta untuk memilih lokasi resource Google Cloud Platform (GCP) default project Anda (jika belum dipilih saat menyiapkan layanan lain).
Cloud Functions for Firebase (khusus fungsi terjadwal) — Jika Anda menjalankan fungsi terjadwal, Cloud Scheduler membutuhkan aplikasi App Engine. Selama penyiapan, Anda akan diminta untuk memilih lokasi resource Google Cloud Platform (GCP) default project Anda (jika belum dipilih saat menyiapkan layanan lain).
Untuk mempelajari lebih lanjut setelan lokasi untuk fungsi tak terjadwal, baca Lokasi Cloud Functions.
Realtime Database — Jika membuat instance Realtime Database, Anda akan diminta untuk memilih lokasi instance, dan setiap instance dapat berada di lokasi yang berbeda. Perhatikan bahwa lokasi instance Realtime Database tidak memengaruhi opsi untuk lokasi resource GCP default Anda.
Memilih setelan lokasi untuk produk atau grup produk
Untuk sebagian besar kasus penggunaan, Anda dapat memilih setelan lokasi di Firebase console, baik selama pembuatan project maupun di halaman konsol untuk produk tertentu.
Analytics
Jika mengaktifkan Google Analytics di project Firebase di Firebase console, Anda akan diminta untuk memilih lokasi pelaporan Analytics. Pilih negara atau region yang mewakili lokasi organisasi Anda.
Jika merupakan Pemilik atau Editor project, Anda dapat mengedit zona waktu dan mata uang untuk lokasi pelaporan Analytics. Buka setelan Google Analytics, lalu scroll ke panel Pelaporan.
Cloud Firestore, Cloud Storage, dan fungsi terjadwal
Cloud Firestore, Cloud Storage, dan fungsi terjadwal memiliki setelan lokasi yang sama, yang disebut lokasi resource GCP default (pelajari perincian setelan lokasi ini di bawah). Perhatikan bahwa lokasi ini mungkin telah ditetapkan sebelumnya, baik selama pembuatan project atau saat menyiapkan layanan lain yang menggunakan setelan lokasi ini.
Jika menyiapkan Cloud Firestore atau Cloud Storage, Anda akan diminta untuk memilih lokasi resource GCP default project di alur kerja Firebase console.
Untuk Cloud Storage, lokasi resource GCP default Anda hanya berlaku untuk bucket default. Jika menggunakan paket Blaze, Anda dapat membuat beberapa bucket, masing-masing memiliki lokasinya sendiri.
Jika Anda menjalankan fungsi terjadwal, Cloud Scheduler memerlukan aplikasi App Engine. Selama penyiapan, Anda akan diminta untuk memilih lokasi resource GCP default project Anda.
Anda dapat menetapkan lokasi resource GCP default secara terprogram dengan memanggil endpoint
defaultLocation.finalize
untuk project Firebase Anda.
Lokasi Realtime Database
Jika Anda membuat instance Realtime Database baru, Anda perlu menentukan lokasi untuk instance tersebut. Setiap instance Realtime Database di project Anda dapat berada di lokasi yang berbeda. Lokasi yang saat ini didukung untuk instance Realtime Database tercantum di bawah ini bersama dengan skema URL database terkait.
Perhatikan bahwa lokasi instance Realtime Database tidak memengaruhi opsi untuk lokasi resource GCP default.
Nama region | Deskripsi region | Skema URL database |
---|---|---|
us-central1 |
Iowa | DATABASE_NAME.firebaseio.com |
europe-west1 |
Belgia | DATABASE_NAME.europe-west1.firebasedatabase.app |
asia-southeast1 |
Singapura | DATABASE_NAME.asia-southeast1.firebasedatabase.app |
Melihat setelan lokasi
Untuk Analytics — Di Firebase console, buka setelan Google Analytics, lalu scroll ke panel Pelaporan.
Untuk Cloud Firestore, Cloud Storage, dan fungsi terjadwal — Di Firebase console, buka Setelan project.
Untuk Realtime Database — Di Firebase console, lihat daftar instance database Anda di penampil data Realtime Database.
Mempelajari lokasi resource GCP default
Beberapa layanan yang tersedia untuk aplikasi Anda memerlukan setelan lokasi yang disebut lokasi resource Google Cloud Platform (GCP) default project Anda. Di lokasi inilah data Anda disimpan untuk layanan GCP yang memerlukan setelan lokasi.
Produk berikut ini berbagi lokasi resource GCP default yang sama:
Cloud Firestore
Perhatikan bahwa lokasi resource GCP default Anda tidak berlaku untuk Firebase Realtime Database.Cloud Storage
Perhatikan bahwa lokasi resource GCP default Anda hanya berlaku untuk bucket Cloud Storage default Anda. Jika menggunakan paket Blaze, Anda dapat membuat beberapa bucket, yang masing-masing memiliki lokasinya sendiri.Aplikasi App Engine (misalnya untuk fungsi terjadwal)
Jika Anda menyiapkan aplikasi App Engine, lokasinya mengikuti lokasi resource GCP default Anda. Perhatikan bahwa jika menggunakan Cloud Scheduler (misalnya untuk menjalankan fungsi terjadwal), Anda harus memiliki aplikasi App Engine di project Anda.
Anda dapat memilih lokasi multi-region atau lokasi regional sebagai lokasi resource GCP default Anda. Perhatikan bahwa jika Anda sudah memiliki aplikasi App Engine dengan lokasi us-central
atau europe-west
, layanan GCP apa pun yang menggunakan setelan lokasi ini akan dianggap sebagai multi-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 ke berbagai zona sehingga data dapat terus ditayangkan di dalam region tersebut bahkan jika suatu zona hilang.
Firebase mendukung lokasi resource GCP 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) |
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 GCP lainnya.
Firebase mendukung lokasi resource GCP regional berikut:Nama Region | Deskripsi Region | |
---|---|---|
Amerika Utara | ||
us-west1 | Oregon | |
us-west2 | Los Angeles | |
us-west3 | Salt Lake City | |
us-west4 | Las Vegas | |
northamerica-northeast1 | Montréal | |
|
Toronto | |
us-east1 | South Carolina | |
us-east4 | Northern Virginia | |
Amerika Selatan | ||
southamerica-east1 | Sao Paulo | |
Eropa | ||
europe-west2 | London | |
|
Belanda | |
|
Paris | |
europe-west3 | Frankfurt | |
europe-central2 | Warsawa | |
europe-west6 | Zürich | |
Timur Tengah | ||
|
Doha | |
|
Tel Aviv | |
Asia | ||
asia-south1 | Mumbai | |
Lokasi ini tidak mendukung Cloud Storage for Firebase. Jika berencana menggunakan Cloud Storage for Firebase, 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 | |
Lokasi ini tidak mendukung Cloud Storage for Firebase. Jika berencana menggunakan Cloud Storage for Firebase, Anda harus memilih lokasi lain. |
Melbourne |
Langkah berikutnya
Untuk membuat database Cloud Firestore di lokasi tertentu, baca bagian Memulai Cloud Firestore.
Untuk membuat bucket Cloud Storage, buka halaman Memulai untuk platform Anda.
Untuk menjalankan fungsi terjadwal dengan Cloud Functions for Firebase, baca panduan penyiapan.
Untuk informasi lebih lanjut mengenai cara mem-build aplikasi yang memenuhi persyaratan latensi, ketersediaan, dan ketahanan, baca Geografi dan Region.