Gunakan Tablestore SDK for .NET untuk membuat tabel pemetaan dengan mengeksekusi pernyataan SQL - Tablestore

Anda dapat menggunakan pernyataan CREATE TABLE untuk membuat tabel pemetaan untuk tabel atau indeks pencarian yang sudah ada. Saat membuat tabel pemetaan, tentukan nama dan tipe bidang, informasi kunci utama, serta mesin eksekusi yang sesuai dengan kebutuhan bisnis Anda.

Catatan

Untuk detail lebih lanjut, lihat Buat tabel pemetaan untuk sebuah tabel dan Buat tabel pemetaan untuk indeks pencarian.

Catatan penggunaan

Fitur kueri SQL didukung oleh Tablestore SDK for .NET V5.0.0 dan versi lebih baru. Pastikan Anda telah menginstal versi Tablestore SDK for .NET yang kompatibel saat menggunakan fitur ini.

Untuk informasi lebih lanjut, lihat Riwayat versi Tablestore SDK for .NET.

Prasyarat

Klien harus diinisialisasi. Untuk detail lebih lanjut, lihat Inisialisasi klien Tablestore.
Tabel data harus dibuat.
Jika ingin membuat tabel pemetaan untuk indeks pencarian, Anda harus terlebih dahulu membuat indeks pencarian.

Parameter

Parameter	Deskripsi
query	Pernyataan SQL. Konfigurasikan parameter ini berdasarkan fitur yang diperlukan.

Contoh

Catatan

Bagian ini menjelaskan cara membuat tabel pemetaan untuk sebuah tabel. Jika ingin membuat tabel pemetaan untuk indeks pencarian, ganti pernyataan SQL dalam contoh kode dengan pernyataan SQL untuk membuat tabel pemetaan untuk indeks pencarian.

Contoh berikut menunjukkan cara menggunakan pernyataan CREATE TABLE `test_table` (`pk0` VARCHAR(1024), `pk1` BIGINT(20), `col0` MEDIUMTEXT, `col1` BIGINT(20), `col2` DOUBLE, `col3` BOOL, `col4` MEDIUMBLOB, `date_col` MEDIUMTEXT, `geo_col` MEDIUMTEXT, `col0_v1` MEDIUMTEXT, `col0_v2` MEDIUMTEXT, PRIMARY KEY(`pk0`,`pk1`)); untuk membuat tabel pemetaan untuk tabel test_table.

/// <summary>
/// Buat tabel pemetaan untuk tabel data.
/// </summary>
/// <param name="otsClient"></param>
public static void CreateMappingTable(OTSClient otsClient)
{
    string sqlCommand = @"CREATE TABLE `test_table` (
        `pk0` VARCHAR(1024),
        `pk1` BIGINT(20),
        `col0` MEDIUMTEXT,
        `col1` BIGINT(20),
        `col2` DOUBLE,
        `col3` BOOL,
        `col4` MEDIUMBLOB,
        `date_col` MEDIUMTEXT,
        `geo_col` MEDIUMTEXT,
        `col0_v1` MEDIUMTEXT,
        `col0_v2` MEDIUMTEXT,
        PRIMARY KEY(`pk0`,`pk1`)
    );";

    SQLQueryRequest sqlQueryRequest = new SQLQueryRequest(sqlCommand);

    SQLQueryResponse sqlQueryResponse = otsClient.SQLQuery(sqlQueryRequest);
}

FAQ

Apa yang harus saya lakukan jika pesan kesalahan "Table 'instancename.tablename' tidak ada?" muncul saat saya membuat tabel pemetaan?

Penyebab yang mungkin
Tabel tempat Anda ingin membuat tabel pemetaan belum tersedia.
Solusi
Pernyataan CREATE TABLE hanya dapat digunakan untuk membuat tabel pemetaan untuk tabel atau indeks pencarian yang sudah ada. Pastikan bahwa tabel atau indeks pencarian tersebut telah tersedia sebelum melanjutkan.

Apa yang harus saya lakukan jika pesan kesalahan "Table 'instancename.tablename' sudah ada?" muncul saat saya membuat tabel pemetaan?

Penyebab yang mungkin
Tabel pemetaan untuk tabel tersebut sudah dibuat.
- Pengguna secara manual telah 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 dalam tabel tanpa membuat tabel pemetaan, Tablestore akan membuat tabel pemetaan secara otomatis. Tabel pemetaan yang dibuat otomatis hanya mencakup kolom kunci utama dan kolom yang telah ditentukan sebelumnya dari tabel data. Kolom atribut tabel pemetaan tidak dapat diperbarui.
Solusi
Eksekusi pernyataan DESCRIBE untuk memeriksa skema tabel pemetaan. Jika skema tersebut tidak sesuai dengan kebutuhan bisnis Anda, Anda dapat memperbarui kolom atribut tabel pemetaan. Jika tabel pemetaan dibuat otomatis oleh Tablestore, Anda tidak dapat memperbarui kolom atribut. Dalam hal ini, Anda dapat menghapus tabel pemetaan dan membuat yang baru, asalkan yakin bahwa proses ini tidak akan memengaruhi operasional bisnis Anda.

Catatan

Untuk kesalahan umum dan solusi terkait fitur kueri SQL, lihat Bagaimana cara menyelesaikan masalah kesalahan umum pada kueri SQL?.

Referensi

Setelah membuat tabel pemetaan, Anda dapat memperbarui kolom atribut tabel pemetaan, mengkueri informasi tabel pemetaan, mengkueri nama-nama tabel pemetaan, mengkueri informasi indeks tabel pemetaan, dan menghapus tabel pemetaan. Untuk detail lebih lanjut, lihat Perbarui kolom atribut tabel pemetaan, Kueri informasi tentang sebuah tabel, Kueri nama-nama tabel pemetaan, Kueri informasi indeks tentang sebuah tabel, dan Hapus tabel pemetaan.
Anda dapat menggunakan pernyataan SELECT untuk mengkueri dan menganalisis data dalam tabel pemetaan. Untuk informasi lebih lanjut, lihat Kueri data.