Todos os produtos
Search
Central de documentação

EventBridge:QueryEventHouseWithTimeRange

Última atualização: Sep 03, 2026

Executa uma instrução SQL somente leitura para consultar dados internos do EventHouse dentro de um intervalo de tempo especificado. O intervalo de tempo restringe apenas os dados internos do EventHouse referenciados na instrução SQL e não afeta fontes de dados externas montadas. Retorna um conjunto de resultados estruturado.

Descrição da operação

Executa uma única instrução SQL somente leitura e retorna um conjunto de resultados estruturado. BeginTime e EndTime restringem apenas os dados internos do EventHouse referenciados na instrução SQL e não afetam fontes de dados externas montadas.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Query

string

Sim

A única instrução SQL somente leitura a ser executada. Você pode consultar dados internos do EventHouse ou realizar consultas federadas com fontes de dados externas montadas.

SELECT * FROM my_catalog.my_namespace.my_table LIMIT 100

BeginTime

integer

Sim

A hora de início para consultar dados internos do EventHouse. Especifique um timestamp UNIX em segundos. O intervalo de tempo inclui este ponto no tempo.

1787587200

EndTime

integer

Sim

A hora de término para consultar dados internos do EventHouse. Especifique um timestamp UNIX em segundos. O intervalo de tempo exclui este ponto no tempo. O valor deve ser maior que BeginTime.

1787590800

Limit

integer

Não

O número máximo de linhas de resultado que podem ser retornadas para esta consulta.

100

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Message

string

Uma mensagem de sucesso se a chamada for bem-sucedida, ou uma mensagem de erro específica se a chamada falhar.

success

RequestId

string

O ID exclusivo da solicitação. Você pode usar este ID para solução de problemas.

34AD682D-5B91-5773-8132-AA38C130****

Data

object

Os dados de resultado estruturados retornados pela consulta SQL.

Rows

array

A lista de linhas de resultado retornadas pela consulta SQL.

Row

Uma única linha de resultado que contém o nome, tipo, valor e sinalizador nulo de cada coluna na linha.

Total

integer

O número de linhas de resultado realmente retornadas pela consulta.

1

Code

string

O código de retorno da operação. Success indica uma chamada bem-sucedida. Outros valores indicam códigos de erro específicos.

Success

Success

boolean

Indica se a chamada foi bem-sucedida. Um valor true indica sucesso. Um valor false indica falha.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Message": "success",
  "RequestId": "34AD682D-5B91-5773-8132-AA38C130****",
  "Data": {
    "Rows": [
      {
        "Columns": [
          {
            "Name": "index",
            "Type": "text",
            "Value": "product_info",
            "IsNull": false
          }
        ]
      }
    ],
    "Total": 1
  },
  "Code": "Success",
  "Success": true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403 ServiceNotEnable Service not enable

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.