mirror of
https://github.com/Bayselonarrend/OpenIntegrations.git
synced 2025-04-23 12:18:48 +02:00
104 lines
5.0 KiB
Plaintext
Vendored
104 lines
5.0 KiB
Plaintext
Vendored
---
|
|
sidebar_position: 4
|
|
---
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
# Выполнить запрос SQL
|
|
Выполняет произвольный SQL запрос
|
|
|
|
|
|
|
|
`Функция ВыполнитьЗапросSQL(Знач ТекстЗапроса, Знач Параметры = "", Знач ФорсироватьРезультат = Ложь, Знач Соединение = "") Экспорт`
|
|
|
|
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|
|
|-|-|-|-|-|
|
|
| ТекстЗапроса | --sql | Строка | ✔ | Текст запроса к базе |
|
|
| Параметры | --params | Массив Из Произвольный | ✖ | Массив позиционных параметров запроса |
|
|
| ФорсироватьРезультат | --force | Булево | ✖ | Включает попытку получения результата, даже для не SELECT запросов |
|
|
| Соединение | --dbc | Строка, Произвольный | ✖ | Соединение или строка подключения |
|
|
|
|
|
|
Возвращаемое значение: Структура Из КлючИЗначение - Результат выполнения запроса
|
|
|
|
<br/>
|
|
|
|
:::tip
|
|
Доступные типы параметров: Cтрока, Число, Дата, Булево, ДвоичныеДанные. Двоичные данные могут также быть переданы как структура `{'blob':Путь к файлу}`. Возвращаются значения двоичных данных (BLOB) в виде `{'blob':Base64 строка}`
|
|
|
|
Без указания флага `ФорсироватьРезультат`, чтение результата осуществляется только для запросов, начинающихся с `SELECT` Для остальных запросов возвращается `result:true` или `false` с текстом ошибки
|
|
:::
|
|
<br/>
|
|
|
|
|
|
|
|
```bsl title="Пример использования для 1С:Предприятие/OneScript"
|
|
Картинка = "https://api.athenaeum.digital/test_data/picture.jpg";
|
|
OPI_ПреобразованиеТипов.ПолучитьДвоичныеДанные(Картинка); // Картинка - Тип: ДвоичныеДанные
|
|
|
|
Адрес = "93.125.42.204";
|
|
Логин = "bayselonarrend";
|
|
Пароль = "12we...";
|
|
База = "test_data";
|
|
|
|
СтрокаПодключения = OPI_PostgreSQL.СформироватьСтрокуПодключения(Адрес, База, Логин, Пароль);
|
|
Соединение = OPI_PostgreSQL.ОткрытьСоединение(СтрокаПодключения);
|
|
|
|
// CREATE
|
|
|
|
ТекстЗапроса = "
|
|
|CREATE TABLE test_table (
|
|
|id SERIAL PRIMARY KEY,
|
|
|name NAME,
|
|
|age INT,
|
|
|salary REAL,
|
|
|is_active BOOL,
|
|
|created_at DATE,
|
|
|data BYTEA
|
|
|);";
|
|
|
|
Результат = OPI_PostgreSQL.ВыполнитьЗапросSQL(ТекстЗапроса, , , Соединение);
|
|
|
|
// INSERT с параметрами
|
|
|
|
ТекстЗапроса = "
|
|
|INSERT INTO test_table (name, age, salary, is_active, created_at, data)
|
|
|VALUES ($1, $2, $3, $4, $5, $6);";
|
|
|
|
МассивПараметров = Новый Массив;
|
|
МассивПараметров.Добавить(Новый Структура("NAME" , "Vitaly"));
|
|
МассивПараметров.Добавить(Новый Структура("INT" , 25));
|
|
МассивПараметров.Добавить(Новый Структура("REAL" , 1000.12));
|
|
МассивПараметров.Добавить(Новый Структура("BOOL" , Истина));
|
|
МассивПараметров.Добавить(Новый Структура("DATE" , OPI_Инструменты.ПолучитьТекущуюДату()));
|
|
МассивПараметров.Добавить(Новый Структура("BYTEA", Картинка));
|
|
|
|
Результат = OPI_PostgreSQL.ВыполнитьЗапросSQL(ТекстЗапроса, МассивПараметров, , Соединение);
|
|
|
|
// SELECT (Результат этого запроса приведен в следующем блоке)
|
|
|
|
ТекстЗапроса = "SELECT id, name, age, salary, is_active, created_at, data FROM test_table;";
|
|
|
|
Результат = OPI_PostgreSQL.ВыполнитьЗапросSQL(ТекстЗапроса, , , Соединение);
|
|
|
|
// DO + Транзакция
|
|
|
|
ТекстЗапроса = "DO $$
|
|
|BEGIN
|
|
| CREATE TABLE users (
|
|
| id SMALLSERIAL,
|
|
| name TEXT NOT NULL,
|
|
| age INT NOT NULL
|
|
| );
|
|
| INSERT INTO users (name, age) VALUES ('Alice', 30);
|
|
| INSERT INTO users (name, age) VALUES ('Bob', 25);
|
|
| INSERT INTO users (name, age) VALUES ('Charlie', 35);
|
|
| COMMIT;
|
|
```
|
|
|
|
|
|
|
|
|
|
|