PartiQL

PartiQL é a linguagem de consulta compatível com SQL do DynamoDB. Mude qualquer aba de tabela para o modo PartiQL (⌘⇧M) para escrever instruções SELECT, INSERT, UPDATE e DELETE diretamente, em vez de clicar em pílulas de filtro.

Mudar uma aba para o modo PartiQL roda automaticamente o scan padrão SELECT * FROM "table" — o equivalente direto a abrir a tabela na visão visual. Assim que você edita a instrução, rodá-la fica por sua conta: pressione ⌘↩ para executar. Os resultados são transmitidos, e Carregar mais busca as próximas páginas.

SELECT * FROM "my-table" WHERE pk = 'USER#42' AND begins_with(sk, 'ORDER#')

PartiQL não é SQL

O PartiQL do DynamoDB é um subconjunto deliberado. O editor analisa sua consulta enquanto você digita e sinaliza construções que o DynamoDB não vai rodar — geralmente com uma correção rápida de um clique. As pegadinhas comuns:

• IN usa colchetes, não parênteses — WHERE id IN ['a', 'b'], não ('a', 'b'). A correção rápida reescreve isso. O linter também avisa quando a lista ultrapassa os limites do DynamoDB (50 valores em uma coluna de chave de partição, 100 em uma coluna que não é chave) antes que o servidor a rejeite.
• Sem cláusula LIMIT — o tamanho da página é um controle da aba, não SQL. Use Carregar mais.
• Sem JOIN, GROUP BY, HAVING, agregações, subconsultas, UNION ou CTEs. Para isso, abra uma aba de Workbench — o linter te aponta para lá.
• LIKE → função — LIKE '%foo%' vira contains(col, 'foo'), 'foo%' vira begins_with(col, 'foo'). Correção rápida oferecida.
• IS NULL / IS NOT NULL → attribute_not_exists(col) / attribute_exists(col). Correção rápida oferecida (note o mapeamento inverso).
• Literais de string com aspas simples — 'value', não "value". Aspas duplas significam um identificador.

O popover de ajuda de formato ao lado do botão Executar lista essas regras inline sempre que você precisar de um lembrete.

Templates e consultas salvas

O menu Consultas solta instruções prontas no editor, resolvidas contra as chaves reais da tabela ativa e um valor amostrado — então um template SELECT chega já referenciando sua chave de partição, não um placeholder. Use o Tab para percorrer os buracos destacados e preencher o resto.

Guarde uma instrução que você vai reutilizar com o botão Salvar — suas consultas salvas ficam no mesmo menu ao lado dos templates, prontas para rodar em qualquer tabela. O Workbench e o PartiQL mantêm bibliotecas separadas, já que falam linguagens de consulta diferentes.

Templates de escrita

Os templates INSERT / UPDATE / DELETE usam chaves sintéticas DEMO-* de propósito, para que rodar um logo de cara não possa alterar uma linha real por acidente. Eles são feitos para rodar em ordem — inserir, depois atualizar, depois excluir o mesmo item de demonstração — e você edita as chaves para mirar dados reais.

Histórico

Toda consulta executada é salva em um histórico por modo (separado do do Workbench). Reabra o menu de histórico para restaurar uma instrução anterior no editor — incluindo execuções que falharam, para você corrigir e tentar de novo.