Skip to main content
Permite consultar dados armazenados em um banco de dados SQLite.

Sintaxe

Argumentos

Valor retornado

  • Um objeto de tabela com as mesmas colunas da tabela SQLite original.

Passando uma consulta em vez de um nome de tabela

Em vez de um nome de tabela, o segundo argumento pode ser uma consulta SELECT passada ao SQLite como está. A estrutura da tabela resultante é inferida a partir do resultado da consulta. A consulta pode ser escrita como uma subconsulta ou encapsulada na função query:
Essa tabela é somente leitura: não é permitido fazer INSERT nela. A mesma sintaxe também é aceita pelo motor de tabela SQLite.
A forma de subconsulta (SELECT ...) é analisada pelo ClickHouse e reserializada antes de ser enviada ao SQLite. Portanto, ela deve ser um SQL válido do ClickHouse. Para usar uma sintaxe específica do SQLite que o ClickHouse não analisa, use a forma query('...'), cujo texto é enviado ao SQLite literalmente.Qualquer WHERE, LIMIT, agregação etc. externo da consulta ClickHouse circundante não é aplicado à consulta fornecida — ele é aplicado no ClickHouse depois que o resultado completo da consulta é buscado. Para restringir os dados lidos do SQLite, coloque o filtro dentro da consulta fornecida. Com external_table_strict_query = 1, um filtro externo que não pode ser aplicado é rejeitado com uma exceção, em vez de ser aplicado localmente.

Exemplo

Query
Response
Última modificação em 23 de julho de 2026