Tablestore：Perbarui kolom atribut tabel pemetaan

Prasyarat

• Sebuah instance OTSClient telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi Instance OTSClient.

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

Catatan penggunaan

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

• Anda dapat menambah atau menghapus satu kolom atribut dalam tabel pemetaan dengan menjalankan pernyataan ALTER TABLE. Untuk menambah atau menghapus beberapa kolom atribut, jalankan pernyataan ALTER TABLE beberapa kali.

• Pernyataan ALTER TABLE hanya memperbarui skema tabel pemetaan. Skema tabel Tablestore tempat tabel pemetaan dibuat tidak diperbarui.

• Kolom kunci utama dalam tabel pemetaan tidak dapat ditambahkan atau dihapus menggunakan pernyataan ALTER TABLE.

• Setelah menjalankan pernyataan ALTER TABLE, mesin SQL akan memperbarui tabel pemetaan secara asinkron. Proses ini dapat memakan waktu hingga 30 detik. Selama periode ini, kolom baru mungkin tidak langsung tersedia dalam hasil query.

Parameter

Contoh

• Tambahkan Kolom Atribut ke Tabel Pemetaan

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

  $request = array(
      'query' => 'alter table exampletable add column colvalue bigint',
  );
  $response = $otsClient->sqlQuery($request);
  print json_encode($response, JSON_PRETTY_PRINT);

• Hapus Kolom Atribut dari Tabel Pemetaan

  Contoh kode berikut menunjukkan cara menghapus kolom colvalue bertipe BIGINT dari tabel pemetaan bernama exampletable:

  $request = array(
      'query' => 'alter table exampletable drop column colvalue',
  );
  $response = $otsClient->sqlQuery($request);
  print json_encode($response, JSON_PRETTY_PRINT);

FAQ

• Apa yang harus saya lakukan jika pesan kesalahan "Unsupported operation: Unsupported alter non-mapping table" muncul saat memperbarui kolom atribut tabel pemetaan?

• Bagaimana cara menangani kesalahan umum dari kueri SQL?

Referensi

• Untuk mempercepat kueri data dan komputasi dengan menjalankan pernyataan SQL, Anda dapat membuat indeks sekunder atau indeks pencarian. Untuk informasi lebih lanjut, lihat Kebijakan Pemilihan Indeks dan Komputasi Pushdown.

• Setelah memperbarui kolom atribut tabel pemetaan, Anda dapat menggunakan pernyataan SELECT untuk mengkueri dan menganalisis data menggunakan tabel pemetaan. Untuk informasi lebih lanjut, lihat Kueri Data.

• Untuk mengkueri deskripsi tabel, gunakan pernyataan DESCRIBE. Untuk informasi lebih lanjut, lihat Kueri Informasi tentang Tabel.

• Jika tabel pemetaan yang dibuat untuk tabel atau indeks pencarian tidak lagi diperlukan, gunakan pernyataan DROP MAPPING TABLE untuk menghapusnya. Untuk informasi lebih lanjut, lihat Hapus Tabel Pemetaan.

• Untuk melihat informasi indeks tentang tabel, gunakan pernyataan SHOW INDEX. Untuk informasi lebih lanjut, lihat Kueri Informasi Indeks tentang Tabel.

• Untuk mengkueri nama tabel pemetaan dalam database saat ini, gunakan pernyataan SHOW TABLES. Untuk informasi lebih lanjut, lihat Daftar Nama Tabel.