Topik ini menjelaskan operasi dasar fitur inti yang disediakan oleh Edge KV. Panduan ini membantu Anda membuat namespace, membaca dan menulis data, serta mengintegrasikan API melalui instruksi sederhana, contoh kode, dan pertimbangan penting.
Sebelum Anda mulai
Sebelum menggunakan Edge KV, perhatikan hal-hal berikut:
Ruang penyimpanan
Satu akun Alibaba Cloud dapat memiliki hingga 10 GB ruang penyimpanan.
Satu namespace dapat memiliki hingga 1 GB ruang penyimpanan.
Key-Value
Panjang key maksimum adalah 512 byte dan hanya boleh berisi huruf, angka, tanda hubung (-), serta garis bawah (_). Key tidak boleh berisi karakter khusus seperti spasi, garis miring (/), atau tanda tanya (?).
Ukuran value maksimum adalah 1,8 MB.
CatatanSetiap pasangan key-value terkait dengan satu namespace.
Waktu sinkronisasi
Untuk memastikan konsistensi data, data disinkronkan ke titik kehadiran (POPs) di seluruh dunia dalam waktu 20 detik, meskipun dalam kasus langka bisa mencapai 300 detik.
Batas akses
Edge Routine hanya dapat membaca dan menulis data Edge KV dari akun Alibaba Cloud yang sama. Sebagai contoh, Edge Routine Akun A tidak dapat membaca atau menulis data Edge KV milik Akun B.
Menggunakan Edge KV
Setelah mengaktifkan Edge KV, Anda dapat menggunakannya melalui Konsol Edge Security Acceleration (ESA) atau dengan melakukan operasi API bawaan dari Edge Routine.
Membuat namespace
Namespace bersifat terisolasi satu sama lain. Anda dapat membuat hingga 10 namespace.
Masuk ke Konsol ESA, lalu pilih di panel navigasi sebelah kiri.
Pada halaman yang muncul, klik Create Namespace. Di dialog yang muncul, ikuti petunjuk untuk menentukan parameter Namespace Name dan Description.
CatatanParameter Namespace Name sesuai dengan parameter namespace dalam operasi API bawaan Edge Routine.
Klik OK.
Mengelola data Edge KV
Mengelola data Edge KV menggunakan Konsol ESA
Anda dapat menambahkan nilai dengan ukuran hingga 100 KB di Konsol ESA. Untuk nilai lebih besar, gunakan operasi API dari Edge Routine.
Anda dapat menambah, memodifikasi, atau menghapus data Edge KV di Konsol ESA.
Masuk ke Konsol ESA, lalu pilih di panel navigasi sebelah kiri.
Dalam daftar namespace, temukan namespace yang ingin dikelola dan klik Manage di kolom Actions.
Klik Add Key-value Pair dan ikuti petunjuk untuk menentukan parameter Key dan Value.
Klik OK.
Opsional. Setelah menambahkan data, klik Modify, View, atau Delete untuk mengelola data.
Mengelola data Edge KV dengan melakukan operasi API
Anda dapat menggunakan operasi API bawaan dari Edge Routine untuk menambah, memodifikasi, menanyakan, atau menghapus data Edge KV.
Sebelum melakukan operasi API untuk mengelola data, pastikan bahwa sebuah namespace telah dibuat di Konsol ESA.
Untuk informasi lebih lanjut tentang operasi API, lihat Operasi API Edge KV.
Lakukan operasi Constructor untuk melewatkan parameter namespace guna membuat objek key-value.
Nilai parameter namespace adalah nama namespace yang Anda buat di Konsol ESA. Anda dapat melihatnya di daftar namespace.
const edgeKv = new EdgeKV({ namespace: "ns"});Setelah membuat objek key-value, lakukan operasi API bawaan berikut untuk mengimplementasikan fitur terkait: