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

Obtém os dados quentes dos logs de auditoria.

Descrição da operação

Para usar esta operação de API, os seguintes pré-requisitos devem ser atendidos:

Ao usar o SDK do Alibaba Cloud ou o SDK do DAS, use a versão mais recente.
Ao chamar o DAS usando o SDK, você deve definir a região como cn-shanghai.
Esta operação de API é aplicável ao PolarDB for MySQL, ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL e ApsaraDB RDS for SQL Server.
A indexação de logs está ativada para a instância.

Nota

A hora de início da consulta não pode ser anterior a 7 dias atrás. O intervalo entre a hora de início e a hora de fim da consulta não pode exceder 1 dia. Esta operação de API retorna no máximo 10.000 registros.

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:GetDasSQLLogHotData

get

*All resources.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância de banco de dados.	rm-2ze1jdv45i7l6****
Start	integer	Sim	A hora de início da consulta. A hora está no formato de timestamp UNIX. Unidade: milissegundos. Nota Você só pode consultar dados gerados após a ativação da edição Enterprise do DAS. A hora de início não pode ser mais de 7 dias anterior à hora atual.	1684734297000
End	integer	Sim	A hora de fim da consulta. A hora está no formato de timestamp UNIX. Unidade: milissegundos. Nota A hora de fim deve ser posterior à hora de início, e o intervalo entre a hora de início e a hora de fim não pode exceder 1 dia.	1684820697000
QueryKeyword	string	Não	A palavra-chave. Nota Há suporte para correspondência difusa. Você pode usar no máximo 10 palavras-chave para uma consulta combinada. Separe várias palavras-chave com espaços. Exemplo: a1 b2 c3.	a1 b2
AccountName	string	Não	A conta do banco de dados. Nota Você pode usar várias contas de banco de dados para uma consulta combinada. Separe várias contas de banco de dados com espaços. Exemplo: `user1 user2 user3`.	testuser
DBName	string	Não	O nome do banco de dados. Nota Você pode usar vários nomes de banco de dados para uma consulta combinada. Separe vários nomes de banco de dados com espaços. Exemplo: `DB1 DB2 DB3`.	testDB
HostAddress	string	Não	O endereço IP do cliente. Nota Você pode usar vários endereços IP de cliente para uma consulta combinada. Separe vários endereços IP de cliente com espaços. Exemplo: `IP1 IP2 IP3`.	47.100.XX.XX
LogicalOperator	string	Não	A relação lógica entre várias palavras-chave. Valores válidos: or: OR. and: AND.	or
MaxLatancy	integer	Não	A duração máxima de execução. Unidade: microssegundos. Este parâmetro é usado para consultar instruções SQL cuja duração de execução seja menor que o valor especificado.	100
MaxScanRows	integer	Não	O número máximo de linhas verificadas. Este parâmetro é usado para consultar instruções SQL cujo número de linhas verificadas seja menor que o valor especificado.	10000
MinLatancy	integer	Não	A duração mínima de execução. Unidade: microssegundos. Este parâmetro é usado para consultar instruções SQL cuja duração de execução seja maior ou igual ao valor especificado.	10
MinScanRows	integer	Não	O número mínimo de linhas verificadas. Este parâmetro é usado para consultar instruções SQL cujo número de linhas verificadas seja maior ou igual ao valor especificado.	10
SqlType	string	Não	O tipo de instrução SQL. Valores válidos: select update delete Valores válidos: select : Consulta. update : Atualização. delete : Exclusão.	select
State	string	Não	O resultado da execução. Se você inserir 0, o sistema consultará instruções SQL que foram executadas com êxito. Você também pode inserir um código de erro específico para consultar as instruções SQL correspondentes.	0
ThreadID	string	Não	O ID do thread. Nota Você pode usar vários IDs de thread para uma consulta combinada. Separe vários IDs de thread com espaços. Exemplo: `ThreadID1 ThreadID2 ThreadID3`.	657
PageNumbers	integer	Não	O número da página para a consulta paginada. As páginas começam em 1. Valor padrão: 1.	2
MaxRecordsPerPage	integer	Não	O número máximo de registros por página para a consulta paginada. Valores válidos: 5 a 100.	10
SortKey	string	Não	A chave de ordenação. Valores válidos: ScanRows: o número de linhas verificadas. UpdateRows: o número de linhas atualizadas. Consume: a duração da execução. OriginTime: a hora de execução. ReturnRows: o número de linhas retornadas.	ScanRows
SortMethod	string	Não	A ordem de classificação. Valores válidos: ASC: ordem crescente. DESC: ordem decrescente.	ASC
ChildDBInstanceIDs	string	Não	O ID do nó. Nota Para uma instância do PolarDB for MySQL, você deve especificar o ID do nó.	pi-bp179lg03445l****
Role	string	Não	O parâmetro reservado. Este parâmetro não é suportado.	None
TraceId	string	Não	O parâmetro reservado. Este parâmetro não é suportado.	None
MinRows	integer	Não	O parâmetro reservado. Este parâmetro não é suportado.	None
MaxRows	integer	Não	O parâmetro reservado. Este parâmetro não é suportado.	None
MinSpillCnt	integer	Não	O parâmetro reservado. Este parâmetro não é suportado.	None
MaxSpillCnt	integer	Não	O parâmetro reservado. Este parâmetro não é suportado.	None
TransactionId	string	Não	O ID da transação.	0
Fail	string	Não	O código de erro retornado quando a instrução SQL é executada. Você pode chamar a operação GetAsyncErrorRequestStatByCode para obter o código de erro.	1064

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status HTTP retornado.	200
Message	string	A mensagem retornada. Nota Se a solicitação for bem-sucedida, Successful será retornado. Se a solicitação falhar, uma mensagem de erro, como um código de erro, será retornada.	Successful
RequestId	string	O ID da solicitação, que é um identificador exclusivo gerado pelo Alibaba Cloud para a solicitação.	0A74B755-98B7-59DB-8724-1321B394****
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
Data	object	Os dados retornados.
List	array<object>	A lista de informações retornadas.
	object	Os dados de auditoria e do SQL Explorer retornados.
Latancy	integer	A duração da execução. Unidade: microssegundos.	10000
Ext	string	O campo de informações estendidas. Este é um parâmetro reservado.	None
ExecuteTime	string	A hora de execução. A hora está no formato UTC: `yyyy-MM-ddTHH:mm:ssZ`.	2023-05-23 T12:11:20Z
OriginTime	string	A hora de execução. A hora está no formato UTC: `yyyy-MM-ddTHH:mm:ss.SSSZ`.	2023-05-23 T12:11:20.999Z
HostAddress	string	O endereço IP do cliente.	47.100.XX.XX
UpdateRows	integer	O número de linhas atualizadas.	30
LogicRead	integer	As leituras lógicas.	12
SQLText	string	Os detalhes da instrução SQL.	select 1
LockTime	integer	A duração da espera de bloqueio. Unidade: microssegundos.	1
ScanRows	integer	O número de linhas verificadas.	29
ThreadID	integer	O ID do thread.	657
State	string	O status. Um valor 0 indica que a execução foi bem-sucedida. Caso contrário, um código de erro é retornado.	0
DBName	string	O nome do banco de dados.	testDB
SqlType	string	O tipo de instrução SQL. Valores válidos: select update delete	select
AccountName	string	A conta do banco de dados.	testuser
PhysicSyncRead	integer	O número de leituras síncronas físicas.	0
PhysicAsyncRead	integer	O número de leituras assíncronas físicas.	0
TransactionId	string	O ID da transação iniciada.	0
ReturnRows	integer	O número de linhas retornadas.	1
NodeId	string	O ID do nó.	pi-bp120roy76f3qbd84
Total	integer	O número total de registros retornados.	20
PageNo	integer	O número da página.	2
PageSize	integer	O número de entradas por página.	10
Extra	any	O parâmetro reservado.	None

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "0A74B755-98B7-59DB-8724-1321B394****",
  "Success": "true",
  "Data": {
    "List": [
      {
        "Latancy": 10000,
        "Ext": "None",
        "ExecuteTime": "2023-05-23 T12:11:20Z",
        "OriginTime": "2023-05-23 T12:11:20.999Z",
        "HostAddress": "47.100.XX.XX",
        "UpdateRows": 30,
        "LogicRead": 12,
        "SQLText": "select 1",
        "LockTime": 1,
        "ScanRows": 29,
        "ThreadID": 657,
        "State": "0",
        "DBName": "testDB",
        "SqlType": "select",
        "AccountName": "testuser",
        "PhysicSyncRead": 0,
        "PhysicAsyncRead": 0,
        "TransactionId": "0",
        "ReturnRows": 1,
        "NodeId": "pi-bp120roy76f3qbd84"
      }
    ],
    "Total": 20,
    "PageNo": 2,
    "PageSize": 10,
    "Extra": "None"
  }
}

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 permissão 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.