GetDasSQLLogHotData - Database Autonomy Service - Centro de documentación de Alibaba Cloud

Obtiene datos recientes de los registros de auditoría SQL.

Descripción de la operación

Antes de llamar a esta API, asegúrese de cumplir con los siguientes requisitos:

Utilice la versión más reciente del SDK de Alibaba Cloud o del SDK de DAS.
Al utilizar un SDK para llamar al servicio DAS, especifique la región como cn-shanghai.
Motores compatibles: PolarDB MySQL, ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL y ApsaraDB RDS for SQLServer.
Habilite la indexación de registros para la instancia.

Nota

La hora de inicio de la consulta debe estar dentro de los últimos 7 días. La duración de la consulta no puede exceder 1 día. La API devuelve hasta 10,000 registros.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

hdm:GetDasSQLLogHotData

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	Sí	El ID de la instancia de base de datos.	rm-2ze1jdv45i7l6****
Start	integer	Sí	El inicio del intervalo de tiempo a consultar. Este valor debe ser una marca de tiempo Unix en milisegundos. Nota Solo puede consultar datos generados después de habilitar DAS Enterprise Edition. La hora de inicio no puede ser anterior a siete días antes de la hora actual.	1684734297000
End	integer	Sí	El fin del intervalo de tiempo a consultar. Este valor debe ser una marca de tiempo Unix en milisegundos. Nota La hora de finalización debe ser posterior a la hora de inicio. El intervalo de tiempo no puede exceder un día.	1684820697000
QueryKeyword	string	No	La palabra clave de búsqueda. Nota Se admite la búsqueda difusa. Puede especificar hasta 10 palabras clave. Separe varias palabras clave con un espacio. Por ejemplo: a1 b2 c3.	a1 b2
AccountName	string	No	La cuenta de la base de datos. Nota Puede especificar varias cuentas de base de datos. Separe varias cuentas con un espacio. Por ejemplo: `user1 user2 user3`.	testuser
DBName	string	No	El nombre de la base de datos. Nota Puede especificar varios nombres de bases de datos. Separe varios nombres con un espacio. Por ejemplo: `DB1 DB2 DB3`.	testDB
HostAddress	string	No	La dirección IP del cliente. Nota Puede especificar varias direcciones IP de clientes. Separe varias direcciones IP con un espacio. Por ejemplo: `IP1 IP2 IP3`.	47.100.XX.XX
LogicalOperator	string	No	El operador lógico que se utiliza con múltiples palabras clave. Valores válidos: or and	or
MaxLatancy	integer	No	El tiempo máximo de ejecución en microsegundos. Devuelve sentencias SQL cuyo tiempo de ejecución es menor que este valor.	100
MaxScanRows	integer	No	El número máximo de filas escaneadas. Devuelve sentencias SQL que escanearon menos filas que esta cantidad.	10000
MinLatancy	integer	No	El tiempo mínimo de ejecución en microsegundos. Devuelve sentencias SQL cuyo tiempo de ejecución es mayor o igual a este valor.	10
MinScanRows	integer	No	El número mínimo de filas escaneadas. Devuelve sentencias SQL que escanearon al menos esta cantidad de filas.	10
SqlType	string	No	El tipo de SQL. Valores válidos: select : Sentencia SELECT. update : Sentencia UPDATE. delete : Sentencia DELETE.	select
State	string	No	El estado de ejecución. Establezca este parámetro en 0 para consultar sentencias SQL ejecutadas correctamente. También puede especificar un código de error para consultar las sentencias SQL correspondientes.	0
ThreadID	string	No	El ID del subproceso. Nota Puede especificar varios ID de subprocesos. Separe varios ID con un espacio. Por ejemplo: `657 658 659`.	657
PageNumbers	integer	No	El número de página a devolver. Las páginas comienzan desde 1. El valor predeterminado es 1.	2
MaxRecordsPerPage	integer	No	El número máximo de entradas por página. Valores válidos: de 5 a 100.	10
SortKey	string	No	La clave de ordenamiento. Valores válidos: ScanRows: filas escaneadas. UpdateRows: filas actualizadas. Consume: tiempo de ejecución. OriginTime: la hora de inicio de la ejecución. ReturnRows: filas devueltas.	ScanRows
SortMethod	string	No	El orden de clasificación. Valores válidos: ASC: ascendente DESC: descendente	ASC
ChildDBInstanceIDs	string	No	El ID del nodo. Nota Este parámetro es obligatorio si la instancia de base de datos es un clúster de PolarDB for MySQL.	pi-bp179lg03445l****
Role	string	No	Un parámetro reservado.	Ninguna
TraceId	string	No	Un parámetro reservado.	Ninguna
MinRows	integer	No	Un parámetro reservado.	Ninguna
MaxRows	integer	No	Un parámetro reservado.	Ninguna
MinSpillCnt	integer	No	Un parámetro reservado.	Ninguna
MaxSpillCnt	integer	No	Un parámetro reservado.	Ninguna
TransactionId	string	No	El ID de la transacción.	0
Fail	string	No	El código de error de ejecución de SQL. Puede llamar a la operación GetAsyncErrorRequestStatByCode para obtener el código de error.	1064

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
Code	string	El código de estado.	200
Message	string	El mensaje de respuesta. Nota Si la solicitud se realiza correctamente, se devuelve Successful. Si la solicitud falla, se devuelve un mensaje de error, que puede incluir un código de error.	Successful
RequestId	string	El ID único de solicitud generado por Alibaba Cloud.	0A74B755-98B7-59DB-8724-1321B394****
Success	string	Indica si la solicitud se realizó correctamente: true: la solicitud se realizó correctamente. false: la solicitud falló.	true
Data	object	Los datos devueltos.
List	array<object>	Una lista de los datos devueltos.
	object	Los datos de análisis y auditoría de SQL.
Latancy	integer	La latencia, en microsegundos.	10000
Ext	string	Un parámetro reservado.	Ninguna
ExecuteTime	string	La hora UTC en la que se registró la ejecución, con formato `yyyy-MM-ddTHH:mm:ssZ`.	2023-05-23 T12:11:20Z
OriginTime	string	La hora UTC precisa en la que se registró la ejecución, con formato `yyyy-MM-ddTHH:mm:ss.SSSZ`.	2023-05-23 T12:11:20.999Z
HostAddress	string	La dirección IP del cliente.	47.100.XX.XX
UpdateRows	integer	El número de filas actualizadas.	30
LogicRead	integer	El número de lecturas lógicas.	12
SQLText	string	La sentencia SQL.	select 1
LockTime	integer	El tiempo de espera de bloqueo, en microsegundos.	1
ScanRows	integer	El número de filas escaneadas.	29
ThreadID	integer	El ID del subproceso.	657
State	string	El estado de ejecución. Un valor de 0 indica éxito. Cualquier otro valor es un código de error.	0
DBName	string	El nombre de la base de datos.	testDB
SqlType	string	El tipo de SQL. Valores válidos: select update delete	select
AccountName	string	La cuenta de la base de datos.	testuser
PhysicSyncRead	integer	El número de lecturas síncronas físicas.	0
PhysicAsyncRead	integer	El número de lecturas asíncronas físicas.	0
TransactionId	string	El ID de la transacción.	0
ReturnRows	integer	El número de filas devueltas.	1
NodeId	string	El ID del nodo.	pi-bp120roy76f3qbd84
Total	integer	El número total de registros.	20
PageNo	integer	El número de página.	2
PageSize	integer	El tamaño de página.	10
Extra	any	Un parámetro reservado.	Ninguna

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParams	The request parameters are invalid.
403	NoPermission	You are not authorized to do this action.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.