DescribeHotBigKeys - : Central de Documentação do Alibaba Cloud

Esta operação classifica chaves dos tipos list, hash, set e zset com base no número de elementos contidos. As três chaves com maior quantidade de elementos são consideradas large keys. Se o número de consultas por segundo (QPS) de uma chave exceder 3.000, ela será considerada uma hot key.

Se você utilizar um SDK da Alibaba Cloud, verifique se a versão do aliyun-sdk-core é posterior à V4.3.3. Recomendamos o uso da versão mais recente.
A versão do SDK do Database Autonomy Service (DAS) deve ser V1.0.2 ou superior.
Ao chamar o DAS via SDK, defina a região como cn-shanghai.
A operação DescribeHotBigKeys está disponível apenas para instâncias do ApsaraDB for Redis que atendem aos seguintes requisitos:
- A instância é uma Community Edition com versão principal 5,0 ou superior, ou uma instância de desempenho aprimorado da Enhanced Edition (Tair).
- A instância está atualizada para a versão secundária mais recente.

Nota

Para obter informações sobre como consultar e atualizar a versão secundária de uma instância, consulte

ModifyInstanceMinorVersion

e

DescribeEngineVersion

.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeHotBigKeys	A operação a ser executada. Defina o valor como DescribeHotBigKeys.
ConsoleContext	String	Não	None	Parâmetro reservado.
InstanceId	String	Sim	r-bp18ff4a195d****	ID da instância do ApsaraDB for Redis. Chame a operação DescribeInstances para consultar o ID.
NodeId	String	Não	r-****-db-0	ID do shard de dados na instância do ApsaraDB for Redis. Chame a operação DescribeRoleZoneInfo para consultar o ID.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Message	String	Successful	Mensagem retornada pela solicitação.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	ID da solicitação.
Data	Object		Detalhes sobre hot keys e large keys.
HotKeys	Array of HotKey		Detalhes sobre as hot keys.
HotKey
Key	String	abc:def:eng	Nome da chave.
Db	Integer	0	Banco de dados onde a chave está armazenada.
Hot	String	5500~6000	Frequência de acesso à chave, indicando o QPS da chave.
KeyType	String	zset	Tipo da chave.
Lfu	Integer	253	Valor estatístico calculado com base no algoritmo de cache least frequently used (LFU).
NodeId	String	r-x****-db-0	ID do shard de dados na instância do ApsaraDB for Redis.
BigKeys	Array of BigKey		Detalhes sobre as large keys.
BigKey
Db	Integer	0	Banco de dados onde a chave está armazenada.
Key	String	abc:def:eng	Nome da chave.
KeyType	String	zset	Tipo da chave.
Size	Long	2	Número de elementos na chave.
NodeId	String	r-x****-db-0	ID do shard de dados na instância do ApsaraDB for Redis.
HotKeyMsg	String	current version doesn't support	Motivo da falha na consulta da hot key.
BigKeyMsg	String	current version doesn't support	Motivo da falha na consulta da large key.
Code	String	200	Código de status HTTP retornado.
Success	String	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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>

Formato JSON

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParams	The request parameters are invalid.	Mensagem de erro retornada porque os parâmetros de solicitação especificados são inválidos.

Para obter uma lista de códigos de erro, visite o API Error Center.