Gunakan Tablestore SDK untuk Node.js guna menjalankan operasi pada model wide column.
Quick start
Siapkan lingkungan, instal SDK, dan inisialisasi client untuk mulai menggunakan Tablestore SDK untuk Node.js.
Prasyarat
-
Node.js 4.0 atau versi yang lebih baru.
PentingJangan gunakan Node.js versi 12.0 hingga 12.14 karena terdapat masalah kompatibilitas.
Alat pengembangan Node.js.
Instal SDK
Jalankan perintah npm berikut untuk menginstal Tablestore SDK untuk Node.js:
npm install tablestore
Program contoh yang mencakup operasi umum pada model wide column tersedia melalui saluran berikut:
Unduh Node.js SDK dan lihat contoh di folder sample.
Kunjungi repositori GitHub.
Konfigurasikan kredensial akses
Buat AccessKey untuk Akun Alibaba Cloud Anda atau Pengguna RAM. Kemudian, konfigurasikan AccessKey tersebut dalam variabel lingkungan seperti yang ditunjukkan di bawah ini. Mengonfigurasi AccessKey dalam variabel lingkungan meningkatkan keamanan karena mencegah penyematan informasi sensitif secara langsung di dalam kode.
Setelah konfigurasi selesai, Anda harus me-restart atau merefresh lingkungan pengembangan Anda. Ini mencakup IDE, command-line interface, aplikasi desktop lainnya, serta layanan latar belakang. Hal ini memastikan bahwa variabel lingkungan sistem terbaru dimuat. Untuk informasi selengkapnya mengenai jenis kredensial akses lainnya, lihat Konfigurasikan kredensial akses.
Linux
-
Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file
~/.bashrc.echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc -
Jalankan perintah berikut untuk menerapkan perubahan.
source ~/.bashrc -
Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
macOS
-
Jalankan perintah berikut di terminal untuk melihat jenis shell default Anda.
echo $SHELL -
Lakukan langkah-langkah berikut berdasarkan jenis shell default Anda.
Zsh
-
Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file
~/.zshrc.echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc -
Jalankan perintah berikut untuk menerapkan perubahan.
source ~/.zshrc -
Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
Bash
-
Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file
~/.bash_profile.echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profile -
Jalankan perintah berikut untuk menerapkan perubahan.
source ~/.bash_profile -
Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
-
Windows
CMD
-
Jalankan perintah berikut di Command Prompt (CMD) untuk mengatur variabel lingkungan.
setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID" setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET" -
Restart CMD dan jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
echo %TABLESTORE_ACCESS_KEY_ID% echo %TABLESTORE_ACCESS_KEY_SECRET%
PowerShell
-
Jalankan perintah berikut di PowerShell.
[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User) -
Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User) [Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)
Inisialisasi client
Setelah Anda menginisialisasi client, daftarkan tabel-tabel dalam instans untuk memverifikasi koneksi.
Akses jaringan publik dinonaktifkan secara default untuk instans baru. Untuk mengakses sumber daya instans melalui jaringan publik, aktifkan akses jaringan publik di Network Management.
var TableStore = require('tablestore');
// Ganti yourInstanceName dengan nama instans Anda
var instancename = 'yourInstanceName';
// Ganti yourEndpoint dengan titik akhir instans Anda
var endpoint = 'yourEndpoint';
// Dapatkan ID AccessKey dan AccessKey Secret dari variabel lingkungan
var accessKeyId = process.env.TABLESTORE_ACCESS_KEY_ID;
var secretAccessKey = process.env.TABLESTORE_ACCESS_KEY_SECRET;
// Inisialisasi client Tablestore
var client = new TableStore.Client({
accessKeyId: accessKeyId,
secretAccessKey: secretAccessKey,
endpoint: endpoint,
instancename: instancename
});
// Daftarkan semua tabel dalam instans dan cetak ke konsol
client.listTable({}, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', data);
});
Tipe data
Tipe data Tablestore dipetakan ke tipe data Node.js SDK sebagai berikut.
|
Tipe data Tablestore |
Tipe data Node.js SDK |
Deskripsi |
|
String |
string |
Tipe primitif JavaScript. |
|
Integer |
int64 |
Tipe yang disediakan oleh SDK. JavaScript tidak memiliki tipe integer 64-bit bawaan. SDK menyediakan dukungan |
|
Double |
number |
Tipe primitif JavaScript. |
|
Boolean |
boolean |
Tipe primitif JavaScript. |
|
Binary |
Buffer |
Objek |
TableStore.Long mengonversi antara int64 dan tipe JavaScript bawaan number atau string:
// Buat int64 dari number atau string
const valueA = TableStore.Long.fromNumber(1000);
const valueB = TableStore.Long.fromString('2000');
// Konversi int64 kembali ke tipe JavaScript bawaan
const numA = valueA.toNumber(); // 1000
const strA = valueA.toString(); // '1000'
const numB = valueB.toNumber(); // 2000
const strB = valueB.toString(); // '2000'
FAQ
Referensi
Untuk informasi mengenai penanganan error di Tablestore, lihat Error handling.