Sign in Join
Wiki copytemporary

Firebird embedded/ru: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

OldNewLine
11## Что это такое
22
33Firebird Embedded - это специальная версия сервера баз данных [[Firebird/ru|Firebird]]. Она позволяет вам запускать ваши программы без выделенного (прим.перев.: предварительно запущенного) сервера базы данных. Вместо этого вы добавляете библиотеку (.dll/.so/.dylib) в свое приложение) и позволяете вашему приложению получать доступ к файлу базы данных Firebird .fdb с помощью этой библиотеки.
44
55Это похоже на работу таких программ, как Microsoft Access и LibreOffice Base.
66
77Преимущества:
88
99- работает на многих архитектурах (Linux, macOS, Windows, FreeBSD, Solaris)
1010- отдельная настройка сервера не требуется, что снижает сложность использования
1111- вы можете легко переключаться с embedded на полноценный клиент/сервер - без изменения строк кода (кроме строки подключения). Это, вероятно, хорошее преимущество по сравнению с sqlite.
1212- прим.перев.: не требуется пароль (он может быть произвольным)
1313
1414Недостатки:
1515
1616- только однопользовательский доступ
1717- необходимо распространять некоторые библиотеки вместе с вашей программой при ее распространении (если вы не можете статически связать их)
1818
1919## Предупреждение: Windows x64
2020
2121> **Warning:** В версиях FPC ниже FPC 2.7.1 r23738 (март 2013 г.), FPC x64 в Windows не очень хорошо работает с embedded dll Firebird или другими DLL. Раздел ниже содержит обходной путь, если у вас есть старая версия FPC
2222
2323В версиях FPC ниже 2.7.1 r23738 вы можете получать ошибки/исключения объекта IBConnection, даже если вы пишете правильный код(см., например, [Create database bug report](http://bugs.freepascal.org/view.php?id=21581).
2424
2525Обходное решение:
2626
27271. перейти к моментальному снимку разработки/версии FPC после FPC 2.7.1 r23738; см. [[User Changes 3.0|Exception handling has been changed to be ABI-conformant]]
28282. если на FPC 2.7.1 ниже, чем r23738, скомпилируйте FPC с ключом `-dTEST_WIN64_SEH`, чтобы использовать новый код Структурированной Обработки Исключений (SEH) на Win64.
29293. использовать 32-битную FPC и Lazarus на Windows 64
3030
3131## Установка
3232
3333В Windows встроенный Firebird и обычные клиентские библиотеки Firebird - это разные файлы. Встроенный Firebird всегда может служить обычным клиентом, что делает его логичным выбором для включения в вашу установку.
3434
3535### Windows
3636
3737Загрузите и разархивируйте комплект embedded Firebird. Убедитесь, что файлы .dll и .manifest находятся либо:
3838
3939- в каталоге вашего проекта и в каталоге исполняемых файлов (где генерируется .exe), либо
4040- в каталоге в вашем PATH (не в системном каталоге) (полезно, если вы не хотите сохранять скопированные dll)
4141
4242Обратите внимание, что битность должна совпадать: вы должны использовать embedded x64 версию, если вы компилируете свою программу под 64-бит, и embedded x32, если вы пишете 32-битные программы. Также убедитесь, что файлы .dlls и .manifest размещены в выходном (исполняемом) каталоге вашего проекта, и распространяйте их вместе с приложениями и файлами лицензий.
4343
4444Как указание, минимально необходимыми файлами для Firebird 2.5 являются:
4545
4646- fbembed.dll
4747- firebird.msg
4848- ib_util.dll
4949- icudt30.dll
5050- icuin30.dll
5151- icuuc30.dll
5252- IDPLicense.txt
5353- IPLicense.txt
5454- Microsoft.VC80.CRT.manifest
5555- msvcp80.dll
5656- msvcr80.dll
5757
5858### Linux
5959
6060Для Debian, вероятно, похоже на Ubuntu: получите файлы библиотеки, а также символическую ссылку: например, /usr/lib/x86_64-linux-gnu/libfbembed.so linking для /user/lib/x86_64-linux-gnu/libfbembed.so.bla.x.y
6161
6262``` bash
6363aptitude install libfbembed2.5 firebird-dev
6464```
6565
6666По крайней мере, для Firebird 2.5+: не указывайте имя пользователя или пароль, так как это приведет к поиску security.fdb, что может привести к сбою в случае невозможности доступа к общесистемному security.fdb. Укажите роль RDB\$ADMIN в Firebird 2.5+, так как она должна дать вам полный контроль над файлом базы данных.
6767
6868Поместите эти файлы в каталог вашего проекта (для этого: проверьте, все ли это необходимо):
6969
70-`firebird/libfbembed.so (или возможно libfbembed.so.2.5)`\
71-`firebird.conf`\
72-`firebird/security.fdb #возможно, нет необходимости `\
73-`firebird/intl/fbintl`\
74-`firebird/udf/fbudf.so`
70+```text
71+firebird/libfbembed.so (или возможно libfbembed.so.2.5)
72+firebird.conf
73+firebird/security.fdb #возможно, нет необходимости
74+firebird/intl/fbintl
75+firebird/udf/fbudf.so
76+```
7577
7678Для Firebird 3 вам понадобится:
7779
78-`firebird/libfbclient.so`\
79-`plugins/libEngine12.so`
80+```text
81+firebird/libfbclient.so
82+plugins/libEngine12.so
83+```
8084
8185Вам нужно изменить переменную каталога плагинов. Если вы не можете этого сделать, вам нужно поместить libEngine в его оригинальный каталог.
8286
8387Установите это в firebird.conf (для этого: проверьте, все ли это необходимо)
8488
8589``` ini
8690RootDirectory=./firebird #замените на ваш каталог
8791DatabaseAccess = Full #наверное полезно
8892ExternalFileAccess = Full #наверное полезно
8993UdfAccess = Full #наверное полезно
9094#disable
9195#TempDirectories = /tmp #=> не удалось исправить проблемы блокировки /tmp/firebird
9296#TempDirectories = ~/tmp #=> не удалось исправить проблемы блокировки /tmp/firebird
9397```
9498
9599Перед запуском приложения необходимо установить 2 переменные среды. Предположим, что приложение установлено в /home/pascaldev/embed:
96100
97101``` bash
98102# сообщаем динамическому загрузчику, где найти embedded lib:
99103LD_LIBRARY_PATH=/home/pascaldev/embed/firebird
100104# сообщаем серверу, где искать файлы (сообщения, настройки и т. д.)
101105FIREBIRD=. #или используйте абсолютный путь: /home/pascaldev/embed
102106```
103107
104108Если вы поймали ошибку такую, как
105109
106-`EIBDatabaseError/ : DoInternalConnect :`\
107-` -Can't access lock files' directory /tmp/firebird`
110+```text
111+EIBDatabaseError/ : DoInternalConnect :
112+ -Can't access lock files' directory /tmp/firebird
113+```
108114
109115возможно, у вас лежат устаревшие файлы блокировки, принадлежащие другому пользователю. Удаление каталога /tmp/firebird работает, но проблема в том, что он будет воссоздан под вашими локальными разрешениями.
110116
111117См. [Как установить embedded Firebird на Linux or Mac?](http://www.firebirdfaq.org/faq51/) для подсказок по работе со встроенным Firebird на Linux или Apple macOS. Кто-то использовал embedded Firebird в FPC: [Более ранняя версия embedded Firebird на Linux](http://www.mwasoftware.co.uk/index.php?option=com_content&task=view&id=105).
112118
113119### macOS
114120
115121- todo: описать это, возможно адаптация [Более ранняя версия embedded Firebird на Linux](http://www.mwasoftware.co.uk/index.php?option=com_content&task=view&id=105) и особенно [Firebird Embedded на macOS](http://paulbeachsblog.blogspot.mx/2012/09/firebird-embedded-on-macosx.html)
116122
117123### FreeBSD
118124
119125- to do: описать это, возможно адаптация [Более ранняя версия embedded Firebird на Linux](http://www.mwasoftware.co.uk/index.php?option=com_content&task=view&id=105)
120126
121127## Коннект к серверу Firebird
122128
123129Как уже упоминалось, встроенный Firebird может работать как обычный клиент Firebird. Следовательно, использование встроенной библиотеки Firebird вместо клиент-серверной библиотеки Firebird может помочь сделать ваше приложение более гибким.
124130
125131> **Note:** по крайней мере, в Firebird Embedded 2.5.3 и FPC 2.6.4 есть ошибка, которая вылетает при закрытии соединения с удаленным сервером. Эта ошибка была исправлена ​​в транке FPC.
126132
127133## Использование
128134
129135Как только в вашем распоряжении окажутся подходящие библиотеки встроенного Firebird по правильному пути (см. выше), вам нужно указать, что вы подключаетесь к встроенной версии сервера, а не к клиент-серверной. Оставьте свойство hostname объекта *IBConnection* пустым. Остальные свойства работают так же, как в версии клиент/сервер, например DatabaseName - это полный путь к файлу .fdb или просто имя базы данных, если оно находится в том же каталоге, что и fbembed.dll. Кроме того, в старых версиях FPC (FPC 2.6.2+ это точно не нужно) может потребоваться установить для свойства UseEmbeddedFirebird значение true. Это свойство отсутствует в модуле SQLDB, но вам нужно добавить *ibase60dyn* в секцию uses.
130136
131137### Создание базы данных
132138
133139#### Использование Firebird ISQL
134140
135141Вы можете создавать базы данных с помощью приложения Firebird isql (например, как это предусмотрено в обычном пакете Firebird (клиент)). В Windows этот исполняемый файл должен находиться в том же каталоге, что и ваш fbembed.dll.
136142
137143> **Note:** isql ожидает библиотеку fbclient, а не fbembed; Вы можете скопировать и переименовать fbembed, например, в fbclient.dll в Windows, чтобы это исправить.
138144
139145Запустите **isql**, затем сделайте:
140146
141147``` sql
142148create database 'employee.fdb' user 'SYSDBA' password 'masterkey' page_size 16384 default character set UTF8;
143149exit;
144150```
145151
146152Удаление базы данных в основном означало бы удаление файла, но вы также можете запустить: **isql**
147153
148154``` sql
149155connect 'employee.fdb' user 'sysdba' password 'masterkey';
150156drop database;
151157commit;
152158exit;
153159```
154160
155161#### Программно
156162
157163Вы также можете создать базу данных из вашей программы. Программа в разделе [[Firebird embedded/ru|Создание тестовой базы данных]] ниже показывает, как вы можете обнаружить отсутствующие базы данных и создать их на лету.
158164
159165Аналогичная процедура может быть вызвана в приложениях Lazarus при инициализации вашей формы (событие FormShow).
160166
161167### Создание таких объектов, как таблицы, вьюхи, триггеры,...
162168
163169Создание объектов - как и большинство вещей - одинаково, что в embedded Firebird, что в Firebird. См. [[Firebird/ru|Программное создание объектов]]
164170
165171## Запуск набора тестов базы данных FPC
166172
167173Может быть полезно запускать среду тестирования базы данных FPC (в каталоге packages\fcl-db\tests), когда вы охотитесь за ошибками, пытаетесь выяснить, как что-то работает или улучшаете код базы данных.
168174
169175### Сообщаем платформе, какую базу данных использовать
170176
171177Вам нужно будет отредактировать INI-файл db test framework, чтобы сообщить исполняемому файлу теста, что ему нужно использовать вашу встроенную базу данных. См. [[Databases/ru|Выполнение тестов базы данных FPC]] для получения инструкций о том, как это сделать.
172178
173179### Создание тестовой базы данных
174180
175181Если вы настроили среду для использования Firebird, вам нужно будет подготовить среду для тестирования.
176182
177183Скопируйте библиотеки embedded Firebird и другие файлы для вашей архитектуры в тестовый каталог.
178184
179185Затем создайте тестовую базу данных - вручную или программно/
180186
181187#### Создание базы данных вручную
182188
183189**isql**
184190
185191``` sql
186192create database 'test.fdb' user 'SYSDBA' password 'masterkey' page_size 16384 default character set UTF8;
187193exit;
188194```
189195
190196#### Программное создание базы данных
191197
192198Вы можете программно создать базу данных. В приведенном ниже примере создается локальная встроенная база данных, но ее можно легко изменить на удаленную базу данных (измените имя хоста и, если необходимо, путь):
193199
194200``` pascal
195201program firebirdembeddedtest;
196202{$mode objfpc}{$H+}
197203
198204uses
199205 {$IFDEF UNIX}{$IFDEF UseCThreads}
200206 cthreads,
201207 {$ENDIF}{$ENDIF}
202208 Classes, SysUtils,
203209 sqldb, IBConnection {for Firebird};
204210
205211const
206212 // Имя для базы данных. Обязательно укажите одно и то же имя в вашем database.ini
207213 DatabaseFile = 'test.fdb'; //Разумное имя для тестовой базы данных, верно?
208214var
209215 Fire: TIBConnection;
210216
211217begin
212218 //Подключение к базе данных Firebird
213219 //Следующая строка нужна для довольно старых версий FPC
214220 //UseEmbeddedFirebird: = true;
215221 //Более новые версии сначала будут искать файл fbembed.dll в каталоге приложения автоматически
216222 //Использование встроенного (и fbembed.dll) или обычного клиент/сервера (fbclient.dll) требует использования ibase60dyn
217223 Fire:=TIBConnection.Create(nil);
218224 try
219225 Fire.HostName := ''; //должен быть пустым для embedded Firebird; должен быть заполнен для клиент/сервера Firebird
220226 Fire.DatabaseName := DatabaseFile; //(путь и ) имя файла
221227 // Имя пользователя и пароль не имеют значения для аутентификации, но вы получаете авторизацию в базе данных
222228 // на основе имени (и, возможно, роли), которое вы даете.
223229 Fire.Username := 'SYSDBA';
224230 Fire.Password := 'masterkey'; //пароль для SYSDBA по умолчанию
225231 Fire.Charset := 'UTF8'; //Отправка и получение строковых данных в кодировке UTF8
226232 Fire.Dialect := 3; //Никто больше не использует диалекты 1 или 2 (прим.перев.: это справедливо лишь в отношении новых проектов)
227233 Fire.Params.Add('PAGE_SIZE=16384'); //Мне нравится большой размер страницы (используется при создании базы данных). Полезно для больших индексов ⇒ больший возможный размер столбца
228234 // Выясните, есть ли база данных в каталоге приложения.
229235 // Если нет, создайте его. Примечание: это может не сработать, если у вас недостаточно прав.
230236
231237 // Если вы используете клиент / сервер, вам явно не нужна эта часть кода.
232238 if (not FileExists(DatabaseFile)) then
233239 begin
234240 writeln('Файл '+DatabaseFile+' не существует.');
235241 writeln('Создание базы данных Firebird embedded ...');
236242 // Создаем базу данных, поскольку она не существует
237243 try
238244 Fire.CreateDB; //Создаем файл базы данных.
239245 except
240246 on E: Exception do
241247 begin
242248 writeln('ОШИБКА при создании базы данных. Возможно проблемы с загрузкой встроенной библиотеки:');
243249 writeln('- не все файлы присутствуют');
244250 writeln('- неправильная архитектура (например, 32 бит вместо 64 бит)');
245251 writeln('Exception message:');
246252 writeln(E.ClassName+'/'+E.Message);
247253 end;
248254 end;
249255 Fire.Close;
250256 end;
251257 finally
252258 Fire.Free;
253259 end;
254260end.
255261```
256262
257263### Запуск набора тестов
258264
259265Наконец, скомпилируйте и запустите *dbtestframework.pas* программы тестирования базы данных. Он должен генерировать вывод состояния на консоли и вывод XML в файлах с результатами теста, которые можно проанализировать и отправить разработчикам.
260266
261267## Внешние ссылки
262268
263269- [Как настроить embedded Firebird для Linux или Mac?](http://www.firebirdfaq.org/faq51/) (англ.)
264270- [Более ранняя версия embedded Firebird на Linux](http://www.mwasoftware.co.uk/index.php?option=com_content&task=view&id=105)(англ.)
265271
266272---
267273*From the Free Pascal wiki, page "Firebird embedded/ru", as it stood on 2020-01-26 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).*

Back to history