全部产品
Search
文档中心

Tablestore:CreateTable

更新时间:Jul 06, 2025

Membuat tabel data berdasarkan skema yang telah ditentukan.

Catatan penggunaan

  • Setelah membuat tabel data, Anda tidak dapat langsung melakukan operasi baca dan tulis. Umumnya, operasi tersebut dapat dilakukan satu menit setelah tabel dibuat.

  • Anda dapat membuat hingga 64 tabel dalam satu instance. Jika memerlukan lebih banyak tabel, submit a ticket.

Sintaks permintaan

message CreateTableRequest {
    required TableMeta table_meta = 1;
    required ReservedThroughput reserved_throughput = 2; 
    optional TableOptions table_options = 3;
    repeated PartitionRange partitions = 4;
    optional StreamSpecification stream_spec = 5;
    optional SSESpecification sse_spec = 6;
    repeated IndexMeta index_metas = 7;
    optional bool enable_local_txn = 8;
}

Parameter

Tipe

Diperlukan

Deskripsi

table_meta

TableMeta

Ya

Skema tabel data. Konfigurasikan parameter berikut:

Penting

Setelah Anda membuat tabel data, Anda tidak dapat mengubah skema tabel data tersebut.

  • table_name: nama tabel data. Nama tabel harus unik di dalam instance.

  • primary_key: informasi tentang kunci utama. Kunci utama dapat berisi satu hingga empat kolom kunci utama. Nama setiap kolom kunci utama harus sesuai dengan konvensi penamaan, dan tipe data dari kolom kunci utama harus STRING, INTEGER, atau BINARY. Untuk informasi lebih lanjut tentang konvensi penamaan dan tipe data, lihat Konvensi penamaan dan tipe data.

  • defined_Columns: informasi tentang kolom yang telah ditentukan sebelumnya. Jika Anda ingin menggunakan indeks sekunder untuk tabel data, Anda harus menambahkan kolom yang telah ditentukan sebelumnya ke tabel data saat Anda membuat tabel data. Kolom yang telah ditentukan sebelumnya adalah kolom non-kunci utama yang telah ditentukan sebelumnya dengan tipe data tertentu. Setelah Anda menambahkan kolom yang telah ditentukan sebelumnya ke tabel data, Anda dapat menggunakan kolom yang telah ditentukan sebelumnya sebagai kolom atribut atau kolom kunci indeks dari tabel indeks. Anda juga dapat menambahkan kolom yang telah ditentukan sebelumnya ke tabel data setelah tabel data dibuat. Untuk informasi lebih lanjut, lihat Bagaimana cara menggunakan kolom yang telah ditentukan sebelumnya?

reserved_throughput

ReservedThroughput

Ya

Throughput baca atau tulis yang dicadangkan untuk tabel data. Throughput baca atau tulis yang dicadangkan untuk tabel data tidak boleh melebihi 100.000. Unit: unit kapasitas (CU).

Anda dapat memanggil operasi UpdateTable untuk mengubah throughput baca atau tulis yang dicadangkan untuk tabel data.

table_options

TableOptions

Tidak

Parameter tabel, termasuk time_to_live dan max_versions.

partitions

PartitionRange

Tidak

Rentang partisi tabel data.

stream_spec

StreamSpecification

Tidak

Menentukan apakah akan mengaktifkan atribut terkait Stream.

sse_spec

SSESpecification

Tidak

Konfigurasi enkripsi tabel data.

index_metas

IndexMeta

Tidak

Skema tabel indeks.

enable_local_txn

bool

Tidak

Menentukan apakah akan mengaktifkan fitur transaksi lokal untuk tabel data. Nilai default: false.

Untuk melakukan operasi atomik untuk membaca atau menulis satu atau beberapa baris data, aktifkan fitur transaksi lokal untuk tabel data.

Sintaks respons

message CreateTableResponse {
}

Gunakan SDK Tablestore

Anda dapat menggunakan SDK Tablestore berikut untuk membuat tabel data sesuai skema yang ditentukan: