Lua-скрипты — особенности PG-совместимости

Lua-смарт-скрипты работают на обеих СУБД (MS SQL Server и PostgreSQL). Для кросс-платформенного SQL используется функция get_mspg_query() с тегами {MS}...{/MS} и {PG}...{/PG} — внутри них указывается синтаксис для соответствующей СУБД.

Известные проблемы

Различия MS SQL и PostgreSQL, которые нужно учитывать в Lua-скриптах:

Проблема	MSSQL	PG	Решение
[Column] quoting	Работает	Ошибка синтаксиса	{MS}sc.[Key]{/MS}{PG}sc.key{/PG}
Ключи в результатах SQL:query_one / SQL:query	Регистр сохраняется (Value)	Всё в нижнем регистре (value)	data['Value'] or data['value']
CACHE:set с nil	json_encode(nil) → "null"	То же	Всегда проверять переменную перед кэшированием
Устаревший кэш	—	—	CACHE:get проверять на ~= nil и ~= 'null'. Ручного сброса нет — менять имя ключа или ждать TTL
Таблицы без схемы dbo.	Работает (dbo — схема по умолчанию)	42P01: relation not found	Всегда указывать dbo.TableName
NULL в UNION ALL	Чистый NULL → OK	42804: UNION types text and bigint	CAST(NULL AS BIGINT) — кросс-платформенно
Boolean и integer колонки	= 1 везде работает	42883: integer = boolean	Не все колонки Is*/Allow* на PG имеют тип boolean. Проверять тип через information_schema.columns

При преобразовании результата запроса в словарь платформа использует доступ к ключам без учёта регистра. Поэтому в большинстве случаев обращение к полям результата по именам вроде Value/value от регистра не зависит. Однако в «сыром» SQL, при экранированных идентификаторах и явной работе со строковыми ключами различие MSSQL/PG по регистру по-прежнему нужно учитывать.

Работа со скриптами через Admin API

Получение существующего скрипта — GET /api/admin/smart/scripts/{scriptId}/editor; сохранение — POST /api/admin/smart/scripts/editor (тело: {script: <объект скрипта>, context: null}).

Не путать: GET /api/admin/smart/scripts/editor?id=... — это создание нового скрипта (возвращает пустой объект).