KEPLIN Docs

Alterar ou eliminar várias linhas

Como alterar ou eliminar todas as linhas que cumprem uma condição, com pré-visualização do antes e do depois, ensaio, confirmação escrita e cópia para repor.

Para mudar muitas linhas de uma vez (passar todas as contas em prospeto para ativo, ou eliminar os registos de teste), as operações em várias linhas trabalham por condição: escolhes as linhas por uma condição, vês o antes e o depois de cada uma, e só então executas.

A pré-visualização é uma leitura: nada se escreve antes de carregares em Executar. Antes de executar, o Keplin guarda uma cópia das linhas, e a operação pode repor-se durante 30 dias no histórico de operações.

Abrir uma operação

  1. Abre a tabela no separador próprio (ver Ver e editar os dados de uma tabela).
  2. Se quiseres, filtra a grelha com Filtrar…: a operação começa com o filtro da grelha como condição.
  3. Carrega em Operações e escolhe Alterar linhas… ou Eliminar linhas…. Por baixo de cada opção, o menu mostra quantas linhas o filtro da grelha tem.

O diálogo tem duas escolhas no topo:

  • Alterar ou Eliminar: a operação. Podes trocar sem perder a condição.
  • Construtor ou SQL: a forma de escrever a condição.

À esquerda, defines a operação. À direita, a pré-visualização mostra as linhas afectadas.

Escolher as linhas com o construtor

A secção Linhas a alterar (ou Linhas a eliminar) é um grupo de condições:

  • Todas estas condições junta as condições com E; Qualquer destas condições junta-as com OU.
  • Condição acrescenta uma condição: a coluna, o operador e o valor. Os operadores dependem do tipo da coluna (por exemplo, contém e começa por no texto, maior do que nos números e nas datas). é um de e não é nenhum de aceitam vários valores separados por vírgulas.
  • Grupo acrescenta um grupo dentro do grupo, para misturar E e OU.
  • Tabela relacionada acrescenta uma condição sobre outra tabela, ligada a esta por uma chave estrangeira. Por exemplo, Linhas de contactos que apontam para esta com não tem nenhuma com escolhe as contas sem contactos. As condições dentro da tabela relacionada são sobre as colunas dela.

Numa coluna com lista de valores, o valor escolhe-se na lista.

Atenção

Uma condição por acabar (sem valor) fica a vermelho, e o Keplin recusa a operação inteira enquanto ela lá estiver. Uma condição vazia nunca conta como "todas as linhas".

Para aplicar a operação a todas as linhas da tabela, marca Todas as linhas da tabela (sem condição). Nesse caso, a confirmação pede o nome da tabela em vez do número de linhas.

Definir os valores novos

Ao alterar, a secção Valores novos tem uma linha por coluna a mudar: a coluna, o modo e o valor. Coluna acrescenta outra.

Modo Colunas O que faz
Valor fixo Todas Escreve o valor indicado.
NULL As que aceitam NULL Apaga o valor.
Valor de outra coluna Todas Copia o valor de outra coluna da mesma linha.
Somar, Subtrair, Multiplicar, Dividir Números Faz a conta com o valor actual.
Somar percentagem Números Soma ao valor actual a percentagem indicada.
Juntar texto no início, Juntar texto no fim Texto Junta o texto indicado ao valor actual.
Substituir texto Texto Troca o Texto a substituir pelo texto em Substituir por.
Maiúsculas, Minúsculas Texto Muda as letras do valor actual.
Data e hora actuais Datas Escreve a data e a hora do momento da execução.
Somar dias Datas Soma ao valor actual o número de dias indicado (negativo, para subtrair).

A chave primária, as colunas que a base de dados gera sempre e as colunas calculadas não aparecem na lista, porque não se alteram.

Ler a pré-visualização

A pré-visualização corre sozinha sempre que mudas a condição ou os valores, e mostra:

  • O número de linhas, por exemplo 3 linhas a alterar em contas.
  • Pré-visualização actual, com a hora da leitura, e Actualizar para ler de novo.
  • A lista das linhas, com o valor de antes riscado e o de depois por baixo, nas colunas que mudam. A lista mostra até 200 linhas. Quando há mais, a contagem diz quantas ficam de fora da lista.
  • Reposição: até quando a operação se pode repor, ou os avisos que a impedem de se repor por completo.
  • Ver o SQL que vai correr: a instrução que o Keplin vai executar.

Alterar várias linhas: a condição e os valores novos à esquerda, a pré-visualização com o antes e o depois à direita.
Alterar várias linhas: a condição e os valores novos à esquerda, a pré-visualização com o antes e o depois à direita.

Escrever a condição em SQL

Em SQL, escreves só a condição, e não a instrução inteira: o Keplin monta-a, com a tabela no alias t. Por exemplo:

t.estado = 'prospeto' and t.criado_em < '2026-01-01'

Os valores novos são uma expressão SQL por coluna, com as colunas escritas sem alias (por exemplo preco * 1.1).

Ao passar de Construtor para SQL, o Keplin converte a condição e os valores do construtor. Se já tinhas escrito SQL, o teu SQL fica como estava, e o botão Substituir pelo construtor troca-o pela conversão.

A condição tem de ser uma só expressão de leitura: sem ;, sem escritas e com as aspas fechadas. Assim, a pré-visualização, a cópia e a verificação da contagem funcionam em qualquer motor de base de dados.

A mesma operação em SQL: a condição do construtor convertida, com a tabela no alias t.
A mesma operação em SQL: a condição do construtor convertida, com a tabela no alias t.

Eliminar várias linhas

A eliminação usa a mesma condição. Além das linhas, a pré-visualização mostra a secção Tabelas que apontam para a tabela, com o que acontece em cada tabela ligada:

O que aparece O que quer dizer
Eliminadas também A chave elimina em cascata: as linhas ligadas saem com as da tabela. A cópia inclui-as.
Ficam sem ligação A chave passa a NULL nas linhas ligadas.
Ligadas A chave não deixa eliminar linhas com ligações.

No último caso, a pré-visualização mostra A base vai recusar, e Executar eliminação fica desligado. Acrescenta à condição uma Tabela relacionada com não tem nenhuma com, ou trata primeiro as linhas ligadas.

Para um pedido de eliminação de dados pessoais, marca Eliminar sem guardar cópia. A operação não guarda cópia e, por isso, não se pode repor.

Ensaiar e executar

  1. Confirma a pré-visualização.
  2. No campo Para executar, escreve, escreve o número de linhas que a pré-visualização contou (ou o nome da tabela, quando a operação não tem condição).
  3. Opcional: carrega em Ensaiar. O Keplin corre a operação numa transacção e desfá-la no fim, e mostra quantas linhas seriam afectadas. O ensaio confirma que as chaves e os triggers da tabela aceitam a operação, sem gravar nada.
  4. Carrega em Executar alteração ou Executar eliminação.

O Keplin guarda a cópia das linhas, executa a operação numa transacção e mostra Linhas alteradas ou Linhas eliminadas, com o número.

Duas protecções correm no momento de executar:

  • A contagem: se o número de linhas que cumprem a condição mudou depois da pré-visualização, nada é alterado, e a pré-visualização volta a correr.
  • O limite: uma operação afecta no máximo 50 000 linhas. Acima disso, divide a condição em partes.

Avisos antes de executar

A secção Reposição avisa dos casos em que a operação não se pode repor por completo, ou em que o resultado vai além da tabela:

Aviso O que quer dizer
Triggers A tabela tem triggers que correm em cada linha. O que escrevem noutras tabelas não aparece na pré-visualização nem é desfeito ao repor.
Cascata A eliminação apaga também linhas de outras tabelas. A cópia inclui-as.
Colunas que a cópia não guarda tal e qual Ao repor, essas colunas podem não voltar exactamente iguais.
Chave gerada sempre pela base As linhas eliminadas não podem voltar com a mesma chave.
Falta de permissões O utilizador da base de dados não pode inserir, alterar ou eliminar nesta tabela. A operação ou a reposição vai falhar.
Tabela sem transacções Uma falha a meio não se desfaz sozinha, e o ensaio fica desligado. A cópia é a única forma de repor.

Quando um aviso impede a reposição completa, marca Executo sabendo que esta operação não se pode repor por completo. antes de executar.

Perguntas frequentes

  • Posso escrever um UPDATE ou um DELETE completo? Não nesta janela: escreve-se só a condição, para o Keplin poder pré-visualizar, copiar e contar. Para SQL livre, os administradores têm a consola SQL.
  • Porque é que a operação respondeu "Nada foi alterado"? Outra pessoa ou outro programa alterou linhas entre a pré-visualização e a execução. Revê a pré-visualização nova e executa outra vez.
  • Porque é que o Ensaiar está desligado? A tabela não tem transacções (por exemplo, uma tabela MyISAM no MySQL), e um ensaio nessa tabela não se podia desfazer.
  • A operação aparece no histórico? Sim, com a condição, os valores e a cópia das linhas.