全部产品
Search
文档中心

Tablestore:Go SDK

更新时间:Jul 06, 2025

Tablestore SDK for Go mendukung operasi pada model Wide Column, model TimeSeries, dan model Timeline.

Fitur

Sebelum menggunakan fitur-fitur SDK, Anda harus menginisialisasi klien. Untuk detail lebih lanjut tentang fitur yang didukung oleh Go SDK, lihat tabel berikut.

Catatan

Untuk informasi lebih lanjut tentang model Timeline, lihat model Timeline.

Model Wide Column

Jenis fitur

Operasi

Deskripsi

Operasi tabel

Buat tabel

Anda dapat membuat tabel data untuk menyimpan data. Anda dapat mengonfigurasi enkripsi data dan kolom primary key auto-increment saat membuat tabel data.

Perbarui konfigurasi tabel

Anda dapat memperbarui informasi konfigurasi tabel, seperti time to live (TTL) dan jumlah versi maksimum.

Daftar tabel

Anda dapat menanyakan nama semua tabel dalam sebuah instance.

Kueri informasi tabel

Anda dapat menanyakan konfigurasi sebuah tabel.

Hapus tabel

Anda dapat menghapus sebuah tabel.

Operasi data

Tulis data

Anda dapat menulis data ke tabel data di Tablestore. Sebagai contoh, Anda dapat menulis satu baris data, memperbarui satu baris data, dan menulis beberapa baris data secara bersamaan.

Baca data

Anda dapat membaca data dari tabel data di Tablestore. Sebagai contoh, Anda dapat membaca satu baris data, membaca beberapa baris data secara bersamaan, dan membaca data yang nilai primary key-nya berada dalam rentang tertentu.

Hapus data

Anda dapat menghapus data dari tabel data di Tablestore. Sebagai contoh, Anda dapat menghapus satu baris data atau menghapus beberapa baris data secara bersamaan.

Filter

Setelah Anda mengonfigurasi filter, hasil kueri akan difilter di sisi server berdasarkan kondisi filter. Hanya baris data yang memenuhi kondisi filter yang dikembalikan.

Pembaruan bersyarat

Jika Anda menggunakan pembaruan bersyarat, data dalam tabel hanya dapat diperbarui jika kondisi terpenuhi. Jika tidak, pembaruan gagal dan pesan kesalahan dikembalikan.

Counter atomik

Fitur counter atomik memungkinkan Anda menentukan kolom sebagai counter atomik dan melakukan operasi counter atomik pada kolom tersebut.

Transaksi lokal

Setelah Anda mengaktifkan transaksi lokal untuk tabel data, Anda dapat membuat transaksi lokal berdasarkan nilai partition key. Anda dapat membaca dan menulis data dalam transaksi lokal tersebut dan kemudian mengonfirmasi atau membatalkan transaksi lokal berdasarkan kebutuhan bisnis Anda.

Indeks pencarian

Buat indeks pencarian

Anda dapat membuat indeks pencarian untuk tabel data.

Daftar indeks pencarian

Kueri indeks pencarian yang dibuat untuk sebuah tabel.

Perbarui konfigurasi indeks pencarian

Perbarui time to live (TTL) indeks pencarian.

Kueri deskripsi indeks pencarian

Kueri deskripsi indeks pencarian, termasuk informasi tentang bidang dalam indeks pencarian dan konfigurasi indeks pencarian.

Hapus indeks pencarian

Anda dapat menghapus indeks pencarian yang tidak lagi Anda butuhkan.

Tentukan TTL indeks pencarian

Hapus data historis atau perpanjang periode retensi data dalam indeks pencarian berdasarkan kebutuhan bisnis.

Kueri dasar

Tipe kueri dasar meliputi kueri cocok semua, kueri tepat, kueri terms, kueri awalan, kueri wildcard, kueri rentang, kueri eksistensi, collapse (distinct), kueri geo, dan kueri nested.

Kueri Boolean

Kondisi kueri dapat berisi satu atau lebih subkondisi. Tablestore menentukan apakah data memenuhi kondisi kueri berdasarkan subkondisi tersebut.

Pengurutan dan paging

Saat Anda menggunakan indeks pencarian untuk menanyakan data, Anda dapat menentukan metode pengurutan untuk data yang dikembalikan. Saat banyak baris dikembalikan, Anda dapat menggunakan paging berbasis offset atau token-based paging untuk dengan cepat menemukan data yang diperlukan.

Agregasi

Anda dapat melakukan operasi agregasi untuk mendapatkan nilai minimum, nilai maksimum, jumlah, rata-rata, dan hitungan serta hitungan unik dari baris. Anda juga dapat melakukan operasi agregasi untuk mengelompokkan hasil berdasarkan nilai bidang, rentang, lokasi geografis, atau filter. Anda dapat melakukan beberapa operasi agregasi untuk kueri kompleks.

Pencarian teks lengkap

Tablestore menyediakan kueri match dan kueri match phrase untuk mengimplementasikan pencarian teks lengkap. Saat Anda melakukan kueri, data dicocokkan berdasarkan tokenisasi. Anda juga dapat menggunakan fitur highlight untuk menyoroti string kueri.

Kueri vektor KNN

Anda dapat menggunakan fitur kueri vektor KNN (K-nearest neighbor) untuk melakukan pencarian tetangga terdekat berdasarkan vektor. Dengan cara ini, Anda dapat menemukan item data yang memiliki kesamaan tertinggi dengan vektor yang ingin Anda tanyakan dalam dataset skala besar.

Pemindaian paralel

Jika Anda tidak ingin mengurutkan seluruh set hasil, Anda dapat menggunakan fitur pemindaian paralel untuk mengembalikan semua data yang cocok dengan kecepatan lebih cepat.

Indeks sekunder

Buat indeks sekunder

Anda dapat membuat indeks sekunder untuk tabel data.

Gunakan indeks sekunder untuk membaca data

Anda dapat menanyakan data dalam indeks sekunder dengan membaca satu baris data atau membaca data yang nilai primary key-nya berada dalam rentang tertentu. Jika kolom atribut yang diperlukan disertakan dalam indeks sekunder, data dapat langsung dibaca dari indeks sekunder. Jika tidak, data harus dibaca dari tabel data.

Hapus indeks sekunder

Anda dapat menghapus indeks sekunder yang ditentukan dari tabel data.

Layanan Tunnel

Buat tunnel

Anda dapat membuat tunnel untuk tabel data untuk konsumsi data waktu nyata.

Kueri informasi tentang semua tunnel tabel data

Anda dapat mencantumkan informasi tentang semua tunnel dalam tabel data, seperti nama tunnel, tipe tunnel, ID tunnel, tahap tunnel, dan apakah data telah kedaluwarsa.

Kueri informasi tentang sebuah tunnel

Anda dapat memperoleh informasi spesifik tentang sebuah tunnel, seperti informasi tunnel dan informasi saluran dalam tunnel tersebut.

Hapus tunnel

Anda dapat menghapus sebuah tunnel dari tabel data.

Kueri SQL

Buat tabel pemetaan

Anda dapat membuat tabel pemetaan untuk tabel atau indeks yang sudah ada.

Perbarui kolom atribut dalam tabel pemetaan

Tambah atau hapus kolom atribut dalam tabel pemetaan yang sudah ada.

Hapus tabel pemetaan

Hapus satu atau lebih tabel pemetaan.

Daftar nama tabel pemetaan

Anda dapat mencantumkan tabel pemetaan dalam database saat ini.

Kueri deskripsi tabel

Anda dapat menanyakan deskripsi tabel, seperti nama bidang dan tipe bidang.

Kueri deskripsi indeks

Anda dapat menanyakan deskripsi indeks tabel.

Kueri data

Kueri data dalam tabel.

Kueri data tanggal dan waktu

Setelah Anda menanyakan data tipe waktu (termasuk Datetime, Date, dan Time) menggunakan pernyataan SQL, Anda dapat memperoleh data spesifik berdasarkan kebutuhan Anda.

Pengiriman data lake

Buat tugas pengiriman

Anda dapat membuat tugas pengiriman untuk mengirim data dari tabel data Tablestore ke Bucket OSS untuk penyimpanan.

Daftar nama tugas pengiriman

Anda dapat mencantumkan semua informasi tugas pengiriman untuk tabel data, seperti nama tabel, nama tugas pengiriman, dan tipe tugas pengiriman.

Kueri deskripsi tugas pengiriman

Kueri informasi deskriptif tugas pengiriman.

Hapus tugas pengiriman

Hapus tugas pengiriman.

Model TimeSeries

Jenis fitur

Operasi

Deskripsi

Operasi tabel time series

Buat tabel time series

Buat tabel time series untuk menyimpan data time series.

Perbarui tabel time series

Anda dapat memperbarui konfigurasi tabel time series atau metadata time series.

Daftar nama tabel time series

Anda dapat melihat nama dan informasi konfigurasi semua tabel time series dalam sebuah instance.

Kueri deskripsi tabel time series

Kueri informasi tentang tabel time series, seperti konfigurasi TTL.

Hapus tabel time series

Hapus tabel time series.

Operasi data time series

Tulis data time series

Anda dapat menulis data time series ke tabel time series secara batch.

Kueri data time series

Kueri data time series yang memenuhi kondisi tertentu dalam time series tertentu.

Operasi time series

Ambil time series

Anda dapat menentukan beberapa kondisi untuk mengambil informasi time series, seperti nama metrik dan informasi sumber data.

Perbarui time series

Anda dapat memperbarui metadata time series secara batch.

Hapus time series

Anda dapat menghapus metadata time series secara batch.

Penyimpan analitik time series

Buat penyimpan analitik

Anda dapat membuat penyimpan analitik untuk tabel time series yang sudah ada.

Perbarui TTL penyimpan analitik

Perbarui konfigurasi time to live (TTL) untuk data dalam penyimpan analitik. Setelah Anda memperbarui TTL penyimpan analitik, Tablestore secara otomatis membersihkan data yang periode retensinya melebihi TTL penyimpan analitik secara asinkron.

Kueri informasi penyimpan analitik

Anda dapat menanyakan deskripsi penyimpan analitik, seperti konfigurasi TTL, opsi sinkronisasi data, status sinkronisasi data, dan ukuran penyimpanan data.

Hapus penyimpan analitik

Anda dapat menghapus penyimpan analitik dari tabel time series.

Indeks Lastpoint

Buat indeks Lastpoint

Anda dapat membuat indeks Lastpoint untuk tabel time series untuk dengan cepat mengambil data titik waktu terbaru setiap time series.

Kueri data indeks Lastpoint

Anda dapat menanyakan data dalam indeks Lastpoint.

Ambil indeks Lastpoint

Anda dapat menggunakan indeks pencarian yang dibuat untuk indeks Lastpoint untuk mengambil data dalam indeks Lastpoint. Indeks pencarian dapat digunakan untuk mempercepat pengambilan data untuk indeks Lastpoint dan memberikan kemampuan kueri multidimensi serta analisis statistik.

Hapus indeks Lastpoint

Anda dapat menghapus indeks Lastpoint yang tidak lagi Anda butuhkan.

Kueri SQL

Buat tabel pemetaan

Anda dapat membuat tabel pemetaan untuk tabel atau indeks yang sudah ada.

Perbarui kolom atribut dalam tabel pemetaan

Tambah atau hapus kolom atribut dalam tabel pemetaan yang sudah ada.

Hapus tabel pemetaan

Hapus satu atau lebih tabel pemetaan.

Daftar nama tabel pemetaan

Anda dapat mencantumkan tabel pemetaan dalam database saat ini.

Kueri deskripsi tabel

Anda dapat menanyakan deskripsi tabel, seperti nama bidang dan tipe bidang.

Kueri deskripsi indeks

Anda dapat menanyakan deskripsi indeks tabel.

Kueri data

Kueri data dalam tabel.

Kompatibilitas versi

Versi terbaru adalah 1.17.x, yang kompatibel dengan semua versi sebelumnya.

Untuk informasi lebih lanjut tentang iterasi versi SDK, lihat Riwayat versi Tablestore SDK for Go.

Referensi

Untuk informasi lebih lanjut tentang penanganan kesalahan di Tablestore, lihat Penanganan kesalahan.