Tablestore：Perbarui kolom atribut tabel pemetaan

Prasyarat

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

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

Catatan Penggunaan

• Anda dapat mengeksekusi pernyataan ALTER TABLE untuk memperbarui kolom atribut hanya pada tabel pemetaan yang dibuat dengan mengeksekusi pernyataan CREATE TABLE. Anda tidak dapat mengeksekusi pernyataan ALTER TABLE untuk memperbarui kolom atribut dalam tabel pemetaan yang dibuat secara otomatis untuk sebuah tabel dengan mengeksekusi pernyataan DESCRIBE.

• Anda dapat menambah atau menghapus hanya satu kolom atribut dalam tabel pemetaan dengan mengeksekusi pernyataan ALTER TABLE. Jika Anda ingin menambah atau menghapus beberapa kolom atribut dalam tabel pemetaan, Anda dapat mengeksekusi pernyataan ALTER TABLE beberapa kali.

• Anda dapat mengeksekusi pernyataan ALTER TABLE untuk memperbarui hanya skema tabel pemetaan. Skema tabel Tablestore tempat tabel pemetaan dibuat tidak diperbarui.

• Anda tidak dapat mengeksekusi pernyataan ALTER TABLE untuk menambah atau menghapus kolom kunci utama dalam tabel pemetaan.

• Setelah Anda mengeksekusi pernyataan ALTER TABLE, mesin SQL secara asinkron memperbarui tabel pemetaan. Dibutuhkan hingga 30 detik untuk menyelesaikan pembaruan. Selama periode pembaruan, kolom yang Anda tambahkan mungkin tidak dikembalikan saat Anda melakukan operasi yang seharusnya mengembalikan semua kolom.

Parameter

Contoh

• Tambahkan kolom atribut ke tabel pemetaan.

  Kode sampel berikut memberikan contoh cara menambahkan kolom colvalue bertipe BIGINT ke tabel pemetaan bernama exampletable:

  /// <summary>
  /// Tambahkan kolom colvalue bertipe BIGINT ke tabel pemetaan bernama exampletable. 
  /// </summary>
  /// <param name="otsClient"></param>
  public static void AlterTableAddColumn(OTSClient otsClient)
  {
      SQLQueryRequest sqlQueryRequest = new SQLQueryRequest("alter table exampletable add column colvalue bigint");
      otsClient.SQLQuery(sqlQueryRequest);
  }

• Hapus kolom atribut dari tabel pemetaan.

  Kode sampel berikut memberikan contoh cara menghapus kolom colvalue bertipe BIGINT dari tabel pemetaan bernama exampletable:

  /// <summary>
  /// Hapus kolom colvalue bertipe BIGINT dari tabel pemetaan bernama exampletable.  
  /// </summary>
  /// <param name="otsClient"></param>
  public static void AlterTableDropColumn(OTSClient otsClient)
  {
      SQLQueryRequest sqlQueryRequest = new SQLQueryRequest("alter table exampletable drop column colvalue");
      otsClient.SQLQuery(sqlQueryRequest);
  }

FAQ

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

• Bagaimana cara menangani kesalahan umum dalam kueri SQL?

Referensi

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

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

• Jika Anda ingin menanyakan deskripsi tabel, Anda dapat mengeksekusi pernyataan DESCRIBE. Untuk informasi lebih lanjut, lihat Kueri Informasi tentang Tabel.

• Jika Anda tidak lagi memerlukan tabel pemetaan yang dibuat untuk tabel atau indeks pencarian, Anda dapat mengeksekusi pernyataan DROP MAPPING TABLE untuk menghapus tabel pemetaan. Untuk informasi lebih lanjut, lihat Hapus Tabel Pemetaan.

• Jika Anda ingin melihat informasi indeks tentang tabel, Anda dapat mengeksekusi pernyataan SHOW INDEX. Untuk informasi lebih lanjut, lihat Kueri Informasi Indeks tentang Tabel.

• Jika Anda ingin menanyakan nama tabel pemetaan dalam database saat ini, Anda dapat mengeksekusi pernyataan SHOW TABLES. Untuk informasi lebih lanjut, lihat Daftar Nama Tabel.