23 мая 2017 г.

Differences between Firebird and InterBase

InterBase was created in 1985: it was the first commercial multi-versioning database. In the end of 1999, Borland decided to close InterBase development and published its source codes under InterBase Public License. This code was copied (it is permitted by the license), and Firebird was born – from the version 1.0 Firebird is a production-ready database, based on previous decades of InterBase development.

Как не запутаться в зависимостях объектов ПИ

Уже миллион раз успел пожалеть, что сделал в Гедымине режим добавления объектов в ПИ "с зависимыми". Это мощная функция, которая требует от применяющего досконального знания теории реляционных баз данных, структуры конкретной БД, внутреннего устройства своего прикладного решения.

Добросовестная разработка с использованием данной галки требует следования определенной последовательности операций:

  1. Добавить объект в ПИ с зависимыми.
  2. Открыть список ПИ. Найти нужное и по-порядку, по списку входящих в него объектов, проверить что именно добавилось. Убрать лишнее.
  3. Открыть список зависимостей для выбранного ПИ и проверить какие зависимости добавились. При необходимости изменить.
  4. Сохранить ПИ в репозиторий.
  5. Взять чистый эталон и загрузить на него пакет (каждый функционально завершенный и обособленный модуль должен быть оформлен в виде пакета).
  6. Протестировать работоспособность загруженного пакета.
Очень важно! Добавление с зависимостями можно делать, если разработка ведется на отдельной, специально выделенной, чистой актуальной базе данных.

Почему?

Представим, что за основую для разработки прикладного пакета мы взяли старую клиентскую базу с данными:

  1. В такой базе может присутствовать целый букет устаревших, временных, давно забытых ПИ. При добавлении "с зависимостями" они подхватятся и затянутся в список зависимых ПИ.
  2. В таблицах на таких БД могут присутствовать устаревшие, уже не используемые поля. Мало того, что они затянутся в ПИ, так еще затянутся и объекты на которые они ссылаются.
  3. Устаревшие скрипт-функции могут привести к тому, что код, работающий на разработочной базе, не будет работать на чистой базе, собранной из актуальных ПИ.

Прозаическая реальность оказалась далека от ожиданий. Добавление с зависимостями применяется чтобы на скорую руку получить результат, а какого он будет качества мало кого волнует. Потом, когда выясняется что ПИ не устанавливается, требуется затратить в 10 раз больше усилий, чтобы распутать зависимости между объектами и файлами ПИ.

Если не уверен в себе и на все 100% не понимаешь что происходит "под капотом" системы, то каждый объект надо добавлять в ПИ вручную, по-отдельности, в порядке реляционной зависимости. Что особенно ценно, при добавлении вручную маловероятны ситуации "запутывания" связей между объектами или файлами ПИ.

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

Пример: пусть мы создаем небольшое прикладное решение, расширяющее стандартный пакет Зарплата и Кадры. Назовем его Наряды.

  1. Поскольку решение не велико, то объекты разобъем по следующим ПИ:
    • GS.Зарплата.Наряды.Метаданные -- домены, таблицы, триггеры и т.п.
    • GS.Зарплата.Наряды.Хранилище -- экранные формы.
    • GS.Зарплата.Наряды.Макросы -- перекрытые методы, локальные макросы форм.
    • GS.Зарплата.Наряды.Отчеты -- печатные формы.
  2. Зависимости настроим следующим образом:
    • GS.Зарплата.Наряды.Метаданные зависит от пакета GS.Зарплата.
    • GS.Зарплата.Наряды.Хранилище зависит от GS.Зарплата.Наряды.Метаданные.
    • GS.Зарплата.Наряды.Макросы зависит от GS.Зарплата.Наряды.Хранилище.
    • GS.Зарплата.Наряды.Отчеты зависит от GS.Зарплата.Наряды.Макросы.
  3. Создадим пакет GS.Зарплата.Наряды и сделаем его зависимым от GS.Зарплата.Наряды.Отчеты. Обратите внимание, что нет необходимости в пакете ставить зависимость от всех ПИ нашего решения, так как между ними итак уже присутствуют зависимости.
  4. Сохраним ПИ в файлы и расположим их в подкаталоге Наряды в папке Зарплата и кадры.
  5. Запишем в репозиторий.
  6. Подключимся к чистой эталонной базе данных ипоставим на загрузку пакет GS.Зарплата.Наряды. Проверим, чтобы загрузка не кидала ошибок. Проверим работоспособность после загрузки.

7 апр. 2017 г.

Большой размер кэша в Firebird 3.0

Сам уже дважды прокололся, поэтому хочу предупредить всех. 2.5 мы используем в режиме Classic и размер кэша не велик. Обычно 2000 страниц. С 3.0 основная идея -- это гигантский кэш, соизмеримый с размером БД, и значительный буфер под сортировку в ОЗУ. Например, при размере памяти сервера 128 Гб мы рекомендуем кэш 64 Гб и 32 Гб под буфер сортировки.

Пока активная база одна, проблем не возникает. Но, при попытке открыть вторую базу (например, чтобы свериться с архивом или испытать экспериментальные функции на тестовой копии), оперативной памяти сервера не хватит на размещение двух кэшей и начнется своппинг в файл подкачки. Производительность сервера драматически снизится.

В таком случае следует уменьшить буфер одной из баз данных с помощью утилиты командной строки:

gfix database_name -user SYSDBA -password sysdba_password -buffers 2000

31 янв. 2017 г.

15 лет потребовалось, чтобы добавить в Дельфи удобную функцию вставки SQL из буфера, которая в Гедымине появилась еще в начале нулевых. Причем в нашей платформе она работает в обе стороны.

21 янв. 2017 г.

Новые поля в GD_CURRRATE и встроенная функция пересчета валюты

После деноминации курсы некоторых валют (в частности российского рубля) стали такими маленькими, что требуют хранения минимум 6-ти знаков после запятой. Для базы данных всё равно (домен dcurrrate у нас имеет точность до 10-ти знаков после запятой), но если такое значение где-то пройдет через тип Currency сохранятся только четыре знака, т.е. произойдет потеря точности. Мы добавили в таблицу GD_CURRRATE два поля amount и val. Где val -- это курс валюты за количество единиц amount. Теперь для российского рубля можно использовать amount=100 и четыре знака после запятой, как это делает наш Национальный Банк, когда публикует валютные сводки. При amount=1, val=coeff. Пересчет полей происходит на триггере. Весь старый код, который читает или изменяет только поле coeff сохранил свою работоспособность.

Попутно мы внесли следующие улучшения:

  • Для курса валюты можно указать кто его установил. Например, курс Национального банка, курс Валютно-фондовой биржи, курс банка Васи Пупкина и т.п.
  • Для курса можно указать не только дату, но и время, если курс меняется несколько раз в течение дня.

Для пересчета сумм из одной валюты в другую (в том числе и с использованием кросс-курса) в платформу добавлена функция System.GetCurrRate.

6 янв. 2017 г.

Проект для исходников документации

У нас более-менее наведен порядок с исходным кодом платформы и прикладных решений, но для размещения исходных файлов документации не применялось никаких правил. Задавшись целью отыскать исходные DOC файлы к инструкциям, которые на нашем сайте доступны в формате PDF, где мы их только не находили. И в затерянных папках на рабочем столе, и вместе с исходным кодом программ, и рядом с клиентскими базами данных.

Пришло время навести порядок с помощью так любимого нами github-а. Создан проект gsbelarus/gedemin-doc, где собраны исходные файлы руководств пользователя и разработчика, учебные пособия, тесты для контроля знаний, презентации, макеты рекламных буклетов и т.п.

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

Актуальные файлы документации по программам POSitive:Cash & POSitive:Check вынесены в обособленный репозиторий gsbelarus/check-and-cash.

28 дек. 2016 г.

Под новый год количество просмотров статей на сайте документации перевалило за 3 миллиона! Это при том, что там же находятся десятки руководств в PDF статистика чтений которых никак не учитывается.

27 дек. 2016 г.

То, что нашей компании через месяц стукнет 23 года начинаешь осознавать, когда перед "взрослым" праздником приходится устраивать утренник для детей сотрудников.

8 дек. 2016 г.

External exception C0000006

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

Причиной может быть обрыв сетевого соединения, если выполняемый файл находится на сетевом диске.

Мы добавили в заголовок gedemin.exe, gedemin_upd.exe и gdcc.exe флаг IMAGE_FILE_NET_RUN_FROM_SWAP. Теперь при запуске программы с сетевого диска она будет целиком копироваться в swap файл локального компьютера. Это замедлит процесс начальной загрузки, но позволит избавиться от ошибки в случае обрыва соединения.

Для обновления следует взять архив с нашего сайта и переписать с заменой все файлы из него. Утилита автоматического обновления может не сработать, так как номера версий файлов не изменились.

Следует протестировать новый выполняемый модуль в сетях, где возникала указанная проблема. Если установка флага не поможет, то, возможно, следует аналогичный флаг установить и для всех динамических библиотек, используемых Гедымином.

Также в сети есть информация, что если ошибка появляется при работе в терминальных сессиях Windows Terminal Server 2008, то рекомендуется установить в реестре флаг:

Subkey: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MRxSmb\Parameters
Type: REG_DWORD
Entry: MultiUserEnabled
Value: 1

30 нояб. 2016 г.

Быстрая установка сервера Firebird 3

Здесь под "быстрая" мы имеем ввиду, что Firebird запускается в режиме максимальной совместимости с версией 2.5. Т.е. от нас не потребуется дополнительных усилий по настройке учетной записи SYSDBA и для существующих приложений не придется менять клиентские библиотеки.

Заходим сюда и скачиваем архив с новейшей версией сервера нужной нам разрядности.

Предположим, мы остановились на 32-х битной версии. Заходим в c:\Program Files и создаем там папку FB3.

Распаковываем содержимое скачаного архива в созданную папку.

Переходим в нее, находим и открываем на редактирование файл firebird.conf. Находим следующие параметры, убираем перед их именем символ комментария -- решетку и устанавливаем значения по списку ниже:
  • AuthServer = Legacy_Auth
  • AuthClient = Legacy_Auth
  • UserManager = Legacy_UserManager
  • WireCrypt = Disabled
  • WireCompression = false
Если на данном компьютере уже установлен Firebird, например версии 2.5, то изменим номер порта, чтобы избежать конфликтов. Номер по-умолчанию 3050. Установим, например, 3054:
  • RemoteServicePort = 3054
Сохраняем файл конфигурации.

В папку FB3\UDF подкладываем библиотеку GUDF.DLL, которую берем здесь (если устанавливается 64-х битная версия сервера, то библиотеку берем здесь).

Открываем окно командной строки. Перемещаемся в папку FB3 и выполняем три команды:
  1. instreg install
  2. instsvc install -a -n fb3
  3. instsvc start -n fb3
Теперь сервер работает и к нему можно подключаться. Если мы прописали порт 3054, как указано выше, то с этого же компьютера сетевое подключение будет выглядеть как localhost/3054.

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

29 нояб. 2016 г.

GDMNN: Задача #1

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

Цель:
  • Унифицировать механизмы фиксации и учета движения, обобщив и распространив их не только на движение ТМЦ, но и на движение (изменение, трансформацию) любого объекта учета.
  • Избавиться от дублирования данных и непрозрачных функций преобразования (поля документа => аналитические признаки в проводках).
  • Любое поле документа может быть использовано в качестве аналитического признака при построении отчетов.
  • Отойти от ограниченной структуры шапка-позиции. Для сложных документов предусмотреть наличие нескольких датасетов с произвольным уровнем вложенности. 
  • Для сумовых данных, используемых с целью ускорения выборок (INV_BALANCE), предусмотреть неблокирующую схему обновления, чтобы отказаться от автокомита в складских документах (комита частично введенного документа). 
  • Статус документа: черновик, отложенный, готовый.
  • Уменьшить размер базы и, как следствие, увеличить скорость операций по изменению и выборке. 
Для новой структуры представить запрос на построение журнала ордера с использованием SQL window functions и другого функционала Firebird 3.

21 нояб. 2016 г.

14-15 ноября для студентов курса "Бухгалтер-калькулятор в общественном питании", обучающихся в "Республиканском институте повышения квалификации и переподготовки работников Министерства труда и социальной защиты Республики Беларусь", были проведены занятия по программому комплексу на платформе Гедымин.