Инструменты редактирования

функциональный

Преобразовывайте и генерируйте значения ячеек, находите и заменяйте по всей сетке, и копируйте подготовленные изменения как SQL.

Подготовленное редактирование сетки идёт с повседневными инструментами, которые ускоряют массовую чистку: текстовые макросы и генераторы значений в любой ячейке, поиск и замена по всей сетке и копирование подготовленных изменений в SQL-скрипт одним кликом. Каждый из них создаёт обычные подготовленные изменения, поэтому они появляются в панели ожидающих изменений, а предпросмотр — в Предварительный просмотр SQL, отменяются с помощью Отменить, и фиксируются в той же единой транзакции, что и правки, введённые вручную.

Преобразовать значение

Щелкните правой кнопкой мыши ячейку с текстом и выберите Преобразовать: элемент под Редактировать ячейку: ЗАГЛАВНЫЕ БУКВЫ, строчные буквы, Каждое слово с заглавной, Убрать пробелы, или Удалить диакритические знаки (Crème Brûlée становится Creme Brulee, и буквы без разложения, такие как Ł, Ø, и ß, тоже приводятся к своей ASCII-основе). Удалить диакритические знаки удаляет диакритические знаки только у латинских, греческих и кириллических букв. В других письменностях, таких как деванагари, тайская и хангыль, комбинируемые знаки являются частью написания, поэтому текст остается точно таким же. Каждое слово с заглавной делает первую букву каждого слова заглавной по правилам title case, так что слово, начинающееся с ß становится Ss, а знак диакритики никогда не начинает новое слово. Если в ячейке уже есть подготовленное значение, макрос перезаписывает его, так что можно обрезать пробелы, затем капитализировать и только потом сохранять. Преобразования применяются только к редактируемым текстовым столбцам. Ключи, вычисляемые столбцы, столбцы enum и SET столбцы, JSON- и XML-столбцы, а также нетекстовые типы отклоняются с сообщением о причине — как и столбец результата, являющийся выражением, а не столбцом таблицы.

Чтобы очистить всю партию сразу, откройте Преобразовать меню на панели ожидающих изменений. Оно применяет макрос ко всем подготовленным значениям в текстовом столбце — и к правкам, и к новым строкам — как одно действие отмены. Подготовленные значения в JSON, XML, enum и SET колонки оставляются без изменений, потому что их переписывание может сделать их недействительными. В редакторе строк каждое поле с простым текстом имеет собственное Преобразовать меню, которое переписывает черновик на месте.

SQLly
Щёлкните правой кнопкой мыши по текстовой ячейке: пункты меню Преобразовать и генераторы значений готовят изменение на месте.Щёлкните правой кнопкой мыши по текстовой ячейке: пункты меню Преобразовать и генераторы значений готовят изменение на месте.
Щёлкните правой кнопкой мыши по текстовой ячейке: пункты меню Преобразовать и генераторы значений готовят изменение на месте.

Вставьте сгенерированное значение или SQL-функцию

То же меню заполняет ячейку сгенерированным значением:

  • Установить новый UUID записывает свежий случайный UUID, сгенерированный на вашей машине. Предлагается для столбцов UUID и обычных текстовых столбцов, достаточно широких для 36-символьной формы (не для JSON, XML, enum или SET столбцов).
  • Установить текущую метку времени (по локальным часам) записывает текущие дату и время вашего компьютера, приведённые к типу столбца (дата, время или дата и время).
  • SQL-функции подготовьте выражение, которое сервер вычисляет при сохранении, так что значение берется из базы данных, а не с вашего компьютера: время сервера, дата сервера (CURRENT_DATE, CURDATE(), CAST(SYSDATETIME() AS date)), генерируемый сервером UUID (NEWID(), gen_random_uuid(), UUID(), SYS_GUID(), uuid()), и текущий пользователь (SUSER_SNAME(), CURRENT_USER, USER).

Каждому движку соответствует свой вариант написания функции, а предварительный скрипт показывает точный SQL. Сетка отмечает отложенную функцию как <server date>, <server UUID>, и так далее, пока вы не сохраните. В редакторе строк отдельное для каждого поля меню Вставить перечисляет те же генераторы, и в подписи каждого пункта — SQL функции для вашего диалекта.

SQLite, libSQL и DuckDB не требуют входа, поэтому текущий пользователь не предлагается там. SQLite и libSQL не имеют функции UUID, поэтому UUID, сгенерированный сервером, записывается как 32 случайных шестнадцатеричных символа (lower(hex(randomblob(16)))). У Oracle SYS_GUID() также генерирует 32 заглавных шестнадцатеричных символа без дефисов, а не 36-символьную форму с дефисами.

На подключении через релейный мост при открытии сеанса мост сообщает, какие возможности поддерживает его версия SQLLY. Дата сервера, генерируемый сервером UUID, и текущий пользователь предлагаются только если мост их поддерживает; со старым мостом, который отклонил бы всю правку целиком, меню сетки их скрывает, а в редакторе строк они показаны неактивными с предложением обновить мост. Время сервера, Установить новый UUID, а метка времени по локальным часам работает с любым мостом. Ожидающие применения правки сетки сохраняются через реле так же, как локально, — одной транзакцией, которая откатывается, если какая-то строка изменилась в базе, когда мост это поддерживает. На более старом мосту панель ожидающих изменений пишет Для сохранения нужна более новая версия моста и Сохранить изменения остается отключенной, в то время как редактор строк все еще сохраняет строки по одной за раз.

Найти и заменить в сетке

Нажмите Найти в сетке сочетание клавиш, или щелкните правой кнопкой мыши и выберите Инструменты › Найти и заменить в сетке…, и введите текст в поле поиска. Поле замены — под ним. Заменить перезаписывает выделенное совпадение и Заменить всё заменяет каждое совпадение. Регистр не учитывается, и заменяется каждое вхождение внутри совпавшей ячейки. Текст поиска используется ровно так, как вы его ввели, включая пробелы в начале и в конце, поэтому замена меняет ровно тот текст, который выделила сетка.

Замены превращаются в подготовленные изменения ячеек и никогда не пишутся в базу напрямую. «Заменить всё» — один шаг отмены, а вкладка «Сообщения» сообщает, сколько ячеек и строк подготовлено. Замена трогает только ячейки, которые можно безопасно переписать: редактируемые текстовые столбцы. Совпадения в ключевых, identity, вычисляемых, rowversion, с ограничением enum, числовых, датовых, JSON и XML столбцах пропускаются, как и NULL-ячейки — даже если сетка показывает их как NULL. Столбец результатов, который является выражением, также пропускается, даже если он имеет то же имя, что и столбец таблицы (SELECT id, left(body, 50) AS body): записываются только столбцы, которые запрос выбирает напрямую из таблицы. Строки, уже подготовленные для удаления, пропускаются, так же как и ячейки, содержащие подготовленную SQL-функцию, такую как <server UUID>. Замена работает с тем значением, которое вы видите, поэтому она основывается на любом содержимом, уже подготовленном в этой ячейке. Каждая строка сохраняет собственный механизм оптимистического контроля параллелизма: свои исходные значения и свою собственную версию строки (rowversion), если результат включает её.

«Заменить всё» охватывает строки, которые искала панель поиска. На очень большом результате, который SQLLY хранит на диске, поиск идёт только по строкам, загруженным вокруг вашей позиции прокрутки, и останавливается после 100 000 совпадений. Когда действует любое из этих ограничений, вкладка Сообщения точно сообщает, какие строки были охвачены, например 100 загруженных строк (3001–3100 из 5000). Прокручивайте или запустите «Заменить всё» ещё раз, чтобы добраться до остальных.

SQLly
Панель поиска по сетке со строкой замены: совпадения становятся черновыми правками, которые просматривают и сохраняют как обычные ручные правки.Панель поиска по сетке со строкой замены: совпадения становятся черновыми правками, которые просматривают и сохраняют как обычные ручные правки.
Панель поиска по сетке со строкой замены: совпадения становятся черновыми правками, которые просматривают и сохраняют как обычные ручные правки.

Копировать подготовленные изменения как SQL

Иногда нужен скрипт, а не сохранение: чтобы вставить его в тикет, прогнать через процесс развёртывания или сначала обсудить его с коллегой. Когда изменения подготовлены, нажмите Копировать как SQL на панели ожидающих изменений, на вкладке Предварительный просмотр SQL или в диалоге Подтвердить подготовленные изменения диалоге. Вы также можете выполнить Результаты: копировать подготовленные изменения как SQL через палитру команд. Скрипт создается в момент нажатия, поэтому даже изменение, сделанное мгновение назад, всегда включено. Копирование никогда не сохраняет и не удаляет ничего. Ваши изменения остаются подготовленными, пока вы не сохраните или не отмените их.

Скопированный скрипт содержит те же инструкции, что Предварительный просмотр SQL, в той же обёртке транзакции, но она не совпадает байт в байт с тем, что отправляет сохранение. Сохранение передаёт значения как параметры, а скрипт подставляет их как литералы. Сохранение также требует, чтобы каждая UPDATE и DELETE меняла ровно одну строку, и откатывает весь пакет, если это не так, потому что строка была изменена или удалена с момента её загрузки. Скрипт выполняет эту проверку там, где движок может её выразить:

  • SQL Server: после каждого оператора следует IF @ROWCOUNT <> 1 THROW …, и SET XACT_ABORT ON откатывает транзакцию.
  • PostgreSQL и совместимые движки (кроме CockroachDB): каждый оператор выполняется в DO блоке, который проверяет количество строк и вызывает ошибку, что прерывает транзакцию.
  • Oracle: каждый оператор выполняется в блоке PL/SQL, который проверяет SQL%ROWCOUNT. Запустите скрипт с WHENEVER SQLERROR EXIT ROLLBACK (SQL*Plus или SQLcl), чтобы неудачная проверка отменяла и предыдущие операторы.
  • MySQL, MariaDB, SQLite, libSQL, DuckDB и CockroachDB не имеют способа проверить количество строк в обычном скрипте. Каждая инструкция отмечена -- expect 1 row, так что проверяйте количество сами.

В SQL Server сохранение также считывает вставленные строки с помощью OUTPUT INSERTED.*. Скрипт не включает это. Комментарий в шапке скрипта повторяет эти различия.

SQLly
Копировать как SQL в предварительном просмотре подготовленных изменений: скрипт ожидающих применения изменений копируется в буфер обмена без выполнения.Копировать как SQL в предварительном просмотре подготовленных изменений: скрипт ожидающих применения изменений копируется в буфер обмена без выполнения.
Копировать как SQL в предварительном просмотре подготовленных изменений: скрипт ожидающих применения изменений копируется в буфер обмена без выполнения.