All Products
Search

This Product

    Tablestore:Buat tabel pemetaan

    Document Center

    Tablestore:Buat tabel pemetaan

    Last Updated:Apr 30, 2026

    Anda dapat mengeksekusi pernyataan CREATE TABLE untuk membuat tabel pemetaan atas tabel atau indeks pencarian yang sudah ada. Saat membuat tabel pemetaan, tentukan nama dan tipe bidang, informasi kunci primer, serta mesin eksekusi yang akan digunakan untuk mengkueri data sesuai kebutuhan bisnis Anda.

    Catatan

    Untuk informasi selengkapnya, lihat Buat tabel pemetaan untuk tabel dan Buat tabel pemetaan untuk indeks pencarian.

    Prasyarat

    Sebelum memulai, pastikan bahwa:

    Parameter

    Parameter

    Deskripsi

    query

    Pernyataan SQL yang digunakan untuk membuat tabel pemetaan. Tipe kolom dalam pernyataan tersebut harus sesuai dengan tipe data kolom terkait di tabel data.

    Contoh

    Catatan

    Topik ini menjelaskan cara membuat tabel pemetaan untuk tabel data. Untuk membuat tabel pemetaan bagi indeks pencarian, ganti pernyataan SQL dalam contoh kode berikut dengan pernyataan SQL untuk tabel pemetaan indeks pencarian.

    Berbeda dengan pernyataan CREATE TABLE pada database relasional, pernyataan ini tidak membuat tabel baru. Pernyataan ini membuat pemetaan SQL atas tabel data Tablestore yang sudah ada, sehingga memungkinkan kueri berbasis SQL pada data NoSQL.

    Contoh berikut membuat tabel pemetaan untuk test_table menggunakan pernyataan create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk)).

    const params = {
  // Pernyataan SQL untuk membuat tabel pemetaan.
  // Tipe kolom harus sesuai dengan tipe data kolom terkait di tabel data.
  // Untuk detail sintaksis SQL, lihat dokumentasi referensi SQL.
  query: "create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk))",
}

client.sqlQuery(params, function (err, data) {
  if (err) {
    console.log('sqlQuery error:', err.toString());
  } else {
    console.log('sqlQuery success:', data);
  }
});

    FAQ

    Apa yang harus saya lakukan jika muncul pesan error "Table 'instancename.tablename' doesn't exist?" saat membuat tabel pemetaan?

    • Kemungkinan penyebab

      Tabel tempat Anda ingin membuat tabel pemetaan tidak ada.

    • Solusi

      Anda hanya dapat mengeksekusi pernyataan CREATE TABLE dalam SQL untuk membuat tabel pemetaan atas tabel atau indeks pencarian yang sudah ada. Pastikan tabel atau indeks pencarian tersebut benar-benar tersedia.

    Apa yang harus saya lakukan jika muncul pesan error "Table 'instancename.tablename' already exist?" saat membuat tabel pemetaan?

    • Kemungkinan penyebab

      Tabel pemetaan telah dibuat untuk tabel tersebut.

      • Pengguna secara manual membuat tabel pemetaan untuk tabel tersebut.

      • Tablestore secara otomatis membuat tabel pemetaan untuk tabel tersebut. Jika Anda langsung menggunakan pernyataan SQL (seperti DESCRIBE, SELECT, dll.) untuk mengkueri data di tabel data tanpa membuat tabel pemetaan terlebih dahulu, Tablestore akan secara otomatis membuat tabel pemetaan tersebut. Tabel pemetaan yang dibuat secara otomatis hanya mencakup kolom kunci primer dan kolom pradefinisi dari tabel data. Anda tidak dapat memperbarui kolom atribut pada tabel pemetaan tersebut.

    • Solusi

      Anda dapat mengeksekusi pernyataan DESCRIBE untuk mengkueri skema tabel pemetaan. Jika skema tersebut tidak memenuhi kebutuhan bisnis Anda, Anda dapat memperbarui kolom atribut tabel pemetaan. Namun, jika tabel pemetaan tersebut dibuat secara otomatis oleh Tablestore, Anda tidak dapat memperbarui kolom atributnya. Dalam kasus ini, Anda dapat menghapus tabel pemetaan tersebut dan membuat yang baru, asalkan Anda yakin operasional bisnis Anda tidak terganggu setelah penghapusan tersebut.

    Catatan

    Untuk daftar error umum beserta solusinya terkait fitur kueri SQL, lihat Pemecahan masalah error kueri SQL umum.

    Referensi