Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Gestión de registros/ Consulta de registros de consultas lentas
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Consulta de registros de consultas lentas

Función

Esta API se utiliza para consultar los registros de consulta lenta de una instancia de base de datos especificada. Antes de invocar a esta API:

URI

POST /v3.1/{project_id}/instances/{instance_id}/slow-logs

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

Explicación:

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

Restricciones:

Ninguna

Rango de valores:

El valor puede contener 32 caracteres. Solo se permiten letras y dígitos.

Valor predeterminado:

Ninguna

instance_id

Sí

String

Explicación:

ID de instancia, que identifica de forma única una instancia.

Restricciones:

Ninguna

Rango de valores:

El valor puede contener 36 caracteres con in07 como el sufijo. Solo se permiten letras y dígitos.

Valor predeterminado:

Ninguna

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Explicación:

Token de usuario.

Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

Restricciones:

Ninguna

Rango de valor:

Ninguna

Valor predeterminado:

Ninguna

X-Language

No

String

Explicación:

Tipo de idioma de solicitud.

Restricciones:

Ninguna

Rango de valor:

  • en-us
  • zh-cn

Valor predeterminado:

en-us
Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

node_id

Sí

String

Explicación:

ID del nodo.

Restricciones:

Ninguna

Rango de valores:

El valor puede contener 36 caracteres, comenzando con un UUID y terminando con no07. Solo se permiten letras y dígitos.

Valor predeterminado:

Ninguna

start_time

Sí

String

Explicación:

Hora de inicio en el formato "aaaa-mm-ddThh:mm:ssZ".

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

Restricciones:

Ninguna

Rango de valores:

La hora es anterior a la hora actual.

Valor predeterminado:

Ninguna

end_time

Sí

String

Explicación:

Hora de finalización en formato "aaaa-mm-ddThh:mm:ssZ".

T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100.

Restricciones:

Ninguna

Rango de valores:

La hora es posterior a la hora de inicio y anterior a la hora actual.

Valor predeterminado:

Ninguna

limit

Sí

Integer

Explicación:

Número de registros que se van a consultar.

Restricciones:

Ninguna

Rango de valores:

1–5000

Valor predeterminado:

Ninguna

line_num

No

String

Explicación:

Número de secuencia de un suceso de registro. Este parámetro no es necesario para la primera consulta, pero sí para consultas de paginación posteriores. El valor se puede obtener de la respuesta de la última consulta.

Restricciones:

Ninguna

Rango de valores:

El valor es una cadena de 13 dígitos.

Valor predeterminado:

Ninguna

operate_type

No

String

Explicación:

Tipo de sentencia SQL.

Restricciones:

Ninguna

Rango de valores:

Si este parámetro se deja en blanco o se establece en ALL se consultan todos los tipos de sentencias.

También puede especificar los siguientes tipos de registros:

  • INSERT
  • UPDATE
  • SELECT
  • DELETE
  • ALTER
  • DROP
  • CREATE

Valor predeterminado:

Ninguna

database

No

String

Explicación:

Base de datos a la que pertenecen los registros de consultas lentas.

Restricciones:

Ninguna

Rango de valores:

Ninguna

Valor predeterminado:

Ninguna

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetro del cuerpo de respuesta

Parámetro

Tipo

Descripción

slow_log_list

Array of LtsLogSlowDetail objects

Explicación:

Registros de consultas lentas.
Tabla 5 LtsLogSlowDetail

Parámetro

Tipo

Descripción

node_id

String

Explicación:

ID del nodo.

Rango de valores:

El valor puede contener 36 caracteres, comenzando con un UUID y terminando con no07. Solo se permiten letras y dígitos.

count

String

Explicación:

Número de ejecuciones.

Rango de valores:

Ninguna

time

String

Explicación:

Hora de ejecución.

Rango de valores:

Ninguna

lock_time

String

Explicación:

Tiempo de espera de bloqueo.

Rango de valores:

Ninguna

rows_sent

String

Explicación:

Número de filas enviadas.

Rango de valores:

Ninguna

rows_examined

String

Explicación:

Número de filas escaneadas.

Rango de valores:

Ninguna

database

String

Explicación:

Base de datos a la que pertenecen los registros de consultas lentas.

Rango de valores:

gaussdb-mysql

users

String

Explicación:

Nombre de cuenta.

Rango de valores:

Ninguna

query_sample

String

Explicación:

Sintaxis de ejecución.

Rango de valores:

Ninguna

type

String

Explicación:

Tipo de sentencia.

Rango de valores:

  • INSERT
  • UPDATE
  • SELECT
  • DELETE
  • ALTER
  • DROP
  • CREATE

start_time

String

Explicación:

Hora de inicio en formato UTC.

Rango de valores:

Ninguna

client_ip

String

Explicación:

Dirección IP.

Rango de valores:

Ninguna

line_num

String

Explicación:

Número de secuencia de un suceso de registro.

Rango de valores:

Ninguna

Código de estado: 400

Tabla 6 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Consulta de registros de consultas lentas

POST https://{endpoint}/v3.1/056538411200d4cd2f79c003c7606412/instances/096c0fc43e804757b59946b80dc27f8bin07/slow-logs
{
  "start_time" : "2022-11-20T00:00:00+0800",
  "end_time" : "2022-11-29T00:00:00+0800",
  "node_id" : "cc07c60e94ec4575989840e648fb4f66no07",
  "limit" : 10,
  "line_num" : 1669344916000
}

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "slow_log_list" : [ {
    "node_id" : "cc07c60e94ec4575989840e648fb4f66no07",
    "count" : 1,
    "time" : "1.04899 s",
    "lock_time" : "0.00003 s",
    "rows_sent" : 0,
    "rows_examined" : 0,
    "database" : "gaussdb-mysql",
    "users" : "root",
    "query_sample" : "INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N @time_zone_id);",
    "type" : "INSERT",
    "start_time" : "2022-11-25T10:55:16.000",
    "client_ip" : "192.*.*.1",
    "line_num" : 1669344916000
  } ]
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.

Tema principal: Gestión de registros