Tair (Redis® OSS-Compatible):Doc

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

• Bir Tair DRAM tabanlı örnek

• Örnek küçük sürümü 1.8.4 veya üzeri (JSON.GET aracılığıyla tam JSONPath desteği için gereklidir)

Örneğinizi en son küçük sürüme güncellemek için bkz. Örneğin küçük sürümünü güncelleme.

Küme veya okuma/yazma ayrımı yapan örnekler için, tüm komutların beklendiği gibi çalışmasını sağlamak üzere proxy düğümlerini en son küçük sürüme güncelleyin.

Komut listesi

Bu referansta kullanılan sözdizimi kuralları:

• BÜYÜK HARF: komut anahtar kelimesi

• _italik_: değişken

• [seçenek]: isteğe bağlı parametre

• A | B: birbirini dışlayan seçenekler

• ...: parametre tekrar edilebilir

JSON.SET

Sözdizimi: JSON.SET anahtar yol json [NX | XX]

Bir TairDoc anahtarı oluşturur ve belirtilen yolda bir JSON öğesi depolar. Anahtar ve yol zaten varsa öğeyi günceller.

Parametreler:

Dönüş değerleri:

Örnek — JSON belgesi oluşturma:

Aşağıdaki komut, kök yolda ($) bir doc anahtarı oluşturur ve dört kitap ile bir bisiklet içeren bir kitapçı belgesi depolar:

JSON.SET doc $ '{ "store": { "book": [ { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95 }, { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99 }, { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99 }, { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99 } ], "bicycle": { "color": "red", "price": 19.95 } } }'

Beklenen çıktı:

OK

JSON.GET

Sözdizimi: JSON.GET anahtar yol [FORMAT XML | YAML] [ROOTNAME kök] [ARRNAME dizi]

Belirtilen yoldaki JSON öğesini alır. Hem JSONPath hem de JSON Pointer sözdizimini destekler.

Parametreler:

Dönüş değerleri:

Örnek — belgeyi XML olarak alma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

Ardından, kök etiket adı olarak ROOT ve dizi etiket adı olarak ARR belirterek XML olarak alın:

JSON.GET doc . FORMAT XML ROOTNAME ROOT ARRNAME ARR

Beklenen çıktı:

"<?xml version=\"1.0\" encoding=\"UTF-8\"?><ROOT><foo>bar</foo><baz>42</baz></ROOT>"

JSON.DEL

Sözdizimi: JSON.DEL anahtar yol

Belirtilen yoldaki JSON öğesini siler. Yol verilmezse tüm anahtarı siler. Anahtar veya yol yoksa sessizce hiçbir işlem yapmaz.

Parametreler:

Dönüş değerleri:

Örnek — alan silme:

Önce belgeyi oluşturun:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

foo alanını silin:

JSON.DEL doc .foo

Beklenen çıktı — 1 öğenin silindiğini gösterir:

(integer) 1

JSON.TYPE

Sözdizimi: JSON.TYPE anahtar yol

Belirtilen yoldaki JSON öğesinin türünü döndürür.

Parametreler:

Dönüş değerleri:

Örnek — alanın türünü alma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

foo alanının türünü alın ("bar" bir dizedir):

JSON.TYPE doc .foo

Beklenen çıktı:

string

JSON.MERGE

Sözdizimi: JSON.MERGE anahtar yol değer

Bir JSON değerini belirtilen yolla birleştirir. Yeni değerler eklemeyi, mevcut değerleri güncellemeyi ve belirtilen yoldaki değerleri silmeyi destekler.

Parametreler:

Dönüş değerleri:

Örnek — tek işlemde değer ekleme, güncelleme ve silme:

Önce belgeyi oluşturun:

JSON.SET doc $ '{"f1": {"a":1}, "f2":{"a":2}}'

Değişiklikleri birleştirin: f1 değerini null olarak ayarlayın (silinir), f2.a değerini güncelleyin ve f2.b ekleyin ve yeni bir f3 dizisi ekleyin:

JSON.MERGE doc $ '{"f1": null, "f2":{"a":3, "b":4}, "f3":[2,4,6]}'

Beklenen çıktı:

OK

Sonucu JSON.GET doc . ile doğrulayın. Birleştirme yamasında bir alanı null olarak ayarlamak onu sildiğinden f1 anahtarı kaldırılır:

"{\"f2\":{\"a\":3,\"b\":4},\"f3\":[2,4,6]}"

JSON.NUMINCRBY

Sözdizimi: JSON.NUMINCRBY anahtar yol değer

Belirtilen yoldaki sayısal JSON öğesini artırır. Hem mevcut öğe hem de artış değeri aynı türde olmalıdır — tamsayı veya ondalık sayı.

Parametreler:

Dönüş değerleri:

Örnek — sayısal alanı artırma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

baz değerini 10 artırın (42 + 10 = 52):

JSON.NUMINCRBY doc .baz 10

Beklenen çıktı:

"52"

JSON.STRAPPEND

Sözdizimi: JSON.STRAPPEND anahtar yol json-dizesi

Belirtilen yoldaki JSON dize öğesine bir dize ekler. Hem mevcut öğe hem de eklenen değer string türünde olmalıdır.

Parametreler:

Dönüş değerleri:

Örnek — dize alanına ekleme yapma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

foo değerine rrrrr ekleyin — "bar" değeri "barrrrrr" olur ve 8 karakter uzunluğundadır:

JSON.STRAPPEND doc .foo rrrrr

Beklenen çıktı:

(integer) 8

JSON.STRLEN

Sözdizimi: JSON.STRLEN anahtar yol

Belirtilen yoldaki JSON dize öğesinin karakter uzunluğunu döndürür. Öğe string türünde olmalıdır.

Parametreler:

Dönüş değerleri:

Örnek — dize alanının uzunluğunu alma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

foo değerinin uzunluğunu alın — "bar" 3 karakter uzunluğundadır:

JSON.STRLEN doc .foo

Beklenen çıktı:

(integer) 3

JSON.ARRAPPEND

Sözdizimi: JSON.ARRAPPEND anahtar yol json [json ...]

Bir veya daha fazla JSON öğesini bir dizinin sonuna ekler. Zaman karmaşıklığı O(M×N)'dir; burada M eklenecek öğe sayısı, N ise mevcut dizi uzunluğudur.

Parametreler:

Dönüş değerleri:

Örnek — diziye birden çok öğe ekleme:

Önce belgeyi oluşturun:

JSON.SET doc . '{"id": [1,2,3]}'

id dizisine null, false ve true ekleyin. Dizi 3 öğeden 6 öğeye çıkar:

JSON.ARRAPPEND doc .id null false true

Beklenen çıktı:

(integer) 6

JSON.ARRPOP

Sözdizimi: JSON.ARRPOP anahtar yol [dizin]

Bir dizide belirtilen dizindeki öğeyi kaldırır ve döndürür. Zaman karmaşıklığı O(M×N)'dir; burada M anahtardaki alt öğe sayısı, N ise dizi uzunluğudur.

Parametreler:

Dönüş değerleri:

Örnek — dizinin ilk öğesini kaldırma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"id": [1,2,3]}'

0 dizinindeki öğeyi (ilk öğe, 1) kaldırın ve döndürün:

JSON.ARRPOP doc .id 0

Beklenen çıktı:

"1"

JSON.ARRINSERT

Sözdizimi: JSON.ARRINSERT anahtar yol [dizin] json [json ...]

Bir veya daha fazla JSON öğesini bir diziye belirtilen dizinden önce ekler. Zaman karmaşıklığı O(M×N)'dir; burada M eklenecek öğe sayısı, N ise mevcut dizi uzunluğudur.

Parametreler:

Dönüş değerleri:

Örnek — dizinin başına öğe ekleme:

Önce belgeyi oluşturun:

JSON.SET doc . '{"id": [1,2,3]}'

0 dizininden önce 10 ve 15 ekleyin. Sonuçta oluşan dizi [10, 15, 1, 2, 3] olur:

JSON.ARRINSERT doc .id 0 10 15

Beklenen çıktı:

(integer) 5

JSON.ARRLEN

Sözdizimi: JSON.ARRLEN anahtar yol

Bir dizideki öğe sayısını döndürür.

Parametreler:

Dönüş değerleri:

Örnek — dizinin uzunluğunu alma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"id": [1,2,3]}'

id dizisindeki öğe sayısını alın:

JSON.ARRLEN doc .id

Beklenen çıktı:

(integer) 3

JSON.ARRTRIM

Sözdizimi: JSON.ARRTRIM anahtar yol başlangıç bitiş

Bir diziyi yalnızca [başlangıç, bitiş] aralığındaki (dahil) öğelerin kalacak şekilde kırpar. Bu aralığın dışındaki tüm öğeler kaldırılır.

Parametreler:

Dönüş değerleri:

Örnek — diziyi alt aralığa kırpma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"id": [1,2,3,4,5,6]}'

Diziyi yalnızca 3 ve 4 dizinlerindeki öğeleri (değerler 4 ve 5) tutacak şekilde kırpın. Bu aralığın dışındaki öğeler atılır:

JSON.ARRTRIM doc .id 3 4

Beklenen çıktı — 2 öğe kalır:

(integer) 2

JSONPath

JSON.GET esnek sorgular için JSONPath RFC taslağı-4 sözdizimini destekler. Tam JSONPath desteği için sürüm 1.8.4 veya üzeri gerekir.

Desteklenen seçiciler:

Sorgu örnekleri:

Aşağıdaki örnekler bu kitapçı belgesini kullanır. Önce oluşturun:

JSON.SET dockey $
'{
    "store": {
        "book": [{
                "category": "reference",
                "author": "Nigel Rees",
                "title": "Sayings of the Century",
                "price": 8.95
            },
            {
                "category": "fiction",
                "author": "Evelyn Waugh",
                "title": "Sword of Honour",
                "price": 12.99
            },
            {
                "category": "fiction",
                "author": "Herman Melville",
                "title": "Moby Dick",
                "isbn": "0-553-21311-3",
                "price": 8.99
            },
            {
                "category": "fiction",
                "author": "J. R. R. Tolkien",
                "title": "The Lord of the Rings",
                "isbn": "0-395-19395-8",
                "price": 22.99
            }
        ],
        "bicycle": {
            "color": "red",
            "price": 19.95
        }
    },
    "expensive": 10
}'

Beklenen çıktı:

OK

JSON.GET dockey $

"[{"store":{"book":[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"Evelyn Waugh","title":"Sword of Honour","price":12.99},{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99},{"category":"fiction","author":"J. R. R. Tolkien","title":"The Lord of the Rings","isbn":"0-395-19395-8","price":22.99}],"bicycle":{"color":"red","price":19.95}}}]"

JSON.GET dockey $.store.bicycle.*

"["red",19.95]"

JSON.GET dockey $.store.bicycle.price

"[19.95]"

JSON.GET dockey $.store.book[0]

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95}]"

JSON.GET dockey "$.store.book[*]['title']"

"["Sayings of the Century","Sword of Honour","Moby Dick","The Lord of the Rings"]"

JSON.GET dockey $.store.book[0:2:1]

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99},{"category":"fiction","author":"Evelyn Waugh","title":"Sword of Honour","price":12.99}]"

JSON.GET dockey $..price

"[8.95,12.99,8.99,22.99,19.95]"

JSON.GET dockey $.store.book[0,2]

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99}]"

JSON.GET dockey $.store.book[?(@.isbn)]

"[{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99},{"category":"fiction","author":"J. R. R. Tolkien","title":"The Lord of the Rings","isbn":"0-395-19395-8","price":22.99}]"

JSON.GET dockey '$.store.book[?(@.price < 10)]'

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99}]"

JSON.GET dockey "$..book[?((@.price == 12.99 || @.price > $.store.bicycle.price) || @.category == 'reference')]"

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"J. R. R. Tolkien","title":"The Lord of the Rings","isbn":"0-395-19395-8","price":22.99},{"category":"fiction","author":"Evelyn Waugh","title":"Sword of Honour","price":12.99}]"

JSON Pointer

TairDoc, JSON Pointer sözdizimini (RFC 6901) tam olarak destekler. Bir belgeye gitmek için / ile ayrılmış yolları kullanın.

Örnek — iç içe geçmiş dizi öğesini alma:

Önce belgeyi oluşturun:

JSON.SET doc . '{"foo": "bar", "baz" : [1,2,3]}'

JSON Pointer yolu /baz/0 kullanarak baz dizisinin ilk öğesini alın:

JSON.GET doc /baz/0

Beklenen çıktı:

"1"