Skip to main content

List SQL Execution Logs

List NineData SQL execution audit logs with pagination. This API requires Audit module permissions.

Endpoint: /openapi/v1/actionSQL/list

Method: GET

Request parameters

ParameterTypeRequiredDescription
accountIdStringNoAccount ID. Omit it to query all accounts.
startTimeDateTimeNoStart of the operation time range in ISO 8601 format.
endTimeDateTimeNoEnd of the operation time range in ISO 8601 format.
moduleStringNoModule. Use the values listed in List Operation Logs.
sqlTypeStringNoSQL type: UPDATE, DELETE, INSERT, SELECT, CREATE, DROP, ALTER, TRUNCATE, CALL, EXECUTE, GRANT, REVOKE, OPTIMIZE, or OTHER.
datasourceIdStringNoData source ID.
databaseNameStringNoDatabase name.
tableNameStringNoTable name.
sqlStringNoSQL statement keyword for fuzzy matching.
currentIntegerNoCurrent page number, starting at 1. Default: 1.
pageSizeIntegerNoRecords per page. Default: 10; maximum: 1000.

Response parameters

ParameterTypeDescription
successBooleanWhether the request succeeded.
requestIdStringRequest ID.
currentIntegerCurrent page.
pageSizeIntegerPage size.
totalIntegerTotal number of records.
dataArraySQL execution log details.
data[].trailIdStringLog ID.
data[].eventTimeDateTimeEvent operation time.
data[].accountIdStringAccount ID.
data[].accountNameStringAccount name.
data[].hostStringClient IP address.
data[].moduleStringModule.
data[].typeStringEvent type.
data[].sqlTypeStringSQL type.
data[].datasourceIdStringData source ID.
data[].databaseNameStringDatabase name.
data[].sqlStringSQL statement.
data[].statusStringExecution status.
data[].affectedRowsLongAffected row count.
data[].sensitiveColumnsStringSensitive-column information.
data[].elaspedTimeFloatExecution time in seconds.
data[].tablesArrayInvolved table objects.
data[].tables[].databaseNameStringDatabase name.
data[].tables[].schemaNameStringSchema name.
data[].tables[].nameStringTable name.
data[].tables[].aliasStringTable alias.

Success response

{"success": true, "requestId": "<requestId>", "current": 1, "pageSize": 10, "total": 1, "data": [{"trailId": "<trailId>", "module": "sqlWindow", "type": "execute", "sqlType": "SELECT", "datasourceId": "<datasourceId>", "databaseName": "example_db", "sql": "SELECT 1", "status": "success", "affectedRows": 0, "tables": []}]}