База данных

Для взаимодействия с базой данных используется встроенный модуль db.

const db = require('@chemsoft/legacy-db');

Модуль работает через провайдера ODBC с СУБД MS Access, MS SQL Server.

Для СУБД Oracle используется Oracle Call Interface (OCI).

Сигнатура

Модуль db предоставляет несколько функций для работы с базой данных.

Внимание

Все callback аргументы являются синхронными

each(sql[, parameters, callback])

sql: <string> - строка SQL запроса parameters: <any[]> | <any> - параметры запроса callback: <Function> - функция, вызывающаяся для обработки каждой строки результата запроса row: <any[]> - строка выборки. Массив, содержащий выбираемые параметры Функция each позволяет обрабатывать многострочные результаты. Параметры можно пропустить, если они не нужны.

function each(sql: string, callback: (row: any[]) => void): void;

executeScalar(sql[, parameters])

sql: <string> - строка SQL запроса parameters: <any[]> | <any> - параметры запроса Функция executeScalar возвращает первую колонку первой строки запроса.

execute(sql[, parameters)

sql: <string> - строка SQL запроса parameters: <any[]> | <any> - параметры запроса Возвращает: <ExecuteResult> Функция execute возвращает детальный результат выполнения запроса и все полученные данные.

ExecuteResult

rows: <any[][]> - Результат выполнения запроса в виде двумерного массива rowsAffected: <number> - Количество выбранных строк запроса insertedId: <number> - Идентификатор вставленной сущности (работает только для MS SQL)

Пример

const db = require('db'); const message = require('message');

const users = []; db.each('select num_rec, fioisp from login', (r) => {

   const user = {};

   [user.id, user.fullName] = r;
   users.push(user);

   message.show(user);

});

db.execute('insert into uzer (num_user, name_short, name_full) values (?, ?, ?)',

           [10, 'КраткоеИмя', 'ПолноеИмя']);

const fullName = db.executeScalar('select fioisp from login where num_rec = ?',

   [users[0].id]);