All Products
Search
Document Center

Tablestore:Node.js SDK

Last Updated:Jun 04, 2026

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.

    Penting

    Jangan 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:

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

  1. 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
  2. Jalankan perintah berikut untuk menerapkan perubahan.

    source ~/.bashrc
  3. Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.

    echo $TABLESTORE_ACCESS_KEY_ID
    echo $TABLESTORE_ACCESS_KEY_SECRET

macOS

  1. Jalankan perintah berikut di terminal untuk melihat jenis shell default Anda.

    echo $SHELL
  2. Lakukan langkah-langkah berikut berdasarkan jenis shell default Anda.

    Zsh
    1. 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
    2. Jalankan perintah berikut untuk menerapkan perubahan.

      source ~/.zshrc
    3. Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.

      echo $TABLESTORE_ACCESS_KEY_ID
      echo $TABLESTORE_ACCESS_KEY_SECRET
    Bash
    1. 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
    2. Jalankan perintah berikut untuk menerapkan perubahan.

      source ~/.bash_profile
    3. Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.

      echo $TABLESTORE_ACCESS_KEY_ID
      echo $TABLESTORE_ACCESS_KEY_SECRET

Windows

CMD
  1. 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"
  2. Restart CMD dan jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.

    echo %TABLESTORE_ACCESS_KEY_ID%
    echo %TABLESTORE_ACCESS_KEY_SECRET%
PowerShell
  1. 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)
  2. 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.

Penting

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 int64 melalui TableStore.Long.

Double

number

Tipe primitif JavaScript.

Boolean

boolean

Tipe primitif JavaScript.

Binary

Buffer

Objek Buffer Node.js untuk menangani data biner.

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.