Доработка документации СУБД

docs/en/md/Instructions/MSSQL.md

@@ -30,6 +30,36 @@ This library has two parts: basic methods, like connecting and executing SQL que
 
 By default, all SELECT queries return an array of selected data, while other queries return only `true` in the `result` field on success, or `false` and error text in the `result` and `error` fields, respectively. To execute queries that require data to be returned but are not SELECT queries, the `ExecuteSQLQuery()` function has a `ForceResult` parameter
 
+## Query parameters
+
+The MSSQL connector supports the use of positional parameters. All values passed both when executing queries directly through the `ExecuteRequestSQL()` function and in ORM methods with value setting, such as `AddRecords` and `UpdateRecords`, must be a structure of the form `{'Data Type': 'Value'}`. The following data types are supported\*:
+
+> \* The MSSQL type list lists only a few suitable types
+
+  | Имя типа (ключ структуры) | Тип значения 1С | Подходит для типов MSSQL |
+  |-|-|-|
+  | TINYINT | Number  | tinyint |
+  | SMALLINT | Number  | smallint |
+  | INT | Number  | int |
+  | BIGINT | Number  | bigint |
+  | FLOAT24 | Number  | float(24), real |
+  | FLOAT53 | Number  | float(53) |
+  | NUMERIC | Number  | decimal, numeric |
+  | DECIMAL | Number  | decimal, numeric |
+  | BIT | Bool | bit |
+  | NVARCHAR | String | nvarchar, varchar, nchar, char, ntext, text |
+  | UUID | String, UUID | uniqueidentifier |
+  | XML | String | xml |
+  | DATE | Date, String | date |
+  | TIME | Date, String | time |
+  | DATETIME | Date, String | datetime, datetime2 |
+  | DATETIMEOFFSET | Date, String | datetimeoffset |
+  | BYTES | BinaryData | varbinary |
+
+## Retrieving Binary Data
+
+Binary data retrieved from the database will be represented as an object (structure) of the form `{"BYTES": "Base64 string"}` and must be manually converted from Base64
+
 ## TLS
 
 The library supports operation in TLS mode. To enable it, you need to configure TLS settings using the `GetTlsSettings` function and pass them as the corresponding parameter to the `CreateConnection` function or one of the ORM functions that support this parameter. If the TLS parameter is not provided when calling these functions, the connection will be initialized in an unsecured mode.

docs/en/md/Instructions/MySQL.md

@@ -47,7 +47,9 @@ The MySQL connector supports the use of positional parameters. All values passed
   | TIME | Дата, String (RFC 3339) | TIME |
   | TEXT | String | CHAR, VARCHAR, TINYTEXT, TEXT, MEDIUMTEXT, LONGTEXT, SET  |
 
+## Retrieving Binary Data
 
+Binary data retrieved from the database will be represented as an object (structure) of the form `{"BYTES": "Base64 string"}` and must be manually converted from Base64
 
 ## TLS
 

docs/en/md/Instructions/PostgreSQL.md

@@ -72,6 +72,10 @@ The PostgreSQL connector supports the use of positional parameters. All values p
 
 A similar list of types is also available to retrieve as query results from PostgreSQL
 
+## Retrieving Binary Data
+
+Binary data retrieved from the database will be represented as an object (structure) of the form `{"BYTES": "Base64 string"}` and must be manually converted from Base64
+
 ## TLS
 
 The library supports operation in TLS mode. To enable it, you need to configure TLS settings using the `GetTlsSettings` function and pass them as the corresponding parameter to the `CreateConnection` function or one of the ORM functions that support this parameter. If the TLS parameter is not provided when calling these functions, the connection will be initialized in an unsecured mode.

docs/ru/md/Instructions/MSSQL.md

@@ -31,6 +31,35 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
 
 По умолчанию, все запросы SELECT возвращают массив выбранных данных, а остальные запросы - только `true` в поле `result` при успехе, либо `false` и текст ошибки в полях `result` и `error` соответственно. Для выполнения запросов, требующих возврата данных, но не являющихся запросами SELECT, в функции `ВыполнитьЗапросSQL()` есть параметр `ФорсироватьРезультат`
 
+## Параметры запросов
+
+Коннектор MSSQL поддерживает использование позиционных параметров. Все значения, передаваемые как при прямом выполнении запросов через функцию `ВыполнитьЗапросSQL()`, так и в ORM методах с установкой значений, вроде `ДобавитьЗаписи` и `ОбновитьЗаписи`, должный представлять из себя структуру вида `{'Тип данных': 'Значение'}`. Поддерживаются следующие типы данных\*:
+
+> \* В перечне типов MSSQL  перечислены только некоторые подходящие типы
+
+  | Имя типа (ключ структуры) | Тип значения 1С | Подходит для типов MSSQL |
+  |-|-|-|
+  | TINYINT | Число  | tinyint |
+  | SMALLINT | Число  | smallint |
+  | INT | Число  | int |
+  | BIGINT | Число  | bigint |
+  | FLOAT24 | Число  | float(24), real |
+  | FLOAT53 | Число  | float(53) |
+  | NUMERIC | Число  | decimal, numeric |
+  | DECIMAL | Число  | decimal, numeric |
+  | BIT | Булево | bit |
+  | NVARCHAR | Строка | nvarchar, varchar, nchar, char, ntext, text |
+  | UUID | Строка, УникальныйИдентификатор | uniqueidentifier |
+  | XML | Строка | xml |
+  | DATE | Дата, Строка | date |
+  | TIME | Дата, Строка | time |
+  | DATETIME | Дата, Строка | datetime, datetime2 |
+  | DATETIMEOFFSET | Дата, Строка | datetimeoffset |
+  | BYTES | ДвоичныеДанные | varbinary |
+
+## Получение двоичных данных
+
+Двоичные данные при получении из БД будут представленны как объект (структура) вида `{"BYTES": "Base64 строка"}` и должны быть преобразованы из Base64 вручную
 
 ## TLS
 

docs/ru/md/Instructions/MySQL.md

@@ -37,7 +37,7 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
 
 > \* В перечне типов MySQL перечислены только некоторые подходящие типы
 
-  | Имя типа (ключ) | Тип значения 1С | Подходит для типов MySQL |
+  | Имя типа (ключ структуры) | Тип значения 1С | Подходит для типов MySQL |
   |-|-|-|
   | BYTES | Строка (путь к файлу), ДвоичныеДанные| TINYBLOB, BLOB, MEDIUMBLOB, LONGBLOB  |
   | UINT | Число (целое, без знака) | TINYINT UNSIGNED, SMALLINT UNSIGNED, MEDIUMINT UNSIGNED, INT UNSIGNED, BIGINT UNSIGNED |
@@ -48,6 +48,9 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
   | TIME | Дата, Строка (дата в формате RFC 3339) | TIME |
   | TEXT | Строка | CHAR, VARCHAR, TINYTEXT, TEXT, MEDIUMTEXT, LONGTEXT, SET |
 
+## Получение двоичных данных
+
+Двоичные данные при получении из БД будут представленны как объект (структура) вида `{"BYTES": "Base64 строка"}` и должны быть преобразованы из Base64 вручную
 
 ## TLS
 

docs/ru/md/Instructions/PostgreSQL.md

@@ -73,6 +73,10 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3,
 
 Аналогичный список типов доступен и для получения в качестве результатов запросов из PostgreSQL
 
+## Получение двоичных данных
+
+Двоичные данные при получении из БД будут представленны как объект (структура) вида `{"BYTES": "Base64 строка"}` и должны быть преобразованы из Base64 вручную
+
 ## TLS
 
 Библиотека поддерживает работу в режиме TLS. Для его включения необходимо сформировать настройки TLS при помощи функции `ПолучитьНастройкиTls`, и передать их как соответствующий параметр в функцию `ОткрытьСоединение` или одну из функций ORM, поддерживающих данный параметр. Если параметр TLS при вызове этих функций не передан, соединение инициализируется в незащищенном режиме