Tables permite armazenar e gerenciar dados estruturados diretamente no seu workspace. Use para manter dados de referência, coletar saídas de workflows ou montar bancos de dados leves — tudo sem sair do Studio.
Cada tabela tem um schema de colunas tipadas, aceita filtros e ordenação e está totalmente acessível pela Tables API.
Criando uma tabela
| Tipo | Armazena | Exemplo |
|---|---|---|
| Text | Um texto livre | "Acme Corp" |
| Number | Um valor numérico | 42 |
| Currency | Um valor na moeda que você escolhe por coluna | $1,234.56 |
| Boolean | true ou false | true |
| Date | Uma data | 2026-03-16 |
| JSON | Um objeto ou array | { "tier": "pro" } |
| Select | Uma opção de um conjunto fixo, ou várias | Pro |
Toda tabela começa com uma única coluna de texto. Adicione mais colunas clicando em New column na área do cabeçalho das colunas.
Uma coluna Currency armazena um número simples e o exibe na moeda escolhida para aquela coluna, então filtros, ordenações e exportações sempre veem o valor em si. Trocar a moeda de uma coluna só muda o rótulo — não converte os valores.
Editando uma tabela
Cada coluna tem um tipo que determina como os valores são armazenados e validados.
| Tipo | Descrição | Valores de exemplo |
|---|---|---|
| Text | Texto livre | "Acme Corp", "hello@example.com" |
| Number | Valor numérico | 42, 3.14, -100 |
| Boolean | Verdadeiro ou falso | true, false |
| Date | Valor de data | 2026-03-16 |
| JSON | Objeto ou array estruturado | {"key": "value"}, [1, 2, 3] |
Os tipos de coluna são aplicados na entrada. Por exemplo, digitar em uma coluna
Number aceita apenas dígitos, pontos e sinais de menos. Valores não numéricos
inseridos por colagem são convertidos para 0.
Trabalhando com linhas
Adicionando linhas
- Clique em New row abaixo da última linha para acrescentar uma linha
- Pressione Shift + Enter com uma célula selecionada para inserir uma linha abaixo
- Cole dados tabulares (de uma planilha ou de um TSV) para criar linhas em lote
Editando células
Clique em uma célula para selecioná-la e então pressione Enter, F2 ou comece a digitar para editar. Pressione Escape para cancelar, ou Tab para salvar e ir para a próxima célula.
Selecionando linhas
Clique na caixa de seleção de uma linha para selecioná-la. Marcar outras caixas soma à seleção sem limpar as anteriores.
| Ação | Comportamento |
|---|---|
| Clicar na caixa de seleção | Alterna a seleção daquela linha |
| Shift + clique na caixa de seleção | Seleciona o intervalo da última clicada até a atual |
| Clicar na caixa de seleção do cabeçalho | Seleciona tudo / desmarca tudo |
| Shift + Space | Alterna a seleção da linha pelo teclado |
Excluindo linhas
Clique com o botão direito em uma linha selecionada (ou em um grupo de linhas selecionadas) e escolha Delete row no menu de contexto.
Filtrando e ordenando
Use a barra de ferramentas acima da tabela para filtrar e ordenar seus dados.
- Filter: define condições em qualquer coluna (por exemplo, "Name contains Acme"). Vários filtros são combinados com lógica AND.
- Sort: ordena as linhas por qualquer coluna, de forma crescente ou decrescente.
Filtros e ordenações são aplicados em tempo real e não modificam os dados subjacentes.
Atalhos de teclado
Todos os atalhos funcionam quando a tabela está em foco e nenhuma célula está em edição.
Mod significa Cmd no macOS e Ctrl no Windows/Linux.
Navegação
| Atalho | Ação |
|---|---|
| Teclas de seta | Move uma célula |
Mod + teclas de seta | Salta para a borda da tabela |
Tab / Shift + Tab | Vai para a célula seguinte / anterior |
Escape | Limpa a seleção |
Seleção
| Atalho | Ação |
|---|---|
Shift + teclas de seta | Estende a seleção em uma célula |
Mod + Shift + teclas de seta | Estende a seleção até a borda |
Mod + A | Seleciona todas as linhas |
Shift + Space | Alterna a seleção da linha atual |
Edição
| Atalho | Ação |
|---|---|
Enter ou F2 | Começa a editar a célula selecionada |
Escape | Cancela a edição |
| Digitar qualquer caractere | Começa a editar com aquele caractere |
Shift + Enter | Insere uma nova linha abaixo |
Space | Expande os detalhes da linha |
Área de transferência
| Atalho | Ação |
|---|---|
Mod + C | Copia as células selecionadas |
Mod + X | Corta as células selecionadas |
Mod + V | Cola |
Delete / Backspace | Limpa as células selecionadas (todas as colunas quando a seleção é por caixa) |
Histórico
| Atalho | Ação |
|---|---|
Mod + Z | Desfazer |
Mod + Shift + Z | Refazer |
Mod + Y | Refazer (alternativa) |
Usando Tables em workflows
Seus workflows podem ler e escrever em tabelas com o bloco Table. Os padrões mais comuns são:
- Consulta: buscar dados de referência em uma tabela (por exemplo, regras de preço, metadados de clientes)
- Escrita de volta: guardar as saídas do workflow em uma tabela para revisão ou relatórios posteriores
- Iteração: processar cada linha de uma tabela como parte de um workflow em lote
Acesso via API
As tabelas estão totalmente acessíveis pela API REST. Você pode criar, ler, atualizar e excluir tabelas e linhas de forma programática.
Veja a Tables API Reference para endpoints, parâmetros e exemplos.
Boas práticas
- Use colunas tipadas para garantir a integridade dos dados — prefira Number e Boolean em vez de guardar tudo como Text
- Nomeie as colunas de forma descritiva para que se expliquem por si quando referenciadas em workflows
- Use colunas JSON com moderação — são flexíveis, mas mais difíceis de filtrar e ordenar
- Aproveite a API para importações em lote, em vez de digitar grandes volumes de dados manualmente