Belirli bir zaman aralığındaki en büyük 100 anahtarı sorgular.
List, hash, set ve zset anahtarları, bu anahtarlardaki öğe sayısına göre sıralanır. En çok öğeye sahip ilk üç anahtar büyük anahtar olarak kabul edilir.
Bir Alibaba Cloud SDK kullanıyorsanız aliyun-sdk-core sürümünün 4.3.3'ten sonraki bir sürüm olduğundan emin olun. En son sürümü kullanmanızı öneririz.
DAS SDK sürümü 1.0.2 veya üzeri olmalıdır.
SDK kullanarak Database Autonomy Service (DAS) çağrısı yapıyorsanız bölgeyi cn-shanghai olarak ayarlayın.
-
DescribeTopBigKeys işlemi yalnızca aşağıdaki sürümlerden birine sahip ApsaraDB for Redis örnekleri için kullanılabilir:
Örnek, ana sürümü 5,0 veya üzeri olan ApsaraDB for Redis Community Edition örnekleridir ya da ApsaraDB for Redis Enhanced Edition (Tair) performans artırılmış bir örnektir.
ApsaraDB for Redis örneği en son küçük sürüme güncellenmiştir.
Bir örneğin küçük sürümünü sorgulama ve güncelleme hakkında daha fazla bilgi için bkz.
ve
.
İstek parametreleri
| Parametre | Tür | Gerekli | Örnek | Açıklama |
| Action | String | Evet | DescribeTopBigKeys | Gerçekleştirmek istediğiniz işlem. Değeri DescribeTopBigKeys olarak ayarlayın. |
| ConsoleContext | String | Hayır | Yok | Ayrılmış bir parametredir. |
| InstanceId | String | Evet | r-bp18ff4a195d**** | ApsaraDB for Redis örneğinin ID'si. ID'yi sorgulamak için DescribeInstances işlemini çağırabilirsiniz. |
| NodeId | String | Hayır | r-x****-db-0 | ApsaraDB for Redis örneğindeki veri parçasının ID'si. ID'yi sorgulamak için DescribeRoleZoneInfo işlemini çağırabilirsiniz. |
| StartTime | String | Evet | 1596177993000 | Sorgulanacak zaman aralığının başlangıcı. Bu parametrenin değeri bir UNIX zaman damgasıdır. Birim: milisaniye. |
| EndTime | String | Evet | 1596177993001 | Sorgulanacak zaman aralığının bitişi. Bu parametrenin değeri bir UNIX zaman damgasıdır. Birim: milisaniye. Not
|
Yanıt parametreleri
| Parametre | Tür | Örnek | Açıklama |
| Message | String | Successful | İstek için döndürülen mesaj. |
| RequestId | String | B6D17591-B48B-4D31-9CD6-9B9796B2**** | İsteğin ID'si. |
| Data | BigKey dizisi | Büyük anahtarlarla ilgili ayrıntılar. Not Sorgu dönemi içinde büyük anahtar bulunamazsa sonuç döndürülmez. |
|
| BigKey | |||
| Key | String | abc:def:eng | Anahtarın adı. |
| Db | Integer | 0 | Anahtarın depolandığı veritabanı. |
| KeyType | String | zset | Anahtarın türü. |
| Size | Long | 2 | Anahtardaki öğe sayısı. |
| NodeId | String | r-x****-db-0 | ApsaraDB for Redis örneğindeki veri parçasının ID'si. |
| Code | String | 200 | Döndürülen HTTP durum kodu. |
| Success | String | true | İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:
|
Örnekler
Örnek istekler
http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeTopBigKeys
&ConsoleContext=6c2e064b-a45f-4bd0-8a80-*********
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&StartTime=1596177993000
&EndTime=1596177993001
&<Common request parameters>
Başarılı yanıt örnekleri
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeTopBigKeysResponse>
<Message>Successful</Message>
<RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
<Data>
<Key>abc:def:eng</Key>
<Db>0</Db>
<KeyType>zset</KeyType>
<Size>2</Size>
<NodeId>r-x****-db-0</NodeId>
</Data>
<Code>200</Code>
<Success>true</Success>
</DescribeTopBigKeysResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"Message" : "Successful",
"RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
"Data" : [ {
"Key" : "abc:def:eng",
"Db" : 0,
"KeyType" : "zset",
"Size" : 2,
"NodeId" : "r-x****-db-0"
} ],
"Code" : "200",
"Success" : "true"
}
Hata kodları
|
HTTP durum kodu |
Hata kodu |
Hata mesajı |
Açıklama |
|
400 |
InvalidParams |
The request parameters are invalid. |
Belirtilen istek parametreleri geçersiz olduğu için döndürülen hata mesajı. |
Hata kodlarının listesi için bkz. Hizmet hata kodları.