Editar dados no Data Output

Altere, adicione e remova registros com segurança no grid de resultados, entenda alterações pendentes e saiba o que fazer quando a gravação é recusada.

O Data Output e o painel que mostra o resultado das consultas. Em parte dos resultados você também pode alterar os dados ali mesmo, sem escrever comandos de atualização.

Para que serve

Use quando precisar corrigir registros pontuais que já apareceram no resultado: ajustar uma descrição, preencher um campo em branco, remover uma linha errada.

Para alterações em massa, escreva a consulta apropriada no editor. O grid foi feito para correções pontuais e conferidas.

Antes de começar

• Confirme em qual banco você está conectado. O cabeçalho do QueryConsole mostra a conexão em uso.
• Tenha certeza de que a alteração pode ser feita naquele ambiente. Um banco restaurado para conferência é diferente do banco em produção.
• Prefira executar antes um SELECT que mostre exatamente as linhas que você pretende alterar.

Nem todo resultado pode ser editado

O RestauraDB só libera a edição quando consegue provar que sabe exatamente qual linha da tabela corresponde a cada linha da tela. Isso exige três coisas ao mesmo tempo:

1. o resultado vem de uma única tabela;
2. essa tabela tem chave primária;
3. a chave primária aparece inteira no resultado.

Quando qualquer uma dessas condições falha, o resultado fica somente leitura e os botões de adicionar, colar, remover e salvar ficam desativados.

Casos comuns que ficam somente leitura:

Como o cabeçalho ajuda

Cada coluna do resultado mostra o nome e, embaixo, o tipo do campo:

• [PK] indica que a coluna faz parte da chave primária;
• um lápis indica que a coluna aceita edição;
• colunas geradas automaticamente pelo banco não recebem o lápis e não podem ser digitadas.

Como alterar um valor

1. Execute a consulta.
2. De duplo clique na célula que deseja alterar.
3. Digite o novo valor e pressione Tab ou Enter.
4. Repita nas demais células, se precisar.
5. Pressione F6 para gravar.

Alterações pendentes

Enquanto não grava, o RestauraDB marca visualmente o que mudou:

• célula alterada ganha um fundo diferente;
• linha nova aparece destacada;
• linha marcada para exclusão fica esmaecida até a gravação;
• célula inválida fica em tom de erro, com o motivo no tooltip.

Passe o mouse sobre a célula alterada para ver qual é o valor que ainda está no banco. Isso ajuda a conferir antes de gravar.

Adicionar uma linha

1. Clique em Add row ou use Alt + Shift + A.
2. Preencha os campos da nova linha.
3. Pressione F6.

Campos que você deixar em branco não são enviados: o banco aplica o valor padrão dele, quando existir. Isso é diferente de marcar o campo como nulo.

Remover linhas

1. Selecione a linha ou as linhas.
2. Clique em Delete row.
3. As linhas ficam marcadas, mas ainda não foram removidas.
4. Pressione F6 para confirmar.

Campo vazio não é o mesmo que nulo

Esta diferença importa no PostgreSQL:

• apagar o texto de uma célula grava texto vazio;
• usar Definir como NULL (menu do botão direito) grava nulo de verdade.

Células nulas aparecem no grid como [null], em cinza, para você distinguir de um campo que apenas está em branco.

Copiar e colar

• Ctrl + C copia a seleção com tabulação entre colunas, pronta para colar no Excel.
• O menu ao lado do botão Copy permite copiar com os nomes das colunas ou em formato CSV.
• Ctrl + V cola no grid a partir da célula selecionada, preenchendo para a direita e para baixo.

Dados colados entram como alterações pendentes, iguais as digitadas: nada vai para o banco antes do F6.

Desfazer antes de gravar

Com o botão direito sobre o grid:

• Reverter célula devolve apenas aquela célula ao valor do banco;
• Reverter linha devolve a linha inteira;
• Descartar todas as alterações limpa tudo o que estava pendente.

Nenhuma dessas ações toca no banco: elas apenas desfazem o que estava na tela.

Quando a gravação é recusada

Se o banco recusar qualquer parte do lote, nada é gravado — nem as alterações que estavam corretas. É tudo ou nada, de propósito: um lote salvo pela metade deixaria os dados inconsistentes.

Quando isso acontece:

• suas alterações continuam na tela, para você corrigir;
• as células envolvidas ficam marcadas com o motivo;
• a aba Mensagens mostra o que o banco respondeu, incluindo o código do erro do PostgreSQL;
• o botão de salvar continua ativo.

Motivos frequentes de recusa:

Como saber se deu certo

Após gravar, a aba Mensagens informa quantas alterações foram aplicadas, separadas entre inseridas, alteradas e removidas. As marcações de pendência desaparecem e o botão de salvar fica desativado, porque não há mais nada a gravar.

Resultados com muitas linhas

O grid mostra 1000 linhas por vez. Se a consulta trouxer mais, use os botões de página na parte superior direita.

Quando procurar suporte

Procure suporte quando:

• a gravação continuar sendo recusada mesmo após corrigir o valor indicado;
• você não tiver certeza do impacto da alteração no sistema do cliente;
• o resultado deveria ser editável e continua somente leitura sem motivo claro.

Informe o código exibido, a tabela consultada e o que você estava tentando alterar. Não envie senhas nem dados sensíveis dos registros.

Artigos relacionados

• Abrir o QueryConsole
• Atalhos do QueryConsole
• O QueryConsole não salva minha alteração
• RDB-SQL-003 — As alterações não foram gravadas