SQL Livre

​

O que é possível fazer?

• Consultas (SELECT): Realizar buscas complexas ou agregações de dados.
• Manipulação de Dados (DML): INSERT, UPDATE e DELETE em massa.
• Mudanças Estruturais (DDL): CREATE TABLE, ALTER TABLE, DROP TABLE e TRUNCATE.

​

Como funciona

​

Segurança por Design

1. Sua role possui permissões exclusivamente no seu schema (project_{id}_cdp).
2. Se você tentar acessar um schema de outro projeto (ex: SELECT * FROM project_2_cdp.users), o PostgreSQL retornará um erro 403 Forbidden (Permission Denied).
3. Você não precisa se preocupar em qualificar suas tabelas com o nome do schema (ex: SELECT * FROM leads funcionará perfeitamente).

​

Exemplo de Requisição (SELECT)

{
  "sql": "SELECT * FROM leads WHERE idade > 25"
}

​

Exemplo de Resposta (Sucesso)

{
  "success": true,
  "type": "SELECT",
  "rows": [
    { "id": "...", "email": "ana@exemplo.com", "idade": 28 },
    { "id": "...", "email": "marcos@exemplo.com", "idade": 32 }
  ],
  "row_count": 2
}

​

Melhores Práticas

• Uso criterioso: Embora potente, o endpoint SQL deve ser usado com cuidado para não causar deleções acidentais em massa.
• Ponto e Vírgula: Não é necessário finalizar sua query com ; no payload JSON.
• Sincronização: Comandos DDL (CREATE, ALTER, DROP) acionam automaticamente o sync_schema no seu painel Metabase.