Mengakses database Anda

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

Sebelum memulai

Dokumen ini mengasumsikan bahwa Anda telah membuat database mode Datastore. Jika Anda belum membuat database, ikuti petunjuk di Mulai cepat Firestore dalam mode Datastore.

Mengakses database 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, tetapi aplikasi Anda mungkin kehilangan akses ke Firestore kecuali jika Anda menetapkan peran IAM dengan izin Firestore yang diperlukan. Peran IAM Pemilik Datastore dan Pengguna Datastore, 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 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 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 Buat instance.
  3. Di bagian Identity and API access, tetapkan Access scopes untuk memberikan akses untuk Datastore. Klik Izinkan akses penuh ke semua Cloud API untuk memberi akses ke semua Google Cloud API, atau klik Tetapkan akses untuk setiap API, klik dropdown untuk Datastore, lalu klik Diaktifkan untuk memberi akses ke Datastore.
  4. Klik tombol Create untuk membuat instance VM.
  5. Pastikan instance Anda 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, 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 dalam 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 Anda gunakan untuk instance VM.

  3. Pastikan instance Anda berjalan.

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

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

Mengakses database dari platform lain

Bagian ini menunjukkan cara mengakses database mode Datastore 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 akan mengisi kolom ID akun layanan berdasarkan nama ini.

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

  5. Klik Buat.

  6. Klik kolom Pilih peran.

    Di bagian Semua peran, pilih peran yang memberikan akses ke database Anda, seperti 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 Buat. 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

Sejumlah kuota gratis tersedia, seperti yang dijelaskan dalam Harga dan Kuota. Artinya, Anda tidak diwajibkan untuk mengaktifkan penagihan untuk memulai atau menggunakan Firestore dalam mode Datastore hingga batas kuota gratis. Namun, jika Anda memerlukan lebih banyak resource daripada yang disediakan oleh kuota gratis, Anda harus mengaktifkan penagihan.

Langkah selanjutnya

Untuk mengaktifkan penagihan, lihat Mengaktifkan penagihan untuk project.