Получить записи

Получает записи из выбранной таблицы

Параметры

Функция ПолучитьЗаписи(Знач Таблица, Знач Поля = "*", Знач Фильтры = "", Знач Сортировка = "", Знач Количество = "", Знач Соединение = "", Знач Tls = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
Таблица	--table	Строка	✔	Имя таблицы
Поля	--fields	Массив Из Строка	✖	Поля для выборки
Фильтры	--filter	Массив Из Структура	✖	Массив фильтров. См. ПолучитьСтруктуруФильтраЗаписей
Сортировка	--order	Структура Из КлючИЗначение	✖	Сортировка: Ключ > поле, Значение > направление (ASC, DESC)
Количество	--limit	Число	✖	Ограничение количества получаемых строк
Соединение	--dbc	Строка, Произвольный	✖	Соединение или строка подключения
Tls	--tls	Структура Из КлючИЗначение	✖	Настройки TLS, если необходимо. См. ПолучитьНастройкиTls

Возвращаемое значение

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

Расширенный вызов ?

Параметр	Описание
addin_mode	Ручной выбор режима подключения внешней компоненты (для 1С): Изолированно, НеИзолированно
dontwait	Создает фоновое задание и возвращает его данные (только для 1С и OneScript)

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

    Адрес  = "127.0.0.1";
    Логин  = "SA";
    Пароль = "12we...";
    База   = "testbase1";

    НастройкиTLS      = OPI_MSSQL.ПолучитьНастройкиTLS(Истина);
    СтрокаПодключения = OPI_MSSQL.СформироватьСтрокуПодключения(Адрес, База, Логин, Пароль);

    // Все записи без отборов

    Таблица = "testtable";

    // При использовании строки подключения инициализируется новое соединение,
    // которое будет закрыто после выполнения функции.
    // В случае выполнения нескольких операций желательно использовать одно соединение,
    // заранее созданное функцией ОткрытьСоединение()
    Результат = OPI_MSSQL.ПолучитьЗаписи(Таблица, , , , , СтрокаПодключения, НастройкиTLS);

    // Отборы, выбранные поля, количество и сортировка

    СтрокаПодключения = OPI_MSSQL.СформироватьСтрокуПодключения(Адрес, "test_data", Логин, Пароль);

    Таблица = "test_data";

    Поля = Новый Массив;
    Поля.Добавить("first_name");
    Поля.Добавить("last_name");
    Поля.Добавить("email");

    Фильтры = Новый Массив;

    СтруктураФильтра1 = Новый Структура;

    СтруктураФильтра1.Вставить("field", "gender");
    СтруктураФильтра1.Вставить("type" , "=");
    СтруктураФильтра1.Вставить("value", "Male");
    СтруктураФильтра1.Вставить("union", "AND");
    СтруктураФильтра1.Вставить("raw"  , Ложь);

    СтруктураФильтра2 = Новый Структура;

    СтруктураФильтра2.Вставить("field", "id");
    СтруктураФильтра2.Вставить("type" , "BETWEEN");
    СтруктураФильтра2.Вставить("value", "20 AND 50");
    СтруктураФильтра2.Вставить("raw"  , Истина);

    Фильтры.Добавить(СтруктураФильтра1);
    Фильтры.Добавить(СтруктураФильтра2);

    Сортировка = Новый Структура("ip_address", "DESC");
    Количество = 5;

    Результат = OPI_MSSQL.ПолучитьЗаписи(Таблица, Поля, Фильтры, Сортировка, Количество, СтрокаПодключения, НастройкиTLS);

Bash

    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint mssql ПолучитьЗаписи \
      --table "testtable" \
      --dbc "Server=127.0.0.1;Database=***;User Id=SA;Password=***;" \
      --tls "{'use_tls':true,'accept_invalid_certs':true}"

CMD/Bat

    :: JSON данные также могут быть переданы как путь к файлу .json
    
    oint mssql ПолучитьЗаписи ^
      --table "testtable" ^
      --dbc "Server=127.0.0.1;Database=***;User Id=SA;Password=***;" ^
      --tls "{'use_tls':true,'accept_invalid_certs':true}"

Результат

{
 "data": [
  {
   "bigint_field": 20000000000,
   "bit_field": 1,
   "date_field": "2026-05-26",
   "datetime_field": "2026-05-26T17:35:14",
   "dto_field": "2026-05-26T12:35:14+00:00",
   "float24_field": 10.1234569549561,
   "float53_field": 10.1234567891235,
   "int_field": 200000,
   "numeric_field": 5.333,
   "nvarchar_field": "Some text",
   "smallint_field": 2000,
   "time_field": "17:35:14",
   "tinyint_field": 5,
   "uid_field": "a4d58b9d-db98-45a7-9735-a64d064099c1",
   "varbinary_field": {
    "BYTES": "/9j/4VTBRX..."
   },
   "xml_field": "<root><element><name>Пример</name><value>123</value></element><element><name>Тест</name><value>456</..."
  }
 ],
 "result": true
}