DBCHM

🚩 О проекте

DBCHM — это инструмент для создания документов баз данных! Начиная с поддержки формата CHM, благодаря открытому исходному коду, коллективному мышлению и постоянному совершенствованию, были добавлены возможности экспорта в форматы Word, Excel, PDF, HTML, XML и Markdown.

🎯 Цель этого проекта — создание простейшего и самого полезного инструмента для создания документов баз данных!

🍀 Поддерживаемые базы данных

• DAMENG DM (DM8)
• SUNBIN OSCAR (V7.0.8)
• ZHONGKAO KINGBASE ES (KingbaseES v9: V009R001C001B0030)
• SQL Server
• MySQL
• Oracle
• PostgreSQL
• DB2
• SQLite

🥝 Основные функции

Какие данные содержатся в документах?

• Номер | Название столбца | Тип данных | Длина | Число знаков после запятой | Первичный ключ | Автозаполнение | Разрешено пустое значение | Значение по умолчанию | Описание столбца
• Виды | Конкретное содержимое видов
• Процедуры | Конкретное содержимое процедур🔹 Примечание: Для Oracle начиная с версии v1.8.0.3-beta отображение автозаполнения временно недоступно.

Какие форматы документов поддерживаются?

• CHM
• Word
• Excel
• PDF
• HTML
• XML
• Markdown

Как можно обновить комментарии к таблицам?

• Через меню "Инструменты" -> "Загрузка комментариев", выбирая файл для импорта:
  • PDM, созданное при проектировании базы данных с помощью PowerDesigner.
  • XML, созданное при установке свойства проекта Entity Class Library в Visual Studio.
  • XML, созданное через экспорт XML в DBCHM.
• Комментарии к столбцам можно массово обновить, выбрав строки перед редактированием и наклеив несколько строк текста.

🎉 Демонстрация работы

1 Пример конфигурации соединения с базой данных

2 Управление соединением с базой данных

3 Приближенное совпадение названий таблиц

### 4 Выполнение обновлений закомментированных записей ### 5 Экспорт файла CHM

6 Информация о структуре таблиц

7 Для просмотра других форматов скачайте версию для тестирования!!

Смотрите пример CHM: Структура таблиц в примере WeChat Framework.chm

📘 История выпусков

ReleaseNote

💪 Вкладчики

• @trycache Основной разработчик
• @пустота Предшественник

⬇️ Скачивание и использование

• Скачать выпуск версии, после распаковки дважды щелкните по DBCHM.exe.

• Скачать внутреннюю тестовую версию с новыми возможностями, чтобы узнать о исправленных багах и новых функциях, присоединитесь к !

🍄 Другие инструменты

• htmlhelp, установите перед созданием файла CHM.
• PDMToCHM, преобразование структуры PDM таблиц в файл CHM.

🌱 Разработка плана- [x] Сбор проблем, улучшение основных функций

• Усовершенствование библиотеки MJTop.Data

• Тестовый генератор данных

• Генератор кода C# сущностей

• Поддержка базы данных DM8

• ...## 📖 Часто задаваемые вопросы

• Не удается подключиться, что делать? 1. Введенные в интерфейсе "Настройки подключения к базе данных" данные "подключения" точно верны? 2. На сервере базы данных есть ограничения от "сетевых экранов/групп безопасности"? 3. Попробуйте подключиться с помощью Navicat Premium!

• При попытке подключения к базе данных кнопка "Подключиться/Тестировать" не реагирует длительно?

  Возможно, проблема связана с плохим интернет-соединением при подключении к удаленной базе данных. Установите значение "тайм-аута соединения" поменьше.- Dbchm подключается успешно, но данные не отображаются, что делать?

  • Перед экспортом документов, учетная запись базы данных должна иметь права доступа уровня "root". Подключение с аккаунта ниже уровня root может привести к неполной отображаемости таблиц или невозможности получения данных из-за недостаточных прав.

  • Проблема с dbchm, отправьте Issue или вступите в группу для обратной связи.

  • Хочу мигрировать примечания столбцов, как это сделать?

    1. Используйте функцию "Экспорт XML" в dbchm для экспорта текущих примечаний базы данных в xml-файл.
    2. Нажмите "Связь с данными", переключитесь на целевую базу данных.
    3. Используйте функцию "Загрузка примечаний", выберите только что созданный xml-файл. Если структура таблиц совпадает, примечания будут обновлены на целевой базе данных.

  • Как использовать dbchm с очень старой базой данных, такой как SQL Server 2000?

    1. Установите Navicat Premium.
    2. Подключитесь к серверу старой базы данных и выгрузите скрипт структуры таблиц.
    3. Создайте временную базу данных на более новом сервере и импортируйте выгруженные скрипты.
    4. Затем используйте dbchm для подключения к новому серверу базы данных.- Файлы CHM могут быть экспортированы нормально, но имя файла отображается некорректно, а при открытии показывает ошибку "Не удалось получить эту страницу" Одна из возможных причин — это настройки региона Windows, где активирована опция

    Beta: предоставление глобальной поддержки языков через Unicode UTF-8. Отмените этот выбор, чтобы исправить проблему.

• После подключения к Oracle базе данных, она не отвечает, кажется зависшей, что делать?

  Это связано с медленной производительностью запроса SQL для проверки свойства "является ли колонка автоинкрементируемой". Операция не зависла! Пожалуйста, будьте терпеливы!

🔹Примечание: Из-за высокой затратности времени при запросах автоинкрементных данных в Oracle, с версии v1.8.0.3-beta и далее запросы таких данных временно отключены.

PS: Если у вас есть лучшие предложения по улучшению, приветствуем ваши рекомендации, чтобы сделать этот инструмент ещё более удобным!

• При тестировании соединения с Oracle 11g и Oracle 12c отображается сообщение "[28040] ORA-28040: нет подходящего протокола проверки"? В настоящее время в группе и в разделе Issues были отмечены проблемы, которые могут возникнуть во всех версиях после OnClickListener.

Описание проблемы: инструменты Navicat и другие могут успешно подключаться, но наша программа не может подключиться и сталкивается с вышеуказанной проблемой.

Предложенное решение заключается в добавлении следующих настроек в файл sqlnet.ora:

SQLNET.ALLOWED_LOGON_VERSION=8
SQLNET.ALLOWED_LOGON_VERSION_SERVER=8
SQLNET.ALLOWED_LOGON_VERSION_CLIENT=8
```Значение параметров можно установить как 8, так и 10, и пользователи могут самостоятельно настроить эти параметры в зависимости от своих потребностей.

![](https://gitee.com/dotnetchina/DBCHM/raw/master/DBChm/Images/ORA-28040.png)

Обратите внимание: после выполнения этих действий пароли других связанных пользователей должны быть переопределены, либо они могут быть обновлены до старых значений (пример команды изменения пароля: `ALTER USER SYSTEM IDENTIFIED BY oldpassword`). Эта операция требует осторожности.

Либо этот параметр следует добавить сразу при создании базы данных и затем переопределить пароли связанных пользователей; либо создайте тестовую среду для проведения этой процедуры.

### Другие вопросы

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

Если у вас есть лучшие решения, приветствуем ваши предложения по улучшению или отправку pull requests, чтобы вместе усовершенствовать этот инструмент!## 🔗 Общение
- QQ группа: [Присоединиться к QQ группе](http://shang.qq.com/wpa/qunwpa?idkey=43619cbe3b2a10ded01b5354ac6928b30cc91bda45176f89a191796b7a7c0e26), рекомендуется нажать кнопку для входа в группу, если это невозможно, вы можете самостоятельно найти группу по номеру 132941648 и добавиться в неё). Все вопросы и идеи приветствуются в группе!