Todos los productos
Search
Centro de documentos

ApsaraDB for OceanBase (Deprecated):DescribeOasSQLHistoryList

Última actualización: Sep 02, 2026

Consulta el historial de ejecución de SQL.

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

oceanbase:DescribeOasSQLHistoryList

get

*All Resource

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

InstanceId

string

Sí

El ID del clúster de OceanBase.

ob317v4uif****

TenantId

string

Sí

El ID del inquilino.

t4louaeei****

StartTime

string

Sí

La hora de inicio para consultar el historial de ejecución de la sentencia SQL.
El valor debe estar en hora UTC con el formato AAAA-MM-DDThh:mm:ssZ.

2023-04-12T04:38:38Z

EndTime

string

Sí

La hora de fin para consultar el historial de ejecución de la sentencia SQL.
El valor debe estar en hora UTC con el formato AAAA-MM-DDThh:mm:ssZ.

2023-04-12T05:38:38Z

DbName

string

No

El nombre de la base de datos.

test_db

SqlId

string

Sí

El ID de SQL.

8D6E84****0B8FB1823D199E2CA1****

NodeIp

string

No

La dirección IP del nodo.

i-bp19y05uq6x*********

AcceptLanguage

string

No

El idioma de la respuesta. Valores válidos:

  • zh: chino

  • en: inglés

zh-CN

DynamicSql

boolean

No

Especifica si la sentencia SQL es una sentencia SQL dinámica.

false

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Respuesta devuelta.

RequestId

string

El ID de la solicitud.

EE205C00-30E4-****-****-87E3A8A2AA0C

Data

array<object>

La lista del historial de ejecución de SQL.

object

La información sobre el historial de ejecución.

SQLId

string

El ID de SQL.

8D6E84****0B8FB1823D199E2CA1****

DbName

string

El nombre de la base de datos.

test_db

AvgAffectedRows

integer

Promedio de filas actualizadas durante el periodo de ejecución.

9978.75

AvgBlockCacheHit

integer

Recuento promedio de aciertos de BlockCache durante el periodo de ejecución.

0.0

AvgBlockIndexCacheHit

integer

Recuento promedio de aciertos de BlockIndexCache durante el periodo de ejecución.

0.0

AvgBloomFilterCacheHit

integer

Recuento promedio de aciertos de BloomFilterCache durante el periodo de ejecución.

0.0

Executions

integer

Número total de ejecuciones durante el periodo de ejecución.

1

FailCount

integer

El número total de errores durante el periodo de ejecución.

0

AvgRpcCount

integer

Número promedio de RPC enviados durante la ejecución.

8.0

RemotePlans

integer

Recuento de planes remotos.

0

MissPlans

integer

Recuento de planes no encontrados.

0

AvgReturnRows

integer

Número promedio de filas devueltas durante el periodo de ejecución.

0.0

AvgLogicalReads

integer

Lecturas lógicas promedio durante el periodo de ejecución.

0.0

RetryCount

integer

Número total de reintentos durante el periodo de ejecución.

0

AvgRowCacheHit

integer

Recuento promedio de aciertos de RowCache durante el periodo de ejecución.

0.0

AvgDiskReads

integer

Recuento promedio de lecturas físicas durante el periodo de ejecución.

0.0

AvgMemstoreReadRows

integer

Filas leídas de Memstore en promedio durante el periodo de ejecución.

0.0

AvgSsstoreReadRows

integer

Filas leídas de Ssstore en promedio durante el periodo de ejecución.

0.0

AvgApplicationWaitTime

number

Tiempo de espera promedio del evento Application (en milisegundos) durante el periodo de espera del cliente.

0.0

AvgElapsedTime

number

Tiempo de respuesta promedio (en milisegundos) durante el periodo de ejecución.

1876.78

AvgExecuteTime

number

Tiempo de ejecución del plan promedio (en milisegundos) durante el periodo de ejecución.

1895.7

AvgQueueTime

number

Tiempo de cola promedio (en milisegundos) durante el periodo de ejecución.

0.01

AvgConcurrencyWaitTime

number

Tiempo de espera promedio del evento Concurrency (en milisegundos) durante el periodo de ejecución.

0.0

AvgCpuTime

number

Tiempo de CPU promedio (en milisegundos) durante el periodo de ejecución.

1875.34

AvgDecodeTime

number

Tiempo de análisis sintáctico promedio (en milisegundos) durante el periodo de ejecución.

0.0

AvgNetWaitTime

number

Tiempo de encolamiento de red promedio (en milisegundos) durante el periodo de espera de red.

0.0

AvgUserIoWaitTime

number

Tiempo de espera promedio del evento UserIO (en milisegundos) durante el periodo de ejecución.

0.0

AvgGetPlanTime

number

Tiempo de generación del plan promedio (en milisegundos) durante el periodo de ejecución.

0.0

MaxElapsedTime

number

Tiempo de respuesta máximo.

13643.3

SumWaitTime

number

El tiempo de espera total (en milisegundos) durante el periodo de espera interno.

9421.73

AvgScheduleTime

number

Tiempo de espera promedio del evento Schedule (en milisegundos) durante el periodo de programación.

0.0

MaxCpuTime

number

Tiempo de CPU máximo.

13641.9

SumElapsedTime

number

Tiempo de respuesta total (en milisegundos) durante el periodo de ejecución.

11452126.36

Timestamp

string

Marca de tiempo de la muestra.

2023-04-12T04:46:38Z

Server

string

El servidor donde se ejecuta la sentencia SQL.

i-bp1db1****8uemejio

UserName

string

Nombre de usuario.

test_user

AvgPartitionCount

number

Número promedio de particiones accedidas durante el periodo de ejecución.

1

FailPercentage

number

Porcentaje de errores durante el periodo de ejecución.

0

RetCode4012Count

number

Número de ocurrencias del código 4012 durante el periodo de ejecución.

0

RetCode4013Count

number

Número de ocurrencias del código 4013 durante el periodo de ejecución.

0

RetCode5001Count

number

Número de ocurrencias del código 5001 durante el periodo de ejecución.

0

RetCode5024Count

number

Número de ocurrencias del código 5024 durante el periodo de ejecución.

0

RetCode5167Count

number

Número de ocurrencias del código 5167 durante el periodo de ejecución.

0

RetCode5217Count

number

Número de ocurrencias del código 5217 durante el periodo de ejecución.

0

RetCode6002Count

number

Número de ocurrencias del código 6002 durante el periodo de ejecución.

0

AvgWaitTime

number

Tiempo de espera promedio (en milisegundos) durante el periodo de ejecución.

1442.49

AvgWaitCount

number

Número promedio de esperas durante el periodo de ejecución.

0

LocalPlanPercentage

number

Porcentaje de planes locales durante el periodo de ejecución.

0

RemotePlanPercentage

number

Porcentaje de planes remotos durante el periodo de ejecución.

0

DistPlanPercentage

number

Porcentaje de planes distribuidos durante el periodo de ejecución.

100

AvgNetTime

number

Tiempo de transmisión de red promedio (en milisegundos) durante el periodo de ejecución.

8

AvgExecutorRpcCount

number

Número promedio de solicitudes RPC ejecutadas durante el periodo de ejecución.

0

MissPlanPercentage

number

Tasa de aciertos de plan durante el periodo de ejecución.

0

TableScanPercentage

number

Porcentaje de escaneos de tabla durante el periodo de ejecución.

0

StrongConsistencyPercentage

number

Porcentaje de transacciones con consistencia fuerte durante el periodo de ejecución.

100

WeakConsistencyPercentage

number

Porcentaje de transacciones con consistencia eventual durante el periodo de ejecución.

0

MaxAffectedRows

number

Máximo de filas actualizadas durante el periodo de ejecución.

10000

MaxReturnRows

number

Máximo de filas devueltas durante el periodo de ejecución.

0

MaxWaitTime

number

Tiempo de espera máximo (en milisegundos) durante el periodo de ejecución.

3.4

MaxApplicationWaitTime

number

Tiempo de espera máximo del evento Application (en milisegundos) durante el periodo de ejecución.

0

MaxConcurrencyWaitTime

number

Tiempo de espera máximo del evento Concurrency (en milisegundos) durante el periodo de ejecución.

0

MaxUserIoWaitTime

number

Tiempo de espera máximo del evento UserIO (en milisegundos) durante el periodo de ejecución.

0

MaxDiskReads

number

Recuento máximo de lecturas físicas durante el periodo de ejecución.

0

AvgExpectedWorkerCount

number

Grado de paralelismo promedio durante el periodo de ejecución.

3

AvgUsedWorkerCount

number

Número promedio de hilos utilizados por la sentencia SQL durante el periodo de ejecución.

3

SumLogicalReads

number

Total de lecturas lógicas.

0

ExecPs

number

Recuento promedio de ejecuciones por segundo durante el periodo de ejecución.

0.31

AvgDbTime

number

El tiempo de base de datos promedio, en milisegundos.

100

SumDbTime

number

El tiempo de base de datos total, en milisegundos.

100

WaitEvent

string

El evento de espera.

none

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Data": [
    {
      "SQLId": "8D6E84****0B8FB1823D199E2CA1****",
      "DbName": "test_db",
      "AvgAffectedRows": 9978.75,
      "AvgBlockCacheHit": 0,
      "AvgBlockIndexCacheHit": 0,
      "AvgBloomFilterCacheHit": 0,
      "Executions": 1,
      "FailCount": 0,
      "AvgRpcCount": 8,
      "RemotePlans": 0,
      "MissPlans": 0,
      "AvgReturnRows": 0,
      "AvgLogicalReads": 0,
      "RetryCount": 0,
      "AvgRowCacheHit": 0,
      "AvgDiskReads": 0,
      "AvgMemstoreReadRows": 0,
      "AvgSsstoreReadRows": 0,
      "AvgApplicationWaitTime": 0,
      "AvgElapsedTime": 1876.78,
      "AvgExecuteTime": 1895.7,
      "AvgQueueTime": 0.01,
      "AvgConcurrencyWaitTime": 0,
      "AvgCpuTime": 1875.34,
      "AvgDecodeTime": 0,
      "AvgNetWaitTime": 0,
      "AvgUserIoWaitTime": 0,
      "AvgGetPlanTime": 0,
      "MaxElapsedTime": 13643.3,
      "SumWaitTime": 9421.73,
      "AvgScheduleTime": 0,
      "MaxCpuTime": 13641.9,
      "SumElapsedTime": 11452126.36,
      "Timestamp": "2023-04-12T04:46:38Z",
      "Server": "i-bp1db1****8uemejio",
      "UserName": "test_user",
      "AvgPartitionCount": 1,
      "FailPercentage": 0,
      "RetCode4012Count": 0,
      "RetCode4013Count": 0,
      "RetCode5001Count": 0,
      "RetCode5024Count": 0,
      "RetCode5167Count": 0,
      "RetCode5217Count": 0,
      "RetCode6002Count": 0,
      "AvgWaitTime": 1442.49,
      "AvgWaitCount": 0,
      "LocalPlanPercentage": 0,
      "RemotePlanPercentage": 0,
      "DistPlanPercentage": 100,
      "AvgNetTime": 8,
      "AvgExecutorRpcCount": 0,
      "MissPlanPercentage": 0,
      "TableScanPercentage": 0,
      "StrongConsistencyPercentage": 100,
      "WeakConsistencyPercentage": 0,
      "MaxAffectedRows": 10000,
      "MaxReturnRows": 0,
      "MaxWaitTime": 3.4,
      "MaxApplicationWaitTime": 0,
      "MaxConcurrencyWaitTime": 0,
      "MaxUserIoWaitTime": 0,
      "MaxDiskReads": 0,
      "AvgExpectedWorkerCount": 3,
      "AvgUsedWorkerCount": 3,
      "SumLogicalReads": 0,
      "ExecPs": 0.31,
      "AvgDbTime": 100,
      "SumDbTime": 100,
      "WaitEvent": "none"
    }
  ]
}

Códigos de error

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.