Следующий ID

Команда iex:set-next-id позволяет изменить следующий ID, который будет использоваться при создании новых заявок или пользователей.

Это удобно, если после переноса базы данных, импорта данных или других операций необходимо продолжить нумерацию с определённого значения.

Команда изменяет только значение AUTO_INCREMENT в базе данных и не затрагивает уже существующие записи.

Для чего нужна команда

По умолчанию база данных автоматически увеличивает ID каждой новой записи.

Иногда требуется изменить это значение вручную. Например:

• после переноса базы данных;
• после импорта старых заявок или пользователей;
• при объединении нескольких баз данных;
• чтобы новые заявки начинались с определённого номера;
• чтобы визуально разделить старые и новые записи.

Например, если последняя заявка имеет ID 58342, можно установить следующий ID 100000. После этого новые заявки будут получать номера начиная с 100000.

Что можно изменить

Команда работает со следующими сущностями:

• заявки;
• пользователи.

Для заявок используется таблица tasks.

Для пользователей используется таблица users.

Запуск команды

Подключение к серверу по SSH

Откройте терминал и выполните:

php artisan iex:set-next-id

Если команда запущена без параметров, система сообщит об ошибке, так как необходимо указать, для какой таблицы требуется изменить следующий ID.

Изменение ID для заявок

Чтобы изменить следующий ID для новых заявок, выполните одну из команд:

php artisan iex:set-next-id orders 100000

После успешного выполнения новые заявки будут создаваться начиная с ID 100000, если указанное значение безопасно для текущей базы данных.

Изменение ID для пользователей

Чтобы изменить следующий ID пользователей, выполните:

php artisan iex:set-next-id users 50000

После этого новые пользователи будут создаваться начиная с ID 50000, если это значение больше текущего максимального ID и текущего значения AUTO_INCREMENT.

Изменение ID сразу для всех таблиц

Если необходимо одновременно изменить следующий ID для заявок и пользователей, выполните:

php artisan iex:set-next-id all 100000

Команда установит одинаковое значение для таблиц:

• tasks;
• users.

Используйте этот режим только в том случае, если обе таблицы должны продолжить нумерацию с одного значения.

Проверка без внесения изменений

Перед изменением рекомендуется проверить результат с помощью режима dry-run.

Например:

php artisan iex:set-next-id orders 100000 --dry-run

В этом режиме команда ничего не изменяет в базе данных.

Она только показывает, что произойдёт после применения изменений.

---

Что показывает режим Dry Run

Во время проверки отображается информация:

• таблица;
• текущий максимальный ID;
• текущее значение AUTO_INCREMENT;
• новый ID;
• результат проверки безопасности;
• возможность применения изменений.

Это позволяет заранее убедиться, что выбранное значение корректно.

Применение без подтверждения

По умолчанию команда запрашивает подтверждение перед изменением базы данных.

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

php artisan iex:set-next-id orders 100000 --force

Для рабочих серверов рекомендуется сначала выполнить проверку через --dry-run, а затем использовать --force.

Проверка безопасности

Перед изменением команда автоматически выполняет несколько проверок.

Изменение будет запрещено, если новый ID:

• меньше или равен существующему максимальному ID;
• меньше текущего значения AUTO_INCREMENT;
• равен 0;
• является отрицательным числом;
• не является целым числом;
• превышает максимально допустимое значение для типа BIGINT.

Это предотвращает конфликты идентификаторов и ошибки при создании новых записей.

Что выводит команда

Перед применением отображается план изменений.

Для каждой таблицы выводится информация:

• сущность;
• таблица;
• текущий MAX(id);
• текущий AUTO_INCREMENT;
• новый ID;
• результат проверки;
• статус выполнения.

Если хотя бы одна проверка завершится ошибкой, изменение выполнено не будет.

---

Пример использования

Предположим, необходимо, чтобы новые заявки начинались с номера 100000.

Шаг 1. Проверьте изменения

php artisan iex:set-next-id orders 100000 --dry-run

Убедитесь, что команда не сообщает об ошибках.

Шаг 2. Примените изменения

php artisan iex:set-next-id orders 100000

Шаг 3. Подтвердите выполнение

После подтверждения значение AUTO_INCREMENT будет изменено.

Новые заявки начнут создаваться с указанного ID.

Когда использовать

Команда может быть полезна в следующих случаях:

• после переноса базы данных;
• после восстановления резервной копии;
• после импорта заявок или пользователей;
• при объединении нескольких проектов;
• если необходимо продолжить нумерацию с определённого значения;
• если требуется визуально отделить старые записи от новых.

---

Частые ошибки

Новый ID меньше существующего

Команда не позволит уменьшить следующий ID.

Сначала убедитесь, что выбранное значение больше текущего максимального ID и значения AUTO_INCREMENT.

Команда сообщает об ошибке безопасности

Это означает, что указанное значение может привести к конфликту идентификаторов.

Проверьте вывод режима --dry-run и выберите большее значение.

Изменился технический ID, но номер заявки остался прежним

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

Команда изменяет только техническое поле id в базе данных и не влияет на пользовательские номера заявок, если они формируются отдельным механизмом.

---

Рекомендации

Перед изменением ID рекомендуется:

1. Создать резервную копию базы данных.
2. Выполнить проверку через --dry-run.
3. Убедиться, что выбранное значение больше текущего AUTO_INCREMENT.
4. Выполнять изменение в период минимальной нагрузки на систему.

---

Коротко

Команда iex:set-next-id позволяет безопасно изменить следующий ID для новых заявок и пользователей.

Она изменяет только значение AUTO_INCREMENT, не затрагивая существующие записи.

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