Halaman ini menyediakan latihan singkat dalam membangun aplikasi TaskList command line sederhana dengan Firestore dalam API mode Datastore. Aplikasi TaskList menyimpan, mencantumkan, memperbarui, dan menghapus tugas.
Prasyarat
- Kemampuan untuk menulis dan menjalankan aplikasi command line dalam bahasa pemrograman yang digunakan dalam topik ini
Selain pemahaman dasar tentang cara mengembangkan aplikasi, Anda harus dapat mendownload dan menginstal library tambahan sebelum mencoba tutorial ini. - Project konsol Google Cloud dengan API mode Datastore aktif
Aplikasi yang menggunakan mode Datastore harus dikaitkan dengan project Google Cloud Console dengan API mode Datastore aktif. Project ini memberikan kredensial autentikasi yang Anda gunakan dalam aplikasi untuk mengidentifikasinya ke Google dan mengizinkan penggunaan API mode Datastore.
Ikuti petunjuk ini untuk membuat project, mengaktifkan API mode Datastore untuk project tersebut, lalu menyiapkan lingkungan pengembangan lokal Anda dengan kredensial autentikasi menggunakan perintahgcloud auth login
. Catat ID proyek, yang akan Anda gunakan nanti. - Aplikasi App Engine yang aktif
Project yang menggunakan API mode Datastore memerlukan aplikasi App Engine yang aktif. Buka dasbor App Engine dan pastikan project Anda memiliki aplikasi App Engine yang aktif.
Buat aplikasi App Engine jika perlu. Aplikasi tidak boleh dinonaktifkan.
Penginstalan dan penyiapan
Instal library klien dan konfigurasikan setelan tambahan apa pun untuk lingkungan pengembangan Anda.
C#
- Pastikan Anda telah menginstal Visual Studio (versi 2013 atau yang lebih baru).
- Download aplikasi contoh TaskList dari sini.
- Ekstrak file dari zip ke direktori di folder Documents Anda.
- Di Visual Studio, buka file
dotnet-docs-samples-master\datastore\api\Datastore.sln
. - Di jendela Solution Explorer Visual Studio, klik kanan project TaskList dan pilih Set as StartUp Project.
- Klik kanan project TaskList lagi, lalu pilih Properties.
Di jendela Properties, klik Debug, lalu ketik ID project Google Cloud Platform Anda ke dalam kotak Command line arguments:.
Klik File, lalu klik Save untuk menyimpan perubahan.
Jalankan aplikasi. Tekan F5 di keyboard.
Go
Meng-clone aplikasi contoh TaskList.
go get github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
Ubah direktori tempat Anda meng-clone sampel:
cd $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
Di command prompt, jalankan perintah berikut, dengan
<project-id>
sebagai ID project Google Cloud Platform Anda.export DATASTORE_PROJECT_ID=<project-id>
(Pengguna Windows: gunakan
set
, bukanexport
.)Jalankan aplikasi.
go run tasks.go
Java
Pastikan Anda telah menginstal Maven dan Java (versi 8 atau yang lebih baru).
Download aplikasi contoh TaskList dari sini.
Di command prompt, ekstrak hasil download:
unzip main.zip
Ubah direktori ke aplikasi TaskList:
cd java-datastore-main/samples/snippets
Jalankan perintah berikut, dengan
<project-id>
sebagai ID project Google Cloud Platform Anda.gcloud config set project <project-id>
Kompilasi dan jalankan aplikasi.
mvn clean compile mvn exec:java -Dexec.mainClass="com.google.datastore.snippets.TaskList"
Node.js
Download aplikasi contoh TaskList dari sini.
Ekstrak download:
unzip master.zip
Ubah direktori ke aplikasi TaskList:
cd nodejs-datastore-master/samples
Instal dependensi dan tautkan aplikasi:
npm install
Di command prompt, jalankan perintah berikut, dengan
<project-id>
sebagai ID project Google Cloud Platform Anda.export GCLOUD_PROJECT=<project-id>
(Pengguna Windows: gunakan
set
, bukanexport
.)Jalankan aplikasi.
node tasks.js
PHP
- Pastikan Anda telah menginstal PHP (versi 5.6 atau yang lebih baru) dan Composer.
- Download aplikasi contoh TaskList dari sini.
Ekstrak download:
unzip master.zip
Ubah direktori ke aplikasi TaskList:
cd php-docs-samples-master/datastore/tutorial
Instal dependensi.
composer install
Jalankan aplikasi.
php src/list_tasks.php
Python
- Pastikan Anda telah menginstal Python (versi 2.7.9 atau yang lebih baru), pip, dan virtualenv.
Aktifkan sesi
virtualenv
.virtualenv venv source venv/bin/activate
Download aplikasi contoh TaskList dari sini.
Ekstrak download:
unzip master.zip
Ubah direktori ke aplikasi TaskList:
cd python-docs-samples-master/datastore/cloud-client
Instal dependensi:
pip install -r requirements.txt
Jalankan aplikasi. Gunakan ID project Google Cloud Platform untuk
<project-id>
.python tasks.py new project-id
Ruby
Download aplikasi contoh TaskList dari sini.
Ekstrak download:
unzip master.zip
Ubah direktori ke aplikasi TaskList:
cd google-cloud-ruby-master/google-cloud-datastore/samples
Instal dependensinya:
bundle install
Di command prompt, jalankan perintah berikut, dengan
<project-id>
sebagai ID project Google Cloud Platform Anda.export GOOGLE_CLOUD_PROJECT=<project-id>
(Pengguna Windows: gunakan
set
, bukanexport
.)Jalankan aplikasi.
bundle exec ruby tasks.rb
Membuat Objek Layanan yang Diotorisasi
Untuk membuat permintaan terautentikasi ke Google Cloud API menggunakan library Klien Google API, Anda harus:
- Ambil kredensial yang akan digunakan untuk permintaan.
- Buat objek layanan yang menggunakan kredensial tersebut.
Kemudian, Anda dapat melakukan panggilan API dengan memanggil metode pada objek layanan mode Datastore.
Untuk contoh ini, Anda akan mengambil Kredensial Default Aplikasi dari lingkungan, dan meneruskannya sebagai argumen untuk membuat objek layanan.
Berikut adalah panggilan untuk membuat objek layanan mode Datastore resmi:
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Menyimpan data
Objek dalam mode Datastore dikenal sebagai entitas, dan setiap entity memiliki jenis tertentu. Aplikasi TaskList akan menyimpan entity jenis
Task
, dengan properti berikut:
description
: string yang ditentukan oleh pengguna sebagai deskripsi tugascreated
: tanggal yang menunjukkan kapan tugas pertama kali dibuatdone
: boolean yang menunjukkan apakah tugas telah selesai
Saat pengguna menambahkan tugas baru, aplikasi TaskList akan membuat entity Task
dengan nilai untuk properti yang tercantum di atas:
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk aplikasi ini, kami juga akan menyediakan metode untuk memperbarui properti done
, guna menunjukkan bahwa tugas telah selesai:
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Berikut adalah metode untuk menghapus entity Task
menggunakan kunci entity Task
:
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Menjalankan kueri
Selain mengambil entity dari mode Datastore langsung menurut kuncinya, aplikasi dapat menjalankan kueri untuk mengambilnya berdasarkan nilai propertinya. Kueri tipikal mencakup hal berikut:
- Jenis entitas yang dikenai kueri
- Nol atau beberapa filter, misalnya untuk memilih jenis yang propertinya cocok dengan sebuah nilai
- Nol atau beberapa tata urutan, untuk mengurutkan hasil
Untuk aplikasi ini, kita akan membuat kueri mode Datastore untuk entity Task
yang diurutkan berdasarkan waktu pembuatan:
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Cloud Datastore, lihat library klien Cloud Datastore. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Cloud Datastore.
Untuk melakukan autentikasi ke Cloud Datastore, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Langkah Berikutnya
Tutorial ini hanya membahas langkah-langkah paling dasar yang diperlukan untuk melakukan panggilan ke API mode Datastore dari aplikasi command line. Mode Datastore mendukung transaksi ACID yang cepat dan sangat skalabel, kueri mirip SQL, indeks, dan lainnya.
- Untuk mempelajari lebih lanjut kemampuan mode Datastore, baca Apa yang dimaksud dengan Firestore dalam mode Datastore?.
- Untuk mengetahui informasi tentang penggunaan emulator mode Datastore saat Anda mengembangkan aplikasi, lihat Emulator mode Datastore.