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

Consulta operações SQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Yes	ListSQLExecAuditLog	Operação a executar. Defina o valor como ListSQLExecAuditLog.
StartTime	String	Yes	2021-11-08 11:04:00	Início do intervalo de tempo da consulta. Nota Especifique um horário aproximado no formato YYYY-MM-DD hh:mm:ss.
EndTime	String	Yes	2021-11-08 11:00:00	Fim do intervalo de tempo da consulta. Nota Especifique um horário aproximado no formato YYYY-MM-DD hh:mm:ss. Para facilitar a paginação e melhorar a eficiência, recomendamos especificar um intervalo máximo de um dia.
SearchName	String	No	test_SearchName	Nome do objeto onde a instrução SQL é executada. Nota Defina este parâmetro como o nome do banco de dados alvo da instrução SQL. Caso a execução ocorra em uma instância, especifique o nome da instância.
OpUserName	String	No	test_OpUserName	Apelido do operador.
SqlType	String	No	SELECT	Tipo da instrução SQL. Exemplos: SELECT: consulta dados. INSERT: insere dados. DELETE: exclui dados. CREATE_TABLE: cria uma tabela. Nota Para visualizar mais tipos de instruções SQL, acesse o console do Data Management (DMS), escolha Security and Specifications > Operation Audit e verifique as opções na lista suspensa SQL type.
ExecState	String	No	SUCCESS	Status de execução da instrução SQL. Valores válidos: FAIL: Falha na execução. NOEXE: Instrução SQL não executada. RUNNING: Instrução SQL em execução. CANCEL: Execução cancelada. SUCCESS: Execução bem-sucedida.
PageSize	Integer	Yes	20	Número de entradas por página. Valor máximo: 100.
PageNumber	Integer	Yes	1	Número da página a retornar.
Tid	Long	No	3***	ID do locatário. Chame a operação GetUserActiveTenant para consultar esse ID.
RegionId	String	No	cn-hangzhou	ID da região onde o DMS está ativado. Defina este parâmetro com o ID da região mais próxima dos seus serviços. Para obter mais informações sobre os valores válidos, consulte Parâmetro RegionID.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TotalCount	Long	1	Número total de entradas retornadas.
RequestId	String	39BC9C86-95AE-58F2-9862-A7C3D896****	ID da solicitação.
ErrorCode	String	MissingStartTime	Código de erro retornado.
ErrorMessage	String	StartTime is mandatory for this action.	Mensagem de erro retornada.
Success	Boolean	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true: Solicitação bem-sucedida. false: Falha na solicitação.
SQLExecAuditLogList	Array of SQLExecAuditLog		Logs de auditoria das operações SQL.
SQLExecAuditLog
OpTime	String	2021-11-08 11:04:27	Horário da operação.
UserName	String	test_UserName	Apelido do operador.
UserId	Long	12****	ID do operador.
InstanceName	String	polar123@pc-bp1h9tgq4st9g****.mysql.polardb.rds.aliyuncs.com:3306 [polar_qw_test]	Nome do banco de dados. Nota Se a instrução SQL for executada em uma instância, o DMS retorna o nome da instância.
InstanceId	Long	185***	ID da instância.
SchemaName	String	polar123	Nome do banco de dados.
DbId	Long	2157****	ID do banco de dados.
Logic	Boolean	false	Indica se o banco de dados é lógico. Valores válidos: true: Banco de dados lógico. false: Banco de dados físico.
SQLType	String	SELECT	Tipo da instrução SQL. Exemplos: SELECT: consulta dados. INSERT: insere dados. DELETE: exclui dados. CREATE_TABLE: cria uma tabela. Nota Para visualizar mais tipos de instruções SQL, acesse o console do DMS, escolha Security and Specifications > Operation Audit e verifique as opções na lista suspensa SQL type.
SQL	String	SELECT * FROM `polar123`.`p_qw` ORDER BY `id` DESC	Instrução SQL executada.
ExecState	String	SUCCESS	Status de execução da instrução SQL. Valores válidos: FAIL: Falha na execução. NOEXE: Instrução SQL não executada. RUNNING: Instrução SQL em execução. CANCEL: Execução cancelada. SUCCESS: Execução bem-sucedida.
AffectRows	Long	2	Número total de linhas retornadas após a execução da instrução SQL. Por exemplo, se a instrução for uma consulta, este valor indica a quantidade de linhas resultantes.
ElapsedTime	Long	18	Tempo de execução da instrução SQL, em milissegundos.
Remark	String	success	Observações sobre a operação SQL.

Exemplos

Solicitações de exemplo

http(s)://dms-enterprise.aliyuncs.com/?Action=ListSQLExecAuditLog
&StartTime=2021-11-08 11:04:00
&EndTime=2021-11-08 11:00:00
&SearchName=test_SearchName
&OpUserName=test_OpUserName
&SqlType=SELECT
&ExecState=SUCCESS
&PageSize=20
&PageNumber=1
&Tid=3***
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListSQLExecAuditLogResponse>
    <TotalCount>1</TotalCount>
    <RequestId>39BC****-95AE-58F2-9862-A7C3D896****</RequestId>
    <Success>true</Success>
    <SQLExecAuditLogList>
        <SQLExecAuditLog>
            <UserName>test_UserName</UserName>
            <InstanceId>185****</InstanceId>
            <ElapsedTime>18</ElapsedTime>
            <ExecState>SUCCESS</ExecState>
            <OpTime>2021-11-08 11:04:27</OpTime>
            <SQL>SELECT * FROM `polar123`.`p_qw` ORDER BY `id` DESC</SQL>
            <Remark/>
            <InstanceName>polar123@pc-bp1h9tgq4st9g****.mysql.polardb.rds.aliyuncs.com:3306 [polar_qw_test]</InstanceName>
            <UserId>12****</UserId>
            <DbId>2157****</DbId>
            <Logic>false</Logic>
            <SQLType>SELECT</SQLType>
            <SchemaName>polar123</SchemaName>
            <AffectRows>2</AffectRows>
        </SQLExecAuditLog>
    </SQLExecAuditLogList>
</ListSQLExecAuditLogResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "39BC9C86-95AE-58F2-9862-A7C3D896****",
  "Success" : true,
  "SQLExecAuditLogList" : {
    "SQLExecAuditLog" : [ {
      "UserName" : "test_UserName",
      "InstanceId" : "185****",
      "ElapsedTime" : 18,
      "ExecState" : "SUCCESS",
      "OpTime" : "2021-11-08 11:04:27",
      "SQL" : "SELECT * FROM `polar123`.`p_qw` ORDER BY `id` DESC",
      "Remark" : "",
      "InstanceName" : "polar123@pc-bp1h9tgq4st9g****.mysql.polardb.rds.aliyuncs.com:3306 [polar_qw_test]",
      "UserId" : "12****",
      "DbId" : "2157****",
      "Logic" : false,
      "SQLType" : "SELECT",
      "SchemaName" : "polar123",
      "AffectRows" : 2
    } ]
  }
}

Códigos de erro

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