Після імпорту контенту, масового видалення записів, міграції або аварійного відновлення бази WordPress у таблиці wp_term_relationships можуть залишитися зв’язки з об’єктами, яких уже немає в wp_posts. Такі рядки називають orphaned taxonomy relationships, або «сирітськими» зв’язками.
Вони не завжди одразу спричиняють помітну помилку, але можуть спотворювати лічильники категорій і тегів, ускладнювати обробку таксономій та створювати некоректні результати під час роботи плагінів або власних запитів. Нижче — безпечний порядок перевірки, очищення та повторного підрахунку термінів.
Що таке orphaned-зв’язки в WordPress
WordPress зберігає призначення категорій, тегів і кастомних таксономій у таблиці wp_term_relationships. У ній є щонайменше два важливі поля: object_id — ідентифікатор запису або іншого об’єкта, та term_taxonomy_id — ідентифікатор терміна в конкретній таксономії.
Зв’язок вважається orphaned, якщо його object_id більше не відповідає жодному запису в wp_posts. Наприклад, запис могли видалити без коректного очищення пов’язаних рядків або відновити лише частину таблиць із резервної копії.
До wp_posts належать не тільки звичайні записи блогу. Там також зберігаються сторінки, вкладення та записи кастомних типів. Тому перевірка через wp_posts охоплює всі стандартні об’єкти, які можуть мати таксономії.
- неправильні або несвоєчасно оновлені лічильники термінів;
- зайві рядки в базі даних після імпорту чи масового видалення;
- некоректна робота архівів таксономій або плагінів, що напряму читають зв’язки;
- повільніші запити до таксономій на великих сайтах.
Підготовка: резервна копія та перевірка префікса
Очищення виконується безпосередньо в базі даних, тому перед змінами обов’язково створіть актуальний дамп. Резервна копія має бути доступною для відновлення, а не просто успішно сформованою на сервері.
У прикладах нижче використано префікс wp_. На конкретному сайті він може бути іншим, наприклад abc_ або site1_. Не підставляйте wp_ навмання: неправильний префікс призведе до помилки або перевірки не тієї таблиці.
Поточний префікс можна перевірити у конфігурації WordPress або через WP-CLI, якщо команда доступна у вашому середовищі.
- виконуйте команди з кореневої директорії потрібного WordPress-сайту;
- переконайтеся, що WP-CLI підключається саме до потрібної бази;
- для multisite перевіряйте, до якого сайту та набору таблиць належить операція;
- перед очищенням повідомте команду або клієнта про коротке технічне обслуговування, якщо сайт активно змінює дані.
wp db export before-taxonomy-cleanup.sql
Як знайти orphaned taxonomy relationships
Спочатку потрібно отримати кількість зв’язків, що посилаються на відсутні записи. LEFT JOIN залишає в результаті рядки з wp_term_relationships, для яких відповідний запис у wp_posts не знайдений. Умова p.ID IS NULL відбирає саме такі випадки.
Замініть wp_ на фактичний префікс таблиць і виконайте запит через WP-CLI.
wp db query "
SELECT COUNT(*) AS orphaned_relationships
FROM wp_term_relationships AS tr
LEFT JOIN wp_posts AS p ON p.ID = tr.object_id
WHERE p.ID IS NULL;
"
Додаткова перевірка перед видаленням
Якщо кількість не дорівнює нулю, не поспішайте одразу видаляти рядки. Спочатку подивіться кілька прикладів і перевірте, чи справді це зв’язки з неіснуючими об’єктами, а не помилка у назві таблиці або підключенні до іншої бази.
wp db query "
SELECT tr.object_id, tr.term_taxonomy_id
FROM wp_term_relationships AS tr
LEFT JOIN wp_posts AS p ON p.ID = tr.object_id
WHERE p.ID IS NULL
LIMIT 50;
"
Як безпечно видалити сирітські зв’язки
Після перевірки можна видалити лише ті рядки wp_term_relationships, для яких не існує відповідного запису в wp_posts. Запит не видаляє записи, терміни, таксономії чи медіафайли — він прибирає тільки некоректні зв’язки.
Для MySQL і MariaDB використовується DELETE із JOIN. Виконуйте його лише після створення резервної копії та повторної перевірки префікса таблиць.
- не змінюйте умову на ширшу без розуміння наслідків;
- не видаляйте всі рядки конкретної таксономії, якщо проблема стосується лише неіснуючих object_id;
- якщо сайт продовжує імпорт або масове видалення, спочатку зупиніть ці процеси, щоб дані не змінювалися під час очищення.
wp db query "
DELETE tr
FROM wp_term_relationships AS tr
LEFT JOIN wp_posts AS p ON p.ID = tr.object_id
WHERE p.ID IS NULL;
"
Якщо команда повертає помилку
Найчастіші причини — неправильний префікс, недостатні права користувача бази даних або інший тип СУБД. Перевірте підключення командою wp db cli чи виконайте спочатку безпечний SELECT-запит. Не замінюйте DELETE альтернативним масовим очищенням таблиці.
Перерахунок категорій, тегів і кастомних таксономій
Після видалення orphaned-зв’язків варто перерахувати лічильники термінів. Це допомагає синхронізувати збережені count-значення з фактичною кількістю пов’язаних об’єктів.
Для стандартних таксономій використовуйте WP-CLI-команди:
wp term recount category
wp term recount post_tag
Кастомні таксономії
Для кастомної таксономії вкажіть її системний slug, а не назву, яку бачить користувач в адміністративній панелі. Наприклад, якщо таксономія зареєстрована зі slug product_brand, команда буде такою:
wp term recount product_brand
Перевірка результату після очищення
Після DELETE повторіть початковий SELECT. У нормальній ситуації він має повернути нуль. Якщо orphaned-зв’язки з’явилися знову, проблема може бути не в одноразовому пошкодженні даних, а в імпорті, плагіні або власному коді, який створює зв’язки без перевірки існування запису.
Також перевірте кілька архівів категорій і тегів, сторінки записів та функціональність пошуку. На сайтах із кастомним типом записів перегляньте відповідні архіви окремо.
Окремо варто переконатися, що після очищення не зникли легітимні зв’язки. Запит видаляє тільки рядки, для яких немає object_id у wp_posts, тому чинні записи та їхні таксономії він не повинен зачіпати.
- повторно виконати COUNT-запит;
- перевірити лічильники термінів у потрібних таксономіях;
- переглянути сторінки архівів і кілька записів із категоріями та тегами;
- перевірити журнали імпортера, якщо проблема виникла після імпорту.
wp db query "
SELECT COUNT(*) AS orphaned_relationships
FROM wp_term_relationships AS tr
LEFT JOIN wp_posts AS p ON p.ID = tr.object_id
WHERE p.ID IS NULL;
"
Типові помилки під час очищення
Найнебезпечніша помилка — виконати масове видалення без резервної копії або використати неправильний префікс. Ще одна поширена проблема — плутати orphaned-зв’язки з «сирітськими» термінами. У цьому матеріалі йдеться про відсутні записи в wp_posts. Якщо потрібно перевіряти терміни, що не мають відповідного рядка в wp_terms або wp_term_taxonomy, це вже інша діагностика.
Не варто видаляти рядки вручну з wp_posts або wp_terms, щоб виправити лічильники. Так можна втратити контент або структуру таксономій. Спочатку визначте, який саме тип невідповідності є в базі.
Також не слід вважати будь-який ненульовий результат доказом серйозної помилки сайту. Частина плагінів або нестандартних процесів може тимчасово змінювати дані. Важливі контекст появи рядків і повторна перевірка після очищення.
- не використовуйте TRUNCATE для wp_term_relationships;
- не редагуйте базу під час активного імпорту або міграції;
- не запускайте команду для продакшну, якщо WP-CLI підключений до staging або іншої бази;
- зберігайте дамп до моменту, коли переконаєтеся, що сайт працює коректно.
Поширені запитання
Чи можна видаляти orphaned-зв’язки без резервної копії?
Технічно запит може виконатися, але робити це без резервної копії не варто. Помилка у префіксі, базі або SQL-умові може призвести до втрати даних, а дамп дозволить швидко відновити попередній стан.
Чи видалить цей запит самі записи або категорії?
Ні. Запит видаляє тільки рядки з wp_term_relationships, які посилаються на object_id, відсутній у wp_posts. Записи, терміни та таксономії він не видаляє.
Чому після очищення лічильники категорій залишилися неправильними?
Потрібно виконати wp term recount для відповідних таксономій. Якщо проблема зберігається, перевірте інші типи пошкоджених даних, кешування, фільтри плагінів або процес, який повторно створює некоректні зв’язки.
Чи стосується перевірка вкладень і кастомних типів записів?
Так. Вкладення та записи кастомних типів зазвичай також зберігаються в wp_posts, тому LEFT JOIN за object_id охоплює їх. Однак результати варто інтерпретувати з урахуванням логіки конкретних плагінів.
Висновок
Очищення orphaned taxonomy relationships — це точкова операція для видалення зв’язків із записами, яких більше немає в базі. Безпечний порядок дій такий: створити дамп, перевірити префікс, порахувати сирітські рядки, переглянути приклади, виконати обмежений DELETE і повторно перевірити результат.
Після цього перерахуйте терміни через WP-CLI та перевірте архіви сайту. Якщо некоректні зв’язки з’являються знову, шукайте причину в імпорті, міграції, плагіні або власному коді, а не запускайте очищення без аналізу щоразу.