English version
Óêðà¿íñüêà âåðñ³ÿ

Ââåäåíèå

Ìîäóëü <MySQL> ïðåäîñòàâëÿåò â ñèñòåìó OpenSCADA ïîääåðæêó ÁÄ MySQL. ÁÄ MySQL ÿâëÿåòñÿ ìîùíîé ðåëÿöèîííîé è ìíîãîïëàòôîðìåííîé ÁÄ äîñòóïíîé ïî ñâîáîäíîé ëèöåíçèè. Ðàçðàáîò÷èêîì ÁÄ MySQL ÿâëÿåòñÿ ôèðìà MySQL AB http://www.mysql.com. Ìîäóëü îñíîâàí íà áèáëèîòåêå C API ïðîèçâîäèòåëÿ ÁÄ MySQL. Ìîäóëü ïîçâîëÿåò âûïîëíÿòü äåéñòâèÿ íàä áàçàìè äàííûõ, òàáëèöàìè è ñîäåðæèìûì òàáëèö.

1. Îïåðàöèè íàä ÁÄ

Ïîääåðæèâàþòñÿ îïåðàöèè îòêðûòèÿ è çàêðûòèÿ ÁÄ ñ âîçìîæíîñòüþ ñîçäàíèÿ íîâîé ÁÄ ïðè îòêðûòèè è óäàëåíèÿ ñóùåñòâóþùåé ïðè çàêðûòèè.  òåðìèíàõ ïîäñèñòåìû «ÁÄ» ñèñòåìû OpenSCADA îòêðûòèåì ÁÄ ÿâëÿåòñÿ å¸ ðåãèñòðàöèÿ äëÿ ïîñëåäóþùåãî èñïîëüçîâàíèÿ â ñèñòåìå. Òàêæå ïîääåðæèâàåòñÿ îïåðàöèÿ çàïðîñà ñïèñêà òàáëèö â ÁÄ.

ÁÄ MySQL àäðåñóåòñÿ ñòðîêîé ñëåäóþùåãî òèïà: "{host};{user};{pass};{db};{port}[;{u_sock}[;{charset-collation}[;{tms}]]]". Ãäå:

• host — èìÿ õîñòà íà êîòîðîì ðàáîòàåò ñåðâåð ÁÄ MySQL;
• user — èìÿ ïîëüçîâàòåëÿ ÁÄ;
• pass — ïàðîëü ïîëüçîâàòåëÿ äëÿ äîñòóïà ê ÁÄ;
• bd — èìÿ ÁÄ;
• port — ïîðò, êîòîðûé ñëóøàåò ñåðâåð ÁÄ (ïî óìîë÷àíèþ 3306);
• u_sock — èìÿ UNIX-ñîêåòà â ñëó÷àå ëîêàëüíîãî äîñòóïà ê ÁÄ (/var/lib/mysql/mysql.sock);
• charset-collation-engine — òàáëèöà ñèìâîëîâ, ðåæèì ñðàâíåíèÿ è äâèæîê õðàíèëèùà ÁÄ äëÿ CREATE DATABASE è SET;
• tms — òàéìàóòû MySQL â ôîðìàòå "{connect},{read},{write}" è ñåêóíäàõ.

 ñëó÷àå ëîêàëüíîãî äîñòóïà ê ÁÄ â ïðåäåëàõ îäíîãî õîñòà íóæíî èñïîëüçîâàòü UNIX ñîêåò. Íàïðèìåð: ";roman;123456;OpenSCADA;;/var/lib/mysql/mysql.sock;utf8-utf8_general_ci-MyISAM;5,2,2"

 ñëó÷àå óäàë¸ííîãî äîñòóïà ê ÁÄ íóæíî èñïîëüçîâàòü èìÿ õîñòà è ïîðò ñåðâåðà ÁÄ. Íàïðèìåð: "server.nm.org;roman;123456;OpenSCADA;3306"

2. Îïåðàöèè íàä òàáëèöåé

Ïîääåðæèâàþòñÿ îïåðàöèè îòêðûòèÿ, çàêðûòèÿ òàáëèöû ñ âîçìîæíîñòüþ ñîçäàíèÿ íîâîé òàáëèöû ïðè îòêðûòèè è óäàëåíèÿ ñóùåñòâóþùåé ïðè çàêðûòèè, à òàêæå çàïðîñ ñòðóêòóðû òàáëèöû.

3. Îïåðàöèè íàä ñîäåðæèìûì òàáëèöû

• ñêàíèðîâàíèå çàïèñåé òàáëèöû;
• çàïðîñ çíà÷åíèé óêàçàííûõ çàïèñåé;
• óñòàíîâêà çíà÷åíèÿ óêàçàííûõ çàïèñåé;
• óäàëåíèå çàïèñåé.

API ïîäñèñòåìû “ÁÄ” ïðåäïîëàãàåò äîñòóï ê ñîäåðæèìîìó òàáëèöû ïî çíà÷åíèþ êëþ÷åâîãî(ûõ) ïîëÿ(åé). Òàê, îïåðàöèÿ çàïðîñà çàïèñè ïîäðàçóìåâàåò ïðåäâàðèòåëüíóþ óñòàíîâêó êëþ÷åâûõ êîëîíîê îáúåêòà TConfig, ïî êîòîðûì áóäåò âûïîëíåí çàïðîñ. Ñîçäàíèå íîâîé çàïèñè(ñòðîêè) ïðîèçâîäèòñÿ îïåðàöèåé óñòàíîâêè çíà÷åíèé çàïèñè, êîòîðàÿ îòñóòñòâóåò.

Ìîäóëü ïîçâîëÿåò äèíàìè÷åñêè èçìåíÿòü ñòðóêòóðó òàáëèö ÁÄ MySQL. Òàê, â ñëó÷àå íåñîîòâåòñòâèÿ ñòðóêòóðû òàáëèöû è ñòðóêòóðû óñòàíàâëèâàåìîé çàïèñè, ñòðóêòóðà òàáëèöû áóäåò ïðèâåäåíà ê òðåáóåìîé ñòðóêòóðå çàïèñè.  ñëó÷àå çàïðîñà çíà÷åíèé çàïèñè è íå ñîîòâåòñòâèÿ ñòðóêòóð çàïèñè è òàáëèöû, áóäóò ïîëó÷åíû òîëüêî çíà÷åíèÿ îáùèõ ýëåìåíòîâ çàïèñè è òàáëèöû. Ìîäóëü íå îòñëåæèâàåò ïîðÿäîê ðàñïîëîæåíèÿ ýëåìåíòîâ â çàïèñè è ñòðóêòóðå òàáëèöû.

Ìîäóëåì ðåàëèçóåòñÿ ìåõàíèçì ïîääåðæêè ìíîãîÿçûêîâûõ òåêñòîâûõ ïåðåìåííûõ. Äëÿ ïîëåé ñ ìíîãîÿçûêîâîé òåêñòîâîé ïåðåìåííîé ñîçäàþòñÿ êîëîíêè îòäåëüíûõ ÿçûêîâ â ôîðìàòå <lang>#<FldID> (en#NAME). Ïðè ýòîì áàçîâàÿ êîëîíêà ñîäåðæèò çíà÷åíèå äëÿ áàçîâîãî ÿçûêà. Êîëîíêè îòäåëüíûõ ÿçûêîâ ñîçäàþòñÿ ïî íàäîáíîñòè, â ìîìåíò ñîõðàíåíèÿ â ÁÄ è ïðè èñïîëíåíèè OpenSCADA â ñîîòâåòñòâóþùåé ëîêàëè.  ñëó÷àå îòñóòñòâèÿ çíà÷åíèÿ äëÿ êîíêðåòíîãî ÿçûêà áóäåò èñïîëüçîâàòüñÿ çíà÷åíèé äëÿ áàçîâîãî ÿçûêà.

Òèïû ýëåìåíòîâ ÁÄ MySQL ñëåäóþùèì îáðàçîì ñîîòâåòñòâóþò òèïàì ýëåìåíòîâ ñèñòåìû OpenSCADA:

4. Äîñòóï ê ÁÄ

ÁÄ MySQL ñîäåðæèò ìîùíûé ìåõàíèçì ðàçäåëåíèÿ äîñòóïà, êîòîðûé çàêëþ÷àåòñÿ â âûáîðî÷íîì óêàçàíèè äîñòóïà ïîëüçîâàòåëÿ ÁÄ ê îòäåëüíûì SQL-êîìàíäàì.  òàáëèöå íèæå ïåðå÷èñëåíû îïåðàöèè íàä ÁÄ è òðåáóåìûé äîñòóï ê êîìàíäàì äëÿ ýòèõ îïåðàöèé.

Êðàòêî ðàññìîòðèì ïðîöåäóðó ïåðâè÷íîé íàñòðîéêè ñåðâåðà MySQL ñ öåëüþ ïîäêëþ÷åíèÿ ê íåìó ñ ïîìîùüþ äàííîãî ìîäóëÿ:

• Óñòàíîâêà ñåðâåðà ÑÓÁÄ MySQL â âèäå ïàêåòà èëè ñáîðêîé.
• Çàïóñê ñåðâåðà ÁÄ, åñëè íå çàïóñòèëñÿ ñðàçó:
  $ service mysqld start

  
  
• Óñòàíàâëèâàåì íóæíûé ïàðîëü äëÿ ñèñòåìíîãî ïîëüçîâàòåëÿ "root":
  $ mysqladmin -u root password '123456'

  
  
• Ïîäêëþ÷àåìñÿ ê ñåðâåðó ÁÄ ëîêàëüíî ñ ïîìîùüþ äàííîãî ìîäóëÿ, ââåäÿ àäðåñ ÁÄ: "localhost;root;123456;test;;;utf8"
• Ðàçðåøàåì âíåøíèé äîñòóï:
  • my.cnf: Ìåíÿåì çíà÷åíèå "bind-address" íà "0.0.0.0" äëÿ äîñòóïà ñî âñåõ èíòåðôåéñîâ.
  • Ïîäêëþ÷àåìñÿ ê ÑÓÁÄ ëîêàëüíî äëÿ óïðàâëåíèÿ ïîëüçîâàòåëÿìè "$ mysql -u root -p":
    • Ïîëó÷àåì ïåðå÷åíü ïîëüçîâàòåëåé: "SELECT Host,User,Password FROM mysql.user;"
    • Äîáàâëÿåì ïîëüçîâàòåëÿ: "CREATE USER 'newuser'@'%' IDENTIFIED BY 'password';"
    • Óäàëÿåì ïîëüçîâàòåëÿ: "DROP USER 'newuser'@'%’;"
    • Èçìåíèòü ïàðîëü: "UPDATE mysql.user SET Password=PASSWORD('newpass') WHERE User='newuser';
    • Óñòàíàâëèâàåì ïîëüçîâàòåëþ âñå ïðàâà: "GRANT ALL PRIVILEGES ON *.* TO 'newuser'@'%';"
    • Ïðèìåíÿåì ïðèâèëåãèè: "FLUSH PRIVILEGES;"

5. Ïðîèçâîäèòåëüíîñòü ÁÄ

Çàìåð ïðîèçâîäèòåëüíîñòè ÁÄ âûïîëíÿëñÿ òåñòîì «ÁÄ» ìîäóëÿ ñèñòåìíûõ òåñòîâ "SystemTests" ïóò¸ì âûïîëíåíèÿ îïåðàöèé íàä çàïèñÿìè ñòðóêòóðîé: <name char (20), descr char (50), val double (10.2), id int (7), stat bool, reqKey string, reqVal string>.

Ññûëêè