Todos os produtos
Search
Central de documentação

:Consultar relatórios de log SQL

Última atualização: Jun 29, 2026

Chame a operação DescribeSQLLogReportList para consultar relatórios de log SQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimDescribeSQLLogReportList

A operação a ser executada. Defina o valor como DescribeSQLLogReportList.

DBInstanceIdStringSimrm-uf6wjk5xxxxxxx

ID da instância. Chame a operação DescribeDBInstances para consultar os IDs das instâncias.

EndTimeStringSim2021-03-18T16:00:00Z

Fim do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

Nota A hora final deve ser posterior à hora inicial.
StartTimeStringSim2021-03-13T16:00:00Z

Início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

PageSizeIntegerNão30

Número de entradas retornadas por página. Valores válidos:

  • 30
  • 50
  • 100

Valor padrão: 30.

PageNumberIntegerNão1

Número da página a retornar. Valores válidos: qualquer número inteiro positivo diferente de zero.

Valor padrão: 1.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
ItemsArray of Item

Matriz composta por relatórios de log SQL.

Item
LatencyTopNItemsArray of LatencyTopNItem

Matriz com as instruções SQL executadas com maior latência.

LatencyTopNItem
AvgLatencyLong500

Tempo médio de execução da instrução SQL. Unidade: milissegundos.

SQLExecuteTimesLong5

Número de execuções da instrução SQL.

SQLTextStringSELECT * FROM table_name;

Instrução SQL retornada.

Nota Somente os primeiros 128 caracteres da instrução SQL são retornados. Além disso, apenas instruções SQL com tempo de execução superior a 100 ms são incluídas.
QPSTopNItemsArray of QPSTopNItem

Matriz com as instruções SQL executadas com maior frequência.

QPSTopNItem
SQLExecuteTimesLong5

Número de execuções da instrução SQL.

SQLTextStringSELECT * FROM table_name;

Instrução SQL retornada.

Nota Somente os primeiros 128 caracteres da instrução SQL são retornados. Além disso, apenas instruções SQL com tempo de execução superior a 5 ms são incluídas.
ReportTimeString2019-03-27T16:00:00Z

Momento de geração do relatório. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibida em UTC.

PageNumberInteger1

Número da página retornada.

PageRecordCountInteger30

Número de relatórios na página atual.

RequestIdString08A3B71B-FE08-4B03-974F-CC7EA6DB1828

ID da solicitação.

TotalRecordCountInteger60

Número total de registros retornados.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=DescribeSQLLogReportList
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EndTime=2021-03-18T16:00:00Z
&StartTime=2021-03-13T16:00:00Z
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeSQLLogReportListResponse>
      <TotalRecordCount>60</TotalRecordCount>
      <PageRecordCount>30</PageRecordCount>
      <RequestId>08A3B71B-FE08-4B03-974F-CC7EA6DB1828    </RequestId>
      <PageNumber>1</PageNumber>
      <Items>
            <Item>
                  <ReportTime>2019-03-27T16:00:00Z</ReportTime>
                  <LatencyTopNItems>
                        <LatencyTopNItem>
                              <AvgLatency>500</AvgLatency>
                              <SQLExecuteTimes>5</SQLExecuteTimes>
                              <SQLText>SELECT * FROM table_name;</SQLText>
                        </LatencyTopNItem>
                  </LatencyTopNItems>
                  <QPSTopNItems>
                        <QPSTopNItem>
                              <SQLExecuteTimes>5</SQLExecuteTimes>
                              <SQLText>SELECT * FROM table_name;</SQLText>
                        </QPSTopNItem>
                  </QPSTopNItems>
            </Item>
      </Items>
</DescribeSQLLogReportListResponse>

Formato JSON

{
    "TotalRecordCount": "60",
    "PageRecordCount": "30",
    "RequestId": "08A3B71B-FE08-4B03-974F-CC7EA6DB1828\t",
    "PageNumber": "1",
    "Items": {
        "Item": [{
            "ReportTime": "2019-03-27T16:00:00Z",
            "LatencyTopNItems": {
                "LatencyTopNItem": [{
                    "AvgLatency": "500",
                    "SQLExecuteTimes": "5",
                    "SQLText": "SELECT * FROM table_name;"
                }]
            },
            "QPSTopNItems": {
                "QPSTopNItem": [{
                    "SQLExecuteTimes": "5",
                    "SQLText": "SELECT * FROM table_name;"
                }]
            }
        }]
    }
}

Códigos de erro

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