Tablestore:Perbarui kolom atribut tabel pemetaan

Prasyarat

• Instans OTSClient telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi instans OTSClient.

• Tabel pemetaan telah dibuat. Untuk informasi lebih lanjut, lihat Buat tabel pemetaan.

Catatan penggunaan

• Anda hanya dapat menjalankan pernyataan ALTER TABLE untuk memperbarui kolom atribut pada tabel pemetaan yang dibuat dengan pernyataan CREATE TABLE. Anda tidak dapat menggunakan pernyataan ALTER TABLE untuk memperbarui kolom atribut pada tabel pemetaan yang dibuat secara otomatis melalui pernyataan DESCRIBE.

• Dalam satu eksekusi pernyataan ALTER TABLE, Anda hanya dapat menambahkan atau menghapus satu kolom atribut. Untuk menambahkan atau menghapus beberapa kolom atribut, jalankan pernyataan tersebut beberapa kali.

• Pernyataan ALTER TABLE hanya memperbarui skema tabel pemetaan, bukan skema tabel Tablestore tempat tabel pemetaan tersebut dibuat.

• Anda tidak dapat menggunakan pernyataan ALTER TABLE untuk menambahkan atau menghapus kolom kunci primer pada tabel pemetaan.

• Setelah menjalankan pernyataan ALTER TABLE, mesin SQL melakukan refresh tabel pemetaan secara asinkron. Proses ini memerlukan waktu hingga 30 detik. Selama periode refresh tersebut, kolom yang baru ditambahkan mungkin tidak dikembalikan dalam operasi yang seharusnya mengembalikan semua kolom.

Parameter

Contoh

• Tambahkan kolom atribut

  Contoh berikut menambahkan kolom colvalue bertipe BIGINT ke tabel pemetaan bernama exampletable:

  const params = {
    query: "alter table exampletable add column colvalue bigint",
  }
  
  client.sqlQuery(params, function (err, data) {
    if (err) {
      console.log('sqlQuery error:', err.toString());
    } else {
      console.log('sqlQuery success:', data);
    }
  });

• Hapus kolom atribut

  Contoh berikut menghapus kolom colvalue dari tabel pemetaan bernama exampletable:

  const params = {
    query: "alter table exampletable drop column colvalue",
  }
  
  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 "Unsupported operation: Unsupported alter non-mapping table" saat memperbarui kolom atribut tabel pemetaan?

• Bagaimana cara mengatasi error umum pada kueri SQL?

Langkah selanjutnya

• Untuk mempercepat kueri dan komputasi data SQL, Anda dapat membuat indeks sekunder atau indeks pencarian. Untuk informasi lebih lanjut, lihat Kebijakan pemilihan indeks dan Computation pushdown.

• Jalankan pernyataan SELECT untuk mengkueri dan menganalisis data menggunakan tabel pemetaan. Untuk informasi lebih lanjut, lihat Kueri data.

• Jalankan pernyataan DESCRIBE untuk melihat detail tabel. Untuk informasi lebih lanjut, lihat Kueri informasi tentang tabel.

• Jalankan pernyataan DROP MAPPING TABLE untuk menghapus tabel pemetaan yang dibuat untuk suatu tabel atau indeks pencarian. Untuk informasi lebih lanjut, lihat Hapus tabel pemetaan.

• Jalankan pernyataan SHOW INDEX untuk melihat informasi indeks suatu tabel. Untuk informasi lebih lanjut, lihat Kueri informasi indeks tabel.

• Jalankan pernyataan SHOW TABLES untuk menampilkan daftar tabel pemetaan dalam database saat ini. Untuk informasi lebih lanjut, lihat Daftar nama tabel.