Menggunakan Admin SDK dengan Data Connect

Firebase Admin SDK adalah serangkaian library server yang dapat Anda gunakan untuk berinteraksi dengan Firebase dari lingkungan istimewa untuk melakukan berbagai tindakan, seperti menjalankan kueri dan mutasi pada layanan Firebase Data Connect untuk pengelolaan data massal dan operasi lainnya dengan hak istimewa yang ditingkatkan.

Admin SDK memberi Anda API untuk memanggil operasi di kedua mode baca/tulis dan hanya baca. Dengan operasi hanya baca, Anda dapat merasa tenang dalam menerapkan fungsi administratif yang tidak dapat mengubah data di database.

Penyiapan Admin SDK

Untuk mulai menggunakan dengan Firebase Data Connect di server, Anda akan pertama-tama harus menginstal dan menyiapkan Admin SDK untuk Node.js

Menginisialisasi Admin SDK dalam skrip Anda

Untuk menginisialisasi SDK, impor ekstensi Data Connect dan mendeklarasikan ID dan lokasi layanan project Anda.


import { initializeApp } from 'firebase-admin/app';
import { getDataConnect } from 'firebase-admin/data-connect';

// If you'd like to use OAuth2 flows and other credentials to log in,
// visit https://firebase.google.com/docs/admin/setup#initialize-sdk
// for alternative ways to initialize the SDK.

const app = initializeApp();

const dataConnect = getDataConnect({
    serviceId: 'serviceId',
    location: 'us-west2'
});

Mendesain kueri dan mutasi untuk digunakan dengan Admin SDK

Admin SDK berguna untuk menguji operasi Data Connect, dengan pertimbangan berikut.

Pahami perintah operasi SDK dan @auth(level: NO_ACCESS)

Karena Admin SDK beroperasi dengan hak istimewa, Admin SDK dapat menjalankan kueri dan mutasi apa pun, terlepas dari tingkat akses yang ditetapkan menggunakan perintah @auth, termasuk tingkat NO_ACCESS.

Jika bersama dengan operasi klien, Anda mengatur kueri administratif dan mutasi di file sumber .gql untuk diimpor ke skrip administratif, Firebase merekomendasikan agar Anda menandai operasi administratif tanpa akses otorisasi, atau mungkin lebih eksplisit dan mengaturnya sebagai NO_ACCESS. Bagaimanapun, hal ini mencegah operasi tersebut dijalankan dari klien atau dalam konteks non-hak istimewa lainnya.

Menggunakan SDK dengan emulator Data Connect

Di lingkungan prototipe dan pengujian, sebaiknya lakukan seeding data dan operasi lainnya pada data lokal. Admin SDK memungkinkan Anda menyederhanakan alur kerja karena mengabaikan otentikasi dan otorisasi untuk alur lokal.

Firebase Admin SDK otomatis terhubung ke emulator Data Connect saat variabel lingkungan DATA_CONNECT_EMULATOR_HOST ditetapkan:

export DATA_CONNECT_EMULATOR_HOST="127.0.0.1:8080"

Untuk informasi selengkapnya, lihat:

Mengimplementasikan kasus penggunaan umum

Admin SDK disediakan untuk operasi dengan hak istimewa pada data penting Anda.

API untuk Data Connect terdiri dari executeGraphql baca-tulis dan antarmuka executeGraphqlRead hanya baca.

Mengelola data pengguna

Kasus penggunaan umum untuk Admin SDK adalah mengelola data pengguna.

interface UserData {
  user: {
    id: string;
    name: string;
  };
}

export interface UserVariables {
  id: string;
}

const options:GraphqlOptions<UserVariables> = { variables: { id: "QVBJcy5ndXJ1" } };

// user can be publicly accessible, or restricted to admins
const query = "query getProfile(id: AuthID) { user(id: $id) { id name } }";

//executeGraphql
const gqlResponse = await dataConnect.executeGraphql<UserData, UserVariables>(query, options);

//executeGraphqlRead (similar to above but only for read operations)
const gqlResponse = await dataConnect.executeGraphqlRead<UserData, UserVariables>(query, options);

// gqlResponse -> { "data": { "user": { "id": "QVBJcy5ndXJ1", "name": "Fred" } } }

Apa langkah selanjutnya?