DescribeHotBigKeys - - Centre de documentation Alibaba Cloud

Cette opération trie les clés de type list, hash, set et zset selon le nombre d'éléments qu'elles contiennent. Les trois clés comportant le plus grand nombre d'éléments sont considérées comme des clés volumineuses. Si le nombre de requêtes par seconde (QPS) d'une clé dépasse 3 000, celle-ci est considérée comme une clé à fort trafic.

Si vous utilisez un SDK Alibaba Cloud, assurez-vous que la version de aliyun-sdk-core est supérieure à la V4.3.3. Nous vous recommandons d'utiliser la dernière version disponible.
La version de votre SDK Database Autonomy Service (DAS) doit être la V1.0.2 ou une version ultérieure.
Si vous utilisez un SDK pour appeler DAS, définissez la région sur cn-shanghai.
L'opération DescribeHotBigKeys est disponible uniquement pour les instances ApsaraDB for Redis qui répondent aux exigences suivantes :
- L'instance est une instance Community Edition utilisant une version majeure 5.0 ou ultérieure, ou une instance performance-enhanced de l'édition Enhanced Edition (Tair).
- L'instance utilise la dernière version mineure.

Remarque

Pour savoir comment interroger et mettre à jour la version mineure d'une instance, consultez

ModifyInstanceMinorVersion

et

DescribeEngineVersion

.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeHotBigKeys	Opération à effectuer. Définissez la valeur sur DescribeHotBigKeys.
ConsoleContext	String	Non	None	Paramètre réservé.
InstanceId	String	Oui	r-bp18ff4a195d****	ID de l'instance ApsaraDB for Redis. Appelez l'opération DescribeInstances pour obtenir l'ID.
NodeId	String	Non	r-****-db-0	ID du shard de données sur l'instance ApsaraDB for Redis. Appelez l'opération DescribeRoleZoneInfo pour obtenir l'ID.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Message	String	Successful	Message renvoyé pour la requête.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	ID de la requête.
Data	Object		Détails concernant les clés à fort trafic et les clés volumineuses.
HotKeys	Array of HotKey		Détails concernant les clés à fort trafic.
HotKey
Key	String	abc:def:eng	Nom de la clé.
Db	Integer	0	Base de données dans laquelle la clé est stockée.
Hot	String	5500~6000	Fréquence d'accès à la clé, qui indique le QPS de la clé.
KeyType	String	zset	Type de la clé.
Lfu	Integer	253	Valeur statistique calculée selon l'algorithme de mise en cache Least Frequently Used (LFU).
NodeId	String	r-x****-db-0	ID du shard de données sur l'instance ApsaraDB for Redis.
BigKeys	Array of BigKey		Détails concernant les clés volumineuses.
BigKey
Db	Integer	0	Base de données dans laquelle la clé est stockée.
Key	String	abc:def:eng	Nom de la clé.
KeyType	String	zset	Type de la clé.
Size	Long	2	Nombre d'éléments dans la clé.
NodeId	String	r-x****-db-0	ID du shard de données sur l'instance ApsaraDB for Redis.
HotKeyMsg	String	current version doesn't support	Raison de l'échec de l'interrogation de la clé à fort trafic.
BigKeyMsg	String	current version doesn't support	Raison de l'échec de l'interrogation de la clé volumineuse.
Code	String	200	Code d'état HTTP renvoyé.
Success	String	true	Indique si la requête a abouti. Valeurs possibles : true : La requête a abouti. false : La requête a échoué.

Exemples

Exemple de requête

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

Exemple de réponse réussie

XML format

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 format

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"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParams	The request parameters are invalid.	Message d'erreur indiquant que les paramètres de requête spécifiés ne sont pas valides.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.