Tüm Ürünler
Search
Belge Merkezi

:DescribeHotBigKeys

Son Güncelleme:Oct 06, 2026

Bellekteki hot key'leri ve large key'leri gerçek zamanlı olarak sorgular.

Bu işlem, list, hash, set ve zset anahtarlarını içerdikleri öğe sayısına göre sıralar. En çok öğe içeren ilk üç anahtar large key olarak kabul edilir. Bir anahtarın saniye başına sorgu sayısı (QPS) 3.000'den büyükse bu anahtar hot key olarak değerlendirilir.

  • Bir Alibaba Cloud SDK kullanıyorsanız aliyun-sdk-core sürümünün V4.3.3'ten yeni olduğundan emin olun. En son sürümü kullanmanızı öneririz.

  • Database Autonomy Service (DAS) SDK'nızın sürümü V1.0.2 veya üzeri olmalıdır.

  • SDK kullanarak DAS'ı çağırıyorsanız bölgeyi cn-shanghai olarak ayarlayın.

  • DescribeHotBigKeys işlemi yalnızca aşağıdaki gereksinimleri karşılayan ApsaraDB for Redis örnekleri için kullanılabilir:

    • Örnek, ana sürümü 5,0 veya üzeri olan bir Community Edition örneği ya da Enhanced Edition (Tair) performans artırmalı bir örnektir.

    • Örnek en küçük sürüme güncellenmiştir.

Not

Bir örneğin küçük sürümünü sorgulama ve güncelleme hakkında bilgi için bkz.

ModifyInstanceMinorVersion

ve

DescribeEngineVersion

.

İstek parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

Action

String

Evet

DescribeHotBigKeys

Gerçekleştirmek istediğiniz işlem. Değeri DescribeHotBigKeys 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-****-db-0

ApsaraDB for Redis örneğindeki data shard'ın ID'si. ID'yi sorgulamak için DescribeRoleZoneInfo işlemini çağırabilirsiniz.

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 Object

Hot key'ler ve large key'ler hakkındaki ayrıntılar.

HotKeys Array of HotKey

Hot key'ler hakkındaki ayrıntılar.

HotKey
Key String abc:def:eng

Anahtarın adı.

Db Integer 0

Anahtarın depolandığı veritabanı.

Hot String 5500~6000

Anahtara erişim sıklığı; anahtarın QPS değerini gösterir.

KeyType String zset

Anahtarın türü.

Lfu Integer 253

En az kullanılan (LFU) önbellekleme algoritmasına göre hesaplanan istatistiksel değer.

NodeId String r-x****-db-0

ApsaraDB for Redis örneğindeki data shard'ın ID'si.

BigKeys Array of BigKey

Large key'ler hakkındaki ayrıntılar.

BigKey
Db Integer 0

Anahtarın depolandığı veritabanı.

Key String abc:def:eng

Anahtarın adı.

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 data shard'ın ID'si.

HotKeyMsg String current version doesn't support

Hot key sorgulamasının başarısız olma nedeni.

BigKeyMsg String current version doesn't support

Large key sorgulamasının başarısız olma nedeni.

Code String 200

Döndürülen HTTP durum kodu.

Success String true

İsteğin başarılı olup olmadığını belirtir. Geçerli değerler:

  • true: İstek başarılı oldu.
  • false: İstek başarısız oldu.

Örnekler

Örnek istekler

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeHotBigKeys
&ConsoleContext=6c2e064b-a45f-4bd0-8a80-*********
&InstanceId=r-bp18ff4a195d****
&NodeId=r-****-db-0
&<Common request parameters>

Örnek başarılı yanıtlar

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeHotBigKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <HotKeys>
            <Key>abc:def:eng</Key>
            <Db>0</Db>
            <Hot>5500~6000</Hot>
            <KeyType>zset</KeyType>
            <Lfu>253</Lfu>
            <NodeId>r-x****-db-0</NodeId>
        </HotKeys>
        <BigKeys>
            <Db>0</Db>
            <Key>abc:def:eng</Key>
            <KeyType>zset</KeyType>
            <Size>2</Size>
            <NodeId>r-x****-db-0</NodeId>
        </BigKeys>
        <HotKeyMsg>current version doesn't support</HotKeyMsg>
        <BigKeyMsg>current version doesn't support</BigKeyMsg>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeHotBigKeysResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "HotKeys" : [ {
      "Key" : "abc:def:eng",
      "Db" : 0,
      "Hot" : "5500~6000",
      "KeyType" : "zset",
      "Lfu" : 253,
      "NodeId" : "r-x****-db-0"
    } ],
    "BigKeys" : [ {
      "Db" : 0,
      "Key" : "abc:def:eng",
      "KeyType" : "zset",
      "Size" : 2,
      "NodeId" : "r-x****-db-0"
    } ],
    "HotKeyMsg" : "current version doesn't support",
    "BigKeyMsg" : "current version doesn't support"
  },
  "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 API Error Center adresini ziyaret edin.