Todos os produtos
Search
Central de documentação

ApsaraDB for ClickHouse:DescribeSlowLogTrend

Última atualização: Jun 28, 2026

Consulta estatísticas sobre as tendências de slow log de um cluster.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

clickhouse:DescribeSlowLogTrend

get

*DBCluster

acs:clickhouse:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Não

O ID da região. Chame a operação DescribeRegions para consultar os IDs de região.

cn-hangzhou

DBClusterId

string

Sim

O ID do cluster. Chame a operação DescribeDBClusters para consultar informações sobre todos os clusters em uma região específica, incluindo os IDs de cluster.

cc-bp11xxl475ui8****

StartTime

string

Sim

O início do intervalo de tempo a ser consultado. Especifique o horário no formato yyyy-MM-dd hh:mm:ss. O horário está em UTC.

2022-05-20 16:00:00

EndTime

string

Sim

O fim do intervalo de tempo a ser consultado. Especifique o horário no formato yyyy-MM-dd hh:mm:ss. O horário está em UTC.

Nota

O horário de término deve ser posterior ao horário de início. O intervalo de tempo não pode exceder 7 dias.

2022-05-27 16:00:00

QueryDurationMs

integer

Não

A duração de execução de uma consulta SQL lenta, em milissegundos. O valor mínimo é 1000. O valor padrão é 1000. A operação retorna consultas SQL lentas que levam mais tempo do que essa duração para serem executadas.

1000

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF

SlowLogTrend

object

O conjunto de resultados das consultas SQL lentas.

TableSchema

object

ResultSet

array<object>

The table schema.

object

The schema of the result table.

Type

string

The column type.

UInt64

Name

string

The column name.

query_start_time

Data

object

ResultSet

array<object>

The list of slow SQL queries.

object

The list of slow SQL queries.

QueryStartTime

string

The start time of the query. The time is in the `yyyy-MM-dd hh:mm:ss` format. The time is in UTC.

2022-05-22 20:00:01

MaxQueryDurationMs

string

The longest execution duration. Unit: milliseconds.

3000

MinQueryDurationMs

string

The shortest execution duration. Unit: milliseconds.

1000

Count

string

The total execution duration of slow SQL queries. Unit: milliseconds.

4000

AvgQueryDurationMs

string

The average execution duration. Unit: milliseconds.

2000

Rows

string

O número de linhas no conjunto de resultados.

1

RowsBeforeLimitAtLeast

string

O número mínimo de linhas retornadas antes da aplicação da cláusula LIMIT.

1

Statistics

object

As estatísticas dos resultados da consulta.

RowsRead

integer

The number of rows read.

14721

ElapsedTime

number

The query execution duration. Unit: seconds.

0.001703578

BytesRead

integer

The amount of data read. Unit: bytes.

697899

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "7D3ECB0E-98CA-5E08-A9CA-F70C5A1E9BDF",
  "SlowLogTrend": {
    "TableSchema": {
      "ResultSet": [
        {
          "Type": "UInt64",
          "Name": "query_start_time"
        }
      ]
    },
    "Data": {
      "ResultSet": [
        {
          "QueryStartTime": "2022-05-22 20:00:01",
          "MaxQueryDurationMs": "3000",
          "MinQueryDurationMs": "1000",
          "Count": "4000",
          "AvgQueryDurationMs": "2000"
        }
      ]
    },
    "Rows": "1",
    "RowsBeforeLimitAtLeast": "1",
    "Statistics": {
      "RowsRead": 14721,
      "ElapsedTime": 0.001703578,
      "BytesRead": 697899
    }
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

500 InternalError An error occurred while processing your request. An error occurred while processing your request.
503 ServiceUnavailable An error occurred while processing your request. An error occurred while processing your request.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.