全部产品
Search
文档中心

Tablestore:.NET SDK

更新时间:Jul 23, 2025

Tablestore SDK untuk .NET mendukung operasi pada Model Kolom Lebar.

Daftar fitur

Sebelum menggunakan SDK, Anda perlu menginisialisasi klien. Tabel berikut menjelaskan fitur-fitur yang didukung oleh Tablestore SDK untuk .NET.

Jenis fitur

Operasi

Deskripsi

Operasi tabel data

Buat tabel data

Buat tabel data untuk menyimpan data. Anda dapat mengonfigurasi kolom kunci utama auto-increment saat membuat tabel data.

Perbarui konfigurasi tabel

Perbarui konfigurasi tabel data.

Daftar tabel data

Lihat nama semua tabel data dalam sebuah instans.

Kueri informasi tabel

Kueri konfigurasi tabel data.

Hapus tabel data

Hapus tabel data tertentu.

Operasi data

Tulis data

Tulis data ke tabel data.

Baca data

Baca data dari tabel data.

Hapus data

Hapus data dari tabel data.

Filter

Filter hasil baca di sisi server berdasarkan kondisi dalam filter untuk menentukan data yang akan dikembalikan.

Pembaruan bersyarat

Perbarui data dalam tabel hanya jika data memenuhi kondisi pembaruan. Jika tidak, pembaruan data gagal dan kesalahan dikembalikan.

Penghitung atomik

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

Indeks pencarian

Buat indeks pencarian

Buat indeks pencarian untuk tabel data.

Daftar indeks pencarian

Kueri indeks pencarian yang dibuat untuk sebuah tabel.

Perbarui konfigurasi indeks pencarian

Perbarui masa hidup data (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

Hapus indeks pencarian tertentu.

Kueri dasar

Jenis kueri dasar meliputi pencocokan semua kueri, kueri tepat, kueri istilah, kueri awalan, kueri rentang, kueri wildcard, kueri eksistensi, collapse (menghapus duplikat), kueri geografis, dan kueri bersarang.

Kueri Boolean

Kondisi kueri dapat mencakup satu atau lebih kondisi sub-kueri untuk menentukan apakah data memenuhi kondisi kueri berdasarkan kondisi sub-kueri.

Pengurutan dan paginasi

Saat Anda mengkueri data menggunakan indeks pencarian, dapatkan data yang dikembalikan dalam urutan tertentu. Saat jumlah baris yang dikembalikan besar, Anda dapat dengan cepat menemukan data yang diperlukan menggunakan paginasi berbasis offset atau token.

Agregasi

Anda dapat melakukan operasi seperti menemukan nilai minimum, menemukan nilai maksimum, menghitung jumlah, menghitung rata-rata, menghitung baris, menghitung baris unik, mengelompokkan berdasarkan nilai bidang, mengelompokkan berdasarkan rentang, mengelompokkan berdasarkan lokasi geografis, dan mengelompokkan berdasarkan kondisi filter. Beberapa fitur agregasi dapat digabungkan untuk memenuhi kebutuhan kueri kompleks.

Indeks teks penuh

Tablestore menyediakan kueri cocok dan kueri frase untuk mengimplementasikan fitur indeks teks penuh. Kueri mencocokkan data berdasarkan tokenisasi.

Ekspor paralel

Saat Anda tidak peduli dengan urutan seluruh set hasil, gunakan fitur ekspor paralel untuk mengembalikan semua data yang cocok dengan kecepatan lebih tinggi.

Indeks sekunder

Buat indeks sekunder

Buat indeks sekunder untuk tabel data.

Baca data menggunakan indeks sekunder

Kueri data dalam indeks sekunder dengan membaca satu baris data atau membaca data yang nilai kunci utamanya berada dalam rentang tertentu. Jika kolom atribut yang diperlukan termasuk dalam indeks sekunder, data dapat langsung dibaca dari indeks sekunder. Jika tidak, data harus dibaca dari tabel data.

Hapus indeks sekunder

Hapus indeks sekunder tertentu dari tabel data.

Kueri SQL

Buat tabel pemetaan

Buat 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 beberapa tabel pemetaan.

Daftar tabel pemetaan

Daftar tabel pemetaan dalam database saat ini.

Kueri deskripsi tabel

Kueri deskripsi tabel, seperti nama bidang dan tipe bidang.

Kueri deskripsi indeks

Kueri deskripsi indeks tabel.

Kueri data

Kueri data dalam tabel.

Kompatibilitas versi

Versi terbaru Tablestore SDK untuk .NET adalah 6.x.x. Berikut ini kompatibilitas antara versi terbaru dan versi sebelumnya:

  • Tablestore SDK untuk .NET V5.x.x: kompatibel.

  • Tablestore SDK untuk .NET V4.x.x: kompatibel.

  • Tablestore SDK untuk .NET V3.x.x: kompatibel.

  • Komponen yang tidak kompatibel untuk seri SDK 2.x.x adalah sebagai berikut:

    • Beberapa operasi tidak kompatibel. Parameter Condition.IGNORE, Condition.EXPECT_EXIST, dan Condition.EXPECT_NOT_EXIST dihapus.

    • Nama file DLL diubah dari Aliyun.dll menjadi Aliyun.TableStore.dll.

Untuk informasi lebih lanjut, lihat Riwayat Versi Tablestore SDK untuk .NET.

Referensi

Untuk informasi tentang cara menangani kesalahan Tablestore, lihat Penanganan Kesalahan.