Pular para o conteúdo principal
As consultas no ClickHouse podem ser divididas nos seguintes tipos:
  1. Consultas de leitura de dados: SELECT, SHOW, DESCRIBE, EXISTS.
  2. Consultas de escrita de dados: INSERT, OPTIMIZE.
  3. Consultas de alteração de configurações: SET, USE.
  4. Consultas DDL: CREATE, ALTER, RENAME, ATTACH, DETACH, DROP TRUNCATE.
  5. KILL QUERY.
As configurações a seguir regulam as permissões do usuário por tipo de consulta:

readonly

Restringe as permissões para consultas de leitura de dados, escrita de dados e alteração de configurações. Quando definido como 1, permite:
  • Todos os tipos de consultas de leitura (como SELECT e consultas equivalentes).
  • Consultas que modificam apenas o contexto da sessão (como USE).
Quando definido como 2, permite o acima, além de:
  • SET e CREATE TEMPORARY TABLE
Consultas como EXISTS, DESCRIBE, EXPLAIN, SHOW PROCESSLIST etc. equivalem a SELECT, porque apenas fazem SELECT em tabelas do sistema.
Valores possíveis:
  • 0 — Consultas de leitura, escrita e alteração de configurações são permitidas.
  • 1 — Somente consultas de leitura de dados são permitidas.
  • 2 — Consultas de leitura de dados e alteração de configurações são permitidas.
Valor padrão: 0
Depois de definir readonly = 1, o usuário não pode alterar as configurações readonly e allow_ddl na sessão atual.Ao usar o método GET na interface HTTP, readonly = 1 é definido automaticamente. Para modificar dados, use o método POST.Definir readonly = 1 impede que o usuário altere configurações. Há uma forma de impedir que o usuário altere apenas configurações específicas. Também há uma forma de permitir a alteração apenas de configurações específicas mesmo com as restrições de readonly = 1. Para mais detalhes, consulte restrições nas configurações.

allow_ddl

Permite ou bloqueia consultas DDL. Valores possíveis:
  • 0 — consultas DDL não são permitidas.
  • 1 — consultas DDL são permitidas.
Valor padrão: 1
Você não pode executar SET allow_ddl = 1 se allow_ddl = 0 na sessão atual.
KILL QUERYKILL QUERY pode ser executado com qualquer combinação das configurações readonly e allow_ddl.
Última modificação em 10 de junho de 2026