adodb

BETA

Что это

Это Node.js пакет для выполнения SQL-запросов к базам данных MS Access. Предназначен для использования
на Windows XP и старше. В режиме "клиент-сервер" клиентская часть может использоваться без ограничения операционной
системы.

Зачем это

Для подключения из приложений Node.js к базам данных в формате MS Access.

Какие есть аналоги?

node-adodb. Идея подключения из Node.js к ADODB.Connection через
JScript почерпнута оттуда. Настоящий пакет фактически является переделкой node-adodb, c целью добавления новых
возможностей и устраненния недостатков.

Как это устроено?

Node.js запускает (spawn) процесс Windows Script Host для выполнения небольшого JScript, который фактически и выполняет
SQL-запрос с помощью ADODB.Connection. Данные между процессами передаются через стандартные потоки ввода-вывода: stdin,
stdout, sterr.

Системные требования

Windows XP, 7, Vista, 8, 8.1, 10, Node.js v.4.x (более старшие версии Node.js не тестировались, поскольку не работают на Windows XP),
Microsoft.Jet.OLEDB.4.0. В случае использования пакета в режиме "клиент-сервер" системные требования действительны для
только серверной части. Клиентская часть не использует специфичный для Windows код.

Дополнительные возможности

1. Расширен синтаксис SQL:
1. разрешены комментарии в коде
1. TODO несколько операторов через ";" (multiple statements)
1. Работа в режиме клиент-сервер.
1. Турбо-режим, т.е. использование Recordset.GetString() вместо Recordset.MoveNext(), что значительно ускоряет выполнение
SQL-запросов, особенно с большим количеством столбцов. Применять турбо-режим можно только с оговоркой, что в
возвращаемых данных гарантировано отсутствует символ табуляции (символ табуляции используется процедурой
Recordset.GetString() для разделения строк и столбцов). TODO Отлючение турбо-режима для применения
пакета без оговорок.
1. TODO Потоковый (stream) режим возвращения результатов SQL-запроса.

Использование

$3

TODO

$3

#### Серверная часть
##### Установить серверную часть

C:\>npm install adodb -g
C:\>mkdir adodb-config
C:\>cd adodb-config
C:\adodb-config>adodb run
ADODB_PATH: undefined
config file: C:\adodb\adodb-config.json
opened server on {"address":"::","family":"IPv6","port":4023}
Ctrl+C
^CЗавершить выполнение пакетного файла [Y(да)/N(нет)]? y

В текущем каталоге будет создан файл adodb-config.json.
Его небходимо отредактировать, указав порт и строку подключения к базе данных MS Access.
При наличии системной переменной ADODB_PATH файл adodb-config.json будет создан в каталоге,
указанном этой системной переменной.

##### Запустить сервер для проверки настроек:

C:\adodb-config>adodb run

##### Проверить работу сервера

C:\>telnet localhost 4023
connStr: Provider=Microsoft.Jet.OLEDB.4.0;Data Source=Data Source=C:\node487\node_modules\adodb\test\media\Northwind2003.mdb
endStr: END{6251729b-82fb-4b89-9bf8-d550c78acd3f}
LOCALS
{"OEMCP":"866","ACP":"1251","sDecimal":",","sShortDate":"yyyy-MM-dd","sTimeFormat":"H:m:s"}
END{6251729b-82fb-4b89-9bf8-d550c78acd3f}
testing db connection: OK


CTRL+]
Microsoft Telnet> q
C:\>

##### Установить сервер как сервис windows

C:\adodb-config>adodb install

##### Удалить ранее установленный сервис windows

C:\adodb-config>adodb uninstall

##### Полный список команд

C:\adodb-config>adodb