УРОК · От SQLite к MariaDB/MySQL

Таблица notes и проверочный перенос

Опубликовано Автор: Соловьёва Мария Андреевна

Создадим таблицу в notes_lab и перенесём в неё до двух настоящих строк из notes-php/data/notes.sqlite.

Разберём по шагам

После SQLite4 у таблицы notes четыре поля: id, title, body и необязательное created_at. Копирование файла .sqlite в MariaDB не переносит таблицу. Сохраните отдельный CLI-скрипт в корне notes-php: он прочитает первые две существующие заметки, создаст такую же смысловую схему в новой базе и вставит их подготовленным запросом. Новые id выдаст MariaDB; сверяем title, body и created_at. Исходный SQLite-файл и работающая страница не изменяются.

Слова, которые пригодятся

Схема
Описание таблиц, столбцов, типов и ограничений базы данных; здесь это четыре поля таблицы notes.
AUTO_INCREMENT
Выдача следующего числового id сервером при вставке строки.
utf8mb4
Набор символов для хранения Unicode-текста в MariaDB/MySQL.
Перенос данных
Создание структуры в новой базе и проверенная запись строк из SQLite, а не копирование файла другого движка.
Транзакция
Группа записей, которая фиксируется целиком после проверки или откатывается при ошибке.

Скрипт выполняется только в терминале и не меняет существующий src/db.php или веб-страницу. Он берёт не вымышленные демонстрационные значения, а первые две строки текущего файла SQLite. created_at из SQLite4 может быть NULL у старых записей; это отсутствие значения переносится без подстановки даты. Массовый перенос всех данных потребовал бы отдельной процедуры резервного копирования, повторного запуска и сохранения связей по id.

MariaDB выдаёт новый id через AUTO_INCREMENT, поэтому старый id здесь не копируется. VARCHAR(200) ограничивает столбец, а mb_strlen не даёт этому учебному переносу молча обрезать длинный заголовок. Проверка формы в PHP по-прежнему нужна для понятного сообщения пользователю. Транзакция группирует вставки и сверку: при ошибке вставленные строки откатываются, хотя уже созданная пустая таблица остаётся. Перед повтором проверьте её состояние.

Одна модель данных, разные движки
Свойство SQLite в первом проекте MariaDB в упражнении
Хранение Файл data/notes.sqlite Отдельный сервер и база notes_lab
Новый id INTEGER PRIMARY KEY BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY
Текст и дата TEXT для title, body и необязательного created_at VARCHAR(200) для title, TEXT для body и created_at, utf8mb4

Рабочий пример

<?php
declare(strict_types=1);
$source = __DIR__ . '/data/notes.sqlite';
if (!is_file($source)) {
    fwrite(STDERR, "Нет data/notes.sqlite: выполните шаги README.
");
    exit(1);
}
$drivers = PDO::getAvailableDrivers();
if (!in_array('sqlite', $drivers, true) || !in_array('mysql', $drivers, true)) {
    fwrite(STDERR, "Для этого PHP нужны pdo_sqlite и pdo_mysql.
");
    exit(1);
}
if (!function_exists('mb_strlen')) {
    fwrite(STDERR, "Для этого PHP нужен mbstring.
");
    exit(1);
}
$sqlite = new PDO('sqlite:' . $source, null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$columns = array_column($sqlite->query('PRAGMA table_info(notes)')->fetchAll(PDO::FETCH_ASSOC), 'name');
if (!in_array('created_at', $columns, true)) {
    fwrite(STDERR, "Сначала выполните php migrate-created-at.php.
");
    exit(1);
}
$rows = $sqlite->query('SELECT title, body, created_at FROM notes ORDER BY id LIMIT 2')
    ->fetchAll(PDO::FETCH_ASSOC);
if ($rows === []) {
    fwrite(STDERR, "В SQLite нет строк: выполните php add-note.php.
");
    exit(1);
}
foreach ($rows as $row) {
    if (mb_strlen($row['title']) > 200) {
        fwrite(STDERR, "Название длиннее 200 символов; выберите другие учебные строки.
");
        exit(1);
    }
}
fwrite(STDOUT, 'Пароль notes_app: ');
$password = rtrim((string) fgets(STDIN), "\r
");
if ($password === '') {
    fwrite(STDERR, "Нужен пароль notes_app.
");
    exit(1);
}
$mysql = new PDO(
    'mysql:host=127.0.0.1;port=3306;dbname=notes_lab;charset=utf8mb4',
    'notes_app',
    $password,
    [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false]
);
if ($mysql->query("SHOW TABLES LIKE 'notes'")->fetchColumn() !== false) {
    fwrite(STDERR, "Таблица notes уже есть: проверьте её до повторного переноса.
");
    exit(1);
}
$mysql->exec('CREATE TABLE notes (
    id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
    title VARCHAR(200) NOT NULL,
    body TEXT NOT NULL,
    created_at TEXT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4');
$mysql->beginTransaction();
try {
    $insert = $mysql->prepare('INSERT INTO notes (title, body, created_at)
        VALUES (:title, :body, :created_at)');
    foreach ($rows as $row) {
        $insert->execute($row);
    }
    $copied = $mysql->query('SELECT title, body, created_at FROM notes ORDER BY id')
        ->fetchAll(PDO::FETCH_ASSOC);
    if ($copied !== $rows) {
        throw new RuntimeException('Перенесённые значения не совпали с SQLite');
    }
    $mysql->commit();
} catch (Throwable $error) {
    $mysql->rollBack();
    throw $error;
}
echo 'Перенесено и сверено: ' . count($rows) . PHP_EOL;

Что здесь происходит

  • Проверки источника и драйверов идут до соединения и создания таблицы в notes_lab.
  • CREATE TABLE создаёт четыре поля один раз; при существующей таблице скрипт останавливается до вставки.
  • INSERT с параметрами переносит фактические строки, а SELECT сравнивает все три содержательных поля до фиксации транзакции.

Практика

Перенесите до двух заметок из существующего SQLite-файла в новую базу и сравните содержимое. Так вы увидите результат переноса данных до проверки отдельной записи из PHP.

  1. Из корня notes-php проверьте php -m и php -r "print_r(PDO::getAvailableDrivers());": нужны mbstring, pdo_sqlite и pdo_mysql (в списке PDO — sqlite и mysql). Если драйвера mysql нет, найдите конфигурацию командой php --ini, включите pdo_mysql для этого CLI PHP и повторите проверку. Убедитесь, что data/notes.sqlite содержит хотя бы одну строку и поле created_at из SQLite4.
  2. В Visual Studio Code создайте файл notes-php/bridge-copy.php, вставьте весь пример и сохраните Ctrl+S. Для установленной MariaDB оставьте port=3306 и в открытом в первом уроке терминале Ubuntu из корня notes-php выполните php -l bridge-copy.php, затем php bridge-copy.php. Для Docker Desktop замените в DSN этого файла ровно port=3306 на port=3307 и выполните те же команды в PowerShell на Windows из корня notes-php. Введите локальный пароль notes_app. Ожидайте Перенесено и сверено: 1 или 2 — по числу строк в исходной базе, но не более двух.
  3. В SQL-клиенте пользователя notes_app выполните SHOW CREATE TABLE notes; и SELECT id, title, body, created_at FROM notes ORDER BY id;. Сравните значения с исходными строками SQLite и запишите в README.md число перенесённых строк и отличие в выдаче новых id, без пароля. Не запускайте импорт повторно поверх существующей таблицы.

Как проверить себя

В notes_lab есть таблица notes с четырьмя полями и до двух реальных строк SQLite; скрипт подтвердил совпадение title, body, created_at. SQLite-каталог остался работоспособным.

Если не получилось
  • could not find driver? Проверьте драйверы именно того CLI PHP, которым запущен bridge-copy.php; SQL-клиент не устанавливает расширения PHP.
  • Таблица уже существует? Выполните SHOW CREATE TABLE notes; и SELECT COUNT(*) FROM notes; в notes_lab. Не удаляйте её вслепую: сначала выясните, есть ли там результаты прежнего запуска.
  • Русский текст не совпал? Сохраните bridge-copy.php как UTF-8 и проверьте charset=utf8mb4 в DSN и определение таблицы через SHOW CREATE TABLE notes;.

Куда заглянуть дальше