sql editor

o sql editor do catálogo permite executar consultas sql ad-hoc diretamente sobre as tabelas do lakehouse, sem precisar exportar dados ou pedir para alguém rodar uma consulta por você.

para que serve

• responder perguntas pontuais que não justificam a criação de um novo pipeline ou dashboard;
• validar rapidamente o resultado de um workflow logo após a execução;
• cruzar informações de mais de uma tabela do mesmo lakehouse com um JOIN;
• explorar dados antes de decidir como modelar um pipeline de transformação mais elaborado.

como usar

1. abra uma tabela pelo catálogo (ou vá direto ao editor, se disponível na tela).
2. escreva a consulta sql normalmente — sintaxe padrão SELECT ... FROM ... WHERE ....
3. execute e veja o resultado em formato de tabela, com o tempo de execução da consulta.

escopo da consulta

cada consulta roda no contexto do workspace e do lakehouse selecionados — não é possível, pelo sql editor, consultar tabelas de outro workspace ao qual você não tenha acesso.

boas práticas

• para tabelas grandes, use LIMIT durante a exploração inicial, e só remova o limite quando já souber exatamente o que precisa.
• combine com a aba de schema para confirmar os nomes e tipos das colunas antes de escrever a consulta.
• se a coluna que você precisa é um campo JSON/JSONB, é possível inspecionar as chaves internas antes de escrever a consulta, o que ajuda bastante ao lidar com dados semiestruturados vindos de APIs.

consultas somente leitura

o sql editor foi feito para exploração e validação de dados — não é o lugar para lógica de transformação recorrente. transformações que precisam rodar de forma agendada e confiável devem ser modeladas como nós dentro de um workflow, não como scripts soltos no editor.