Mengakses database Anda

Halaman ini menjelaskan cara mengakses database Firestore dalam mode Datastore dari berbagai platform.

Sebelum memulai

Halaman ini mengasumsikan bahwa Anda telah membuat database mode Datastore. Anda dapat membuat database dengan menyelesaikan Panduan Memulai Firestore dalam mode Datastore.

Mengakses database Anda dari App Engine

Untuk mulai menggunakan mode Datastore dan App Engine, lihat salah satu halaman khusus bahasa berikut:

Lingkungan Standar App Engine Lingkungan Fleksibel App Engine

Izin mode Datastore untuk App Engine

Aplikasi App Engine dapat mengakses database mode Datastore dalam project yang sama secara default. Setiap aplikasi App Engine menggunakan akun layanan default App Engine untuk mengelola akses ke layanan Google Cloud seperti Firestore. Secara default, akun layanan default App Engine memiliki peran IAM Project Editor, yang mencakup akses baca dan tulis penuh ke mode Datastore.

Anda dapat mengubah izin IAM akun layanan default App Engine Anda, tetapi aplikasi Anda dapat kehilangan akses ke Firestore, kecuali jika Anda menetapkan peran IAM dengan izin Firestore yang diperlukan. Peran IAM Datastore Owner dan Datastore User, misalnya, memberikan akses baca dan tulis ke Firestore dalam mode Datastore.

Jika Anda menonaktifkan atau menghapus akun layanan default App Engine, aplikasi App Engine akan kehilangan akses ke database mode Datastore Anda. Jika telah menonaktifkan akun layanan App Engine, Anda dapat mengaktifkannya kembali. Lihat mengaktifkan akun layanan. Jika telah menghapus akun layanan App Engine dalam 30 hari terakhir, Anda dapat memulihkannya. Lihat membatalkan penghapusan akun layanan.

Mengakses database Anda dari instance Compute Engine

Bagian ini menunjukkan cara mengaktifkan dan mengakses database mode Datastore dari instance VM Compute Engine dalam project baru atau yang sudah ada.

Izin mode Datastore untuk Compute Engine

Aplikasi Compute Engine dapat mengakses database mode Datastore dalam project yang sama secara default. Setiap aplikasi Compute Engine menggunakan akun layanan default Compute Engine untuk mengelola akses ke layanan Google Cloud seperti Firestore. Secara default, akun layanan default Compute Engine memiliki peran IAM Project Editor, yang mencakup akses baca dan tulis penuh ke mode Datastore.

Untuk mengakses database Anda dari instance Compute Engine, selesaikan langkah-langkah berikut:

  1. Aktifkan Google Compute Engine API untuk project Anda.
    Aktifkan Compute Engine API

  2. Make sure that billing is enabled for your Google Cloud project.

  3. Buat instance Compute Engine.

Konsol

  1. Di konsol Google Cloud, buka halaman VM Instances.
  2. Klik tombol Create instance.
  3. Di bagian Identity and API access, tetapkan Access scope untuk memberikan akses bagi Datastore. Klik Izinkan akses penuh ke semua Cloud API untuk memberikan akses ke semua Google Cloud API, atau klik Set access for each API, klik menu dropdown untuk Datastore, lalu klik Enabled untuk memberikan akses ke Datastore.
  4. Klik tombol Create untuk membuat instance VM.
  5. Pastikan instance sedang berjalan.
  6. Untuk menggunakan instance VM Compute Engine baru ini, hubungkan ke instance tersebut menggunakan browser Anda.

gcloud

  1. Jika Anda belum melakukannya, instal Google Cloud CLI dan siapkan gcloud compute.

  2. Tambahkan instance VM Compute Engine dan mulai instance tersebut, dengan mengikuti petunjuk untuk memulai instance dalam dokumentasi Compute Engine. Tentukan project ID, nama instance VM, dan cakupan cloud-platform atau datastore seperti yang ditunjukkan pada contoh berikut.

    export PROJECT_ID=[YOUR_PROJECT_ID]
export INSTANCE_NAME=[YOUR_INSTANCE_NAME]
gcloud compute instances create $INSTANCE_NAME --project $PROJECT_ID --scopes datastore

    Ganti [YOUR_PROJECT_ID] dengan ID project yang Anda buat sebelumnya dan [YOUR_INSTANCE_NAME] dengan nama yang ingin digunakan untuk instance VM Anda.

  3. Pastikan instance sedang berjalan.

  4. Untuk menggunakan instance VM baru ini, hubungkan ke VM.

Pada tahap ini, semua layanan dan otorisasi dikonfigurasi untuk project Anda dan Anda dapat mulai menulis kode atau menjelajahi API.

Mengakses database Anda dari platform lain

Bagian ini menunjukkan cara mengakses database mode Datastore Anda dari aplikasi eksternal yang berjalan di platform di luar Google Cloud.

Pertama, buat akun layanan:

  1. Di konsol Google Cloud, buka halaman Create service account.

    Buka Create service account

  2. Pilih project.

  3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud mengisi kolom Service account ID berdasarkan nama ini.

  4. Opsional: Di kolom Deskripsi akun layanan, masukkan deskripsi.

  5. Klik Create.

  6. Klik kolom Pilih peran.

    Pada bagian Semua peran, pilih peran yang memberikan akses ke database Anda, misalnya Datastore > Cloud Datastore User.

  7. Klik Lanjutkan.

  8. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

    Jangan tutup jendela browser Anda. Anda akan menggunakan halaman tersebut pada prosedur berikutnya.

Kemudian, buat kunci akun layanan:

  1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah dibuat.
  2. Klik Kunci.
  3. Klik Tambahkan kunci, lalu Buat kunci baru.
  4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
  5. Klik Close.

Gunakan akun layanan ini untuk mengonfigurasi kredensial untuk kode aplikasi Anda seperti yang dijelaskan dalam Memberikan kredensial akun layanan.

Kuota dan penagihan

Tersedia sejumlah kuota gratis tertentu, seperti yang dijelaskan pada Harga dan Kuota. Artinya, Anda tidak perlu mengaktifkan penagihan untuk memulai atau menggunakan Firestore dalam mode Datastore hingga batas kuota gratis. Namun, jika memerlukan resource lebih banyak dari yang disediakan oleh kuota gratis, Anda harus mengaktifkan penagihan.

Langkah selanjutnya

Untuk mengaktifkan penagihan, lihat Mengaktifkan penagihan untuk project.