ШІ-інструменти та скрипти
Database Schema Handbook: словник даних і ERD за вашою схемою
Для команд, які успадковують базу даних або передають її іншим: скрипт розбирає файли схеми чи міграції, а агент складає словник даних, ERD, посібник зі зв'язків і зауваження з посиланнями на рядки в джерелі, які ви перевіряєте. Словник даних і діаграма зв'язків за файлами вашої бази даних.
Що ви отримаєте: 1 файл · 109.22 KB · ZIP
Переглянути варіанти купівліОпис товару
Опис
Для розробників, агенцій і команд, які успадковують базу даних, передають її іншим або мають пояснити її новому колезі чи клієнтові.
Передайте своєму агентові файли схеми самої бази даних. Агент складе довідник зі схеми, який ви перевірите: словник даних, діаграму, опис зв'язків словами та список зауважень.
Він читає schema.sql, файл pg_dump --schema-only, дамп MySQL, схему SQLite або папку SQL-міграцій, що застосовуються по черзі. Підключення до бази даних не відбувається.
Значення, які агент виводить сам, позначаються як припущені й лишаються неперевіреними, доки ваша команда їх не підтвердить. Представлення, функції та тригери перелічуються, але не описуються.
Що агент пише під час кожного запуску
data-dictionary.mdіdata-dictionary.csv: кожна таблиця й стовпець із типом, допустимістю null, значенням за замовчуванням і ключами, зміст простою мовою та підстава цього змісту: коментар у схемі, обмеження, висновок із назви, ваші слова або невідомо.erd.mmd: діаграма Mermaid, яку можна вставити у вікі чи README.relationships.md: кожен зовнішній ключ словами із зазначенням рядка в джерелі, зв'язки багато-до-багатьох і приклади з'єднань для найпов'язаніших таблиць.findings.md: фактичні спостереження, у кожному з яких названо таблицю чи стовпець і вказано файл та рядок. Приклади: таблиці без первинного ключа, зовнішні ключі без допоміжного індексу, невідповідність типів через зовнішній ключ, грошові стовпці з типом числа з плаваючою комою, стовпці дати й часу без часового поясу, дубльовані індекси.handbook.html: одна самодостатня сторінка з вбудованою діаграмою, усіма таблицями, зв'язками, зауваженнями та відкритими запитаннями. Друкується як є.
Читає скрипт, пояснює агент
Вбудований скрипт розбирає DDL для PostgreSQL, MySQL і SQLite, застосовує оператори ALTER та міграції по черзі й записує файл і рядок кожної таблиці, стовпця, ключа та індексу. Потім агент пише, що означають кожна таблиця й стовпець. Команда check відхиляє словник із пропущеною таблицею чи стовпцем, застарілим типом або порожнім змістом.
Лише ваша схема
Навичка велить агентові позначати кожне виведене значення, а те, чого він знати не може, оформлювати як запитання [NEEDS: ...] для вашої команди замість того, щоб заповнювати самому.
Чесно про обмеження
Він документує структуру так, як її оголошено у файлах. Кількість рядків, якість даних, використання індексів і те, що застосунок робить під час роботи, у цих файлах відсутні, тому їх немає й у довіднику. Значення, виведені з назв, - це чернетки для підтвердження. Представлення, функції, процедури, тригери й обмеження виключення перелічуються з указанням рядків і не описуються. Парсер толерантний, але не повний: файли SQL Server і Oracle не пробували. Зауваження за назвами - це евристики, і кожне може бути свідомим вибором. Читання ORM-моделей (Prisma, Django, Rails) виконує агент за шаблоном, і як тестовий випадок воно не запускалося. HTML-сторінку та її діаграму перевіряли як розмітку, а не в браузері; на великій схемі діаграма виходить високою, а лінії можуть перетинатися.
Арабська мова
На запит довідник пишеться арабською зі сторінкою справа наліво; назви таблиць і стовпців залишаються зліва направо.
У комплекті: SKILL.md, скрипти на Python зі стандартною бібліотекою, довідкові матеріали (читання схем, написання змісту, посібник із зауважень, нотатки щодо арабської), шаблони та розібраний приклад, який можна прочитати до купівлі: база даних запису до клініки на PostgreSQL з 15 таблицями, 116 стовпцями та 19 зовнішніми ключами, що дає 35 спостережень і 33 відкриті запитання.
Перевірено на двох випадках (дамп PostgreSQL англійською; магазин на MySQL із 8 міграцій арабською). Скрипти мають 52 модульні тести.
Коротко
Для розробників, агенцій і команд, які отримують базу даних, передають її або мають пояснити новому колезі чи клієнтові.
Передайте своєму агентові файли схеми бази даних (schema.sql, дамп або папку файлів міграцій). Він складе чернетку довідника, яку ви перевірите: словник даних, діаграму зв'язків, пояснення зв'язків і список зауважень. До бази даних він не підключається взагалі.
Що пише агент
- Файл
data-dictionary: кожна таблиця й стовпець із типом, ключами та змістом, а також джерело цього змісту. - Файл
erd.mmd: діаграма зв'язків у форматі Mermaid. - Файл
relationships.md: кожен зв'язок, описаний словами, із прикладами з'єднань. - Файл
findings.md: фактичні зауваження, при кожному з яких указано ім'я файлу й номер рядка. - Файл
handbook.html: одна сторінка, готова до друку.
Обмеження
Довідник документує структуру лише так, як вона записана у файлах, і не бачить самих даних та того, що робить застосунок. Значення, виведені з назв, - це чернетки, які потребують вашого підтвердження, а те, що невідомо, записується запитанням для вашої команди. Підтримуються PostgreSQL, MySQL і SQLite. Довідник можна запросити арабською; це пробували на одному тестовому випадку.
Запитання
Чи підключається він до моєї бази даних?
Ні. Він читає файли схеми на вашому диску й більше нічого.
Які бази даних він читає?
Файли схем PostgreSQL, MySQL і SQLite або папку SQL-міграцій, що застосовуються по черзі. SQL Server і Oracle не пробували.
У мене лише міграції, файлу схеми немає.
Вкажіть папку. Скрипт застосує міграції по черзі, зокрема перейменування та видалені стовпці, і збереже коротку історію.
Як він дізнається, що означає стовпець?
Із коментарів у схемі, обмежень і назв або з ваших слів. Кожне значення позначається підставою, а те, що лишається невідомим, записується як запитання.
Чи скаже він, що моя схема неправильна?
Він перелічує спостереження із зазначенням рядків у джерелі, щоб ваша команда їх перевірила. Кожне з них може бути свідомим вибором.
Чи може довідник бути арабською?
Так, зі сторінкою справа наліво та ідентифікаторами, що лишаються зліва направо. Це пробували на одному тестовому випадку.
Що ви отримаєте
1 файл · 109.22 KB
- schema-handbook-1.0.0.zipZIP · 109.22 KB
ШІ-інструменти та скрипти
Database Schema Handbook: словник даних і ERD за вашою схемою
Для команд, які успадковують базу даних або передають її іншим: скрипт розбирає файли схеми чи міграції, а агент складає словник даних, ERD, посібник зі зв'язків і зауваження з посиланнями на рядки в джерелі, які ви перевіряєте. Словник даних і діаграма зв'язків за файлами вашої бази даних.
Getly відкрив завантажені файли й не знайшов нічого, що завадило б їх відкрити. Це не антивірусна перевірка і не оцінка якості.
Теги
Поширені запитання
Чи отримаю я доступ одразу?
Так. Це цифровий товар: ви можете завантажити його одразу після оплати, просто зі своєї бібліотеки.
Чи можна використовувати його в комерційних проєктах?
Так. Комерційне використання дозволено: користуйтеся в особистому бізнесі та в тому, що продаєте. Ви не можете перепродавати чи поширювати сам файл.
Яка у вас політика повернення коштів?
Ви можете запросити повернення коштів протягом 30 дн. Якщо щось не так, подайте запит зі свого замовлення, і команда Getly його розгляне.
Які формати та розміри файлів я отримаю?
Ви завантажите 1 файл - ZIP - загалом 109.22 KB.
Чи отримую я безкоштовні оновлення?
Так: коли продавець випускає нову версію, ви можете повторно завантажити свіжі файли зі своєї бібліотеки безкоштовно. Останні оновлення дивіться в журналі змін.
Ціна
$7.00



