Interroger les rapports de journaux SQL - - Centre de documentation Alibaba Cloud

Appelez l'opération DescribeSQLLogReports pour interroger les rapports de journaux SQL d'une instance ApsaraDB RDS.

Cette opération est obsolète. Nous vous recommandons d'appeler l'opération DescribeSQLLogReportList pour interroger les rapports de journaux SQL d'une instance ApsaraDB RDS.

Vous pouvez interroger les rapports de journaux SQL générés au cours d'une période donnée, par exemple de 02:00:00 à 03:00:00.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeSQLLogReports	Opération à effectuer. Définissez la valeur sur DescribeSQLLogReports.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID de l'instance. Appelez l'opération DescribeDBInstances pour récupérer les ID des instances.
EndTime	String	Yes	2021-03-18T16:00:00Z	Fin de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC. Remarque L'heure de fin doit être postérieure à l'heure de début.
StartTime	String	Yes	2021-03-13T16:00:00Z	Début de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
PageSize	Integer	No	30	Nombre d'entrées à renvoyer par page. Valeurs valides : 30 50 100 Valeur par défaut : 30.
PageNumber	Integer	No	1	Numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1.

Paramètres de réponse

Parameter	Type	Example	Description
Items	Array of Item		Tableau composé de rapports de journaux SQL.
Item
LatencyTopNItems	Array of LatencyTopNItem		Tableau composé des instructions SQL ayant la latence d'exécution la plus élevée.
LatencyTopNItem
AvgLatency	Long	500	Temps moyen nécessaire à l'exécution de l'instruction SQL. Unité : millisecondes.
SQLExecuteTimes	Long	5	Nombre d'exécutions de l'instruction SQL.
SQLText	String	SELECT * FROM table_name;	Instruction SQL renvoyée. Remarque Seuls les 128 premiers caractères de l'instruction SQL sont renvoyés. De plus, seules les instructions SQL dont le temps d'exécution dépasse 100 ms sont renvoyées.
QPSTopNItems	Array of QPSTopNItem		Tableau composé des instructions SQL les plus fréquemment exécutées.
QPSTopNItem
SQLExecuteTimes	Long	5	Nombre d'exécutions de l'instruction SQL.
SQLText	String	SELECT * FROM table_name;	Instruction SQL renvoyée. Remarque Seuls les 128 premiers caractères de l'instruction SQL sont renvoyés. De plus, seules les instructions SQL dont le temps d'exécution dépasse 5 ms sont renvoyées.
ReportTime	String	2019-03-27T16:00:00Z	Heure de génération du rapport. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
PageNumber	Integer	1	Numéro de la page renvoyée.
PageRecordCount	Integer	30	Nombre de rapports sur la page actuelle.
RequestId	String	08A3B71B-FE08-4B03-974F-CC7EA6DB1828	ID de la requête.
TotalRecordCount	Integer	60	Nombre total d'enregistrements renvoyés.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

<DescribeSQLLogReportsResponse>
      <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>
</DescribeSQLLogReportsResponse>

Format 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;"
                }]
            }
        }]
    }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API .