﻿---
sidebar_position: 4
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Выполнить запрос SQL
 Выполняет произвольный SQL запрос



`Функция ВыполнитьЗапросSQL(Знач ТекстЗапроса, Знач Параметры = "", Знач ФорсироватьРезультат = Ложь, Знач Соединение = "") Экспорт`

  | Параметр | CLI опция | Тип | Обяз. | Назначение |
  |-|-|-|-|-|
  | ТекстЗапроса | --sql | Строка | &#x2714; | Текст запроса к базе |
  | Параметры | --params | Массив Из Произвольный | &#x2716; | Массив позиционных параметров запроса |
  | ФорсироватьРезультат | --force | Булево | &#x2716; | Включает попытку получения результата, даже для не SELECT запросов |
  | Соединение | --dbc | Строка, Произвольный | &#x2716; | Соединение или строка подключения |

  
  Возвращаемое значение:   Структура Из КлючИЗначение - Результат выполнения запроса

<br/>

:::tip
Доступные типы параметров: Cтрока, Число, Дата, Булево, ДвоичныеДанные. Двоичные данные могут также быть переданы как структура `{'blob':Путь к файлу}`. Возвращаются значения двоичных данных (BLOB) в виде `{'blob':Base64 строка}`

Без указания флага `ФорсироватьРезультат`, чтение результата осуществляется только для запросов, начинающихся с `SELECT` Для остальных запросов возвращается `result:true` или `false` с текстом ошибки
:::
<br/>



```bsl title="Пример использования для 1С:Предприятие/OneScript"

```
    




