全部产品
Search

搜索本产品

    Tair (Redis® OSS-Compatible)：TS

    文档中心

    Tair (Redis® OSS-Compatible)：TS

    更新时间：Nov 10, 2025

    TairTS adalah struktur data deret waktu yang dikembangkan berdasarkan modul Redis. Struktur ini menyediakan akses baca dan tulis dalam memori dengan latensi rendah dan konkurensi tinggi, mendukung kueri agregasi dan penyaringan cepat, serta menawarkan kemampuan penyimpanan dan komputasi. TairTS menyederhanakan pemrosesan data deret waktu dan secara signifikan meningkatkan performa.

    Ikhtisar TairTS

    Dibandingkan dengan RedisTimeSeries, TairTS menawarkan lebih banyak fitur:

    • Kueri agregat multi-timeline menggunakan pkeys. Pkeys memiliki lapisan hash tambahan.

      Sebagai contoh, Anda dapat membuat beberapa skeys bernama berdasarkan nama metrik dan ID perangkat di pkey foo, seperti temperature:1, pressure:1, dan distance:1. Kemudian, Anda dapat menjalankan perintah EXTS.S.MRANGE yang disediakan oleh TairTS untuk mengambil data pemantauan kustom seperti skeys yang memiliki ID perangkat 1. Jika ingin mengimplementasikan fitur serupa menggunakan RedisTimeSeries, Anda harus memasukkan banyak kueri agregat ke dalam kode logika bisnis.

      Gambar 1. Perbandingan antara TairTS dan RedisTimeSeriesTairTS数据结构图

      Berikut adalah penjelasan tentang struktur data TairTS:

      • Pkey: sepotong data TairTS yang menunjukkan satu set timeline. Sebuah pkey terdiri dari beberapa skeys.

      • Skey: sebuah timeline. Sebuah skey terdiri dari beberapa chunk dengan kapasitas tetap. Anda dapat melampirkan satu atau lebih label berbeda pada setiap skey. Skeys dapat difilter berdasarkan label.

      • Chunk: potongan data. Sebuah chunk dapat menyimpan beberapa titik data.

        • Kapasitas setiap chunk dapat disesuaikan. Jika kompresi tidak diaktifkan, sebuah chunk dapat menyimpan hingga 256 titik data. Namun, jika kompresi diaktifkan, sebuah chunk dapat menyimpan lebih dari 256 titik data.

        • Chunk adalah unit kedaluwarsa terkecil. Sebuah chunk akan dihapus setelah semua titik data di dalamnya kedaluwarsa.

      • Datapoint: sepotong data deret waktu yang mencakup timestamp dan nilai tipe DOUBLE.

    • Kueri agregat dalam skenario seperti downsampling, penyaringan atribut, kueri batch, dan penggunaan fungsi numerik ganda. Fitur ini mengintegrasikan kueri batch dan agregasi menjadi satu perintah untuk mengurangi interaksi jaringan dan memberikan waktu respons satu digit milidetik.

    • Pembaruan dan akumulasi data deret waktu historis.

    • Dukungan untuk pengaturan TTL tingkat timeline memastikan bahwa setiap timeline dapat bergulir otomatis sesuai dengan jendela waktu.

    • Algoritma kompresi Gorilla yang efisien dan penyimpanan khusus untuk secara signifikan mengurangi biaya.

    Skenario tipikal

    • Penyimpanan dan komputasi data yang dipantau.

    • Analisis data berdasarkan jendela waktu.

    • Analisis dan pemrosesan data untuk IoT.

    • Caching berita populer.

    • Pemantauan per detik untuk manajemen kinerja aplikasi (APM).

    • Pengendalian risiko dalam skenario throttling.

    Praktik terbaik

    Implementasikan pemantauan per detik menggunakan TairTS.

    Persiapan

    Instans yang ingin Anda kelola adalah instans Tair DRAM-based instance.

    Jika instans tersebut adalah instans DRAM-based yang kompatibel dengan Redis 5.0, versi minor dari instans tersebut harus 1.7.20 atau lebih baru.

    Catatan

    Versi minor terbaru menyediakan lebih banyak fitur dan stabilitas yang lebih tinggi. Kami merekomendasikan agar Anda memperbarui instans ke versi minor terbaru. Untuk informasi lebih lanjut, lihat Perbarui versi minor dari sebuah instans. Jika instans Anda adalah instans kluster atau instans pemisahan baca/tulis, kami sarankan Anda memperbarui node proxy di instans ke versi minor terbaru untuk memastikan semua perintah dapat dijalankan sesuai harapan.

    Catatan penggunaan

    • Data TairTS yang ingin Anda kelola disimpan di instans Tair.

    • TairTS mendukung penulisan dan kueri real-time dengan konkurensi tinggi namun menyediakan kapasitas penyimpanan yang terbatas. Kami menyarankan Anda menentukan TTL untuk data TairTS untuk memastikan data yang kedaluwarsa dihapus tepat waktu.

    Penting

    Perubahan besar:

    Pada tanggal 22 Juli 2024, versi 24.7.0.0 dari instans Tair DRAM-based yang kompatibel dengan Redis 6.0 dirilis. Versi ini memperkenalkan parameter baru yang disebut ts-auto-del-empty-skey-enable, yang diatur ke yes secara default. Ini menunjukkan bahwa ketika semua titik data dalam sebuah skey kedaluwarsa, skey tersebut akan dihapus secara otomatis. Namun, pada versi sebelum 24.7.0.0 dari instans Tair DRAM-based yang kompatibel dengan Redis 6.0, skeys yang titik datanya kedaluwarsa tidak dihapus secara default.

    Sebelum menggunakan TairTS pada instans Tair DRAM-based yang kompatibel dengan Redis 6.0, kami sarankan Anda meningkatkan instans ke versi 24.7.0.0 atau lebih baru, dan konfirmasi serta sesuaikan pengaturan parameter ts-auto-del-empty-skey-enable secara manual. Hal ini dapat mencegah dampak potensial apa pun terhadap bisnis Anda karena perubahan perilaku default.

    Daftar Perintah

    Tabel 1. Perintah TairTS

    Tipe

    Perintah

    Sintaksis

    Deskripsi

    Operasi penulisan dasar

    EXTS.P.CREATE

    EXTS.P.CREATE Pkey

    Membuat pkey TairTS. Jika pkey dengan nama yang sama sudah ada, pkey tidak dapat dibuat.

    EXTS.S.CREATE

    EXTS.S.CREATE Pkey Skey [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 label2 val2 ...]

    Membuat skey di pkey tertentu. Jika pkey tidak ada, maka akan dibuat secara otomatis. Jika skey dengan nama yang sama sudah ada, skey tidak dapat dibuat.

    Catatan

    Anda dapat menentukan parameter untuk skey, seperti waktu kedaluwarsa dan apakah akan mengaktifkan kompresi.

    EXTS.S.ALTER

    EXTS.S.ALTER Pkey Skey [DATA_ET waktu]

    Memodifikasi metadata dari skey tertentu. Hanya nilai pengatur waktu DATA_ET yang dapat dimodifikasi.

    EXTS.S.ADD

    EXTS.S.ADD Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Menyisipkan sebuah titik data ke dalam skey. Jika pkey atau skey tidak ada, maka pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis.

    EXTS.S.MADD

    EXTS.S.MADD Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Menyisipkan titik data ke dalam beberapa skeys dari sebuah pkey. Jika pkey atau skey tidak ada, maka pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis.

    EXTS.S.INCRBY

    EXTS.S.INCRBY Pkey Skey ts nilai [DATA_ET waktu] [CHUNK_SIZE ukuran] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Menyisipkan titik data ke dalam skey. Jika titik data yang ingin Anda sisipkan memiliki nilai positif, nilai yang disisipkan akan ditambahkan ke nilai dari titik data terakhir yang ada di skey. Jika titik data memiliki nilai negatif, nilai yang disisipkan akan dikurangkan dari nilai titik data terakhir yang ada di skey. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Nilai awal default adalah 0. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah akan mengaktifkan kompresi, hanya berlaku jika skey dibuat secara otomatis ketika skey belum ada.

    EXTS.S.MINCRBY

    EXTS.S.MINCRBY Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Menyisipkan titik data ke dalam beberapa skeys dari sebuah pkey. Jika titik data yang ingin Anda sisipkan memiliki nilai positif, nilai yang disisipkan akan ditambahkan ke nilai dari titik data terakhir yang ada di setiap skey. Jika titik data memiliki nilai negatif, nilai yang disisipkan akan dikurangkan dari nilai titik data terakhir yang ada di setiap skey. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Nilai awal default adalah 0. Parameter untuk sebuah skey, seperti waktu kedaluwarsa dan apakah akan mengaktifkan kompresi, hanya berlaku jika skey dibuat secara otomatis ketika skey belum ada sebelumnya.

    EXTS.S.DEL

    EXTS.S.DEL Pkey Skey

    Menghapus skey dari pkey dan semua titik data dalam skey.

    Operasi baca dasar

    EXTS.S.GET

    EXTS.S.GET Pkey Skey

    Mengekueri nilai dari titik data terbaru dalam skey yang ditentukan.

    EXTS.S.INFO

    EXTS.S.INFO Pkey Skey

    Meminta metadata dari skey tertentu. Metadata mencakup jumlah titik data, cap waktu dan nilai dari titik data terbaru, serta informasi label dari skey.

    EXTS.S.QUERYINDEX

    EXTS.S.QUERYINDEX Pkey filter1 [filter2 ...]

    Mengeksekusi kueri untuk mendapatkan skeys yang memenuhi kondisi filter tertentu dalam sebuah pkey.

    Operasi agregat

    EXTS.S.RANGE

    EXTS.S.RANGE Pkey Skey fromTs toTs [MAXCOUNT count] [AGGREGATION tipeAgregasi rentangWaktu]

    Meminta jumlah titik data yang ada dalam sebuah skey selama rentang waktu tertentu. Rentang waktu merupakan interval tertutup.

    EXTS.S.MRANGE

    EXTS.S.MRANGE Pkey fromTs toTs [MAXCOUNT jumlah] [AGGREGATION tipeAgregasi rentangWaktu] [WITHLABELS] FILTER filter1 [filter2 ...]

    Mengeksekusi kueri jumlah titik data yang memenuhi kondisi filter tertentu di beberapa skeys selama rentang waktu tertentu. Rentang waktu merupakan interval tertutup.

    EXTS.P.RANGE

    EXTS.P.RANGE Pkey fromTs toTs pkeyAggregationType pkeyTimeBucket [MAXCOUNT count] [AGGREGATION aggregationType timeBucket] FILTER filter1 [filter2 ...]

    Mengagregasi titik data dalam pkey yang memenuhi kondisi filter tertentu. Jika Anda menentukan satu atau lebih skeys untuk agregasi, skeys tersebut akan diagregasi terlebih dahulu dengan cara yang sama seperti saat menggunakan perintah EXTS.S.MRANGE. Kemudian, pkeys diagregasi berdasarkan hasil agregasi skey.

    Operasi penulisan bersamaan

    EXTS.S.RAW_MODIFY

    EXTS.S.RAW_MODIFY Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Mengubah nilai dari sebuah titik data dalam skey tertentu. Jika pkey atau skey tidak ada, maka pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah akan mengaktifkan kompresi, hanya berlaku jika skey dibuat secara otomatis.

    EXTS.S.RAW_MMODIFY

    EXTS.S.RAW_MMODIFY Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Memodifikasi nilai dari beberapa titik data dalam skey tertentu pada satu waktu. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah akan mengaktifkan kompresi, hanya berlaku jika skey dibuat secara otomatis.

    EXTS.S.RAW_INCRBY

    EXTS.S.RAW_INCRBY Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Memodifikasi nilai dari sebuah titik data dalam skey tertentu. Anda dapat menentukan penambahan atau pengurangan untuk memodifikasi nilai tersebut. Jika pkey atau skey tidak ada, maka pkey atau skey akan dibuat secara otomatis. Nilai awal default adalah 0. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah akan mengaktifkan kompresi, hanya berlaku jika skey dibuat secara otomatis ketika skey belum ada sebelumnya.

    EXTS.S.RAW_MINCRBY

    EXTS.S.RAW_MINCRBY Pkey keynumber Skey ts nilai [Skey ts nilai ...] [DATA_ET waktu] [CHUNK_SIZE ukuran] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Memodifikasi nilai dari beberapa titik data dalam sebuah skey tertentu sekaligus. Anda dapat menentukan penambahan atau pengurangan untuk memodifikasi nilai-nilai tersebut. Jika pkey atau skey tidak ada, maka pkey atau skey akan secara otomatis dibuat. Parameter untuk sebuah skey, seperti waktu kedaluwarsa dan apakah akan mengaktifkan kompresi, hanya berlaku jika skey secara otomatis dibuat ketika skey belum ada sebelumnya.

    Operasi tujuan umum

    DEL

    DEL key [key ...]

    Menghapus satu atau lebih kunci TairTS.

    Catatan

    Daftar berikut menjelaskan konvensi sintaksis perintah yang digunakan dalam topik ini:

    • Kata kunci huruf besar: menunjukkan kata kunci perintah.

    • Teks miring: menunjukkan variabel.

    • [options]: menandakan bahwa parameter yang diapit bersifat opsional. Parameter yang tidak diapit oleh tanda kurung harus ditentukan.

    • A|B: menunjukkan bahwa parameter yang dipisahkan oleh tanda batang vertikal (|) adalah saling eksklusif. Hanya satu dari parameter tersebut yang dapat ditentukan.

    • ...: menunjukkan bahwa parameter sebelum simbol ini dapat ditentukan secara berulang.

    EXTS.P.CREATE

    Item

    Description

    Sintaks

    EXTS.P.CREATE Pkey

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Membuat TairTS pkey. Jika pkey dengan nama yang sama sudah ada, pkey tidak dapat dibuat.

    Parameter

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    Output

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan akan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.P.CREATE foo

    Output contoh:

    OK

    EXTS.S.CREATE

    Item

    Description

    Syntax

    EXTS.S.CREATE Pkey Skey [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 label2 val2 ...]

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Membuat skey di dalam pkey yang ditentukan. Jika pkey tidak ada, maka akan dibuat secara otomatis. Jika skey dengan nama yang sama sudah ada, skey tidak dapat dibuat.

    Catatan

    Anda dapat menentukan parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan atau tidak.

    Parameter

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama dari skey.

    • DATA_ET time: waktu kedaluwarsa relatif dari datapoint. Satuan: milidetik. Parameter ini kosong secara default, yang berarti datapoint tidak kedaluwarsa.

    • CHUNK_SIZE: ukuran chunk tunggal yang digunakan untuk menyimpan datapoint, diukur dalam 16 byte. Nilai default CHUNK_SIZE adalah 256, yang berarti sistem mengalokasikan 4 KB memori ke chunk (dihitung sebagai 16 byte dikalikan 256) untuk menyimpan datapoint. Ketika chunk saat ini mencapai kapasitas penyimpanannya, sistem membuat chunk lain. Nilai valid CHUNK_SIZE adalah 1 hingga 256.

      Catatan

      Sebagai contoh, CHUNK_SIZE diatur ke 256. Jika kompresi tidak diaktifkan untuk skey, satu chunk dapat menyimpan 256 datapoint. Namun, jika kompresi diaktifkan, satu chunk dapat menyimpan lebih dari 256 datapoint, meskipun jumlah pastinya tergantung pada efek kompresi data spesifik tersebut.

      Untuk mengoptimalkan penggunaan memori dan menyeimbangkan efisiensi baca/tulis, kami sarankan Anda mengatur CHUNK_SIZE berdasarkan panduan berikut:

      • Jika rata-rata jumlah datapoint untuk skey tertentu lebih besar dari 5.000, atur CHUNK_SIZE ke 256 (nilai default). Menggunakan chunk yang lebih besar dapat mengurangi jumlah total chunk, yang pada gilirannya mengurangi overhead manajemen metadata.

      • Jika rata-rata jumlah datapoint untuk skey tertentu kurang dari 5.000, atur CHUNK_SIZE ke jumlah rata-rata datapoint dibagi 20. Sebagai contoh, jika jumlah rata-rata datapoint untuk skey adalah 1.000, Anda dapat mengatur CHUNK_SIZE ke 50. Pengaturan ini memungkinkan lebih sedikit data didekompresi selama kueri rentang kecil, yang dapat meningkatkan performa. Namun, jika sejumlah besar data ditulis dalam kasus ini, pembuatan banyak chunk dapat menyebabkan penurunan performa.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Parameter ini kosong secara default, yang berarti kompresi diaktifkan untuk skey.

    • LABELS: label dari skey. Anda dapat menentukan satu atau lebih pasangan nilai-label. Contoh: LABELS sensor_id 1.

    Output

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.CREATE foo temperature DATA_ET 10000000 LABELS sensor_id 1

    Output contoh:

    OK

    EXTS.S.ALTER

    Item

    Description

    Sintaks

    EXTS.S.ALTER Pkey Skey [DATA_ET time]

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Memodifikasi metadata dari skey yang ditentukan. Hanya nilai waktu DATA_ET yang dapat dimodifikasi.

    Parameter

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama skey.

    • DATA_ET time: waktu kedaluwarsa relatif dari datapoint. Satuan: milidetik. Parameter ini kosong secara default, yang menunjukkan bahwa datapoint tidak akan kedaluwarsa.

    Keluaran

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.ALTER foo temperature DATA_ET 100000

    Keluaran contoh:

    OK

    EXTS.S.ADD

    Item

    Deskripsi

    Sintaksis

    EXTS.S.ADD Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Menyisipkan titik data ke dalam skey. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis.

    Parameter

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama dari skey.

    • ts: timestamp Unix dari titik data. Satuan: milidetik. Nilai * dapat digunakan untuk menentukan timestamp waktu saat ini.

    • value: nilai dari titik data. Nilai tersebut harus berupa bilangan titik mengambang presisi ganda.

    • DATA_ET time: waktu kedaluwarsa relatif dari titik data. Satuan: milidetik. Parameter ini kosong secara default, yang menunjukkan bahwa titik data tidak kedaluwarsa.

    • CHUNK_SIZE: ukuran satu chunk, diukur dalam 16 byte. Nilai default: 256. Nilai valid: 1 hingga 256. Untuk informasi lebih lanjut, lihat EXTS.S.CREATE.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Parameter ini kosong secara default, yang menunjukkan bahwa kompresi diaktifkan untuk skey.

    • LABELS: label dari skey. Anda dapat menentukan satu atau lebih pasangan label-nilai. Contoh: LABELS sensor_id 1.

    Keluaran

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.ADD foo temperature * 30.5 DATA_ET 1000000 LABELS sensor_id 1

    Keluaran contoh:

    OK

    EXTS.S.MADD

    Item

    Description

    Syntax

    EXTS.S.MADD Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Kompleksitas waktu

    O(n), di mana n menunjukkan jumlah skeys.

    Deskripsi perintah

    Menyisipkan titik data ke dalam beberapa skeys dari sebuah pkey. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis.

    Parameter

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • keynumber: Menentukan jumlah catatan data.

    • Skey: nama dari skey.

    • ts: timestamp Unix dari titik data. Satuan: milidetik. Nilai * dapat digunakan untuk menentukan timestamp waktu saat ini.

    • value: nilai dari titik data. Nilai tersebut harus berupa bilangan titik mengambang presisi ganda.

    • DATA_ET time: waktu kedaluwarsa relatif dari titik data. Satuan: milidetik. Parameter ini kosong secara default, yang berarti titik data tidak kedaluwarsa.

    • CHUNK_SIZE: ukuran satu chunk, diukur dalam 16 byte. Nilai default: 256. Nilai valid: 1 hingga 256. Untuk informasi lebih lanjut, lihat EXTS.S.CREATE.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Parameter ini kosong secara default, yang berarti kompresi diaktifkan untuk skey.

    • LABELS: label dari skey. Anda dapat menentukan satu atau lebih pasangan label-nilai. Contoh: LABELS sensor_id 1.

    Keluaran

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.MADD foo 3 temperature * 30.2 pressure * 2.05 distance * 0.5

    Keluaran contoh:

    1) OK
2) OK
3) OK

    EXTS.S.INCRBY

    Item

    Description

    Syntax

    EXTS.S.INCRBY Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Menyisipkan sebuah titik data ke dalam skey. Jika titik data yang ingin Anda sisipkan memiliki nilai positif, nilai yang disisipkan akan ditambahkan ke nilai dari titik data terakhir yang ada di skey. Jika titik data memiliki nilai negatif, nilai yang disisipkan akan dikurangkan dari nilai titik data terakhir yang ada di skey. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Nilai awal default adalah 0. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis ketika skey belum ada.

    Parameter

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama dari skey.

    • ts: timestamp Unix dari titik data. Satuan: milidetik. Nilai * dapat digunakan untuk menentukan timestamp waktu saat ini.

    • value: nilai yang ingin Anda tambahkan ke nilai titik data. Nilai tersebut bisa negatif. Dalam hal ini, nilai tersebut akan dikurangkan dari nilai titik data. Nilai harus berupa bilangan titik mengambang presisi ganda.

    • DATA_ET time: waktu kedaluwarsa relatif dari titik data. Satuan: milidetik. Parameter ini kosong secara default, yang menunjukkan bahwa titik data tidak kedaluwarsa.

    • CHUNK_SIZE: ukuran dari satu chunk, diukur dalam 16 byte. Nilai default: 256. Nilai valid: 1 hingga 256. Untuk informasi lebih lanjut, lihat EXTS.S.CREATE.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Parameter ini kosong secara default, yang menunjukkan bahwa kompresi diaktifkan untuk skey.

    • LABELS: label dari skey. Anda dapat menentukan satu atau lebih pasangan label-nilai. Contoh: LABELS sensor_id 1.

    Output

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Jalankan perintah EXTS.S.ADD foo temperature 1644310456023 30.0 terlebih dahulu.

    Contoh perintah:

    EXTS.S.INCRBY foo temperature 1644372093031 2

    Contoh output:

    OK

    Jika perintah EXTS.S.GET foo temperature dijalankan pada saat ini, output berikut akan dikembalikan:

    1) (integer) 1644372093031
2) "32"

    EXTS.S.MINCRBY

    Item

    Description

    Sintaksis

    EXTS.S.MINCRBY Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Kompleksitas waktu

    O(n), di mana n menunjukkan jumlah skeys.

    Deskripsi perintah

    Memasukkan sebuah titik data ke dalam beberapa skeys dari sebuah pkey. Jika titik data yang ingin Anda masukkan memiliki nilai positif, nilai yang dimasukkan akan ditambahkan ke nilai dari titik data terakhir yang ada di setiap skey. Jika titik data memiliki nilai negatif, nilai yang dimasukkan akan dikurangkan dari nilai titik data terakhir yang ada di setiap skey. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Nilai awal default adalah 0. Parameter untuk sebuah skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis ketika skey belum ada.

    Opsi

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • keynumber: jumlah skeys.

    • Skey: nama dari skey.

    • ts: timestamp Unix dari titik data. Satuan: milidetik. Nilai * dapat digunakan untuk menentukan timestamp waktu saat ini.

    • value: nilai yang ingin Anda tambahkan ke nilai titik data. Nilai tersebut bisa negatif. Dalam hal ini, nilai tersebut akan dikurangkan dari nilai titik data. Nilai harus berupa bilangan titik mengambang presisi ganda.

    • DATA_ET time: waktu kedaluwarsa relatif dari titik data. Satuan: milidetik. Parameter ini kosong secara default, yang menunjukkan bahwa titik data tidak kedaluwarsa.

    • CHUNK_SIZE: ukuran dari satu chunk, diukur dalam 16 byte. Nilai default: 256. Nilai valid: 1 hingga 256. Untuk informasi lebih lanjut, lihat EXTS.S.CREATE.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Parameter ini kosong secara default, yang menunjukkan bahwa kompresi diaktifkan untuk skey.

    • LABELS: label dari skey. Anda dapat menentukan satu atau lebih pasangan label-nilai. Contoh: LABELS sensor_id 1.

    Keluaran

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.MINCRBY foo 3 temperature * 0.2 pressure * -0.1 distance * 0.0

    Keluaran contoh:

    1) OK
2) OK
3) OK

    EXTS.S.DEL

    Item

    Deskripsi

    Sintaks

    EXTS.S.DEL Pkey Skey

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Menghapus skey dari pkey dan semua titik data dalam skey.

    Parameter

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama dari skey.

    Output

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.DEL foo temperature

    Output contoh:

    OK

    EXTS.S.GET

    Item

    Deskripsi

    Sintaks

    EXTS.S.GET Pkey Skey

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Mengambil nilai dari titik data terbaru dalam skey yang ditentukan.

    Parameter

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama dari skey.

    Output

    • Jika operasi berhasil, nilai titik data akan dikembalikan.

    • Jika pkey atau skey tidak ada, nil akan dikembalikan.

    • Jika tidak, pesan kesalahan akan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.GET foo temperature

    Output contoh:

    1) (integer) 1.644.372.730.150
2) "32,2"

    EXTS.S.INFO

    Item

    Description

    Syntax

    EXTS.S.INFO Pkey Skey

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Mengeksekusi kueri metadata dari skey tertentu. Metadata mencakup jumlah titik data, timestamp dan nilai dari titik data terbaru, serta informasi label dari skey.

    Opsi

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama skey.

    Keluaran

    • Jika operasi berhasil, metadata dari skey dikembalikan.

    • Jika pkey atau skey tidak ada, nil dikembalikan.

    • Selain itu, pesan kesalahan akan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.INFO foo temperature

    Keluaran contoh:

     1) totalDataPoints            // Jumlah titik data. 
 2) (integer) 1
 3) maxDataPoints              // Jumlah maksimum titik data yang dapat disimpan di skey. Nilai default adalah 0, yang menunjukkan tidak ada batas atas.
 4) (integer) 0
 5) maxDataPointsPerChunk      // Jumlah titik data yang dapat disimpan dalam satu chunk. 
 6) (integer) 32
 7) dataPointsExpireTime       // Waktu kedaluwarsa relatif dari skey. Satuan: milidetik. Nilai 0 menunjukkan bahwa skey tidak kedaluwarsa. 
 8) (integer) 0
 9) lastTimestamp              // Timestamp dari titik data terbaru. 
10) (integer) 1.644.389.400.996
11) chunkCount                 // Jumlah chunk dalam skey. 
12) (integer) 1
13) lastValue                  // Nilai dari titik data terbaru. 
14) (integer) 28
15) labels                     // Informasi label dari skey. 
16) 1) 1) "sensor_id"
       2) "1"

    EXTS.S.QUERYINDEX

    Item

    Description

    Syntax

    EXTS.S.QUERYINDEX Pkey filter1 [filter2 ...]

    Kompleksitas waktu

    O(n), di mana n menunjukkan jumlah maksimum set yang terlibat dalam kondisi filter.

    Deskripsi perintah

    Mengecek skeys yang memenuhi kondisi filter tertentu dalam sebuah pkey.

    Parameter

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • filter: kondisi filter. Anda dapat menyaring skeys berdasarkan label. Untuk informasi lebih lanjut, lihat Sintaks penyaringan indeks.

      Catatan

      Saat Anda menentukan kondisi filter, Anda harus menggunakan salah satu logika EQ, CONTAINS, atau LIST_MATCH. Jika tidak, kueri filter tidak dapat dilakukan.

    Output

    • Jika operasi berhasil, skeys yang memenuhi kondisi filter tertentu akan dikembalikan.

    • Jika pkey atau skey tidak ada, nil akan dikembalikan.

    • Jika tidak, pesan kesalahan akan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.QUERYINDEX foo sensor_id=1

    Output contoh:

    1) "temperature"

    EXTS.S.RANGE

    Item

    Description

    Syntax

    EXTS.S.RANGE Pkey Skey fromTs toTs [MAXCOUNT count] [AGGREGATION aggregationType timeBucket]

    Kompleksitas waktu

    O(n), di mana n menunjukkan jumlah chunk yang menjadi bagian dari titik data.

    Deskripsi perintah

    Mengkueri jumlah titik data yang ada dalam skey selama rentang waktu tertentu. Rentang waktu adalah interval tertutup.

    Parameter

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama skey.

    • fromTs: awal rentang waktu untuk kueri. Nilai ini harus berupa timestamp Unix. Satuan: milidetik.

    • toTs: akhir rentang waktu untuk kueri. Nilai ini harus berupa timestamp Unix. Satuan: milidetik. Nilai * dapat digunakan untuk menentukan timestamp waktu saat ini. Jika nilai ini sama dengan nilai fromTs, satu titik waktu digunakan untuk kueri.

    • MAXCOUNT: jumlah titik data yang akan dikembalikan. Parameter ini kosong secara default. Batas atasnya adalah 1.000.000 untuk instans Tair.

    • AGGREGATION:

      • aggregationType: tipe agregasi, seperti MAX, AVG, atau SUM. Untuk informasi lebih lanjut, lihat Sintaks Agregasi.

      • timeBucket: bucket waktu yang digunakan untuk mengumpulkan data. Satuan: milidetik. Batas bawahnya adalah 1.000.

        Dalam ApsaraDB for Redis Enhanced Edition (Tair), data yang ada dalam skey atau pkey selama rentang waktu tertentu di-aggregasi dan hasilnya dikembalikan. Titik waktu untuk mengembalikan hasil adalah awal interval pengumpulan.

      Sebagai contoh, AGGREGATION AVG 5000 mengembalikan rata-rata jumlah titik data yang ada dalam setiap bucket waktu yang berlangsung selama 5.000 milidetik dalam rentang waktu yang ditentukan.

    Output

    • Jika operasi berhasil, jumlah titik data yang memenuhi kondisi filter tertentu akan dikembalikan. Jika agregasi ditentukan dalam perintah, hasil agregasi akan dikembalikan.

      Catatan

      Nilai token tambahan dikembalikan. Nilai 0 menunjukkan bahwa semua titik data yang memenuhi kondisi filter tertentu ditampilkan. Nilai 1 menunjukkan bahwa beberapa titik data yang memenuhi kondisi filter tertentu tidak ditampilkan. Anda dapat mengambil titik data terbaru dari hasil berdasarkan nilai token dan menggunakan timestamp dari titik data terbaru sebagai awal rentang waktu berikutnya untuk kueri untuk menerapkan agregasi batch.

    • Jika pkey atau skey tidak ada, nil dikembalikan.

    • Selain itu, pesan kesalahan akan dikembalikan.

    Contoh

    Perintah sampel:

    EXTS.S.RANGE foo test 1644459031662 * AGGREGATION AVG 10000 MAXCOUNT 2
// Perintah mengambil rata-rata jumlah titik data yang ada dalam setiap bucket waktu yang berlangsung selama 10.000 milidetik dalam rentang waktu yang ditentukan dan mengembalikan dua entri data.

    Output sampel:

    1) 1) 1) (integer) 1644459730000
      2) "20.6"
   2) 1) (integer) 1644459790000
      2) "21.2"
2) (integer) 1                    // Nilai 0 menunjukkan bahwa semua titik data yang memenuhi kondisi filter tertentu ditampilkan. Nilai 1 menunjukkan bahwa beberapa titik data yang memenuhi kondisi filter tertentu tidak ditampilkan.

    EXTS.S.MRANGE

    Item

    Description

    Sintaksis

    EXTS.S.MRANGE Pkey fromTs toTs [MAXCOUNT count] [AGGREGATION aggregationType timeBucket] [WITHLABELS] FILTER filter1 [filter2 ...]

    Kompleksitas waktu

    O(n), di mana n menunjukkan jumlah chunk yang menjadi bagian dari titik data.

    Deskripsi perintah

    Mengkueri jumlah titik data yang memenuhi kondisi filter tertentu dalam beberapa skeys selama rentang waktu tertentu. Rentang waktu adalah interval tertutup.

    Parameter

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • fromTs: awal rentang waktu untuk kueri. Nilai ini harus berupa timestamp Unix. Satuan: milidetik.

    • toTs: akhir rentang waktu untuk kueri. Nilai ini harus berupa timestamp Unix. Satuan: milidetik. Nilai * dapat digunakan untuk menentukan timestamp waktu saat ini. Jika nilai ini sama dengan nilai fromTs, satu titik waktu digunakan untuk kueri.

    • MAXCOUNT: jumlah titik data yang akan dikembalikan dalam sebuah skey. Parameter ini kosong secara default. Batas atasnya adalah 1.000.000 untuk instans Tair.

    • AGGREGATION:

      • aggregationType: jenis agregasi, seperti MAX, AVG, atau SUM. Untuk informasi lebih lanjut, lihat Sintaksis agregasi.

      • timeBucket: bucket waktu yang digunakan untuk mengumpulkan data. Satuan: milidetik. Batas bawahnya adalah 1.000.

        Tair mengumpulkan data yang ada di beberapa bucket waktu dan mengembalikan hasil tunggal. Titik-titik waktu yang dikembalikan adalah awal dari setiap bucket waktu.

    • WITHLABELS: menentukan apakah akan menyertakan informasi label dalam output. Parameter ini kosong secara default, yang menunjukkan bahwa informasi label tidak ditampilkan.

    • filter: kondisi filter. Anda dapat memfilter skeys berdasarkan label. Untuk informasi lebih lanjut, lihat Sintaksis penyaringan indeks.

      Catatan

      Saat menentukan kondisi filter, Anda harus menggunakan salah satu logika EQ, CONTAINS, atau LIST_MATCH. Jika tidak, kueri filter tidak dapat dilakukan.

    Output

    • Jika operasi berhasil, skeys yang memenuhi kondisi filter tertentu akan dikembalikan.

    • Jika pkey atau skey tidak ada, nil akan dikembalikan.

    • Jika tidak, pesan kesalahan akan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.MRANGE foo 1644451031662 * AGGREGATION MAX 10000 WITHLABELS FILTER sensor_id=1

    Output contoh:

    1) 1) "temperature"
   2) 1) 1) "sensor_id"
         2) "1"
   3) 1) 1) (integer) 1644481000000
         2) "30"
   4) (integer) 0
2) 1) "test"
   2) 1) 1) "sensor_id"
         2) "1"
   3) 1) 1) (integer) 1644459730000
         2) "20"
      2) 1) (integer) 1644459790000
         2) "20"
      3) 1) (integer) 1644460620000
         2) "29"
   4) (integer) 0

    EXTS.P.RANGE

    Item

    Deskripsi

    Sintaksis

    EXTS.P.RANGE Pkey fromTs toTs pkeyAggregationType pkeyTimeBucket [MAXCOUNT count] [AGGREGATION aggregationType timeBucket] FILTER filter1 [filter2 ...]

    Kompleksitas waktu

    O(n), di mana n menunjukkan jumlah chunk yang menjadi bagian dari titik data.

    Deskripsi perintah

    Mengagregasi titik data dalam sebuah pkey yang memenuhi kondisi filter tertentu. Jika Anda menentukan satu atau lebih skeys untuk agregasi, skeys tersebut akan terlebih dahulu di-aggregasi dengan cara yang sama seperti saat menggunakan perintah EXTS.S.MRANGE. Kemudian, pkeys di-aggregasi berdasarkan hasil agregasi skey.

    Parameter

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • fromTs: awal rentang waktu untuk kueri. Nilai ini harus berupa timestamp Unix. Satuan: milidetik.

    • toTs: akhir rentang waktu untuk kueri. Nilai ini harus berupa timestamp Unix. Satuan: milidetik. Nilai * dapat digunakan untuk menentukan timestamp waktu saat ini. Jika nilai ini sama dengan nilai fromTs, maka titik waktu digunakan untuk kueri.

    • pkeyAggregationType: tipe agregasi dari pkey. Untuk informasi lebih lanjut, lihat Sintaksis Agregasi.

    • pkeyTimeBucket: bucket waktu yang digunakan untuk mengagregasi data dalam pkey. Satuan: milidetik. Batas bawah adalah 1.000.

      Tair mengagregasi data yang ada di beberapa bucket waktu dan mengembalikan satu hasil. Titik waktu yang dikembalikan adalah awal dari setiap bucket waktu.

    • MAXCOUNT: jumlah titik data yang akan dikembalikan dalam sebuah skey. Parameter ini kosong secara default. Batas atasnya adalah 1.000.000 untuk instans Tair.

    • AGGREGATION:

      • aggregationType: tipe agregasi dari skey. Untuk informasi lebih lanjut, lihat Sintaksis Agregasi.

      • timeBucket: bucket waktu yang digunakan untuk mengagregasi data dalam skey. Satuan: milidetik. Batas bawah adalah 1.000.

        Tair mengagregasi data yang ada di beberapa bucket waktu dan mengembalikan satu hasil. Titik waktu yang dikembalikan adalah awal dari setiap bucket waktu.

    • filter: kondisi filter. Anda dapat menyaring skeys berdasarkan label. Untuk informasi lebih lanjut, lihat Sintaksis Penyaringan Indeks.

      Catatan

      Saat Anda menentukan kondisi filter, Anda harus menggunakan salah satu logika EQ, CONTAINS, atau LIST_MATCH. Jika tidak, kueri filter tidak dapat dilakukan.

    Keluaran

    • Jika operasi berhasil, hasil agregasi dikembalikan.

    • Jika pkey atau skey tidak ada, nil dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.P.RANGE foo 1644451031662 * SUM 500000 AGGREGATION SUM 10000 FILTER sensor_id=1

    Keluaran contoh:

    1) 1) 1) (integer) 1644459500000
      2) "40"
   2) 1) (integer) 1644460500000
      2) "29"
   3) 1) (integer) 1644481000000
      2) "30"
2) (integer) 0

    EXTS.S.RAW_MODIFY

    Item

    Deskripsi

    Sintaks

    EXTS.S.RAW_MODIFY Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Memodifikasi nilai dari sebuah titik data dalam skey yang ditentukan. Jika pkey atau skey tidak ada, maka pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis.

    Parameter

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama skey.

    • ts: timestamp Unix dari titik data yang nilainya ingin Anda perbarui. Satuan: milidetik.

    • value: nilai titik data yang ingin Anda perbarui. Nilai tersebut harus berupa angka floating point presisi ganda.

    • DATA_ET time: waktu kedaluwarsa relatif dari titik data. Satuan: milidetik. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa titik data tidak akan kedaluwarsa.

    • CHUNK_SIZE: ukuran satu chunk, diukur dalam 16 byte. Nilai default: 256. Nilai valid: 1 hingga 256. Untuk informasi lebih lanjut, lihat EXTS.S.CREATE.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Secara default, parameter ini dibiarkan kosong, yang menunjukkan bahwa kompresi diaktifkan untuk skey.

    • LABELS: label-label dari skey. Anda dapat menentukan satu atau lebih pasangan label-nilai. Contoh: LABELS sensor_id 1.

    Keluaran

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.RAW_MODIFY foo temperature 1644310456023 31.5

    Keluaran contoh:

    OK

    EXTS.S.RAW_MMODIFY

    Item

    Description

    Sintaksis

    EXTS.S.RAW_MMODIFY Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Kompleksitas waktu

    O(n), di mana n menunjukkan jumlah skeys.

    Deskripsi perintah

    Memodifikasi nilai dari beberapa titik data dalam skey tertentu pada satu waktu. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis.

    Parameter

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • keynumber: Menentukan jumlah entri data.

    • Skey: nama skey.

    • ts: timestamp Unix dari titik data yang nilainya ingin Anda perbarui. Satuan: milidetik.

    • value: nilai titik data yang ingin Anda perbarui. Nilai tersebut harus berupa bilangan floating point presisi ganda.

    • DATA_ET time: waktu kedaluwarsa relatif dari titik data. Satuan: milidetik. Parameter ini kosong secara default, yang menunjukkan bahwa titik data tidak kedaluwarsa.

    • CHUNK_SIZE: ukuran chunk tunggal, diukur dalam 16 byte. Nilai default: 256. Nilai valid: 1 hingga 256. Untuk informasi lebih lanjut, lihat EXTS.S.CREATE.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Parameter ini kosong secara default, yang menunjukkan bahwa kompresi diaktifkan untuk skey.

    • LABELS: label-label dari skey. Anda dapat menentukan satu atau lebih pasangan label-nilai. Contoh: LABELS sensor_id 1.

    Keluaran

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.RAW_MMODIFY foo 3 temperature 1644565954814 30.2 pressure 1644565954814 2.05 distance 1644565954814 0.5

    Keluaran contoh:

    1) OK
2) OK
3) OK

    EXTS.S.RAW_INCRBY

    Item

    Deskripsi

    Sintaksis

    EXTS.S.RAW_INCRBY Pkey Skey ts value [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Kompleksitas waktu

    O(1)

    Deskripsi perintah

    Mengubah nilai dari sebuah titik data dalam skey yang ditentukan. Anda dapat menentukan penambahan atau pengurangan untuk memodifikasi nilainya. Jika pkey atau skey tidak ada, pkey atau skey akan dibuat secara otomatis. Nilai awal default adalah 0. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis ketika skey belum ada.

    Parameter

    • Pkey: nama pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • Skey: nama skey.

    • ts: timestamp Unix dari titik data yang nilainya ingin Anda perbarui. Satuan: milidetik.

    • value: nilai yang ingin Anda tambahkan ke nilai titik data. Nilai tersebut bisa negatif. Dalam hal ini, nilai tersebut dikurangkan dari nilai titik data. Nilai harus berupa bilangan titik mengambang presisi ganda.

    • DATA_ET time: waktu kedaluwarsa relatif dari titik data. Satuan: milidetik. Secara default, parameter ini kosong, yang menunjukkan bahwa titik data tidak kedaluwarsa.

    • CHUNK_SIZE: ukuran chunk tunggal, diukur dalam 16 byte. Nilai default: 256. Nilai valid: 1 hingga 256. Untuk informasi lebih lanjut, lihat EXTS.S.CREATE.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Secara default, parameter ini kosong, yang menunjukkan bahwa kompresi diaktifkan untuk skey.

    • LABELS: label-label dari skey. Anda dapat menentukan satu atau lebih pasangan label-nilai. Contoh: LABELS sensor_id 1.

    Keluaran

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Jalankan perintah EXTS.S.ADD foo temperature 1644310456 30.0 terlebih dahulu.

    Perintah contoh:

    EXTS.S.RAW_INCRBY foo temperature 1644310456 3.3

    Keluaran contoh:

    OK

    Jika perintah EXTS.S.GET foo temperature dijalankan pada saat ini, keluaran berikut akan dikembalikan:

    1) (integer) 1644310456
2) "33.3"

    EXTS.S.RAW_MINCRBY

    Item

    Description

    Syntax

    EXTS.S.RAW_MINCRBY Pkey keynumber Skey ts value [Skey ts value ...] [DATA_ET time] [CHUNK_SIZE size] [UNCOMPRESSED] [LABELS label1 val1 ...]

    Kompleksitas waktu

    O(n), di mana n menunjukkan jumlah titik data.

    Deskripsi perintah

    Memodifikasi nilai dari beberapa titik data dalam skey tertentu secara bersamaan. Anda dapat menentukan penambahan atau pengurangan untuk memodifikasi nilai tersebut. Jika pkey atau skey tidak ada, maka pkey atau skey akan dibuat secara otomatis. Parameter untuk skey, seperti waktu kedaluwarsa dan apakah kompresi diaktifkan, hanya berlaku jika skey dibuat secara otomatis ketika skey belum ada sebelumnya.

    Parameter

    • Pkey: nama dari pkey yang ingin Anda kelola dengan menjalankan perintah ini.

    • keynumber: Menentukan jumlah entri data.

    • Skey: nama dari skey.

    • ts: timestamp Unix dari titik data yang nilainya ingin Anda perbarui. Satuan: milidetik.

    • value: nilai yang ingin Anda tambahkan ke nilai titik data. Nilai ini bisa negatif. Dalam hal ini, nilai tersebut akan dikurangi dari nilai titik data. Nilai harus berupa bilangan titik mengambang presisi ganda.

    • DATA_ET time: waktu kedaluwarsa relatif dari titik data. Satuan: milidetik. Parameter ini kosong secara default, yang menunjukkan bahwa titik data tidak kedaluwarsa.

    • CHUNK_SIZE: ukuran dari satu chunk, diukur dalam 16 byte. Nilai default: 256. Nilai valid: 1 hingga 256. Untuk informasi lebih lanjut, lihat EXTS.S.CREATE.

    • UNCOMPRESSED: menentukan bahwa kompresi dinonaktifkan untuk skey. Parameter ini kosong secara default, yang menunjukkan bahwa kompresi diaktifkan untuk skey.

    • LABELS: label dari skey. Anda dapat menentukan satu atau lebih pasangan label-nilai. Contoh: LABELS sensor_id 1.

    Output

    • Jika operasi berhasil, OK dikembalikan.

    • Jika tidak, pesan kesalahan dikembalikan.

    Contoh

    Perintah contoh:

    EXTS.S.RAW_MINCRBY foo 3 temperature 1644565954814 30.2 pressure 1644565954814 2.05 distance 1644565954814 0.5

    Output contoh:

    1) OK
2) OK
3) OK

    Sintaks penyaringan indeks

    Skeys dapat disaring berdasarkan label. Sintaks berikut digunakan untuk kondisi filter.

    Catatan

    Saat menentukan kondisi filter, Anda dapat menggunakan satu atau lebih dari perintah berikut dan harus menggunakan salah satu logika EQ, CONTAINS, dan LIST_MATCH.

    Perintah Filter

    Deskripsi

    Logika

    L = V

    Label L sama dengan V.

    EQ (sama dengan)

    L !=

    Label L tidak NULL, yang menunjukkan bahwa skey mengandung label L.

    CONTAINS

    L = (v1,v2,...)

    Label L adalah v1, v2, atau nilai lainnya.

    LIST_TMATCH

    L != V

    Label L tidak sama dengan V.

    NOEQ (tidak sama dengan)

    L =

    Label L adalah NULL, yang menunjukkan bahwa skey tidak mengandung label L.

    NOCONTAINS

    L != (v1,v2,...)

    Nilai dari label L tidak cocok dengan salah satu nilai dalam daftar, seperti v1 atau v2.

    LIST_NOTMATCH

    Sintaks agregasi

    Dalam operasi agregasi, data yang ada selama interval yang ditentukan oleh parameter timeBucket diagregasi. Jenis agregasi berikut didukung:

    • MAX: mengembalikan nilai maksimum.

    • MIN: mengembalikan nilai minimum.

    • AVG: mengembalikan nilai rata-rata.

    • SUM: mengembalikan jumlah semua nilai.

    • FIRST: mengembalikan nilai pertama.

    • LAST: mengembalikan nilai terakhir.

    • RANGE: mengembalikan rentang dari nilai minimum hingga nilai maksimum.

    • COUNT: mengembalikan jumlah nilai.

    • STD.P: mengembalikan varians populasi.

    • STD.S: mengembalikan varians sampel.

    • VAR.P: mengembalikan simpangan baku populasi.

    • VAR.S: mengembalikan simpangan baku sampel.

    FAQ

    • P: Mengapa nilai default dari CHUNK_SIZE relatif kecil di beberapa instans Tair berbasis DRAM yang kompatibel dengan Redis 5.0?

      J: Mulai versi 25.2.0.0, CHUNK_SIZE diatur menjadi 256 secara default. Di versi sebelumnya, CHUNK_SIZE diatur menjadi 32 secara default.