Dalam panduan memulai ini, Anda akan mempelajari cara mem-build Firebase Data Connect di aplikasi Anda.
- Tambahkan Firebase Data Connect ke project Firebase Anda.
- Siapkan lingkungan pengembangan termasuk ekstensi Visual Studio Code agar berfungsi dengan instance produksi.
- Kemudian, kami akan menunjukkan cara:
- Buat skema untuk aplikasi ulasan film dan deploy ke produksi.
- Tentukan kueri dan mutasi untuk skema Anda.
- Membuat SDK dengan jenis yang kuat dan menggunakannya di aplikasi
- Deploy skema, kueri, dan data akhir Anda ke produksi.
Prasyarat
Untuk menggunakan quickstart ini di lingkungan lokal, Anda memerlukan hal berikut.
- Linux, macOS, atau Windows
- Visual Studio Code
Menghubungkan ke project Firebase Anda
- Jika Anda belum melakukannya, buat project Firebase.
- Di Firebase console, klik Add project, lalu ikuti petunjuk di layar.
- Buka bagian Data Connect di konsol Firebase dan ikuti alur kerja penyiapan produk.
Upgrade project Anda ke paket Blaze. Dengan demikian, Anda dapat membuat instance Cloud SQL untuk PostgreSQL.
Pilih lokasi untuk database CloudSQL untuk PostgreSQL Anda.
Catat nama dan ID project, layanan, dan database untuk konfirmasi nanti.
Ikuti alur penyiapan yang tersisa, lalu klik Selesai.
Memilih dan menyiapkan lingkungan pengembangan
Data Connect mendukung dua pengalaman pengembangan untuk pengembangan:
- Jika Anda adalah developer Kotlin Android, iOS, Flutter, atau web, Anda dapat menggunakan pengembangan VS Code untuk mendesain dan menguji skema dan operasi secara lokal saat terhubung ke instance Cloud SQL untuk PostgreSQL.
- Jika Anda adalah developer web, Anda dapat menggunakan Pengembangan IDX untuk membuat prototipe di ruang kerja IDX menggunakan template IDX yang telah dikonfigurasi sebelumnya dengan PostgreSQL, ekstensi VS Code dengan emulator Data Connect, dan kode klien quickstart yang disiapkan untuk Anda. Anda akan menemukan informasi selengkapnya di situs Project IDX.
Panduan memulai ini berfokus pada alur pengembangan ekstensi VS Code. Untuk melanjutkan:
- Buat direktori baru untuk project lokal Anda.
- Buka VS Code di direktori baru.
Instal ekstensi Firebase Data Connect dari Visual Studio Code Marketplace.
Menyiapkan project lokal
Instal CLI, dengan mengikuti petunjuk normal. Jika Anda sudah menginstal npm, jalankan perintah berikut:
npm install -g firebase-tools
Menyiapkan direktori project
Untuk menyiapkan project lokal, lakukan inisialisasi direktori project.
Di panel sebelah kiri VS Code, klik ikon Firebase untuk membuka UI ekstensi Firebase VS Code.
- Klik tombol Sign in with Google.
- Klik tombol Connect a Firebase project dan pilih project yang Anda buat sebelumnya di konsol.
- Klik tombol Run firebase init.
- Jika project Anda menggunakan paket Blaze, saat diminta "Apakah Anda ingin mengonfigurasi resource backend sekarang?", jawab "Ya".
Klik tombol Start emulators.
Membuat skema
Di direktori project Firebase, dalam file /dataconnect/schema/schema.gql
, mulai tentukan skema GraphQL yang menyertakan film.
Film
Di Data Connect, kolom GraphQL dipetakan ke kolom. Jenis Movie
memiliki id
, title
, imageUrl
, dan genre
. Data Connect
mengenali jenis data primitif String
dan UUID
.
Salin cuplikan berikut atau hapus tanda komentar pada baris yang sesuai dalam file.
# File `/dataconnect/schema/schema.gql`
# By default, a UUID id key will be created by default as primary key.
type Movie @table {
id: UUID! @default(expr: "uuidV4()")
title: String!
imageUrl: String!
genre: String
}
MovieMetadata
Setelah memiliki film, Anda dapat membuat model metadata film.
Salin cuplikan berikut atau hapus tanda komentar pada baris yang sesuai dalam file.
# Movie - MovieMetadata is a one-to-one relationship
type MovieMetadata @table {
# This time, we omit adding a primary key because
# you can rely on Data Connect to manage it.
# @unique indicates a 1-1 relationship
movie: Movie! @unique
# movieId: UUID <- this is created by the above reference
rating: Float
releaseYear: Int
description: String
}
Perhatikan bahwa kolom movie
dipetakan ke jenis Movie
.
Data Connect memahami bahwa ini adalah hubungan antara Movie
dan MovieMetadata
dan akan mengelola hubungan ini untuk Anda.
Pelajari skema Data Connect lebih lanjut dalam dokumentasi
Men-deploy skema ke produksi
Jika menggunakan ekstensi Firebase VS Code untuk menggunakan database produksi, Anda harus men-deploy skema sebelum melanjutkan. Setelah men-deploy skema ke database produksi, Anda akan dapat melihat skema di konsol.
- Anda dapat menggunakan ekstensi VS Code Data Connect untuk men-deploy.
- Di UI ekstensi, pada panel Firebase Data Connect, klik Deploy to production.
- Anda mungkin perlu meninjau perubahan skema dan menyetujui perubahan yang berpotensi
merusak. Anda akan diminta untuk:
- Meninjau perubahan skema menggunakan
firebase dataconnect:sql:diff
- Setelah Anda puas dengan perubahannya, terapkan perubahan tersebut menggunakan alur yang dimulai oleh
firebase dataconnect:sql:migrate
.
- Meninjau perubahan skema menggunakan
Menambahkan data ke tabel
Di panel editor VS Code, Anda dapat melihat tombol CodeLens muncul di atas
jenis GraphQL di /dataconnect/schema/schema.gql
. Setelah men-deploy skema ke produksi, Anda dapat menggunakan tombol Tambahkan data dan Jalankan (Produksi) untuk menambahkan data ke database di backend.
Untuk menambahkan data ke tabel Movie
:
- Di
schema.gql
, klik tombol Tambahkan data di atas deklarasi jenisMovie
.
- Dalam file
Movie_insert.gql
yang dihasilkan, hard code data untuk empat kolom. - Klik tombol Run (Production).
- Ulangi langkah sebelumnya untuk menambahkan data ke tabel
MovieMetadata
, dengan menyediakanid
Film Anda di kolommovieId
, seperti yang diminta dalam mutasiMovieMetadata_insert
yang dihasilkan.
Untuk memverifikasi dengan cepat bahwa data telah ditambahkan:
- Kembali ke
schema.gql
, klik tombol Baca data di atas deklarasi jenisMovie
. - Pada file
Movie_read.gql
yang dihasilkan, klik tombol Run (Production) untuk menjalankan kueri.
Pelajari mutasi Data Connect lebih lanjut dalam dokumentasi
Menentukan kueri
Sekarang saatnya bagian yang menyenangkan, kueri. Sebagai developer, Anda terbiasa menulis kueri SQL, bukan kueri GraphQL, sehingga hal ini mungkin terasa sedikit berbeda pada awalnya. Namun, GraphQL jauh lebih ringkas dan aman dari jenis daripada SQL mentah. Selain itu, ekstensi VS Code kami akan memudahkan pengalaman pengembangan.
Mulai edit file /dataconnect/connector/queries.gql
. Jika Anda ingin mendapatkan semua film, gunakan kueri seperti ini.
# File `/dataconnect/connector/queries.gql`
# @auth() directives control who can call each operation.
# Anyone should be able to list all movies, so the auth level
# is set to PUBLIC
query ListMovies @auth(level: PUBLIC) {
movies {
id
title
imageUrl
genre
}
}
Jalankan kueri menggunakan tombol CodeLens di dekatnya.
Pelajari kueri Data Connect lebih lanjut dalam dokumentasi
Membuat SDK dan menggunakannya di aplikasi
- Klik tombol Tambahkan SDK ke aplikasi.
Pada dialog yang muncul, pilih direktori yang berisi kode untuk aplikasi Anda. Data Connect. Kode SDK akan dibuat dan disimpan di sana.
Pilih platform aplikasi Anda, lalu perhatikan bahwa kode SDK langsung dibuat di direktori yang Anda pilih.
Pelajari cara menggunakan SDK yang dihasilkan untuk memanggil kueri dan mutasi dari aplikasi klien (web, Android, iOS, Flutter).
Men-deploy skema dan kueri ke produksi
Anda telah mengerjakan iterasi pengembangan. Sekarang Anda dapat men-deploy skema, data, dan kueri ke server dengan UI ekstensi Firebase atau CLI Firebase, seperti yang Anda lakukan dengan skema.
Jika Anda menggunakan ekstensi Firebase VS Code untuk men-deploy, klik tombol Deploy to production.
Setelah di-deploy, buka konsol Firebase untuk memverifikasi bahwa skema, operasi, dan data telah diupload ke cloud. Anda harus dapat melihat skema, dan menjalankan operasi di konsol juga. Instance Cloud SQL untuk PostgreSQL akan diperbarui dengan skema dan data akhir yang dihasilkan dan di-deploy.
Pelajari lebih lanjut cara menggunakan emulator Data Connect dalam dokumentasi
Langkah berikutnya
Tinjau project yang di-deploy dan temukan alat lainnya:
Tambahkan data ke database, periksa dan ubah skema, serta pantau layanan Data Connect di Firebase console. Akses informasi selengkapnya dalam dokumentasi. Misalnya, setelah Anda menyelesaikan panduan memulai:
Pelajari lebih lanjut pengembangan skema, kueri, dan mutasi
Pelajari cara membuat SDK klien dan memanggil kueri serta mutasi dari kode klien untuk web, Android, iOS, dan Flutter.