Tablestore：Membuat tabel data

Catatan penggunaan

Setelah membuat tabel data, tunggu hingga tabel dimuat sebelum melakukan operasi pada data. Jika tidak, operasi tersebut akan gagal. Proses ini biasanya memakan waktu beberapa detik.

Prasyarat

Inisialisasi klien Tablestore.

Deskripsi metode

func (tableStoreClient *TableStoreClient) CreateTable(request *CreateTableRequest) (*CreateTableResponse, error)

Kode contoh

Berikut adalah contoh kode untuk membuat tabel data bernama test_table yang berisi satu kolom kunci utama bertipe string.

func CreateTableSample(client *tablestore.TableStoreClient) {
    // Bangun informasi skema tabel data
    tableMeta := new(tablestore.TableMeta)
    tableMeta.TableName = "test_table"
    // Setidaknya satu kolom kunci utama diperlukan untuk membuat tabel data
    tableMeta.AddPrimaryKeyColumn("id", tablestore.PrimaryKeyType_STRING)

    // Bangun informasi konfigurasi tabel data
    tableOption := new(tablestore.TableOption)
    // Anda harus menentukan jumlah maksimum versi saat membuat tabel data
    tableOption.MaxVersion = 1
    // Anda harus menentukan TTL saat membuat tabel data. Nilai -1 menunjukkan bahwa data tidak pernah kedaluwarsa
    tableOption.TimeToAlive = -1

    // Anda harus menyetel throughput baca dan tulis yang dicadangkan saat membuat tabel data. Nilai default adalah 0 (Hanya instans kinerja tinggi dalam mode CU yang mendukung pengaturan throughput baca dan tulis yang dicadangkan ke nilai bukan nol)
    reservedThroughput := new(tablestore.ReservedThroughput)
    reservedThroughput.Readcap = 0
    reservedThroughput.Writecap = 0

    // Bangun permintaan dan kirimkan
    createTableRequest := new(tablestore.CreateTableRequest)
    createTableRequest.TableMeta = tableMeta
    createTableRequest.TableOption = tableOption
    createTableRequest.ReservedThroughput = reservedThroughput
    _, err := client.CreateTable(createTableRequest)
    if err != nil {
        fmt.Println("Gagal membuat tabel dengan kesalahan:", err)
    } else {
        fmt.Println("Pembuatan tabel selesai.")
    }
}

Lihat contoh kode berikut untuk mengonfigurasi pengaturan tambahan saat membuat tabel data.

• Tambahkan kolom pradefinisi

  tableMeta.AddDefinedColumn("name", tablestore.DefinedColumn_STRING)

• Atur offset versi maksimum

  tableOption.DeviationCellVersionInSec = 86400

• Atur apakah pembaruan diizinkan

  tableOption.AllowUpdate = proto.Bool(false)

• Tambahkan indeks sekunder

  // Bangun indeks sekunder
  indexMeta := new(tablestore.IndexMeta)
  indexMeta.IndexName = "test_table_index"
  // Atur kolom kunci utama indeks
  indexMeta.AddPrimaryKeyColumn("id")
  indexMeta.AddPrimaryKeyColumn("name")
  // Atur tipe indeks
  indexMeta.IndexType = tablestore.IT_LOCAL_INDEX
  // Tambahkan indeks sekunder
  createTableRequest.AddIndexMeta(indexMeta)

• Konfigurasikan pengaturan Stream

  streamSpec := new(tablestore.StreamSpecification)
  streamSpec.EnableStream = true
  streamSpec.ExpirationTime = 168
  createTableRequest.StreamSpec = streamSpec

• Atur apakah transaksi lokal diaktifkan

  enableLocalTxn := proto.Bool(true)
  createTableRequest.EnableLocalTxn = enableLocalTxn

• Atur tipe enkripsi data

  • Enkripsi berbasis KMS

    sseSpec := new(tablestore.SSESpecification)
    sseSpec.SetEnable(true)
    sseSpec.SetKeyType(tablestore.SSE_KMS_SERVICE)
    createTableRequest.SSESpecification = sseSpec

  • Enkripsi BYOK

    Catatan

    Sebelum menjalankan kode, peroleh ID CMK dan ARN peran RAM. Untuk informasi lebih lanjut, lihat Enkripsi BYOK.

    sseSpec := new(tablestore.SSESpecification)
    sseSpec.SetEnable(true)
    sseSpec.SetKeyType(tablestore.SSE_BYOK)
    sseSpec.SetKeyId("key-hzz65****************")
    sseSpec.SetRoleArn("acs:ram::1705************:role/tabletorebyok")
    createTableRequest.SSESpecification = sseSpec

Referensi

• Model Tabel Lebar

• Versi Data dan TTL

• Buat Tabel Deret Waktu