<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html class="client-nojs" dir="ltr" lang="en">
<head>
<meta charset="UTF-8" />
<title>Модули/FireBird - OpenSCADAWiki</title>
<meta content="MediaWiki 1.26.4" name="generator" />
<link href="https://www.gnu.org/copyleft/fdl.html" rel="copyright" />
<link href="../../en/files/doc.css" rel="stylesheet" /></head>
<body><div class="floatright"><a href="../index.html"><img alt="OpenSCADA" src="../../en/files/index.png" /></a></div><div id="mw_header">
<div class="mw-indicators">
</div>
<h1 id="firstHeading" lang="ru">Модули/FireBird</h1>
</div><div class="mw-content-ltr" dir="ltr" id="mw-content-text" lang="ru"><div class="mw-pt-translate-header noprint" dir="ltr" lang="en">This page is a <span class="plainlinks"><a class="external text" href="http://oscada.org/wiki/index.php?title=Special:Translate&group=page-Modules%2FFireBird&action=page&filter=&language=ru" rel="nofollow noreferrer noopener" target="_blank">translated version</a></span> of the page <a class="external" href="http://oscada.org/wiki/Modules/FireBird" title="Modules/FireBird">Modules/FireBird</a> and the translation is 100% complete.</div><hr /><div class="mw-pt-languages" dir="ltr" lang="en"><div class="mw-pt-languages-list autonym"><a class="mw-pt-languages-ui mw-pt-progress mw-pt-progress--complete" href="../../en/Modules/FireBird.html" title="Modules/FireBird (100% translated)">English</a> • ‎<span class="mw-pt-languages-selected mw-pt-progress mw-pt-progress--complete">mRussian</span> • ‎<a class="mw-pt-progress mw-pt-progress--complete" href="../../uk/Modules/FireBird.html" title="Модулі/FireBird (100% translated)">УкраїнÑька</a></div></div>
<table class="wikitable">
<tr>
<th> Модуль </th>
<th> Ð˜Ð¼Ñ </th>
<th> ВерÑÐ¸Ñ </th>
<th> Ð›Ð¸Ñ†ÐµÐ½Ð·Ð¸Ñ </th>
<th> ИÑточник </th>
<th> Языки </th>
<th> Платформы </th>
<th> Тип </th>
<th> Ðвтор </th>
<th> ОпиÑание
</th></tr>
<tr>
<td> <a href="../Modules/FireBird.html" title="Special:MyLanguage/Modules/FireBird">FireBird</a> </td>
<td> БД FireBird
<ul><li> <b><a href="../Program_manual.html#DBFeat" title="Special:MyLanguage/Documents/Program manual">СвойÑтва</a>:</b> SQL, LIST, STRUCT, GET, SEEK, PRELOAD, SET, DEL, FIX, TR</li></ul>
</td>
<td> 3.0 </td>
<td> GPL2 </td>
<td> bd_FireBird.so </td>
<td> en,uk,ru,de </td>
<td> x86,x86_64,ARM
</td>
<td> БД </td>
<td> Роман Савоченко </td>
<td> Модуль БД. ПредоÑтавлÑет поддержку СУБД FireBird.
</td></tr></table>
<p>Модуль предоÑтавлÑет в OpenSCADA поддержку СУБД FireBird, и InterBase, ÐºÐ¾Ñ‚Ð¾Ñ€Ð°Ñ ÑвлÑетÑÑ Ð½ÐµÐ±Ð¾Ð»ÑŒÑˆÐ¾Ð¹ и вÑтраиваемой СУБД Ñ Ñ„ÑƒÐ½ÐºÑ†Ð¸Ñми Ñетевой и поддержкой SQL-запроÑов. FireBird поÑтроена на оÑнове коммерчеÑкой СУБД Interbase и она раÑпроÑтранÑетÑÑ Ð¿Ð¾ Ñвободной лицензии. ОзнакомитьÑÑ Ñ Ð¡Ð£Ð‘Ð” можно на Ñайте <a class="external free" href="http://www.firebirdsql.org" rel="nofollow noreferrer noopener" target="_blank">http://www.firebirdsql.org</a>. Модуль оÑнован на библиотеке API Ð¿Ñ€Ð¾Ð¸Ð·Ð²Ð¾Ð´Ð¸Ñ‚ÐµÐ»Ñ Ð¡Ð£Ð‘Ð” на Ñзыке "С" и он позволÑет выполнÑÑ‚ÑŒ дейÑÑ‚Ð²Ð¸Ñ Ð½Ð°Ð´ базами данных, таблицами и Ñодержимым таблиц.
</p>
<div class="toc" id="toc"><div id="toctitle"><h2>Contents</h2></div>
<ul>
<li class="toclevel-1 tocsection-1"><a href="#.D0.9E.D0.BF.D0.B5.D1.80.D0.B0.D1.86.D0.B8.D0.B8_.D0.BD.D0.B0.D0.B4_.D0.91.D0.94"><span class="tocnumber">1</span> <span class="toctext">Операции над БД</span></a></li>
<li class="toclevel-1 tocsection-2"><a href="#.D0.9E.D0.BF.D0.B5.D1.80.D0.B0.D1.86.D0.B8.D0.B8_.D0.BD.D0.B0.D0.B4_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D0.B5.D0.B9"><span class="tocnumber">2</span> <span class="toctext">Операции над таблицей</span></a></li>
<li class="toclevel-1 tocsection-3"><a href="#.D0.9E.D0.BF.D0.B5.D1.80.D0.B0.D1.86.D0.B8.D0.B8_.D0.BD.D0.B0.D0.B4_.D1.81.D0.BE.D0.B4.D0.B5.D1.80.D0.B6.D0.B8.D0.BC.D1.8B.D0.BC_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D1.8B"><span class="tocnumber">3</span> <span class="toctext">Операции над Ñодержимым таблицы</span></a></li>
<li class="toclevel-1 tocsection-4"><a href="#.D0.94.D0.BE.D1.81.D1.82.D1.83.D0.BF_.D0.BA_.D0.91.D0.94"><span class="tocnumber">4</span> <span class="toctext">ДоÑтуп к БД</span></a></li>
<li class="toclevel-1 tocsection-5"><a href="#.D0.9F.D1.80.D0.BE.D0.B8.D0.B7.D0.B2.D0.BE.D0.B4.D0.B8.D1.82.D0.B5.D0.BB.D1.8C.D0.BD.D0.BE.D1.81.D1.82.D1.8C_.D0.A1.D0.A3.D0.91.D0.94"><span class="tocnumber">5</span> <span class="toctext"><span>ПроизводительноÑÑ‚ÑŒ СУБД</span></span></a></li>
<li class="toclevel-1 tocsection-6"><a href="#.D0.97.D0.B0.D0.BC.D0.B5.D1.87.D0.B0.D0.BD.D0.B8.D1.8F"><span class="tocnumber">6</span> <span class="toctext">ЗамечаниÑ</span></a></li>
</ul>
</div>
<h2><span class="mw-headline" id=".D0.9E.D0.BF.D0.B5.D1.80.D0.B0.D1.86.D0.B8.D0.B8_.D0.BD.D0.B0.D0.B4_.D0.91.D0.94"><span class="mw-headline-number">1</span> Операции над БД</span></h2>
<p>ПоддерживаютÑÑ Ð¾Ð¿ÐµÑ€Ð°Ñ†Ð¸Ð¸ Ð¾Ñ‚ÐºÑ€Ñ‹Ñ‚Ð¸Ñ Ð¸ Ð·Ð°ÐºÑ€Ñ‹Ñ‚Ð¸Ñ Ð‘Ð”, Ñ Ð²Ð¾Ð·Ð¼Ð¾Ð¶Ð½Ð¾Ñтью ÑÐ¾Ð·Ð´Ð°Ð½Ð¸Ñ Ð½Ð¾Ð²Ð¾Ð¹ БД при открытии и ÑƒÐ´Ð°Ð»ÐµÐ½Ð¸Ñ ÑущеÑтвующей при закрытии. Ð’ терминах подÑиÑтемы "БД" OpenSCADA, открытием БД ÑвлÑетÑÑ ÐµÑ‘ региÑÑ‚Ñ€Ð°Ñ†Ð¸Ñ Ð´Ð»Ñ Ð¿Ð¾Ñледующего иÑÐ¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð¿Ñ€Ð¾Ð³Ñ€Ð°Ð¼Ð¼Ð¾Ð¹. Также, поддерживаетÑÑ Ð¾Ð¿ÐµÑ€Ð°Ñ†Ð¸Ñ Ð·Ð°Ð¿Ñ€Ð¾Ñа Ð¿ÐµÑ€ÐµÑ‡Ð½Ñ Ñ‚Ð°Ð±Ð»Ð¸Ñ† в БД.
</p><p>СУБД FireBird адреÑуетÑÑ Ð¿ÑƒÑ‚Ñ‘Ð¼ ÑƒÐºÐ°Ð·Ð°Ð½Ð¸Ñ Ð¸Ð¼ÐµÐ½Ð¸ файла БД, Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Ð¸ паролÑ. Ð’ общем Ð°Ð´Ñ€ÐµÑ Ð‘Ð” запиÑываетÑÑ Ñ‚Ð°ÐºÐ¸Ð¼ образом: <b>{file};{user};{pass}[;{conTm}]</b>. Где:
</p>
<ul><li> <i>file</i> — полное Ð¸Ð¼Ñ Ñ„Ð°Ð¹Ð»Ð° БД;</li>
<li> <i>user</i> — пользователь БД, от имени которого производитÑÑ Ð´Ð¾Ñтуп;</li>
<li> <i>pass</i> — пароль пользователÑ, от имени которого производитÑÑ Ð´Ð¾Ñтуп;</li>
<li> <i>conTm</i> — таймаут подключениÑ, Ñекунд.</li></ul>
<h2><span class="mw-headline" id=".D0.9E.D0.BF.D0.B5.D1.80.D0.B0.D1.86.D0.B8.D0.B8_.D0.BD.D0.B0.D0.B4_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D0.B5.D0.B9"><span class="mw-headline-number">2</span> Операции над таблицей</span></h2>
<p>ПоддерживаютÑÑ Ð¾Ð¿ÐµÑ€Ð°Ñ†Ð¸Ð¸ открытиÑ, Ð·Ð°ÐºÑ€Ñ‹Ñ‚Ð¸Ñ Ñ‚Ð°Ð±Ð»Ð¸Ñ†Ñ‹, Ñ Ð²Ð¾Ð·Ð¼Ð¾Ð¶Ð½Ð¾Ñтью ÑÐ¾Ð·Ð´Ð°Ð½Ð¸Ñ Ð½Ð¾Ð²Ð¾Ð¹ таблицы при открытии и ÑƒÐ´Ð°Ð»ÐµÐ½Ð¸Ñ ÑущеÑтвующей при закрытии, а также Ð·Ð°Ð¿Ñ€Ð¾Ñ Ñтруктуры таблицы.
</p>
<h2><span class="mw-headline" id=".D0.9E.D0.BF.D0.B5.D1.80.D0.B0.D1.86.D0.B8.D0.B8_.D0.BD.D0.B0.D0.B4_.D1.81.D0.BE.D0.B4.D0.B5.D1.80.D0.B6.D0.B8.D0.BC.D1.8B.D0.BC_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D1.8B"><span class="mw-headline-number">3</span> Операции над Ñодержимым таблицы</span></h2>
<ul><li> Ñканирование запиÑей таблицы;</li>
<li> Ð·Ð°Ð¿Ñ€Ð¾Ñ Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ð¹ указанных запиÑей;</li>
<li> уÑтановка значений указанных запиÑей;</li>
<li> удаление запиÑей.</li></ul>
<p>API подÑиÑтемы "БД" предполагает доÑтуп к Ñодержимому таблицы по значению ключевого(Ñ‹Ñ…) полей. Так, Ð¾Ð¿ÐµÑ€Ð°Ñ†Ð¸Ñ Ð·Ð°Ð¿Ñ€Ð¾Ñа запиÑи подразумевает предварительную уÑтановку ключевых колонок объекта TConfig, по которым будет выполнен запроÑ. Создание новой запиÑи(Ñтроки) производитÑÑ Ð¾Ð¿ÐµÑ€Ð°Ñ†Ð¸ÐµÐ¹ уÑтановки значений запиÑи, ÐºÐ¾Ñ‚Ð¾Ñ€Ð°Ñ Ð¾Ñ‚ÑутÑтвует.
</p><p>Модуль позволÑет динамичеÑки менÑÑ‚ÑŒ Ñтруктуру таблиц БД FireBird. Так, в Ñлучае неÑоответÑÑ‚Ð²Ð¸Ñ Ñтруктуры таблицы и Ñтруктуры уÑтанавливаемой запиÑи, Ñтруктура таблицы будет приведена к требуемой Ñтруктуре запиÑи. Ð’ Ñлучае запроÑа значений запиÑи и неÑоответÑÑ‚Ð²Ð¸Ñ Ñтруктур запиÑи и таблицы, будут получены только Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ñ Ð¾Ð±Ñ‰Ð¸Ñ… Ñлементов запиÑи и таблицы. Модуль не отÑлеживает порÑдка раÑÐ¿Ð¾Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ñлементов запиÑи и Ñтруктуры таблицы, кроме Ñтого Ð¾Ð¿ÐµÑ€Ð°Ñ†Ð¸Ñ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ñ Ñ‚Ð¸Ð¿Ð° колонки не ÑвлÑетÑÑ Ð±ÐµÐ·Ð¾Ð¿Ð°Ñной и данные в изменÑемых колонках будут утерÑны!
</p><p>Модулем реализуетÑÑ Ð¼ÐµÑ…Ð°Ð½Ð¸Ð·Ð¼ поддержки многоÑзыковых текÑтовых переменных. Ð”Ð»Ñ Ð¿Ð¾Ð»ÐµÐ¹ Ñ Ð¼Ð½Ð¾Ð³Ð¾Ñзыковой текÑтовой переменной ÑоздаютÑÑ ÐºÐ¾Ð»Ð¾Ð½ÐºÐ¸ отдельных Ñзыков в формате "<b>{lang}#{FldID}</b>" (en#NAME). При Ñтом, Ð±Ð°Ð·Ð¾Ð²Ð°Ñ ÐºÐ¾Ð»Ð¾Ð½ÐºÐ° Ñодержит значение Ð´Ð»Ñ Ð±Ð°Ð·Ð¾Ð²Ð¾Ð³Ð¾ Ñзыка. Колонки отдельных Ñзыков ÑоздаютÑÑ Ð¿Ð¾ надобноÑти, в момент ÑÐ¾Ñ…Ñ€Ð°Ð½ÐµÐ½Ð¸Ñ Ð² БД и при иÑполнении OpenSCADA в ÑоответÑтвующей локали. Ð’ Ñлучае отÑутÑÑ‚Ð²Ð¸Ñ Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ñ Ð´Ð»Ñ ÐºÐ¾Ð½ÐºÑ€ÐµÑ‚Ð½Ð¾Ð³Ð¾ Ñзыка будет иÑпользоватьÑÑ Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ð¹ Ð´Ð»Ñ Ð±Ð°Ð·Ð¾Ð²Ð¾Ð³Ð¾ Ñзыка.
</p><p>Типы Ñлементов СУБД FireBird Ñледующим образом ÑоответÑтвуют типам Ñлементов OpenSCADA:
</p>
<table class="wikitable">
<tr>
<th> Типы полей OpenSCADA </th>
<th> Типы полей FireBird
</th></tr>
<tr>
<td> TFld::String </td>
<td> VARCHAR, BLOB SUBTYPE TEXT
</td></tr>
<tr>
<td> TFld::Integer </td>
<td> INTEGER
</td></tr>
<tr>
<td> TFld::Real </td>
<td> DOUBLE
</td></tr>
<tr>
<td> TFld::Boolean </td>
<td> SMALLINT
</td></tr></table>
<h2><span class="mw-headline" id=".D0.94.D0.BE.D1.81.D1.82.D1.83.D0.BF_.D0.BA_.D0.91.D0.94"><span class="mw-headline-number">4</span> ДоÑтуп к БД</span></h2>
<p>Права доÑтупа к БД определÑÑŽÑ‚ÑÑ Ð¿Ñ€Ð°Ð²Ð°Ð¼Ð¸ файла БД.
</p><p>Кратко раÑÑмотрим процедуру первичной наÑтройки Ñервера FireBird, Ñ Ñ†ÐµÐ»ÑŒÑŽ Ð¿Ð¾Ð´ÐºÐ»ÑŽÑ‡ÐµÐ½Ð¸Ñ Ðº нему Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ данного модулÑ:
</p>
<ul>
<li>УÑтановка СУБД FireBird в виде пакета или Ñборкой.</li>
<li>ЗапуÑк СУБД:
<pre style="white-space: pre-wrap;">
# ЗапуÑк клаÑÑичеÑкого Ñервера
$ service firebird start
# ЗапуÑк в ÑуперÑервере
$ service xinetd restart</pre></li>
<li>УÑтановка нужного Ð¿Ð°Ñ€Ð¾Ð»Ñ Ð´Ð»Ñ ÑиÑтемного Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ "sysdba":
<pre style="white-space: pre-wrap;">
$ gsec -user sysdba -pass masterkey -mo sysdba -pw 123456</pre></li>
<li>Подключение к СУБД Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ данного модулÑ, Ð²Ð²ÐµÐ´Ñ Ð°Ð´Ñ€ÐµÑ Ð‘Ð”: <b>"/var/tmp/test.fbd;sysdba;123456"</b></li>
</ul>
<h2><span class="mw-headline" id=".D0.9F.D1.80.D0.BE.D0.B8.D0.B7.D0.B2.D0.BE.D0.B4.D0.B8.D1.82.D0.B5.D0.BB.D1.8C.D0.BD.D0.BE.D1.81.D1.82.D1.8C_.D0.A1.D0.A3.D0.91.D0.94"><span class="mw-headline-number">5</span> <span id="Tests" title="#Tests">ПроизводительноÑÑ‚ÑŒ СУБД</span></span></h2>
<p>Замер производительноÑти СУБД выполнÑлÑÑ Ñ‚ÐµÑтом "БД" Ð¼Ð¾Ð´ÑƒÐ»Ñ Ñ‚ÐµÑтов "SystemTests", путём Ð²Ñ‹Ð¿Ð¾Ð»Ð½ÐµÐ½Ð¸Ñ Ð¾Ð¿ÐµÑ€Ð°Ñ†Ð¸Ð¹ над запиÑÑми Ñтруктурой: "<b>name char (20), descr char (50), val double (10.2), id int (7), stat bool, reqKey string, reqVal string</b>".
</p>
<table class="wikitable">
<tr>
<th> Operations for 1000 records, seconds
</th>
<th> FireBird 2.5<br />AMD Turion L625 1.6, 2G, FireBird [2.1.3 Local SuperServer; 100Base-TX; 2.5.2 100Base-TX SuperServer ForcedWrites=Off; ForcedWrites=On]<br /> Intel(R) Core(TM) i3 CPU 1.33GHz, 3G, HDD [2.5.2 100Base-TX SuperServer ForcedWrites=Off; ForcedWrites=On] </th>
<th> FireBird 3<br />Intel(R) Core(TM) i7 CPU 2.6GHz, 12G, FastSSD, Local network
</th></tr>
<tr>
<td> <i>Creating:</i> </td>
<td> [0.93; 1.15; 4.4; 5.2]; [3.68; 4.67] </td>
<td> 0.5
</td></tr>
<tr>
<td> <i>Updating:</i> </td>
<td> [2.74; 2.94; 5.1; 5.2]; [3.88; 4.54] </td>
<td> 0.47
</td></tr>
<tr>
<td> <i>Getting:</i> </td>
<td> [1.64; 2.22; 5.0; <span style="color: red">27.8</span>]; [3.69; <span style="color: red">28.8</span>] </td>
<td> 2.95
</td></tr>
<tr>
<td> <i>Seeking:</i> </td>
<td> - ; [5.36; <span style="color: red">32</span>] </td>
<td> 3.3
</td></tr>
<tr>
<td> <i>Seeking in preload:</i> </td>
<td> - ; [0.045; 0.065] </td>
<td> 0.047
</td></tr>
<tr>
<td> <i>Deleting:</i> </td>
<td> [0.65; 1.04; 2.0; 2.4]; [1.69; 1.66] </td>
<td> 0.17
</td></tr></table>
<h2><span class="mw-headline" id=".D0.97.D0.B0.D0.BC.D0.B5.D1.87.D0.B0.D0.BD.D0.B8.D1.8F"><span class="mw-headline-number">6</span> ЗамечаниÑ</span></h2>
<p>СУБД FireBird имеет много архитектурных ограничений и проблем в виду наÑледÑтвенноÑти InterBase и родительÑкой ОС MS Windows, которые препÑÑ‚Ñтвуют её широкому иÑпользованию Ð´Ð»Ñ Ð¼Ð½Ð¾Ð³Ð¸Ñ… задач. ИзвеÑтные проблемы:
</p>
<ul><li> СУБД медленнее в Ñравнении Ñ MySQL или PostgreSQL, Ñм. предыдущий раздел. ОÑобенно в режиме ForcedWrites On(sync).</li>
<li> СУБД имеет фикÑированное ограничение на размер Ð²Ñ‹Ñ€Ð°Ð¶ÐµÐ½Ð¸Ñ SQL в 65536 КБ, которое препÑÑ‚Ñтвует размещению большого Ñодержимого иÑключительно поÑредÑтвом SQL.</li>
<li> КлаÑÑичеÑкий Ñервер на Linux, в режиме Ð²Ñ‹ÐºÐ»ÑŽÑ‡ÐµÐ½Ð¸Ñ ForcedWrites, может намертво завиÑать.</li>
<li> ОтÑутÑтвует контроль за лимитами времени подключениÑ, что приводит к продолжительному и неконтролируемому ожиданию в клиентÑких приложениÑÑ….</li></ul>
</div><table style="border-top: dotted 2px #999999; margin-top: 20pt; color: gray;" width="100%"><tr><td style="text-align: left;" width="40%"><a href="http://oscada.org/wiki/Modules/FireBird/ru">Modules/FireBird/ru</a> - <a href="http://oscada.org/en/main/about-the-project/licenses/">GFDL</a></td><td style="text-align: center;">April 2025</td><td style="text-align: right;" width="40%">OpenSCADA 1+r3018</td></tr></table></body>
</html>