Ferramentas de edição

funcional

Transforme e gere valores de células, localize e substitua em toda a grade, e copie alterações preparadas como SQL.

A edição de grade preparada vem com as ferramentas do dia a dia que tornam rápida a limpeza em massa: macros de texto e geradores de valores em qualquer célula, localizar e substituir na grade, e uma cópia com um clique das suas alterações preparadas como um script SQL. Cada uma delas produz alterações preparadas, então elas aparecem na barra de alterações pendentes, são pré-visualizadas em Pré-visualizar SQL, desfazer com Desfazer, e são aplicadas na mesma transação única que as edições que você digita à mão.

Transformar um valor

Clique com o botão direito em uma célula de texto e escolha um Transformar: entrada em Editar célula: MAIÚSCULAS, letras minúsculas, Iniciais Maiúsculas, Remover espaços em branco, ou Remover diacríticos (Crème Brûlée se torna Creme Brulee, e letras sem decomposição, como Ł, Ø, e ß, também se reduzem à sua base ASCII). Remover diacríticos remove acentos apenas de letras latinas, gregas e cirílicas. Em outros sistemas de escrita, como devanágari, tailandês e hangul, os sinais combinantes fazem parte da ortografia, então o texto é mantido exatamente como estava. Iniciais Maiúsculas coloca em maiúscula a primeira letra de cada palavra com as formas corretas de capitalização de título, de modo que uma palavra que comece com ß se torna Ss, e um acento nunca inicia uma nova palavra. Se a célula já tem um valor pendente, a macro reescreve esse valor, então você pode aparar e depois aplicar capitalização de título antes de salvar. As transformações se aplicam apenas a colunas de texto simples editáveis. Chaves, colunas calculadas, colunas enum e SET colunas, colunas JSON e XML, e tipos não textuais são recusados com uma mensagem explicando o motivo, assim como uma coluna de resultado que é uma expressão em vez de uma coluna de tabela.

Para limpar todo um lote de uma vez, abra o Transformar menu na barra de alterações pendentes. Ele aplica uma macro a todos os valores pendentes em uma coluna de texto simples, tanto em edições quanto em novas linhas, como uma única etapa de desfazer. Valores pendentes em JSON, XML, enum e SET colunas ficam intactas, porque reescrevê-las pode torná-las inválidas. No editor de linhas, cada campo de texto simples tem o seu Transformar menu que reescreve o rascunho ali mesmo.

SQLly
Clique com o botão direito em uma célula de texto: as entradas de Transformar e os geradores de valor preparam uma alteração na hora.Clique com o botão direito em uma célula de texto: as entradas de Transformar e os geradores de valor preparam uma alteração na hora.
Clique com o botão direito em uma célula de texto: as entradas de Transformar e os geradores de valor preparam uma alteração na hora.

Insira um valor gerado ou função SQL

O mesmo menu preenche uma célula com um valor gerado:

  • Definir para novo UUID escreve um UUID aleatório recém-gerado na sua máquina. É oferecido em colunas UUID e em colunas de texto simples largas o suficiente para o formato de 36 caracteres (não em JSON, XML, enum, ou SET colunas).
  • Definir para timestamp atual (relógio local) escreve a data e hora atual do seu computador, ajustadas à coluna (data, hora ou data e hora).
  • Funções SQL preparar uma expressão que o servidor avalia quando você salva, de modo que o valor venha do banco de dados em vez do seu computador: hora do servidor, data do servidor (CURRENT_DATE, CURDATE(), CAST(SYSDATETIME() AS date)), um UUID gerado pelo servidor (NEWID(), gen_random_uuid(), UUID(), SYS_GUID(), uuid()), e o usuário atual (SUSER_SNAME(), CURRENT_USER, USER).

Cada mecanismo tem sua própria grafia de uma função, e o script de pré-visualização mostra o SQL exato. A grade marca uma função preparada como <server date>, <server UUID>, e assim por diante até você salvar. No editor de linhas, o Inserir menu lista os mesmos geradores, com o SQL no dialeto de cada função no rótulo.

SQLite, libSQL e DuckDB não têm login, então usuário atual não é oferecido lá. SQLite e libSQL não possuem função UUID, então um UUID gerado pelo servidor é escrito como 32 caracteres hexadecimais aleatórios (lower(hex(randomblob(16)))). O Oracle SYS_GUID() também produz 32 caracteres hexadecimais maiúsculos sem hífens, não o formato de 36 caracteres com hífens.

Em uma conexão que passa por uma ponte de retransmissão, o bridge informa quais recursos a versão do SQLLY dele suporta quando a sessão abre. Data do servidor, UUID gerado pelo servidor, e usuário atual são oferecidos apenas quando a ponte os suporta; com uma ponte mais antiga, que rejeitaria toda a edição, o menu da grade os oculta e o editor de linhas os lista desabilitados com uma nota para atualizar a ponte. Hora do servidor, Definir para novo UUID, e o carimbo de data/hora do relógio local funciona com qualquer ponte. As edições pendentes da grade são salvas por um relay da mesma maneira que localmente, em uma única transação que é revertida se alguma linha mudar nesse meio tempo, quando a ponte suporta. Com uma ponte mais antiga, a barra de alterações pendentes diz Salvar requer uma ponte mais recente e Salvar alterações permanece desativada, enquanto o editor de linhas ainda salva as linhas uma de cada vez.

Localizar e substituir na grade

Pressione Localizar na grade atalho, ou clique com o botão direito e escolha Ferramentas › Localizar & Substituir na Grade…, e digite no campo localizar. O campo substituir fica abaixo. Substituir reescreve a correspondência focada e Substituir tudo reescreve cada correspondência. A correspondência não diferencia maiúsculas de minúsculas, e cada ocorrência dentro de uma célula correspondente é substituída. O texto de busca é usado exatamente como você digitou, incluindo espaços iniciais e finais, então a substituição reescreve o mesmo texto que a grade destacou.

As substituições viram edições de célula preparadas e nunca são gravadas direto no banco de dados. Um Substituir tudo é um único passo de desfazer, e a aba Mensagens informa quantas células e linhas foram preparadas. Substituir altera apenas as células que pode reescrever com segurança: colunas de texto simples editáveis. Correspondências em colunas de chave, identidade, calculadas, rowversion, com restrição de enumeração, numéricas, de data, JSON e XML são ignoradas, assim como células NULL, mesmo que a grade as exiba como NULL. Uma coluna de resultado que é uma expressão também é ignorada, mesmo quando tem o mesmo nome de uma coluna da tabela (SELECT id, left(body, 50) AS body): apenas as colunas que a consulta seleciona diretamente da tabela são gravadas. Linhas já preparadas para exclusão são puladas, e também células que contêm uma função SQL preparada, como <server UUID>. Um replace funciona sobre o valor que você vê, então ele aproveita o que você já tiver preparado naquela célula. Cada linha mantém a própria proteção de concorrência otimista: os valores originais dela e a rowversion dela, quando o resultado inclui uma.

Substituir tudo cobre as linhas que a barra de busca pesquisou. Em um resultado muito grande que o SQLLY mantém no disco, apenas as linhas carregadas no momento ao redor da sua posição de rolagem são pesquisadas, e uma busca para após 100.000 correspondências. Quando um desses limites se aplica, a aba Mensagens diz exatamente quais linhas foram cobertas, por exemplo as 100 linhas carregadas (3001–3100 de 5000). Role a tela, ou execute Substituir tudo de novo, para chegar ao restante.

SQLly
A barra de busca da grade com sua linha de substituição: as correspondências se tornam edições preparadas, pré-visualizadas e salvas como edições manuais.A barra de busca da grade com sua linha de substituição: as correspondências se tornam edições preparadas, pré-visualizadas e salvas como edições manuais.
A barra de busca da grade com sua linha de substituição: as correspondências se tornam edições preparadas, pré-visualizadas e salvas como edições manuais.

Copiar alterações preparadas como SQL

Às vezes você quer o script, não o salvamento: para colar em um ticket, executar através de um processo de implantação ou revisar com um colega primeiro. Com as alterações preparadas, clique Copiar como SQL na barra de alterações pendentes, na Pré-visualizar SQL aba, ou na Confirmar alterações preparadas . Você também pode executar Resultados: copiar alterações preparadas como SQL pela paleta de comandos. O script é renderizado no momento em que você clica, então uma edição feita uma fração de segundo antes está sempre incluída. Copiar nunca salva nem descarta nada. Suas alterações ficam preparadas até que você salve ou descarte.

O script copiado tem as mesmas instruções que Pré-visualizar SQL, no mesmo contêiner de transação, mas não é byte a byte o que um save envia. Um save vincula os valores como parâmetros, enquanto o script os coloca como literais. Um save também exige que cada UPDATE e DELETE altere exatamente uma linha, e desfaz todo o lote se uma não cumprir, porque a linha foi alterada ou deletada desde que você a carregou. O script realiza essa verificação onde o mecanismo pode expressá-la:

  • SQL Server: cada instrução é seguida por IF @ROWCOUNT <> 1 THROW …, e SET XACT_ABORT ON que desfaz a transação.
  • PostgreSQL e mecanismos compatíveis (exceto CockroachDB): cada instrução é executada em um DO bloco que verifica a contagem de linhas e gera um erro, o que aborta a transação.
  • Oracle: cada instrução é executada em um bloco PL/SQL que verifica SQL%ROWCOUNT. Execute o script com WHENEVER SQLERROR EXIT ROLLBACK (SQL*Plus ou SQLcl) para que uma verificação falha também desfaça as instruções anteriores.
  • MySQL, MariaDB, SQLite, libSQL, DuckDB e CockroachDB não têm como verificar a contagem de linhas em um script simples. Cada instrução é marcada -- expect 1 row, então confira as contagens você mesmo.

No SQL Server, um salvamento também lê de volta as linhas inseridas com OUTPUT INSERTED.*. O script omite isso. Um comentário de cabeçalho no topo do script repete essas diferenças.

SQLly
Copiar como SQL na pré-visualização das alterações preparadas: o script de alterações pendentes vai para a área de transferência sem ser executado.Copiar como SQL na pré-visualização das alterações preparadas: o script de alterações pendentes vai para a área de transferência sem ser executado.
Copiar como SQL na pré-visualização das alterações preparadas: o script de alterações pendentes vai para a área de transferência sem ser executado.