Библиотека базы данных

<< Click to Display Table of Contents >>

Навигация  Проект > Скрипты > Язык ST > Встроенные функции >

Библиотека базы данных

Previous pageReturn to chapter overviewNext page

createdbsqlliteconnection(Input1) - создает соединение с базой данных SQLLite с именем в Input1. База данных создается в папке DB.

 

Пример:

createdbsqlliteconnection(”filename”);

 


createdbconnection(Input1, Input2, Input3) -  создает соединение с базой данных с именем в Input1, именем пользователя в Input2 и паролем в Input3.

 

Пример:

createdbconnection(“jdbc:mysql://192.168.0.76:3306/test”, “username”, “password”);в данном примере создается база данных MySQL. (приставка в начале “jdbc:mysql” значит, что создается MySQL соединение).

 


closedbconnection(Input1) -  закрывает соединение с базой данных с именем в Input1.

 

Пример:

closedbconnection(”filename”);

 


createdbtable(Input1, Input2, Input3) -  создает таблицу в базе данных с именем базы данных в Input1, именем таблицы в Input2 и именем столбцов в Input3 (имена столбцов должны быть разделены запятыми, каждая таблица имеет автоматически увеличивающиеся столбец “_id” ).

 

Пример:

createdbtable(“databasename”, “tablename”, “title, parameter1, parameter2”);


cleardbtable(Input1, Input2) -  очищает таблицу в базе данных с именем базы данных в Input1, именем таблицы в Input2.

 

Пример:

cleardbtable(“databasename”, “tablename”);

 


insertvaluesintodb(Input1, Input2, Input3) -  служит для добавления строки в базу данных с именем БД в Input1, именем таблицы в Input2 и значениями в Input3 (значения должны быть разделены запятыми).

 

Пример:

insertvaluesintodb(“databasename”, “tablename”, “Title, 10, 20”);

 


readvaluefromdb(Input1, Input2, Input3, Input4) - служит для чтения значения из базы данных с именем базы данных  в Input1; именем таблицы в Input2;  именем столбца для чтения в Input3; условиями, которым должна соответствовать строка, в Input4 (если несколько строк соответствует условию, читается первая строка).

 

Пример:

string parameter = readvaluefromdb(“databasename”, “tablename”, “parameter1”,”_id=1”);

 


readvaluefromdbinpos(Input1, Input2, Input3, Input4, Input5) - служит для чтения значения из базы данных с именем базы данных  в Input1; именем таблицы в Input2;  именем столбца для чтения в Input3; условиями, которым должна соответствовать строка, в Input4; позицией строки в Input5.

 

Пример:

string parameter = readvaluefromdbinpos(“databasename”, “tablename”, “parameter1”,”title = Title”, 1);

 


updatevalueindb(Input1, Input2, Input3, Input4, Input5) -  служит для обновления значения в базе данных с именем базы данных в Input1; именем таблицы в Input2; именем обновляемого столбца в Input3; условиями, которым должны соответствовать обновляемые строки, в Input4;  значением в Input5 (если несколько строк соответствует условиям, изменяются значения всех строк).

 

Пример:

updatevalueindb(“databasename”, “tablename”, “parameter1”,”title = Title”, “10”);

 


deleterowindb(Input1, Input2, Input3) - служит для удаления строк в базе данных с именем базы данных в Input1; именем таблицы в Input2; условиям, которым должны соответствовать удаляемые строки, в Input3.

 

Пример:

deleterowindb(“databasename”, “tablename”, “_id=1”);

 


readvaluefromhistorydb(Input1, Input2, Input3, Input4, Input5) - служит, для того чтобы считать параметр из исторической базы данных с ее именем в Input1; начальным временем в Input2; конечным временем в Input3; (начальное и конечное время в миллисекундах начиная с 1 Января 1970 года), Input4 - имя параметра в историчесой базе данных; Input5 - количество знаков после запятой в считываемом параметре. Если несколько значений попадают в заданный временной диапазон, то считывается первое значение.

 

Пример:

string parameter = readvaluefromhistorydb(“History DB0”, 1636367879810, 1636367979810,”pressure”, 2);

 


runsql(Input1, Input2) - используется для выполнения SQL запросов с именем базы данных в Input1 и SQL команды в Input2.

 

Пример:

runsql(“databasename”, “create table if not exists param (_id INTEGER PRIMARY KEY AUTOINCREMENT, temperature, pressure, humidity”);

 


runsqlquery(Input1, Input2, Input3) - используется для выполнения SQL запроса с именем базы данных в Input1 и SQL команды Input2. Input3 содержит имя возвращаемого Result set (таблицы). Данный Result set (таблица) помещается в глобальный набор данных, где ключ  - имя содержащееся в Input3.

 

Пример:

runsqlquery(“databasename”, “select * from param”, "resultname");

 


rsfirst(Input1) - используется для перемещения курсора Result set (таблицы) напротив первого ряда. Input1 содержит имя Result set. Возвращает TRUE, если перемещение прошло успешно. Данная функция не работает с базой данных SQL lite.

 

Пример:

rsfirst("resultname");


 

rslast(Input1) -  используется для перемещения курсора Result set (таблицы) напротив последнего ряда. Input1 содержит имя Result set. Возвращает TRUE, если перемещение прошло успешно. Данная функция не работает с базой данных SQL lite.

 

Пример:

rslast("resultname");

 


rsnext(Input1) - используется для перемещения курсора Result set (таблицы) на следующую позицию. Input1 содержит имя Result set. Возвращает TRUE, если перемещение прошло успешно.

 

Пример:

rsnext("resultname");

 


rsisempty(Input1) - используется для проверки наличия данных в Result set (таблицы). Input1 содержит имя Result set. Возвращает TRUE, если результат не содержит данных. Данная функция не работает с базой данных SQL lite.

 

Пример:

rsfempty("resultname");

 


rsmove(Input1, Input2) - используется для перемещения курсора на заданную позицию. Input1 содержит имя Result set. Input2 содержит величину, на которую переместить курсор. Возвращает TRUE, если перемещение прошло успешно.

 

Пример:

rsmove("resultname",3);

 


rsbeforefirst(Input1) - используется для перемещения курсора Result set (таблицы) перед первым рядом. Input1 содержит имя Result set. Возвращает TRUE, если перемещение прошло успешно. Данная функция не работает с базой данных SQL lite.

 

Пример:

rsbeforefirst("resultname");

 


rsafterlast(Input1) - используется для перемещения курсора Result set (таблицы) после последнего ряда. Input1 содержит имя Result set. Возвращает TRUE, если перемещение прошло успешно. Данная функция не работает с базой данных SQL lite.

 

Пример:

rsafterlast("resultname");

 


rspos(Input1) - используется для возврата текущей позиции курсора . Input1 содержит имя Result set. Данная функция не работает с базой данных SQL lite.

 

Пример:

int pos = rspos("resultname");

 


rsreadstring(Input1, Input2) - используется для чтения строковой величины с текущего курсора. Input1 содержит имя Result set. Input2 содержит имя столбца.

 

Пример:

string name = rsreadstring("resultname","name");

 


rsreadstringnum(Input1, Input2) - используется для чтения строковой величины с текущего курсора. Input1 содержит имя Result set. Input2 содержит индекс столбца.

 

Пример:

string name = rsreadstringnum("resultname",2);

 


rsreaddouble(Input1, Input2) - используется для чтения величины double с текущего курсора. Input1 содержит имя Result set. Input2 содержит имя столбца.

 

Пример:

double value = rsreaddouble("resultname","value");

 


rsreaddoublenum(Input1, Input2) - используется для чтения величины double с текущего курсора. Input1 содержит имя Result set. Input2 содержит индекс столбца.

 

Пример:

double value = rsreaddoublenum("resultname",2);

 


rsreadint(Input1, Input2) - используется для чтения величины integer с текущего курсора. Input1 содержит имя Result set. Input2 содержит имя столбца.

 

Пример:

int value = rsreadint("resultname","value");

 


rsreadintnum(Input1, Input2) - используется для чтения величины integer с текущего курсора. Input1 содержит имя Result set. Input2 содержит индекс столбца.

 

Пример:

int value = rsreadintnum("resultname",2);

 


rsreadbool(Input1, Input2) - используется для чтения величины bool с текущего курсора. Input1 содержит имя Result set. Input2 содержит имя столбца.

 

Пример:

bool value = rsreadbool("resultname","value");

 


rsreadboolnum(Input1, Input2) - используется для чтения величины bool с текущего курсора. Input1 содержит имя Result set. Input2 содержит индекс столбца.

 

Пример:

bool value = rsreadboolnum("resultname",2);

 


rsgetcolnum(Input1) - используется для того, чтобы вернуть количество столбцов. Input1 содержит имя Result set.

 

Пример:

int num = rsgetcolnum("resultname");

 


rsgetcol(Input1, Input2) - используется для того, чтобы вернуть имя столбца Result set. Input1 содержит имя Result set. Input2 содержит индекс столбца. Данная функция не работает с базой данных SQL lite.

 

Пример:

string name = rsgetcol("resultname",2);

 


rsremove(Input1) - используется для того, чтобы удалить Result set из глобального хранилища. .Input1 содержит имя Result set.

 

Пример:

rsremove("resultname");