<?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>Модулі/SQLite - 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="uk">Модулі/SQLite</h1>
</div><div class="mw-content-ltr" dir="ltr" id="mw-content-text" lang="uk"><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%2FSQLite&action=page&filter=&language=uk" rel="nofollow noreferrer noopener" target="_blank">translated version</a></span> of the page <a class="external" href="http://oscada.org/wiki/Modules/SQLite" title="Modules/SQLite">Modules/SQLite</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/SQLite.html" title="Modules/SQLite (100% translated)">English</a> • ‎<a class="mw-pt-progress mw-pt-progress--complete" href="../../ru/Modules/SQLite.html" title="Модули/SQLite (100% translated)">mRussian</a> • ‎<span class="mw-pt-languages-selected mw-pt-progress mw-pt-progress--complete">УкраїнÑька</span></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/SQLite.html" title="Special:MyLanguage/Modules/SQLite">SQLite</a> </td>
<td> БД SQLite
<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, ERR</li></ul>
</td>
<td> 4.0 </td>
<td> GPL2 </td>
<td> bd_SQLite.so </td>
<td> en,uk,ru,de </td>
<td> x86,x86_64,ARM
</td>
<td> БД </td>
<td> Роман Савоченко </td>
<td> Модуль БД. Ðадає підтримку БД SQLite.
</td></tr></table>
<p>Модуль надає до OpenSCADA підтримку БД SQLite. БД SQLite Ñ” невеличкою та вбудованою БД, Ñка підтримує SQL-запити. БД SQLite розповÑюджуєтьÑÑ Ð·Ð° вільною ліцензією. ОзнайомитиÑÑ Ð· БД можна на Ñайті БД — <a class="external free" href="http://sqlite.org" rel="nofollow noreferrer noopener" target="_blank">http://sqlite.org</a>. Модуль оÑнований на бібліотеці API виробника БД мови "C". Модуль дозволÑÑ” виконувати дії над базами даних, таблицÑми та вміÑтом таблиць.
</p><p>Модуль наразі підтримує конкурентну роботу із Ñпільними файлами БД, на кшталт бібліотек, із різних процеÑів OpenSCADA, шлÑхом коректного Ð¾Ð¿Ñ€Ð°Ñ†ÑŽÐ²Ð°Ð½Ð½Ñ Ð±Ð»Ð¾ÐºÑƒÐ²Ð°Ð½Ð½Ñ Ñ„Ð°Ð¹Ð»Ñ–Ð². Тож ви будете отримувати Ð¿Ð¾Ð¿ÐµÑ€ÐµÐ´Ð¶ÐµÐ½Ð½Ñ Ð´Ð¾ÐºÐ¸ файл залишатиметьÑÑ Ð·Ð°Ð±Ð»Ð¾ÐºÐ¾Ð²Ð°Ð½Ð¸Ð¼, та зможете вдало запиÑати до нього щойно він буде звільнений закриттÑм транзакції блокуючим процеÑом.
</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.D1.96.D1.97_.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.D1.96.D1.97_.D0.BD.D0.B0.D0.B4_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D0.B5.D1.8E"><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.D1.96.D1.97_.D0.BD.D0.B0.D0.B4_.D0.B2.D0.BC.D1.96.D1.81.D1.82.D0.BE.D0.BC_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D1.96"><span class="tocnumber">3</span> <span class="toctext">Операції над вміÑтом таблиці</span></a></li>
<li class="toclevel-1 tocsection-4"><a href="#.D0.9F.D1.80.D0.B0.D0.B2.D0.B0_.D0.B4.D0.BE.D1.81.D1.82.D1.83.D0.BF.D1.83"><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.B4.D1.83.D0.BA.D1.82.D0.B8.D0.B2.D0.BD.D1.96.D1.81.D1.82.D1.8C_.D0.91.D0.94"><span class="tocnumber">5</span> <span class="toctext"><span>ПродуктивніÑÑ‚ÑŒ БД</span></span></a></li>
</ul>
</div>
<h2><span class="mw-headline" id=".D0.9E.D0.BF.D0.B5.D1.80.D0.B0.D1.86.D1.96.D1.97_.D0.BD.D0.B0.D0.B4_.D0.91.D0.94"><span class="mw-headline-number">1</span> Операції над БД</span></h2>
<p>ПідтримуютьÑÑ Ð¾Ð¿ÐµÑ€Ð°Ñ†Ñ–Ñ— Ð²Ñ–Ð´ÐºÑ€Ð¸Ñ‚Ñ‚Ñ Ñ‚Ð° Ð·Ð°ÐºÑ€Ð¸Ñ‚Ñ‚Ñ Ð‘Ð”, з можливіÑÑ‚ÑŽ ÑÑ‚Ð²Ð¾Ñ€ÐµÐ½Ð½Ñ Ð½Ð¾Ð²Ð¾Ñ— БД при відкритті та Ð²Ð¸Ð´Ð°Ð»ÐµÐ½Ð½Ñ Ñ–Ñнуючої при закритті. У термінах підÑиÑтеми "БД" OpenSCADA, відкриттÑм БД Ñ” Ñ—Ñ— реєÑÑ‚Ñ€Ð°Ñ†Ñ–Ñ Ð´Ð»Ñ Ð½Ð°Ñтупного викориÑÑ‚Ð°Ð½Ð½Ñ Ð¿Ñ€Ð¾Ð³Ñ€Ð°Ð¼Ð¾ÑŽ. Також, підтримуєтьÑÑ Ð¾Ð¿ÐµÑ€Ð°Ñ†Ñ–Ñ Ð·Ð°Ð¿Ð¸Ñ‚Ñƒ переліку таблиць у БД.
</p><p>БД SQLite адреÑуєтьÑÑ ÑˆÐ»Ñхом Ð²Ð¸Ð·Ð½Ð°Ñ‡ÐµÐ½Ð½Ñ Ñ–Ð¼'Ñ Ñ„Ð°Ð¹Ð»Ñƒ БД у форматі "<b>{FileDBPath}</b>". Де:
</p>
<ul><li> <i>FileDBPath</i> — повний шлÑÑ… до файлу БД (./oscada/Main.db).</li></ul>
<dl><dd>ВикориÑтовуйте порожній шлÑÑ… Ð´Ð»Ñ ÑÑ‚Ð²Ð¾Ñ€ÐµÐ½Ð½Ñ Ñ‚Ð¸Ð¼Ñ‡Ð°Ñової бази даних на диÑку.</dd>
<dd>ВикориÑтовуйте ":memory:" Ð´Ð»Ñ ÑÑ‚Ð²Ð¾Ñ€ÐµÐ½Ð½Ñ Ñ‚Ð¸Ð¼Ñ‡Ð°Ñової бази даних у пам'ÑÑ‚Ñ–.</dd></dl>
<h2><span class="mw-headline" id=".D0.9E.D0.BF.D0.B5.D1.80.D0.B0.D1.86.D1.96.D1.97_.D0.BD.D0.B0.D0.B4_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D0.B5.D1.8E"><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.D1.96.D1.97_.D0.BD.D0.B0.D0.B4_.D0.B2.D0.BC.D1.96.D1.81.D1.82.D0.BE.D0.BC_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D1.96"><span class="mw-headline-number">3</span> Операції над вміÑтом таблиці</span></h2>
<ul><li> ÑÐºÐ°Ð½ÑƒÐ²Ð°Ð½Ð½Ñ Ð·Ð°Ð¿Ð¸Ñів таблиці;</li>
<li> запит значень визначених запиÑів;</li>
<li> вÑÑ‚Ð°Ð½Ð¾Ð²Ð»ÐµÐ½Ð½Ñ Ð·Ð½Ð°Ñ‡ÐµÐ½ÑŒ визначених запиÑів;</li>
<li> Ð²Ð¸Ð´Ð°Ð»ÐµÐ½Ð½Ñ Ð·Ð°Ð¿Ð¸Ñів.</li></ul>
<p>API підÑиÑтеми "БД" передбачає доÑтуп до вміÑту таблиці за значеннÑм ключового(их) полів. Так, Ð¾Ð¿ÐµÑ€Ð°Ñ†Ñ–Ñ Ð·Ð°Ð¿Ð¸Ñ‚Ñƒ запиÑу передбачає попереднє вÑÑ‚Ð°Ð½Ð¾Ð²Ð»ÐµÐ½Ð½Ñ ÐºÐ»ÑŽÑ‡Ð¾Ð²Ð¸Ñ… Ñтовпчиків об'єкту TConfig, за Ñким буде здійÑнено запит. Ð¡Ñ‚Ð²Ð¾Ñ€ÐµÐ½Ð½Ñ Ð½Ð¾Ð²Ð¾Ð³Ð¾ запиÑу(Ñ€Ñдка) здійÑнюєтьÑÑ Ð¾Ð¿ÐµÑ€Ð°Ñ†Ñ–Ñ”ÑŽ вÑÑ‚Ð°Ð½Ð¾Ð²Ð»ÐµÐ½Ð½Ñ Ð·Ð½Ð°Ñ‡ÐµÐ½ÑŒ запиÑу, Ñкий відÑутній.
</p><p>Модуль дозволÑÑ” динамічно мінÑти Ñтруктуру таблиць БД SQLite, шлÑхом ÑÑ‚Ð²Ð¾Ñ€ÐµÐ½Ð½Ñ Ð½Ð¾Ð²Ð¾Ñ— БД з потрібною Ñтруктурою та ÐºÐ¾Ð¿Ñ–ÑŽÐ²Ð°Ð½Ð½Ñ Ð´Ð¾ неї даних зі Ñтарої. Так, у випадку невідповідноÑÑ‚Ñ– Ñтруктури таблиці та Ñтруктури запиÑу що вÑтановлюєтьÑÑ, Ñтруктуру таблиці буде приведено до потрібної Ñтруктури запиÑу. У випадку запиту значень запиÑу та невідповідноÑÑ‚Ñ– Ñтруктур запиÑу Ñ– таблиці, буде отримано тільки Ð·Ð½Ð°Ñ‡ÐµÐ½Ð½Ñ Ð·Ð°Ð³Ð°Ð»ÑŒÐ½Ð¸Ñ… елементів запиÑу та таблиці. Модуль не відÑтежує поÑлідовноÑÑ‚Ñ– Ñ€Ð¾Ð·Ñ‚Ð°ÑˆÑƒÐ²Ð°Ð½Ð½Ñ ÐµÐ»ÐµÐ¼ÐµÐ½Ñ‚Ñ–Ð² запиÑу та Ñтруктури таблиці!
</p><p>Модулем реалізуєтьÑÑ Ð¼ÐµÑ…Ð°Ð½Ñ–Ð·Ð¼ підтримки багатомовних текÑтових змінних. Ð”Ð»Ñ Ð¿Ð¾Ð»Ñ–Ð² із багатомовною текÑтовою змінною ÑтворюютьÑÑ Ñтовпчики окремих мов у форматі "<b>{lang}#{FldID}</b>" (en#NAME). При цьому, базовий Ñтовпчик міÑтить Ð·Ð½Ð°Ñ‡ÐµÐ½Ð½Ñ Ð´Ð»Ñ Ð±Ð°Ð·Ð¾Ð²Ð¾Ñ— мови. Стовпчики окремих мов ÑтворюютьÑÑ Ð·Ð° потреби, у момент Ð·Ð±ÐµÑ€ÐµÐ¶ÐµÐ½Ð½Ñ Ð´Ð¾ БД та при виконанні OpenSCADA у відповідній локалі. У випадку відÑутноÑÑ‚Ñ– значень Ð´Ð»Ñ ÐºÐ¾Ð½ÐºÑ€ÐµÑ‚Ð½Ð¾Ñ— мови буде викориÑтано Ð·Ð½Ð°Ñ‡ÐµÐ½Ð½Ñ Ð´Ð»Ñ Ð±Ð°Ð·Ð¾Ð²Ð¾Ñ— мови.
</p><p>Типи елементів БД SQLite наÑтупним чином відповідають типам елементів OpenSCADA:
</p>
<table class="wikitable">
<tr>
<th> Типи полів OpenSCADA </th>
<th> Типи полів БД SQLite
</th></tr>
<tr>
<td> TFld::String </td>
<td> TEXT
</td></tr>
<tr>
<td> TFld::Integer, TFld::Boolean </td>
<td> INTEGER
</td></tr>
<tr>
<td> TFld::Real </td>
<td> DOUBLE
</td></tr></table>
<h2><span class="mw-headline" id=".D0.9F.D1.80.D0.B0.D0.B2.D0.B0_.D0.B4.D0.BE.D1.81.D1.82.D1.83.D0.BF.D1.83"><span class="mw-headline-number">4</span> Права доÑтупу</span></h2>
<p>Права доÑтупу до БД визначаютьÑÑ Ð¿Ñ€Ð°Ð²Ð°Ð¼Ð¸ доÑтупу до окремо взÑтого файлу БД. Модулем підтримуєтьÑÑ Ñ€Ð¾Ð±Ð¾Ñ‚Ð° з файлами БД SQLite у режимі тільки Ð´Ð»Ñ Ñ‡Ð¸Ñ‚Ð°Ð½Ð½Ñ, наприклад, у демонÑтраціÑÑ….
</p>
<h2><span class="mw-headline" id=".D0.9F.D1.80.D0.BE.D0.B4.D1.83.D0.BA.D1.82.D0.B8.D0.B2.D0.BD.D1.96.D1.81.D1.82.D1.8C_.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> Nokia N800, SD 4GClass6<br />Nokia N900 </th>
<th> RPi2 Debian8 Class10 UHS1;<br />RPi3 Debian8 Class10 UHS1;<br />OrangePiZero Debian8 Class2 </th>
<th> AMD Turion L625 1.6, 2G [HDD; SSD]<br />Intel(R) Core(TM) i3 CPU 1.33GHz, 3G [HDD; SSD];<br />Intel(R) Core(TM) i7 CPU 2.6GHz, 12G FastSSD
</th></tr>
<tr>
<td> <i>Creating:</i> </td>
<td> 3.3; 1.96 </td>
<td> 0.78; 0.43; 0.48 </td>
<td> [0.49; 0.2]; [0.39; 0.22]; 0.056
</td></tr>
<tr>
<td> <i>Updating:</i> </td>
<td> 3.2; 2.47 </td>
<td> 0.7; 0.41; 0.45 </td>
<td> [0.48; 0.19]; [0.40; 0.21]; 0.053
</td></tr>
<tr>
<td> <i>Getting:</i> </td>
<td> 2.6; 1.81 </td>
<td> 0.69; 0.38; 0.45 </td>
<td> [0.36; 0.19]; [0.31; 0.21]; 0.051
</td></tr>
<tr>
<td> <i>Seeking:</i> </td>
<td> 3.1; 1.48 </td>
<td> 0.76; 0.42; 0.51 </td>
<td> [-; 0.22]; [0.21; 0.22]; 0.052
</td></tr>
<tr>
<td> <i>Seeking in preload:</i> </td>
<td> 0.53; 0.29 </td>
<td> 0.13; 0.071; 0.088 </td>
<td> [-; 0.028]; [0.027; 0.028]; 0.0073
</td></tr>
<tr>
<td> <i>Deleting:</i> </td>
<td> 1.18; 0.43 </td>
<td> 0.20; 0.10; 0.13 </td>
<td> [0.08; 0.058]; [0.067; 0.069]; 0.012
</td></tr></table>
</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/SQLite/uk">Modules/SQLite/uk</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>