gregor Apr 9 2009 at 22:18

Mysql Documentor — простая утилита для документирования баз данных Mysql 5+

2 min

1.4K

Self Promo

+40

Comments 49

night_elf Apr 9 2009 at 22:32

Просто скачайте скачайте его с нашего сайта
исправьте

gregor Apr 9 2009 at 22:36

спасибо =)

kellas Apr 10 2009 at 04:01

Интересно.
Нагляднее любых презнтаций было бы демо её работы.
Не могли бы вы показать результат по какой-нибудь БД?

gregor Apr 10 2009 at 04:22

Думаю, вполне мог бы. Сейчас сделаю.

gregor Apr 10 2009 at 04:53

Наслаждайтесь: http://softuniq.com/mydoc_sample/

spike_msu Apr 10 2009 at 04:52

Презентация ни о чем. Одни слова. Где презентация утилиты?
Сайта лежит «Internal Server Error».

Стоит ли вообще на это тратить свое время?

gregor Apr 10 2009 at 04:56

Экспериментировал с mod_rewrite, а вы как раз увидели кратковременное помутнение =) Сейчас уже всё хорошо. Спасибо, что заметили и сказали.

shx Apr 10 2009 at 05:04

Поздравляю, поздравляю от всей души, но в любой нормальной IDE да і в Браузерах БД видно все то же самое и даже больше. Зачем лишние телодвижения?

gregor Apr 10 2009 at 05:13

История создания MyDoc очень проста: рядом с документацией по коду, сгенерированной phpDocumentor-ом, нужно было положить такую же по БД, либо зайти на вики и описать всё там.

Что удивительно, автоматически построенные статические страницы, на которых нет ничего лишнего, почему-то всем понравились больше.

shx Apr 10 2009 at 05:15

О, так-то лутчше :) Значит тулза для создания документации по своим продуктам, с этой точки зрения очень полезно.
Спасибо за коментарий

gregor Apr 10 2009 at 05:51

В общем-то можно и по чужим =). Главное, чтобы был доступ к схеме данных и к схеме mysql_schema.

shx Apr 10 2009 at 06:09

Я старался быть политкоректным ;) Естественно по чужим тоже :) У нас в СНГ с интелектуальной собственностью не будет никогда все нормально.
Страна в которой мы родились нас так воспитала — все общее — слава СССР ;)

gregor Apr 10 2009 at 06:10

Слава роботам! считаю =)

kellas Apr 10 2009 at 05:12

А на мой взгляд идея отличная, вот только над интерфейсом может немного поработать, сделать более наглядным.
Как вариант, сделать таблицу-дерево, типа www.hanpau.com/index.php?page=jqtreetable

gregor Apr 10 2009 at 05:14

Мы уже планируем выдавать схему в виде дерева на Graphwiz и в примерно в таком виде, в котором хотите вы. Нужно только подождать одного из ближайших апдейтов.

UFO landed and left these words here

gregor Apr 10 2009 at 06:00

Мне очень нравится dbForge Studio. Он бесплатен для некоммерческого использования и много что умеет. В том числе и сравнивать схемы. Причём делает это очень неплохо и гибко. Кстати, у них есть вообще отдельный продут для сравнения и синхронизации схем.

gregor Apr 10 2009 at 06:09

продут = продукт

=)

morph Apr 10 2009 at 08:39

эх, ну когда же включат в ms sql комментирование полей…

gregor Apr 10 2009 at 08:55

о как. а его разве нет?

morph Apr 10 2009 at 13:08

я не встречал к сожалению. а как хорошо было бы, если разработчик имел возможность пояснить каждое поле, для чего итп. в самой базе. чтобы не приходилось обращаться к ЕР диаграммам

gregor Apr 10 2009 at 13:13

habrahabr.ru/blogs/i_am_advertising/56883/#comment_1526770

промахнулся со ссылкой «ответить» и ответил не в трэд =(

morph Apr 14 2009 at 04:26

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

dobriykot Apr 14 2009 at 07:26

Можно сделать селект к системной табличке sys.extended_properties. ;)

dobriykot Apr 11 2009 at 16:12

Оно там есть. ;) Могу даже скриншотик приложить, когда на работе буду.

gregor Apr 11 2009 at 19:35

Скриншотик это интересно, да =)

dobriykot Apr 11 2009 at 19:39

Придется ждать до понедельника. Но могу на словах объяснить: в студии жмете на таблицу правой кнопкой, потом «Изменить», и тыкаете на любой столбец. В его свойствах есть «Описание», у нас, в частности, широко используется.

gregor Apr 11 2009 at 19:44

Как вы считаете, имеет смысл сделать ридер для схем ms sql, учитывая то, что он на php? Или лучше сделать версию на, скажем, c#?

dobriykot Apr 11 2009 at 19:47

Лучше на php, я думаю. Исключительно опираюсь на опыт своей работы — в нашей конторе кроме Денвера на моем компьютере, вообще Апач нигде не стоит. А она (контора) не маленькая. :) Ну и конечно, приложением для десктопа пользоваться удобнее.

dobriykot Apr 11 2009 at 19:47

Ой, ошибся словом. Лучше на C#.

gregor Apr 11 2009 at 19:48

Апач для запуска утилиты не нужен — достаточно просто положить куда-нибудь php =)

Но из студии, наверное, лучше запускать экзешник, а ридеры/рендеры делать либами на C#?

dobriykot Apr 11 2009 at 19:51

Как не нужен?) Или я чего-то не понимаю, или php-скрипты просто так из проводника не работают? Лучше отдельной софтиной, чтоб тыкать на красивый ярлычок, и самому еще дописывать комменты. :)

gregor Apr 11 2009 at 19:56

Да, php-скрипты можно запускать и из проводника или ярлыком. Собственно, в корне дистрибутива есть cmd-скрипт, который вызывает стартер. Но php должен быть установлен на машине (то есть дистрибутив php должен быть раззипован в какую-то папку и, желательно, прописан в %path%).

Php довольно давно уже вырос из штанишек «скриптовалки для страницек» =)

dobriykot Apr 12 2009 at 09:45

А, блин! Вот я торможу… Апач — это ж вебсервер, а для работы php нужен php. :)) Но все равно, преимущество у C#, чтоб не ставить и не прописывать ничего лишнего.

pietrovich Apr 12 2009 at 10:40

Как вы считаете, имеет смысл сделать ридер для схем ms sql, учитывая то, что он на php? Или лучше сделать версию на, скажем, c#?

пишите на Java, только в комплект положите сразу несколько вариантов драйверов ибо все они имеют собственные недостатки.
на PHP работать с MS SQL дело гиморное(хотя может новые дрова что и поменяли), до сих пор без слез не могу вспоминать.

c# тоже хорошо, ноприйдется следить за совместимостью с mono (не всегда наличие базы MS SQL говорит о возможности запуска виндовых утилит, вполне возможны ситуации когда к окнас-серверу доступа нет, есть только к БД, тут то и пригодится кроссплатформенность)

gregor Apr 12 2009 at 12:49

Спасибо за советы. Про Java тоже были мысли, да.

dobriykot Apr 13 2009 at 11:46

В общем, вот:

gregor Apr 13 2009 at 11:58

спасибо! =)

morph Apr 14 2009 at 04:27

спасибо.
habrahabr.ru/blogs/i_am_advertising/56883/#comment_1533645

gregor Apr 10 2009 at 13:12

я просто с ms sql ещё не имел удовольствия работать. даже и не думал, что такой серьёзный продукт может как-то обходиться без возможности комментирования полей, если честно =)

вообще MyDoc написан таким образом, чтобы ему было всё-равно, что считывать и через что рендерить документацию. в случае с ms sql, можно бы было создать в схеме, например, служебную таблицу field_comments в которую писать комментарии к полям, а ридер схемы обучить этой таблицей пользоваться. правда средства управления эт овсё поддерживать не будут и для удобного комментирования всё-равно пришлось бы использовать какую-то свою тулу. но, в принципе, задаче вполне решаема и без помощи майкрософта =)

McDEN Apr 10 2009 at 18:37

вот спасибо большое! очень полезная утилита.

gregor Apr 10 2009 at 19:35

пожалуйста. =) было бы здорово, если бы вы как-нибудь рассказали, как применили.

shod Apr 10 2009 at 20:01

А вот я пользуюсь
PowerDesigner уже лет 10. Отличная программа. И умеет делать обратное построение схемы, существующей базы банных. Может и строить красивые отчеты по схеме, включая и триггера и процедуры. Программа для профессионалов — советую всем.

gregor Apr 10 2009 at 20:54

Power Designer — совершенно потрясающая штука, но дороговата, всё же =)

krolser Apr 14 2009 at 09:46

dev.mysql.com/workbench/
Кросплатформенность является ну очень большим плюсом.
Кроме того, сохранённый данной программой файл является зазипованным xml'ем. Можете хоть свой редактор написать :)

Ваше решение тоже имеет право на жизнь, но мне намного удобнее видеть схему бд ввиде «табличек и стрелочек», нагляднее.

gregor Apr 14 2009 at 11:04

Mysql Workbench это всё же «visual database design tool». Mysql Documentor — утилита для построения документации по БД. У них несколько разные задачи.

Тем не менее, в одном из ближайших релизов мы планируем и показать иерархию связей таблиц, и генерацию картинки на Graphwiz.

gibson Apr 10 2009 at 20:47

1. Когда, примерно, ожидать следующую версию?
2. Будет ли поддержка 4 (<4.1) ветки MySQL?

Код написан грамотно, приятно смотреть. Спасибо, за кодес.

gregor Apr 10 2009 at 21:01

1. Через несколько дней. Скорее всего в понедельник.

2. Мы пока не планируем по трём причинам. Первая — мы работаем с 5.0 и нам не нужно. Вторая заключается в том, что mysql_schema появилась только в 4.1 (или даже в 5.0, сейчас не вспомню), поэтому существующий Reader не умеет работать с ранними версиями Mysql. Третья причина — пока кроме вас никто этим не заинтересовался.

Кстати, вы можете самостоятельно написать ридер, который будет использовать конструкции типа 'show tables' и читать старые схемы. Если соберётесь писать, но что-то будет не понятно, то пишите, с удовольствием вам отвечу.

Спасибо за комплимент по поводу кода =)

gregor Apr 14 2009 at 11:00

Похоже, сегодня (во вторник) новой версии тоже не будет — несколько занят основной работой. На неделе сделаем. =)