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

Chama a operação DescribeHotBigKeys para obter as chaves quentes e as chaves grandes na memória atual em tempo real.

Descrição da operação

Para chaves com estruturas de dados do tipo List, Hash, Set ou Zset, as 3 principais chaves são classificadas e exibidas pelo número de elementos na chave e registradas como chaves grandes. Se o QPS de uma chave exceder 5.000, a chave será registrada como uma chave quente. Para mais informações sobre as definições de chaves grandes e chaves quentes, consulte Estatísticas de chaves principais.

Nota

Para instâncias executando Redis Community Edition 7.0.18, 6.0.2.9, 5.5.2.9 ou versões anteriores, ou instâncias em memória do Tair (Enhanced Edition) executando a versão 5.0.50, 25.2.0.0 ou versões anteriores, uma chave com QPS superior a 3.000 é registrada como uma chave quente. Esse limite não pode ser ajustado.

Ao usar o SDK do Alibaba Cloud, certifique-se de que a versão do aliyun-sdk-core seja posterior à 4.3.3. Recomendamos que você use a versão mais recente.
Use o DAS SDK 1.0.2 ou posterior.
Ao chamar o DAS usando o SDK, defina a região como cn-shanghai.
Esta operação aplica-se apenas às seguintes instâncias Redis:
- A instância é Redis Community Edition ou Tair (Redis® OSS-Compatible) em memória.
- A versão secundária da instância é a mais recente.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

hdm:DescribeHotBigKeys

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ConsoleContext	string	Não	O parâmetro reservado.	None
InstanceId	string	Sim	O ID da instância Redis.	r-bp18ff4a195d****
NodeId	string	Não	O ID do fragmento de dados na instância Redis.	r-****-db-0

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Message	string	A mensagem retornada.	Successful
RequestId	string	O ID da solicitação.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Data	object	Os detalhes.
HotKeys	object
HotKey	array<object>	Uma lista de hot keys classificadas por QPS.
	object	Uma lista de hot keys classificadas por QPS.
Key	string	A chave.	abc:def:eng
Db	integer	O banco de dados (DB) onde a chave está armazenada.	0
Hot	string	A frequência de acesso da chave, medida em acessos por segundo.	5500~6000
KeyType	string	O tipo da chave.	zset
Lfu	integer	O valor estatístico do algoritmo Least Frequently Used (LFU).	253
NodeId	string	O ID do fragmento de dados da instância do Redis.	r-x****-db-0
Size	integer		2
BigKeys	object
BigKey	array<object>	Uma lista de big keys classificadas pelo número de elementos.
	object	Uma lista de big keys classificadas pelo número de elementos.
Db	integer	O banco de dados onde a chave está armazenada.	0
Key	string	A chave.	abc:def:eng
KeyType	string	O tipo da chave.	zset
Size	integer	O número de elementos.	2
NodeId	string	O ID do fragmento de dados da instância do Redis.	r-x****-db-0
HotKeyMsg	string	O motivo pelo qual as chaves quentes classificadas por QPS não foram obtidas.	current version doesn't support
BigKeyMsg	string	O motivo pelo qual as chaves grandes classificadas pelo número de subelementos não foram obtidas.	current version doesn't support
HighTrafficKeyMsg	string	O motivo pelo qual as chaves quentes classificadas por tráfego não foram obtidas.	current version doesn't support
HighTrafficKeys	object
HighTrafficKey	array<object>	Uma lista de hot keys classificadas por tráfego.
	object	Uma lista de hot keys classificadas por tráfego.
Key	string	A chave.	abc:def:eng
Db	integer	O banco de dados onde a chave está armazenada.	0
Hot	string	A frequência de acesso da chave, medida em acessos por segundo.	1988
KeyType	string	O tipo da chave.	string
NodeId	string	O ID do nó.	r-x****-db-0
inBytes	integer	O tráfego de entrada em bytes.	85767
outBytes	integer	O tráfego de saída em bytes.	1054684
Size	integer		2
LargeKeys	object
LargeKey	array<object>	Uma lista de big keys classificadas pelo uso de memória.
	object	Uma lista de big keys classificadas pelo uso de memória.
Db	string	O banco de dados onde a chave está armazenada.	0
Key	string	A chave.	abc:def:eng
KeyType	string	O tipo da chave.	string
DataSize	string	O uso de memória da chave em bytes.	33554439
NodeId	string	O ID do nó.	r-x****-db-0
LargeKeyMsg	string	O motivo pelo qual as chaves grandes classificadas por uso de memória não foram obtidas.	current version doesn't support
Code	string	O código de status retornado.	200
Success	string	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data": {
    "HotKeys": {
      "HotKey": [
        {
          "Key": "abc:def:eng",
          "Db": 0,
          "Hot": "5500~6000",
          "KeyType": "zset",
          "Lfu": 253,
          "NodeId": "r-x****-db-0",
          "Size": 2
        }
      ]
    },
    "BigKeys": {
      "BigKey": [
        {
          "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",
    "HighTrafficKeyMsg": "current version doesn't support",
    "HighTrafficKeys": {
      "HighTrafficKey": [
        {
          "Key": "abc:def:eng",
          "Db": 0,
          "Hot": "1988",
          "KeyType": "string",
          "NodeId": "r-x****-db-0\n",
          "inBytes": 85767,
          "outBytes": 1054684,
          "Size": 2
        }
      ]
    },
    "LargeKeys": {
      "LargeKey": [
        {
          "Db": "0",
          "Key": "abc:def:eng",
          "KeyType": "string",
          "DataSize": "33554439",
          "NodeId": "r-x****-db-0"
        }
      ]
    },
    "LargeKeyMsg": "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.	Os parâmetros da solicitação são inválidos.
403	NoPermission	You are not authorized to do this action.	Você não tem as permissões para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.