From 60468b523c9c3820e3d272f49cca93ce0019254e Mon Sep 17 00:00:00 2001 From: Almaz Sharipov Date: Wed, 9 Apr 2025 09:18:47 +0300 Subject: [PATCH] Update README.ru.md --- README.ru.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/README.ru.md b/README.ru.md index 527d920..9efc87f 100644 --- a/README.ru.md +++ b/README.ru.md @@ -2,3 +2,50 @@ [![en](https://img.shields.io/badge/lang-ru-red.svg)](https://github.com/alm494/sql_proxy/blob/main/README.ru.md) # SQL-PROXY + +## Описание + +Легковесный REST-сервис, разработанный для замены вызовов ADODB в устаревших программных системах, поддерживающих веб-запросы. +Этот сервис упрощает взаимодействие с базами данных, сохраняя при этом безопасность и эффективность. + +Например, вы можете удалить все несовместимые с Linux компоненты, такие как следующие элементы (пример для 1С:Предприятие): + +``` +Соединение = Новый COMObject("ADODB.Connection"); +Соединение.Open(СтрокаСоединения); +``` + + +и вместо этого использовать веб-запросы аналогичным образом, применяя простую библиотеку для получения результатов SQL-запросов в формате JSON с переменным числом колонок, определяемых текстом SQL-запроса: + +``` +Функция УстановитьSQLСоединение(СтрокаСоединения) Экспорт + HTTP = Новый HTTPConnection; + ПутьAPI = "/api/v1/connection"; + ... +``` + + +Обратитесь к примеру для языка 1С:Предприятие в папке src/doc, чтобы узнать, как использовать этот API. Обратите внимание, что данный сервис не ограничен только 1С и может быть использован в других системах. + +## Описание API + +Текущая версия API: 1.2. См. спецификацию Swagger OpenAPI 3.0 в папке src/docs/api + +![API overview](src/docs/api/swagger.png) + +## Как скомпилировать + +Номер текущей версии: 1.2.1. Выполнить в командной строке: + +``` +make prod +``` + +## Как запустить + +Все параметры передаются через переменные окружения, см. Makefile для детальной информации: + +``` +BIND_ADDR=localhost BIND_PORT=8081 MAX_ROWS=10000 LOG_LEVEL=3 sql-proxy +```