Firebird/ru: what changed

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

Old	New		Line
1	1		Это руководство по использованию базы данных Firebird в Lazarus/FPC, с использованием Firebird с SQLDB (встроенная библиотека базы данных FPC/Lazarus). Другие методы доступа описаны в разделе [[Other Firebird libraries\|Другие библиотеки Firebird]].
2	2
3	3		## Обзор
4	4
5	5		Firebird - это бесплатный сервер баз данных с открытым исходным кодом, который использовался и разрабатывался десятилетиями (он разрабатывался на основе базы данных Interbase 6, исходные коды которой были открыты компанией Borland). Он включает в себя расширенную поддержку операторов SQL (например, INSERT...RETURNING), хранимых процедур, триггеров и т.д. Вы можете написать скомпилированные библиотеки UDF (библиотеки пользовательских функций) для сервера в FreePascal, если вы хотите расширить и без того обширный список функций Firebird.
6	6
7	7		База данных требует очень мало ручной работы администратора баз данных после того, как она настроена, что делает ее идеальной для использования в малом бизнесе или для встроенного использования. При правильной настройке он может вырасти до терабайтного масштаба, хотя PostgreSQL может быть лучшим выбором для таких больших сред.
8	8
9	9		Firebird предлагает как встроенную (основанную на файлах), так и клиент-серверную базу данных - которую можно использовать без необходимости изменять одну строку кода в FPC/Lazarus. При использовании в качестве встроенной базы данных она предлагает более богатую поддержку SQL, чем [[SQLite]], а также плавную миграцию в базу данных клиент-сервер, хотя SQLite сама по себе является вполне встроенной базой данных.
10	10
11	11		Последняя стабильная версия, Firebird 2.5 (прим.перев.: на момент перевода статьи - это версия Firebird 3.0.4), работает в Windows (32- и 64-разрядная версия), различных версиях Linux (32- и 64-разрядная версия), Solaris (Sparc и Intel), HP-UX (PA-Risc) и macOS.
12	12
13	13		В настоящее время сервер портируется на Android; он пока недоступен в Windows CE/Windows Mobile.
14	14
15	15		Поддержка Firebird в SQLDB компилятора довольно хорошая, сравнимая с уровнем поддержки [[postgres\|PostgreSQL]].
16	16
17	17		## Документация
18	18
19	19		Официальная документация включена в FPC 2.6.2+: [Документация SQLDB для IBConnection](http://www.freepascal.org/docs-html/fcl/ibconnection/index.html)
20	20
21	21		## Установка режимов клиент/сервер и встроенного режима сервера
22	22
23	23		Firebird может работать в режиме клиент/сервер и в режиме встроенного сервера.
24	24
25	25		Client/Server означает, что у вас где-то есть физический сервер Firebird: либо на локальной машине, либо на другой машине, доступной по вашей сети. Соединения с сервером проходят через TCP/IP; при указании соединения имя хоста содержит имя или IP-адрес. Серверу Firebird для "общения" с вашими компонентами доступа необходима fbclient.dll/fbclient.so.nnn (вместе с его файлами поддержки).
26	26
27	27		Embedded Firebird означает, что ваше приложение для доступа к базе данных Firebird на локальной машине загружает единственную библиотеку, которая является и сервером, и клиентской библиотекой Firebird "в одном флаконе". При указании строки соединения имя хоста всегда пусто (не указывается). Серверу Firebird для "общения" с вашими компонентами доступа необходима fbembed.dll/fbembed.so (вместе с его файлами поддержки). См. [[Firebird embedded\|вики-страницу на Firebird embedded]] для более подробной информации.
28	28
29	29		Обратите внимание, что fbembed.dll может использоваться как для клиент-серверного, так и для встроенного использования, поэтому установка только этой dll может быть разумной задачей.
30	30
31	31		------------------------------------------------------------------------
32	32
33	33		Прим.перев.: необходимо уточнить, что выше описанное справедливо для версий FB 1.5, FB 2.0, FB 2.1 и FB 2.5. Начиная с версии FB 3.0, режим используемого сервера зависит от строки подключения, а клиентская библиотека на все случаи жизни одна - все та же fbclient.dll/libfbclient.so.3.0.n (где n - номер билда версии FB).
34	34
35	35		------------------------------------------------------------------------
36	36
37	37		### Windows
38	38
39	39		Win64: пожалуйста, см. предупреждение [[Windows Programming Tips\|здесь]] о нежелательном использовании некоторых версий FPC/Lazarus Win64.
40	40
41	41		Для Windows: (это относится ко всем драйверам базы данных SQLDB) необходимо иметь fbclient.dll (или fbembed.dll' ) и его поддержку dll, установленных в:
42	42
43	43		- каталог проекта и каталог вывода исполняемого файла/каталог приложения (например, lib /что-то еще в каталоге вашего проекта)
44	44		- или каталог в вашем PATH (не в системном каталоге)
45	45		- Если вы хотите использовать системный каталог, пожалуйста, используйте официальный установщик и поставьте галочку «скопировать fbclient в системный каталог»
46	46
47	47		Как и для всех библиотек DLL (базы данных), разрядность библиотеки DLL должна соответствовать вашему приложению: используйте 32-разрядную библиотеку для 32-разрядной скомпилированной программы и 64-разрядную библиотеку для 64-разрядной программы.
48	48
49	49		### Unix/Linux/macOS
50	50
51	51		В Linux/macOS/FreeBSD должна быть установлена клиентская библиотека Firebird (например, вашим менеджером пакетов; установите обычный пакет и пакет -dev), или они должны быть прописаны в путях поиска библиотеки.
52	52
53	53		FPC ищет наиболее распространенные имена библиотек (например, libfbclient.so.2.5, libgds.so и libfbembed.so.2.5; пожалуйста, проверьте ibase60.inc, если ваша версия отличается). При желании можно указать имя библиотеки. Есть 2 способа сделать это:
54	54
55	55		- использовать компонент [[TSQLDBLibraryLoader]] из sqldblib (FPC 2.7.1). Работает для всех компонентов коннектора SQLDB.
56	56		- вызвать функцию
57	57		``` pascal
58	58		function InitialiseIBase60(Const LibraryName : AnsiString) : integer;
59	59		```
60	60
61	61		с правильным именем библиотеки (для этого может потребоваться использовать модуль ibase60dyn).
62	62
63	63		## Примеры подключения
64	64
65	65		1\. Пример для client/server:
66	66
67		-	~~`Hostname: 192.168.1.1`\~~
68		-	~~`* База данных находится на сервере с IP-адресом 192.168.1.1.`\~~
69		-	~~`DatabaseName: /interdata/example.fdb `\~~
70		-	~~`* Имя файла базы данных - "example.fdb" в каталоге /interdata сервера (машина с IP-адресом 192.168.1.1).`\~~
71		-	~~`Username: SYSDBA`\~~
72		-	~~`Password: masterkey`~~
	67	+	```text
	68	+	Hostname: 192.168.1.1
	69	+	* База данных находится на сервере с IP-адресом 192.168.1.1.
	70	+	DatabaseName: /interdata/example.fdb
	71	+	* Имя файла базы данных - "example.fdb" в каталоге /interdata сервера (машина с IP-адресом 192.168.1.1).
	72	+	Username: SYSDBA
	73	+	Password: masterkey
	74	+	```
73	75
74	76		2\. Другой пример client/server:
75	77
76		-	~~`Hostname: dbhost`\~~
77		-	~~`* База данных находится на сервере с именем хоста dbhost`\~~
78		-	~~`DatabaseName: F:\Program Files\firebird\examples\employee.fdb `\~~
79		-	~~`* Имя файла базы данных - "employee.fdb" в каталоге Program Files\firebird\examples на диске F: dbhost.`\~~
80		-	~~`Username: SYSDBA`\~~
81		-	~~`Password: masterkey`~~
	78	+	``` pascal
	79	+	Hostname: dbhost
	80	+	* База данных находится на сервере с именем хоста dbhost
	81	+	DatabaseName: F:\Program Files\firebird\examples\employee.fdb
	82	+	* Имя файла базы данных - "employee.fdb" в каталоге Program Files\firebird\examples на диске F: dbhost.
	83	+	Username: SYSDBA
	84	+	Password: masterkey
	85	+	```
82	86
83	87		3\. Пример для embedded-режима:
84	88
85		-	~~`Hostname: <пустая строка>`\~~
86		-	~~`* Оставляя имя хоста пустым, выбирается embedded-режим.`\~~
87		-	~~`DatabaseName: test.fdb`\~~
88		-	`* Файл базы данных "test.fdb" находится в каталоге запускаемого приложения (убедитесь, что fbembed.dll находится в каталоге исполняемого файла приложения)`\
89		-	~~`Username: SYSDBA`\~~
90		-	~~`* Для встроенного сервера вы должны указать имя пользователя ...`\~~
91		-	~~`Password: <пустая строка> (`прим.перев.`: вообще-то, это может быть любая строка, в т.ч. и пустая)`\~~
92		-	~~`* ... но не важно, какой пароль вы укажете.`~~
	89	+	```text
	90	+	Hostname: <пустая строка>
	91	+	* Оставляя имя хоста пустым, выбирается embedded-режим.
	92	+	DatabaseName: test.fdb
	93	+	* Файл базы данных "test.fdb" находится в каталоге запускаемого приложения (убедитесь, что fbembed.dll находится в каталоге исполняемого файла приложения)
	94	+	Username: SYSDBA
	95	+	* Для встроенного сервера вы должны указать имя пользователя ...
	96	+	Password: <пустая строка> (прим.перев.: вообще-то, это может быть любая строка, в т.ч. и пустая)
	97	+	* ... но не важно, какой пароль вы укажете.
	98	+	```
93	99
94	100		------------------------------------------------------------------------
95	101
96	102		Прим.перев.: выше приведенные примеры подразумевают, что используется порт по умолчанию 3050. Если номер порта отличается от стандартного (например, пусть будет 3051), то для каждого из выше приведенных примеров строка подключения (например, к утилите isql) соответственно будет выглядеть следующим образом:
97	103
98	104		``` bash
99	105		SQL>connect '192.168.1.1/3051:/interdata/example.fdb' -user 'SYSDBA' -password 'masterkey';
100	106		```
101	107
102	108		``` bash
103	109		SQL>connect 'dbhost/3051:F:\Program Files\firebird\examples\employee.fdb' -user 'SYSDBA' -password 'masterkey';
104	110		```
105	111
106	112		``` bash
107	113		SQL>connect 'test.fdb' -user 'SYSDBA' -password '';
108	114		```
109	115
110	116		Начиная с версии FB 3 появилась возможность указывать другие протоколы коннекта:
111	117
112	118		- INET-протокол (для TCP/IP) в виде строки `<host>[/<port>]:<database file path or alias>`
113	119
114	120		Тогда строка подключения (например, к утилите isql) для выше указанных примеров соответственно будет выглядеть так:
115	121
116	122		``` bash
117	123		SQL>connect 'inet://192.168.1.1:3051:/interdata/example.fdb' -user 'SYSDBA' -password 'masterkey';
118	124		```
119	125
120	126		``` bash
121	127		SQL>connect 'inet://dbhost:3051:F:\Program Files\firebird\examples\employee.fdb' -user 'SYSDBA' -password 'masterkey';
122	128		```
123	129
124	130		``` bash
125	131		SQL>connect 'inet://test.fdb' -user 'SYSDBA' -password '';
126	132		```
127	133
128	134		INET-протокол поддерживает URL-стиль (для адресов IPv4 и IPv6) строки подключения вы виде шаблона `[<protocol>://[<host>[:<port>]]]/<database file path or alias>`. Тогда в строке подключения часть строки заменяется с inet:// на inet4:// или inet6:// соответственно. Например:
129	135
130	136		``` bash
131	137		SQL>connect 'inet6://192.168.1.1:3051:/interdata/example.fdb' -user 'SYSDBA' -password 'masterkey';
132	138		```
133	139
134	140		> Note: по умолчанию Firebird прослушивает нулевой адрес IPv6 (: :) и принимает все входящие соединения, будь то IPv4 или IPv6. Если эти адреса имеют ненулевое значение, то в строке подключения они обрамляются квадратными скобками, чтобы устранить двусмысленность при использовании двоеточия в качестве разделителя
135	141
136	142		.
137	143
138	144		Например, если `IPv6 = 2014:1234::5`, то строка подключения примет вид:
139	145
140	146		``` bash
141	147		SQL>connect '[2014:1234::5]://192.168.1.1:3051:/interdata/example.fdb' -user 'SYSDBA' -password 'masterkey';
142	148		```
143	149
144	150		и далее по аналогии...
145	151
146	152		- протокол NetBEUI, или WNET (именованные каналы) - только для Windows! - в виде строки `\\<host>[@<port>]\<database file path or alias>`.
147	153		- протокол XNET для локальных подключений с использованием общей памяти.
148	154
149	155		Последние два протокола имеют строку подключения, аналогичную INET, только вместо inet:// подставляются wnet:// или xnet:// соответственно.
150	156
151	157		Более подробную информацию по нововведениям FB 3, в том числе и по протоколам коннекта можно посмотреть [здесь](http://www.ibase.ru/files/firebird/Firebird_v3.0.3.ReleaseNotes.pdf).
152	158
153	159		------------------------------------------------------------------------
154	160
155	161		## Устранение проблем с доступом client/server
156	162
157	163		Убедитесь, что вы запустили сервер Interbase/Firebird на указанном вами IP-адресе/имени хоста сервера. Вы можете проверить подключение, подключившись к компьютеру через telnet. Firebird обычно слушает порт 3050:
158	164
159	165		``` bash
160	166		telnet 192.168.1.1 3050
161	167		```
162	168
163	169		Вы должны увидеть что-то, может быть, просто пустой экран, но вы можете что-то напечатать. Это означает, что вы можете отправлять данные в базу данных Firebird.
164	170
165	171		Для получения дополнительной информации см. документацию Firebird.
166	172
167	173		## Мониторинг событий
168	174
169	175		FPC/Lazarus поставляется с компонентом для мониторинга событий, поступающих из баз данных Firebird; см. [[TFBEventMonitor]].
170	176
171	177		## Программное создание объектов
172	178
173	179		Хотя для создания таблиц и т.д. можно использовать такие инструменты, как Flamerobin (прим.перев.: для windows, особенно русскоязычной, предпочтительнее использовать IBExpert), вы также можете создавать объекты БД программно/динамически, что может быть удобно, если вы хотите, чтобы ваши программы обновляли существующие схемы базы данных до новой схемы.
174	180
175	181		Вы можете использовать, например, TSQLQuery.ExecSQL для выполнения этой задачи:
176	182
177	183		``` pascal
178	184		Query.ExecSQL('CREATE TABLE TEST(ID INTEGER NOT NULL, TESTNAME VARCHAR(800))');
179	185		// Вам необходимо закомиттить транзакцию после DDL перед любыми инструкциями DML - SELECT, INSERT и т. Д.
180	186		//В противном случае SQL не увидит созданные объекты
181	187		```
182	188
183	189		Используйте для этих целей объект TSQLScript - см. [[TSQLScript]].
184	190
185	191		## Администрирование базы данных
186	192
187	193		У FPC/Lazarus есть компонент для администрирования базы данных; см. [[TFBAdmin]]
188	194
189	195		## Общие проблемы и решения
190	196
191	197		Иногда использование Firebird в Lazarus кажется сложным. Пожалуйста, поищите решения ниже по тексту.
192	198
193	199		### Попытка обновления доступного только для чтения столбца / полей COMPUTED BY
194	200
195	201		Если в вашей таблице Firebird есть поля COMPUTED BY (вычисляемые поля на стороне сервера), SQLDB не будет брать в расчет, что это поля только для чтения (из соображений производительности).
196	202
197	203		В этом случае автоматически сгенерированные операторы INSERTSQL, UPDATESQL могут привести к сообщениям об ошибках, таких как "attempted update of read-only column" (попытка обновления столбца только для чтения).Решение состоит в том, чтобы вручную указать, что данное поле не может быть обновлено после установки свойства SQL в TSQLQuery, что-то вроде:
198	204
199	205		``` pascal
200	206		// Отключаем обновление этого поля или поиск измененных значений, поскольку пользователь не может изменить его
201	207		sqlquery1.fieldbyname('full_name').ProviderFlags:=[];
202	208		```
203	209
204	210		### Bigint: потеря точности
205	211
206	212		Если вы используете тип данных bigint (64-битное целое число со знаком) в Firebird, пожалуйста, используйте .AsLargeInt вместо .AsInteger для параметров:
207	213
208	214		``` pascal
209	215		// Предполагая, что идентификатор здесь bigint
210	216		sqlquery1.sql.text := 'insert into ADDRESS (ID) values (:ID)';
211	217		// делаем так:
212	218		sqlquery1.params.parambyname('ID').aslargeint := <любая qword- или 64-bit integer-переменная>;
213	219		// Не делайте так:
214	220		//sqlquery1.params.parambyname('ID').asinteger := <любая qword- или 64-bit integer-переменная>;
215	221		...
216	222		```
217	223
218	224		... в противном случае вы можете получить такие ошибки, как дубликат PK (первичного ключа) - при использовании bigint в качестве первичного ключа.
219	225
220	226		### Логические типы данных
221	227
222	228		Версии Firebird ниже 3.0 не поддерживают логические типы данных.
223	229
224	230		По крайней мере, в транке FPC (2.7.1) этот тип данных можно эмулировать:
225	231
226	232		Используйте домен, который использует тип SMALLINT (другие целочисленные типы также могут работать - пожалуйста, протестируйте и настройте текст):
227	233
228	234		``` SQL
229	235		CREATE DOMAIN "BOOLEAN"
230	236		AS SMALLINT
231	237		CHECK (VALUE IS NULL OR VALUE IN (-1,0,1))
232	238		/* -1 используется для совместимости с SQLDB FPC; 1 используется многими другими слоями доступа к данным */
233	239		;
234	240		```
235	241
236	242		Позвольте вашему полю/столбцу использовать этот тип домена, например
237	243
238	244		``` SQL
239	245		CREATE TABLE MYTABLE
240	246		(
241	247		...
242	248		MYBOOLEANCOLUMN "BOOLEAN",
243	249		);
244	250		```
245	251
246	252		- Теперь вы можете использовать .AsBoolean для присвоения значений полей и т.д.
247	253
248	254		To do: убедитесь, что это работает с гридами Lazarus и т. д..
249	255
250	256		### Проблемы INSERT INTO...RETURNING/Не открытый курсор
251	257
252	258		Если вы попытаетесь сделать выборку SQL (например, Query.Open) в следущем SQL-запросе:
253	259
254	260		``` SQL
255	261		INSERT INTO PEOPLE (NICKNAME) VALUES ('Superman') RETURNING ID
256	262		```
257	263
258	264		и получаете что-то вроде этой ошибки:
259	265
260	266		```dos
261	267		Database error: : Fetch :
262	268		-Dynamic SQL Error
263	269		-SQL error code = -504
264	270		-Invalid cursor reference
265	271		-Cursor is not open(error code: 335544569)
266	272		```
267	273
268	274		во время работы FPC 2.6.0 (которая поставляется с Lazarus 1.0) или ниже, вы, вероятно, столкнулись с ошибкой синтаксического парсера FPC SQLDB.
269	275
270	276		SQLDB считает, что выполняемый вами оператор является обычным оператором INSERT, который не возвращает данные. Очевидно, он должен возвращать данные. В более новом FPC для этого кода уже внесены исправления.
271	277
272	278		Если вы используете генераторы/последовательности для своих первичных ключей (как это делают многие), в качестве обходного пути вы должны сначала получить следующий порядковый номер:
273	279
274	280		``` SQL
275	281		SELECT NEXT VALUE FOR GEN_PEOPLEID FROM RDB$DATABASE /* Если имя вашего генератора GEN_PEOPLEID */
276	282		```
277	283
278	284		затем используйте это, чтобы сделать обычный INSERT. см. [FAQ entry](http://www.firebirdfaq.org/faq111/%7CFirebird)
279	285
280	286		------------------------------------------------------------------------
281	287
282	288		Прим.перев.: вообще-то, мягко говоря, немного странный совет. Гораздо проще и безопаснее создать в БД триггер BeforeInsert примерно следующего содержания:
283	289
284	290		``` sql
285	291		/* Trigger: TBL_PEOPLE_BI */
286	292		CREATE OR ALTER TRIGGER TBL_PEOPLE_BI FOR TBL_PEOPLE
287	293		ACTIVE BEFORE INSERT POSITION 0
288	294		AS
289	295		BEGIN
290	296		/* генерируем новое значение поля, если вставляемое является NULL-значением */
291	297		IF (NEW.ID IS NULL) THEN
292	298		NEW.ID = GEN_ID(GEN_PEOPLEID,1);
293	299		END
294	300		^
295	301		```
296	302
297	303		чтобы переложить заботу о генерации PK на плечи сервера, передавая с клиента NULL-значение генератора (или не передавая его вообще, что будет восприниматься сервером, как NULL).
298	304
299	305		------------------------------------------------------------------------
300	306
301	307		### Locate, кажется, не работает
302	308
303	309		Источник: [Issue \##21988](https://bugs.freepascal.org/view.php?id=#21988)
304	310
305	311		При запуске locate в CHAR-полях с UTF8 (или, возможно, других многобайтовых символов), locate может не найти вашу запись.
306	312
307	313		Проблема в основном связана с используемой кодировкой UTF8 и тем, как Firebird сообщает о длине столбца. В случае UTF8 Firebird сообщает о максимальной длине столбца (в байтах) как 4 * «размер символа». Поэтому, если у вас есть столбец, определенный как char(8), Firebird сообщает 4*8=32.
308	314
309	315		Значения "добиваются" пробелами справа до этой длины 32. При поиске, скажем, «57200001», совпадений нет, потому что в поле фактически хранится «57200001 ........................» (с конечными пробелами, представленными здесь точками ).
310	316
311	317		Обходной путь: перепишите ваш select-запрос:
312	318
313	319		``` sql
314	320		SELECT substring(THEFIELD from 1 for 8) AS THEFIELD ...
315	321		```
316	322
317	323		или
318	324
319	325		``` sql
320	326		SELECT cast(THEFIELD as varchar(8)) as THEFIELD ...
321	327		```
322	328
323	329		или используйте VARCHAR-тип полей.
324	330
325	331		> Note: эта проблема может возникать и для других баз данных, в зависимости от их возвращаемой длины.
326	332
327	333		## Подробнее о транзакциях
328	334
329	335		Источники для этой информации / дальнейшего чтения:
330	336
331	337		- [Понимание транзакций Firebird](http://www.ibphoenix.com/resources/documents/how_to/doc_400) - очень детальная статья (англ.)
332	338		- [Транзакции в Firebird](https://ib-aid.com/en/transactions-in-firebird-acid-isolation-levels-deadlocks-and-update-conflicts-resolution/) другая очень детальная статья (англ.) (прим.перев.: русскоязычные аналоги от тех же авторов [Жизненный цикл транзакций](http://www.ibase.ru/utl/) и [Транзакции в InterBase и Firebird](http://www.ibase.ru/ibtrans/))
333	339		- Руководство по Interbase 6 API (справедливо для Firebird+Interbase), стр. 63 и далее
334	340		- [Обзор настроек транзакций в Interbase](http://conferences.embarcadero.com/article/32280) (англ.)
335	341		- [Подробное объяснение параметров в Firebird](http://tech.groups.yahoo.com/group/firebird-support/message/58653) (англ.)
336	342		- [Обзор настроек в Firebird](http://fhasovic.blogspot.com/2005/02/transaction-isolation-levels-in.html) (англ.)
337	343		- [Уровни изоляции транзакции в FIBPlus](http://delphi-help.ru/index.php?option=com_k2&view=item&id=309:rabota-s-tranzaktsiyami-i-ih-ispolzovanie-v-fibplus-chast-2&Itemid=55) (прим.перев.: ссылки на devrace'овские статьи, как и сам оригинальный сайт, увы, давно мертвы, остались лишь сохраненные статьи на сторонних ресурсах)
338	344		- README.set_transaction.txt в папке с документацией Firebird 2.5.
339	345
340	346		### Уровни изоляции транзакций
341	347
342	348		Если вы хотите, вы можете изменить уровни изоляции транзакции, добавив строку в свойстве Parameters транзакции:
343	349
344	350		- `isc_tpb_read_committed`: вы видите все изменения, закомиченные другими транзакциями
345	351		- `isc_tpb_concurrency`: также называется Снапшотом (моментальным снимком): вы видите базу данных такой, какой она была при запуске транзакции. Имеет больше накладных расходов, чем isc_tpb_read_committed. Лучше, чем ANSI Serializable, потому что не имеет фантомных чтений.
346	352		- `isc_tpb_consistency`: также называется Table Stability: стабильное, сериализуемое представление данных, но блокирует таблицы. Вряд ли вам это понадобится.
347	353
348	354		Пример:
349	355
350	356		``` pascal
351	357		SQLTransaction1.Params.text:='isc_tpb_read_committed';
352	358		```
353	359
354	360		Вы также можете добавить дополнительные параметры, которые влияют на транзакцию (взятые из исходного файла ibconnection.pp и [1](http://conferences.embarcadero.com/article/32280)):
355	361
356	362		### Режим доступа
357	363
358	364		Этот параметр позволяет или только чтение, или чтение/запись
359	365
360	366		- `isc_tpb_read`: разрешение на чтение
361	367		- `isc_tpb_write`: разрешение на чтение+запись
362	368
363	369		### Обработка конфликтов блокировки
364	370
365	371		- `isc_tpb_nowait`: текущая транзакция откатывается с сообщением о конфликте, если запись все еще редактируется другой транзакцией
366	372		- `isc_tpb_wait`: если запись все еще редактируется другой транзакцией, текущая транзакция дожидается завершения работы той, первой транзакции. Может смягчить «долгоживущие блокировки» в условиях сильной конкуренции ([2](http://tech.groups.yahoo.com/group/firebird-support/message/58653)). См. ниже описание параметра timeout value.
367	373
368	374		### Резервирование таблиц
369	375
370	376		Соглашение по блокировкам таблиц в целом.
371	377
372	378		- `isc_tpb_shared`: сначала указывается этот параметр, затем либо lock_read, либо lock_write для одной или нескольких таблиц. Разделяемый режим чтения или записи для таблиц.
373	379		- `isc_tpb_protected`: сначала указывается этот параметр, затем либо lock_read, либо lock_write для одной или нескольких таблиц. Блокировка на таблицы; может разрешить операции без блокировок за счет отложенных транзакций.
374	380		- `isc_tpb_lock_read`: задает блокировку чтения. Указывается, какая таблица блокируется, например, isc_tpb_lock_read=CUSTOMERS
375	381		- `isc_tpb_lock_write`: задает блокировку чтения/записи. Указывается, какая таблица блокируется, например, isc_tpb_lock_read=CUSTOMERS
376	382
377	383		Комбинации:
378	384
379	385		- Shared, lock_write: пишущая транзакция с уровнем изоляции concurrency или read committed может обновлять таблицу. Читать таблицу может любая транзакция (прим.перев.: только в режиме READ ONLY (read)).
380	386		- Shared, lock_read: читать и обновлять таблицу может любая транзакция.
381	387		- Protected, lock_write: Другие транзакции не могут обновлять таблицу. Читать таблицу могут только транзакции concurrency или read committed.
382	388		- Protected, lock_read: Другие транзакции не могут обновлять таблицу, но могут ее читать.
383	389
384	390		### Версионность записей
385	391
386	392		Этот параметр, по-видимому, относится только к режиму изоляции isc_tpb_read_committed для записей, изменяемых другими транзакциями:
387	393
388	394		- `isc_tpb_no_rec_version`: читается только самая новая версия записи. Может быть полезно для операций пакетной/массовой вставки вместе с isc_tpb_read_committed.
389	395		- `isc_tpb_rec_version`: читается последняя подтвержденная версия записи, даже если в другой транзакции есть другие незакомиченные изменения. Больше накладных расходов, чем isc_tpb_no_rec_version.
390	396
391	397		### Различные варианты
392	398
393	399		Для полноты, в коде Firebird/Interbase FPC появилось еще несколько опций. Скорее всего, вы будете использовать isc_tpb_no_auto_undo только для ускорения вставки/редактирования пакетов.
394	400
395	401		- isc_tpb_exclusive (видимо переводится как защищенный в Firebird, см. [3](http://tech.groups.yahoo.com/group/firebird-support/message/58653))
396	402		- isc_tpb_verb_time (Относится к отложенным ограничениям, которые могут выполняться в verb time или во время коммита. Firebird: не реализовано, всегда используйте verb time)
397	403		- isc_tpb_commit_time (Относится к отложенным ограничениям, которые могут выполняться в verb time или в commit time. Firebird: не реализовано, всегда используйте verb time)
398	404		- isc_tpb_ignore_limbo (игнорирует записи, созданные limbo-транзакциями. limbo-транзакции - это незавершенные транзакции в двухфазном коммите при работе с несколькими базами данных. Вряд ли вам понадобится эта функция)
399	405		- isc_tpb_autocommit (автокоммит транзакции: каждый оператор является отдельной транзакцией. Вероятно, специально для драйвера JDB JayBird.)
400	406		- isc_tpb_restart_requests (очевидно, ищет запросы в соединении, которые были активны в другой транзакции, прибивает их и перезапускает в новой транзакции.)
401	407		- isc_tpb_no_auto_undo (отключает журнал отмен на уровне транзакций, что удобно для получения максимальной пропускной способности при выполнении пакетного обновления. Не имеет эффекта при данных только для чтения.)
402	408		- isc_tpb_lock_timeout (укажите количество секунд ожидания для снятия блокировки, если вы используете isc_tpb_wait. Если это значение достигнуто без снятия блокировки, выдается сообщение об ошибке.)
403	409
404	410		### Firebird и транзакции по стандарту ANSI/ISO SQL
405	411
406	412		Транзакции Firebird не соответствуют 1 в 1 уровню транзакции стандарта ISO/ANSI. Приблизительно так:
407	413
408	414		- ISO Read Committed=READ COMMITTED+RECORD_VERSION
409	415		- ISO Read Committed=READ COMMITTED+NO RECORD_VERSION
410	416		- ISO Repeatable Read=SNAPSHOT (также известная как CONCURRENCY)
411	417		- ISO Serializable=SNAPSHOT TABLE STABILITY (также известная как CONSISTENCY)
412	418
413	419		### Общие комбинации
414	420
415	421		По умолчанию (возможно, придется проверить) read committed.
416	422
417	423		#### Пакетная/массовая вставка
418	424
419	425		isc_tpb_read_committed и isc_tpb_no_rec_version могут быть хорошей комбинацией: она позволяет другим транзакциям функционировать во время выполнения пакетной вставки.
420	426
421	427		#### Транзакции только для чтения
422	428
423	429		Если вы хотите иметь доступ только для чтения к базе данных, вы можете сделать это, установив следующие параметры транзакции:
424	430
425	431		- `isc_tpb_read`
426	432		- `isc_tpb_read_committed`
427	433		- `isc_tpb_rec_version`
428	434		- `nowait`
429	435
430	436		Эта комбинация не будет блокировать сборку мусора, что само по себе хорошо. Источник: [4](http://tech.groups.yahoo.com/group/firebird-support/message/118748)
431	437
432	438		> Note: [Firebird FAQ](http://www.firebirdfaq.org/faq164/) указывает, что вам понадобится доступ с правом записи в файл базы данных, даже если вы только читаете из него, если вы не установите флаг базы данных read-only \[только для чтения\] (например, с помощью утилиты gfix).
433	439
434	440		## Ссылки и дополнительная информация
435	441
436	442		В списке ниже приведены ссылки на дополнительную информацию о Firebird и связанных с ней инструментах.
437	443
438	444		- [[Firebird embedded/ru\|Использование Firebird embedded с приложениями FPC/Lazarus]]
439	445
440	446		### Примеры Lazarus Firebird
441	447
442	448		- Примеры исходного кода приложения Lazarus/Firebird [5](http://lazarus.freepascal.org/index.php/topic,13940.msg73617.html#msg73617)
443	449		- Учебники Firebird/SQLDB:
444	450		- [[SQLdb Tutorial0]]
445	451		- [[SQLdb Tutorial1]]
446	452		- [[SQLdb Tutorial2]]
447	453		- [[SQLdb Tutorial3]]
448	454		- [[SQLdb Tutorial4]]
449	455
450	456		- Учебники по PP4S; включает установку Firebird на Windows, а также
451	457		- [Планирование базы данных (англ.)](http://www.pp4s.co.uk/main/tu-db-plan.html)
452	458		- [Установка Firebird (англ.)](http://www.pp4s.co.uk/main/tu-db-installingfirebird01.html)
453	459		- [Создание базы данных Firebird (англ.)](http://www.pp4s.co.uk/main/tu-db-firebird-create.html)
454	460		- [Редактирование базы данных Firebird (англ.)](http://www.pp4s.co.uk/main/tu-db-firebird-demo1.html)
455	461		- [Поиск в базе данных Firebird (англ.)](http://www.pp4s.co.uk/main/tu-db-firebird-demo2.html)
456	462		- [Создание и печать отчетов (англ.)](http://www.pp4s.co.uk/main/tu-db-firebird-demo3.html)
457	463		- [Создание и использование хранимых процедур (англ.)](http://www.pp4s.co.uk/main/tu-db-firebird-demo4.html)
458	464
459	465		### Инструменты администрирования
460	466
461	467		- [FlameRobin](http://www.flamerobin.org/) - GUI инструмент с открытым исходным кодом для управления Firebird, доступный для Linux, Windows и macOS. Настоятельно рекомендуется.
462	468		- [Turbobird](https://github.com/motaz/turbobird) - GUI инструмент с открытым исходным кодом для управления Firebird. Написано с помощью Lazarus с использованием TIBConnection.
463	469		- ibconsole : инструмент для управления Firebird и базами данных Interbase с графическим интерфейсом, доступен для Windows и Linux.
464	470		- Lazarus Data Desktop - входит в репозиторий Lazarus (находится в каталоге 'tools/lazdatadesktop/').
465	471		- [LazSQLX](http://lazsqlx.wordpress.com/)- многофункциональный инструмент управления базами данных с открытым исходным кодом. Написан на Lazarus с использованием компонентов как SQLDB, так и Zeos. Включает поддержку Firebird.
466	472		- tiSQLEditor - включен в каталог «Support Apps» репозитория [[tiOPF]]. Это инструмент, используемый для написания SQL с некоторой поддержкой автозавершения кода, может запускать сценарии, выполнять сценарии обновления для приложений от одной сборки до более поздней сборки, имеет различные удобные функции копирования и вставки для приложений Object Pascal, имеет много функций, которые полезны для tiOPF (создает шаблоны кода Object Pascal из результатов запросов, для классов посетителей tiOPF), экспортирует результаты запросов в CSV и т.д.
467	473		- Прим.перев.: [IBExpert](http://www.ibexpert.net/ibe/) - ИМХО, лучший GUI-инструмент для администрирования БД Firebird под Windows. Постоянно обновляемый, с активным [русскоязычным коммунити](https://www.sql.ru/forum/ibexpert), бесплатен для пользователей Windows с кодовой страницей Win1251 (в основном, жителей exUSSR). В комплекте SQL-редактор с подсветкой синтаксиса и автозавершением слов, редактор скриптов, построитель запросов, поддержка IBEScript, менеждер прав и пользователей, печать и экспорт данных в различные форматы и проч.проч. Скачать можно по прямой ссылке [здесь](http://www.ibexpert.com/rus/ibe_sfx.exe) в виде самораспаковывающегося архива. Документация представлена [здесь](http://www.ibexpert.net/ibe/index.php?n=Doc.Doc).
468	474
469	475		### Firebird
470	476
471	477		- РСУБД [Firebird](http://firebirdsql.org/). Этот сайт также содержит много документации по Firebird.
472	478		- Firebird [FAQ](http://firebirdfaq.org/). Удобный сайт, который показывает, например, отличия от других РСУБД.
473	479		- [Новый сайт](http://www.controlpascal.com/firebird.htm), который показывает, как использовать новейшие инструменты и LibreOffice, FPC будет добавлен в ближайшее время.
474	480
475	481		---
476	482		From the Free Pascal wiki, page "Firebird/ru", as it stood on 2020-02-16 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