From 9dcd7981cb408ce71f8b3ac902c3e65c48ffc7bf Mon Sep 17 00:00:00 2001 From: Anton Titovets Date: Sun, 29 Jun 2025 22:16:53 +0300 Subject: [PATCH] Fastfix --- docs/en/md/Instructions/MSSQL.md | 42 +++++++++++ docs/en/md/Instructions/MySQL.md | 120 +++++++++++++++---------------- docs/ru/md/Instructions/MSSQL.md | 6 +- 3 files changed, 103 insertions(+), 65 deletions(-) create mode 100644 docs/en/md/Instructions/MSSQL.md diff --git a/docs/en/md/Instructions/MSSQL.md b/docs/en/md/Instructions/MSSQL.md new file mode 100644 index 0000000000..152a86ac88 --- /dev/null +++ b/docs/en/md/Instructions/MSSQL.md @@ -0,0 +1,42 @@ +--- +id: MSSQL +sidebar_class_name: MSSQL +--- + + + +# MSSQL + +This section is dedicated to the MSSQL database library. On this page, all the steps necessary to start working are described + +
+ + +
An external component is used to implement some functions in this library
+Please review the ["About external components"](/docs/Start/Component-requirements) section before getting started
+
+ + +
+ + +
This library requires **OpenSSL 3.x** to run on Linux
+Learn more: "Using OpenSSL in External Components"
+
+ +## About implemented methods + +This library has two parts: basic methods, like connecting and executing SQL queries, and a small ORM for common operations like CREATE, SELECT, INSERT, DELETE, and so on. Working through the ORM and through the query texts executed through the `ExecuteSQLQuery()` function is technically the same: the ORM simply generates the SQL query text based on the layouts, but then also calls them through this function + +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 + +## 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. + +:::tip +TLS settings can only be applied when the connection is established — either explicitly when using the `CreateConnection` function or implicitly when passing a connection string to ORM methods. Providing TLS settings along with an already established connection (passed via the *Connection* parameter) will be ignored. ::: + +## Compatibility + +Technically, the client implementation is a Native component in Rust. It comes in a zip archive format, and, in theory, should work on all available platforms: x86 and x64 Windows and Linux. The actual testing was done on Windows x64 and, cossentially (via OneScript), on Linux x64 \ No newline at end of file diff --git a/docs/en/md/Instructions/MySQL.md b/docs/en/md/Instructions/MySQL.md index 109ee1a758..a33852bac6 100644 --- a/docs/en/md/Instructions/MySQL.md +++ b/docs/en/md/Instructions/MySQL.md @@ -1,61 +1,61 @@ ---- -id: MySQL -sidebar_class_name: MySQL ---- - - - -# MySQL - -This section is dedicated to the PostMySQLgreSQL database library. On this page, all the steps necessary to start working are described - -
- - -
An external component is used to implement some functions in this library
-Please review the ["About external components"](/docs/Start/Component-requirements) section before getting started
-
- - -
- - -
This library requires **OpenSSL 3.x** to run on Linux
-Learn more: "Using OpenSSL in External Components"
-
- -## About implemented methods - -This library has two parts: basic methods, like connecting and executing SQL queries, and a small ORM for common operations like CREATE, SELECT, INSERT, DELETE, and so on. Working through the ORM and through the query texts executed through the `ExecuteSQLQuery()` function is technically the same: the ORM simply generates the SQL query text based on the layouts, but then also calls them through this function - -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 MySQL 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 MySQL type list lists only a few suitable types - - | Type name (key) | 1C type | Suitable MySQL types | - |-|-|-| - | BYTES | String (filepath), BinaryData | TINYBLOB, BLOB, MEDIUMBLOB, LONGBLOB | - | UINT | Number (integer, unsigned) | TINYINT UNSIGNED, SMALLINT UNSIGNED, MEDIUMINT UNSIGNED, INT UNSIGNED, BIGINT UNSIGNED | - | INT | Number (integer) | TINYINT, SMALLINT, MEDIUMINT, INT, BIGINT | - | FLOAT | Number | FLOAT | - | DOUBLE | Number | DOUBLE (REAL, DOUBLE PRECISION) | - | DATE | Date, String (RFC 3339) | DATE, DATETIME, TIMESTAMP | - | TIME | Дата, String (RFC 3339) | TIME | - | TEXT | String | CHAR, VARCHAR, TINYTEXT, TEXT, MEDIUMTEXT, LONGTEXT, SET | - - - -## 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. - -:::tip -TLS settings can only be applied when the connection is established — either explicitly when using the `CreateConnection` function or implicitly when passing a connection string to ORM methods. Providing TLS settings along with an already established connection (passed via the *Connection* parameter) will be ignored. ::: - -## Compatibility - +--- +id: MySQL +sidebar_class_name: MySQL +--- + + + +# MySQL + +This section is dedicated to the MySQL database library. On this page, all the steps necessary to start working are described + +
+ + +
An external component is used to implement some functions in this library
+Please review the ["About external components"](/docs/Start/Component-requirements) section before getting started
+
+ + +
+ + +
This library requires **OpenSSL 3.x** to run on Linux
+Learn more: "Using OpenSSL in External Components"
+
+ +## About implemented methods + +This library has two parts: basic methods, like connecting and executing SQL queries, and a small ORM for common operations like CREATE, SELECT, INSERT, DELETE, and so on. Working through the ORM and through the query texts executed through the `ExecuteSQLQuery()` function is technically the same: the ORM simply generates the SQL query text based on the layouts, but then also calls them through this function + +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 MySQL 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 MySQL type list lists only a few suitable types + + | Type name (key) | 1C type | Suitable MySQL types | + |-|-|-| + | BYTES | String (filepath), BinaryData | TINYBLOB, BLOB, MEDIUMBLOB, LONGBLOB | + | UINT | Number (integer, unsigned) | TINYINT UNSIGNED, SMALLINT UNSIGNED, MEDIUMINT UNSIGNED, INT UNSIGNED, BIGINT UNSIGNED | + | INT | Number (integer) | TINYINT, SMALLINT, MEDIUMINT, INT, BIGINT | + | FLOAT | Number | FLOAT | + | DOUBLE | Number | DOUBLE (REAL, DOUBLE PRECISION) | + | DATE | Date, String (RFC 3339) | DATE, DATETIME, TIMESTAMP | + | TIME | Дата, String (RFC 3339) | TIME | + | TEXT | String | CHAR, VARCHAR, TINYTEXT, TEXT, MEDIUMTEXT, LONGTEXT, SET | + + + +## 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. + +:::tip +TLS settings can only be applied when the connection is established — either explicitly when using the `CreateConnection` function or implicitly when passing a connection string to ORM methods. Providing TLS settings along with an already established connection (passed via the *Connection* parameter) will be ignored. ::: + +## Compatibility + Technically, the client implementation is a Native component in Rust. It comes in a zip archive format, and, in theory, should work on all available platforms: x86 and x64 Windows and Linux. The actual testing was done on Windows x64 and, cossentially (via OneScript), on Linux x64 \ No newline at end of file diff --git a/docs/ru/md/Instructions/MSSQL.md b/docs/ru/md/Instructions/MSSQL.md index 28fe9a91dd..73e53ce02c 100644 --- a/docs/ru/md/Instructions/MSSQL.md +++ b/docs/ru/md/Instructions/MSSQL.md @@ -8,7 +8,7 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3, # MS SQL Server -Этот раздел посвящен библиотеке для работы с базами данных MySQL в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы +Этот раздел посвящен библиотеке для работы с базами данных MSSQL в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы
@@ -31,10 +31,6 @@ keywords: [1C, 1С, 1С:Предприятие, 1С:Предприятие 8.3, По умолчанию, все запросы SELECT возвращают массив выбранных данных, а остальные запросы - только `true` в поле `result` при успехе, либо `false` и текст ошибки в полях `result` и `error` соответственно. Для выполнения запросов, требующих возврата данных, но не являющихся запросами SELECT, в функции `ВыполнитьЗапросSQL()` есть параметр `ФорсироватьРезультат` -## Параметры запросов - -Коннектор MySQL поддерживает использование позиционных параметров. Все значения, передаваемые как при прямом выполнении запросов через функцию `ВыполнитьЗапросSQL()`, так и в ORM методах с установкой значений, вроде `ДобавитьЗаписи` и `ОбновитьЗаписи`, должный представлять из себя структуру вида `{'Тип данных': 'Значение'}`. Поддерживаются следующие типы данных\*: - ## TLS