Read and write data with the Tablestore CLI - Tablestore - Alibaba Cloud Dokümantasyon Merkezi

Ön koşullar

Tablestore CLI yüklü olmalı ve erişim kimlik bilgileri yapılandırılmış olmalıdır. Daha fazla bilgi için bkz. Tablestore CLI.
Bir veri tablosu oluşturulmuş olmalıdır. Daha fazla bilgi için bkz. Veri tablosu işlemleri.

Veri işlemlerini çalıştırmadan önce hedef veri tablosunu seçmek için aşağıdaki komutu çalıştırın:

use -t <tableName>

Veri ekleme

Bir veri tablosuna bir satır veri ekler.

put --pk '<pk_values>' --attr '<attr_json>'

Parametre	Gerekli	Açıklama
-k, --pk	Evet	JSON dizisi olarak temsil edilen veri tablosunun birincil anahtar değerleri. Önemli Birincil anahtar sütunlarının sayısı ve türleri veri tablosundakilerle eşleşmelidir. Birincil anahtar sütunu otomatik artan bir sütunsa değerini null yer tutucusuna ayarlayın.
-a, --attr	Evet	JSON dizisi olarak temsil edilen öznitelik sütunları. Her öznitelik sütunu aşağıdaki alanları içerir: c (gerekli): Öznitelik sütunu adı. v (gerekli): Öznitelik sütunu değeri. t (isteğe bağlı): Öznitelik sütunu türü. Geçerli değerler: integer, string (UTF-8 kodlu dize), binary, Boolean ve double. Öznitelik sütunu türü binary ise bu alan gereklidir. ts (isteğe bağlı): veri sürümü olan zaman damgası. Bu parametreyi ayarlamazsanız Tablestore bir zaman damgası oluşturur.
--condition	Hayır	Satır varlık koşulu. Koşullu güncelleme desteklenir. Geçerli değerler: ignore (varsayılan): Satırın var olup olmadığına bakılmaksızın veri ekler. Mevcut satırların üzerine yazar. exist: Yalnızca satır varsa veri ekler. Mevcut verilerin üzerine yazar. not_exist: Yalnızca satır yoksa veri ekler.
-i, --input	Hayır	Bir JSON yapılandırma dosyasından veri ekler. Yapılandırma dosyası kullanırken --pk ve --attr belirtmeniz gerekmez.

Bir yapılandırma dosyasından veri eklemek için aşağıdaki komutu çalıştırın:

Windows

put -i D:\\localpath\\filename.json

Linux ve macOS

put -i /localpath/filename.json

Yapılandırma dosyası örneği:

{
    "PK":{
        "Values":["86", 6771]
    },
    "Attr":{
        "Values":[
            {"C":"age", "V":32, "TS":1626860801604, "IsInt":true}
        ]
    }
}

Örnekler

Bir satır ekler. İlk birincil anahtar sütunu değeri "86", ikinci birincil anahtar sütunu değeri 6771'dir. Satırda name ve country adlı iki öznitelik sütunu bulunur.
```
put --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]'
```

Yalnızca satır yoksa veri ekler.

put --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]' --condition not_exist

Veri okuma

Birincil anahtara göre bir satır veri okur.

Not

Belirtilen satır yoksa boş bir sonuç döndürülür.

get --pk '<pk_values>'

Parametre	Gerekli	Açıklama
-k, --pk	Evet	JSON dizisi olarak temsil edilen veri tablosunun birincil anahtar değerleri. Birincil anahtar sütunlarının sayısı ve türleri veri tablosundakilerle eşleşmelidir.
-c, --columns	Hayır	Okunacak sütunlar. Birincil anahtar sütunlarını veya öznitelik sütunlarını virgülle ayırarak belirtin. Bu parametreyi ayarlamazsanız tüm sütunlar döndürülür.
--max_version	Hayır	Okunacak maksimum veri sürümü sayısı.
--time_range_start	Hayır	Belirtilen sürüm numarası aralığındaki verileri okur. time_range_start ve time_range_end sırasıyla başlangıç ve bitiş zaman damgalarını belirtir. Aralık [başlangıç, bitiş) şeklinde yarı açık bir aralıktır.
--time_range_end	Hayır
--time_range_specific	Hayır	Belirli bir sürüm numarasındaki verileri okur.
-o, --output	Hayır	Sorgu sonucunu yerel bir dosyaya çıkarır.

Örnek

İlk birincil anahtar sütunu değeri "86" ve ikinci birincil anahtar sütunu değeri 6771 olan satırı okur.

get --pk '["86", 6771]'

Veri güncelleme

Bir veri tablosundaki bir satırın öznitelik sütunlarını günceller.

update --pk '<pk_values>' --attr '<attr_json>'

Parametre	Gerekli	Açıklama
-k, --pk	Evet	JSON dizisi olarak temsil edilen veri tablosunun birincil anahtar değerleri. Birincil anahtar sütunlarının sayısı ve türleri veri tablosundakilerle eşleşmelidir.
--attr	Evet	JSON dizisi olarak temsil edilen öznitelik sütunları. Her öznitelik sütunu aşağıdaki alanları içerir: c (gerekli): Öznitelik sütunu adı. v (gerekli): Öznitelik sütunu değeri. t (isteğe bağlı): Öznitelik sütunu türü. Geçerli değerler: integer, string (UTF-8 kodlu dize), binary, Boolean ve double. Öznitelik sütunu türü binary ise bu alan gereklidir. ts (isteğe bağlı): Veri sürümü olan zaman damgası. Bu parametreyi ayarlamazsanız Tablestore bir zaman damgası oluşturur.
--delete	Hayır	Silinecek öznitelik sütununun adı. Belirtilen öznitelik sütununu diğer sütunları güncellemeden silmek için bu parametreyi `--attr '[]'` ile birlikte kullanın. Bir öznitelik sütununu silerken hem --delete hem de --attr gereklidir.
--condition	Hayır	Satır varlık koşulu. Koşullu güncelleme desteklenir. Geçerli değerler: ignore (varsayılan): Satırın var olup olmadığına bakılmaksızın verileri günceller. exist: Yalnızca satır varsa verileri günceller. not_exist: Yalnızca satır yoksa veri ekler.
-i, --input	Hayır	Bir JSON yapılandırma dosyasından verileri günceller. Yapılandırma dosyası kullanırken --pk ve --attr belirtmeniz gerekmez.

Bir yapılandırma dosyasından verileri güncellemek için aşağıdaki komutu çalıştırın:

Windows

update -i D:\\localpath\\filename.json

Linux ve macOS

update -i /localpath/filename.json

Yapılandırma dosyası biçimi veri ekleme işlemiyle aynıdır.

Örnekler

İlk birincil anahtar sütunu değeri "86" ve ikinci birincil anahtar sütunu değeri 6771 olan satırı günceller.
```
update --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]' --condition ignore
```
Birincil anahtar değeri "abc" olan satırdan aaa öznitelik sütununu siler.
```
update --pk '["abc"]' --delete aaa --attr '[]'
```

Veri silme

Birincil anahtara göre bir satır veriyi siler.

delete --pk '<pk_values>'

Parametre	Gerekli	Açıklama
-k, --pk	Evet	JSON dizisi olarak temsil edilen veri tablosunun birincil anahtar değerleri. Birincil anahtar sütunlarının sayısı ve türleri veri tablosundakilerle eşleşmelidir.

Örnek

İlk birincil anahtar sütunu değeri "86" ve ikinci birincil anahtar sütunu değeri 6771 olan satırı siler.

delete --pk '["86", 6771]'

Veri tarama

Bir veri tablosundan tüm verileri veya belirtilen sayıda satırı tarar ve alır.

scan --limit <n>

Parametre	Gerekli	Açıklama
--limit	Hayır	Döndürülecek maksimum satır sayısı. Bu parametreyi ayarlamazsanız tabloda bulunan tüm satırlar taranır.

Örnek

Bir veri tablosundan en fazla 10 satırı tarar ve alır.

scan --limit 10

Veri dışa aktarma

Bir veri tablosundaki verileri yerel bir JSON dosyasına dışa aktarır.

scan -o /localpath/filename.json

Parametre	Gerekli	Açıklama
-o, --output	Evet	Verilerin dışa aktarılacağı yerel dosya yolu.
-c, --columns	Hayır	Dışa aktarılacak sütunlar. Birincil anahtar sütunlarını veya öznitelik sütunlarını virgülle ayırarak belirtin. Bu parametreyi ayarlamazsanız tüm sütunlar dışa aktarılır.
--max_version	Hayır	Dışa aktarılacak maksimum veri sürümü sayısı.
--time_range_start	Hayır	Belirtilen sürüm numarası aralığındaki verileri dışa aktarır. time_range_start ve time_range_end sırasıyla başlangıç ve bitiş zaman damgalarını belirtir. Aralık [başlangıç, bitiş) şeklinde yarı açık bir aralıktır.
--time_range_end	Hayır
--time_range_specific	Hayır	Belirli bir sürüm numarasındaki verileri dışa aktarır.
--backward	Hayır	Verileri birincil anahtara göre azalan sırada dışa aktarır.
-l, --limit	Hayır	Dışa aktarılacak maksimum satır sayısı.
-b, --begin	Hayır	Dışa aktarma aralığının başlangıç ve bitiş noktaları. Birincil anahtar aralığı [başlangıç, bitiş) şeklinde yarı açık bir aralıktır. Not --begin [null,null] olarak ayarlanırsa başlangıç noktası [INF_MIN,INF_MIN] olur; bu, her birincil anahtar sütununun minimum değerinden başlayacağı anlamına gelir. --end [null,null] olarak ayarlanırsa bitiş noktası [INF_MAX,INF_MAX] olur; bu, her birincil anahtar sütununun maksimum değerinde biteceği anlamına gelir.
-e, --end	Hayır

Örnekler

Mevcut tablodaki tüm verileri mydata.json adlı yerel bir dosyaya dışa aktarır.
```
scan -o /tmp/mydata.json
```
Yalnızca uid ve name sütunlarını dışa aktarır.
```
scan -o /tmp/mydata.json -c uid,name
```
Belirtilen birincil anahtar aralığındaki verileri dışa aktarır.
```
scan -o /tmp/mydata.json -b '["86", 6771]' -e '["86", 6775]'
```

Veri içe aktarma

Yerel bir JSON dosyasından bir veri tablosuna veri aktarır.

Önemli

Dosya yolunda Çince karakterler varsa içe aktarma işlemi başarısız olur.

import -i /localpath/filename.json

Parametre	Gerekli	Açıklama
-a, --action	Hayır	İçe aktarma modu. Geçerli değerler: put (varsayılan): Satır varsa orijinal satır verileri (tüm sütunlar ve tüm sürümler) önce silinir ardından yeni satır verileri yazılır. update: Satır varsa öznitelik sütunları ekleyebilir veya silebilir, belirli sürümlerdeki verileri silebilir veya öznitelik sütunu değerlerini güncelleyebilirsiniz. Satır yoksa yeni bir satır eklenir.
-i, --input	Evet	Yerel bir JSON veri dosyasının yolu. Önemli Birincil anahtar sütunlarının sayısı ve türleri veri tablosundakilerle eşleşmelidir. Birincil anahtar sütunu otomatik artan bir sütunsa değerini null yer tutucusuna ayarlayın.
--ignore_version	Hayır	Zaman damgası kontrolünü yoksayar ve geçerli saati zaman damgası olarak kullanır.

Veri dosyası biçimi (satır başına bir JSON kaydı):

{"PK":{"Values":["redchen",0]},"Attr":{"Values":[{"C":"country","V":"china0"},{"C":"name","V":"redchen0"}]}}
{"PK":{"Values":["redchen",1]},"Attr":{"Values":[{"C":"country","V":"china1"},{"C":"name","V":"redchen1"}]}}

Örnekler

mydata.json dosyasındaki verileri mevcut tabloya aktarır.
```
import -i /tmp/mydata.json
```
Verileri aktarır ve zaman damgası olarak geçerli saati kullanır.
```
import -i /tmp/mydata.json --ignore_version
```