# Load Оператор LOAD загружает поля из файла, из определенных в скрипте данных, из ранее загруженной таблицы, из веб-страницы, из результата последующего оператора SELECT или путем создания данных. LOAD [ distinct ] fieldlist [( from file [ format-spec ] | from\_field fieldassource [format-spec] inline data [ format-spec ] | *resident* table-label | autogenerate size )] [ where criterion | while criterion ] [ group\_by groupbyfieldlist ] [order\_by orderbyfieldlist ] Аргументы Load | Аргумент | Описание | | --- | --- | | distinct[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) | Можно использовать distinct в качестве предиката, если только требуется загружать уникальные записи. Если имеются повторяющиеся записи, загружается первый экземпляр.

Если используются предшествующие загрузки, необходимо поместить distinct в первый оператор load, так как distinct затрагивает только таблицу назначения. | | fieldlist | fieldlist ::= ( \* \| field {, field } )

Список полей, которые необходимо загрузить. Символ \* в качестве списка полей обозначает все поля таблицы.

field ::= ( fieldref \| expression ) [as aliasname ]

Определение поля должно всегда содержать литерал, ссылку на существующее поле или выражение.

fieldref ::= ( fieldname \|@fieldnumber
\|@startpos:endpos
[ I \| U \| R \| B \| T] )

fieldname — это текст, идентичный имени поля в таблице. Обратите внимание, что для указания имени поля необходимо заключить его в прямые двойные кавычки или квадратные скобки, если имя содержит пробелы.
Иногда имена полей явно недоступны. В таких случаях используется другая нотация:


@fieldnumber представляет номер поля в табличном файле с разделителями. Он должен быть положительным целым числом с предшествующим символом «@». Нумерация всегда начинается с 1 и идет до числа полей.


@startpos:endpos представляет начальную и конечную позиции поля в файле с записями фиксированной длины. Позиции должны быть положительными целыми числами. Двум числами должен предшествовать символ «@», и они должны быть разделены двоеточием. Нумерация всегда начинается с 1 и содержит число позиций. В последнем поле элемент n используется как конечное положение.



expression может быть числовой или строковой функцией на основе одного или нескольких других полей в этой же таблице. Дополнительные сведения см. в справке по синтаксису выражений.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)as используется для назначения полю нового имени. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
from | from используется в случае, если данные должны быть загружены из файла.

file ::= [ path ] filename



Если путь отсутствует, программа QlikView выполняет поиск файла в каталоге, указанном оператором Directory. Если оператор Directory отсутствует, приложение QlikView выполняет поиск в рабочем каталоге, который обычно является каталогом, в котором находится файл QlikView.

Примечание к информацииПри серверной установке QlikView рабочим каталогом по умолчанию является C:\ProgramData\QlikTech\Documents. Рабочий каталог по умолчанию можно изменить в Консоль управления QlikView.

Элемент filename может содержать стандартные знаки подстановки DOS ( \* и ? ). В результате будут загружены все файлы в указанном каталоге, удовлетворяющие критериям.

format-spec ::= ( fspec-item { , fspec-item
} )

Спецификация формата состоит из списка нескольких элементов спецификации формата, заключенных в скобки.

[Directory](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Directory.htm)

[From](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/From.htm) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
from\_field | from\_field используется в случае, если данные должны быть загружены из ранее загруженного поля.

fieldassource::=(tablename, fieldname)

Поле — это имя ранее загруженных tablename и fieldname.

format-spec ::= ( fspec-item
{, fspec-item } )

Спецификация формата состоит из списка нескольких элементов спецификации формата, заключенных в скобки. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
inline | inline используется в случае, если данные должны быть введены в скрипте, а не загружены из файла.

data ::= [ text ]

Данные, введенные с использованием предложения inline, должны быть заключены в специальные символы: квадратные скобки, двойные кавычки или обратные кавычки. Текст между ними интерпретируется так же, как и содержимое файла. Поэтому при вставке новой строки в текстовый файл ее также необходимо вставить в текст предложения inline, нажав клавишу «Ввод» при вводе скрипта.

В простой встроенной загрузке количество столбцов определяется по первой строке.

format-spec ::= ( fspec-item
{, fspec-item } )

Для настройки встроенной загрузки можно использовать многие из тех же элементов спецификации формата, которые доступны для других загруженных таблиц. Эти элементы перечислены в скобках. Для получения дополнительной информации см. раздел [Элементы спецификации формата](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptSpecifiers/format-specification-items.htm).

Для получения дополнительной информации о встроенных загрузках см. [Загрузка данных из встроенных таблиц](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/inline-loads-qv.htm). | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
resident | Элемент resident используется в случае, если данные должны быть загружены из ранее загруженной таблицы.

table label — это метка, предшествующая оператору(-ам) LOAD или SELECT, используемым для создания исходной таблицы. В конце метки должно быть указано двоеточие.

При использовании сочетания операторов LOAD distinct и resident в версии QlikView12.00 или более поздней версии порядок загрузки отличается от принятого в QlikView11.20. Чтобы определить порядок загрузки, добавьте предложение order by.

[Загрузка данных из ранее загруженной таблицы](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/load-data-from-previously-loaded-table.htm)

[Метки таблицы](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/table-labels.htm) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
autogenerate | autogenerate используется в случае, если данные должны быть автоматически созданы программой QlikView.

size ::= number

Number — это целое число, обозначающее число создаваемых записей. Список полей не должно содержать выражения, для которых требуются данные из базы данных. В выражениях допускается использовать только константы и функции без параметров (такие как rand() или recno()). | | extension | Можно загружать данные из аналитических подключений. Предложение extension можно использовать для вызова функции, определенной в подключаемом модуле серверного расширения (SSE), либо для оценки скрипта.

Если отправить одну таблицу в подключаемый модуль SSE, будет возвращена одна таблица данных. Если подключаемый модуль не указал имена возвращенных полей, полям будут присвоены имена начиная с Field1, Field2.

Extension pluginname.functionname( tabledescription );



Обработка типов данных в определении поля таблицы

Типы данных в аналитических подключениях определяются автоматически. Если в составе данных отсутствуют числовые значения, однако содержится по крайней мере одна текстовая строка, отличная от NULL, поле считается текстовым. В противном случае поле считается числовым.

Тип данных можно установить принудительно. Для этого необходимо заключить имя поля в функцию String() или Mixed().



Использование функций String() или Mixed() вне определений поля таблицы extension не поддерживается, как не поддерживается использование других функций QlikView в определении поля таблицы.

Подробные сведения об аналитических подключениях

Для получения инструкций по созданию аналитического подключения в QlikView Server или QlikView Desktop см. раздел [Аналитические подключения](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Analytic_connections.htm).

Ознакомиться с подробными сведениями об аналитических подключениях можно в репозитории GitHub. [qlik-oss/server-side-extension](https://github.com/qlik-oss/server-side-extension) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
where | where — предложение, которое используется для указания того, нужно ли включить запись в выборку или нет. Выборка включается, если элемент criterion имеет значение True.

criterion — это логическое выражение. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
while | while — это предложение, используемое для указания необходимости повторного чтения записи. Эта же запись читается, если для элемента criterion указано значение True. Чтобы быть полезным, выражение while обычно должно содержать функцию IterNo( ).

criterion — это логическое выражение. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
group\_by | group by — это выражение, используемое для определения полей данных для агрегирования (группировки). Поля агрегирования должны быть включены таким же образом в загруженные выражения. Вне функций агрегирования в загруженных выражениях могут использоваться только поля агрегирования.

groupbyfieldlist ::= (fieldname { ,fieldname } ) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)
order\_by | order by — это выражение, используемое для сортировки записей резидентной таблицы до их обработки оператором load. Резидентная таблица может быть отсортирована по одному или нескольким полям в возрастающем или убывающем порядке. Сортировка осуществляется первично по числовому значению и дополнительно в порядке соответствия национальных параметров. Это выражение может использоваться, только если источником данных является резидентная таблица.

Поля заказов указывают поле для сортировки резидентной таблицы. Поле может быть указано по имени или по числу в резидентной таблице (первое поле имеет номер 1).

orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] }

sortorder имеет значение asc для сортировки по возрастанию или desc для сортировки по убыванию. Если sortorder не указан, используется asc.

fieldname, path, filename и aliasname — это текстовые строки, представляющие подразумеваемые соответствующие имена. Любое поле в исходной таблице может использоваться в качестве fieldname. Однако поля, созданные с помощью выражения (aliasname), не рассматриваются и не могут использоваться внутри одного оператора load. | Если источник данных не указан с помощью предложений from, inline, resident, from\_field или autogenerate, данные будут загружены из результата сразу после выполнения оператора SELECT или LOAD. Последующий оператор не должен иметь префикс. [Предшествующий оператор LOAD](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/preceding-load.htm) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Загрузка различных форматов файлов Загрузка файла данных с разделителями с параметрами по умолчанию: `LOAD * from data1.csv; ` Загрузка файла с разделителями с точкой в качестве разделителя и со встроенными метками: `LOAD * from 'c:\userfiles\data1.csv' (ansi, txt, delimiter is ',', embedded labels); ` Загрузка файла с разделителями с табуляцией в качестве разделителя и со встроенными метками: `LOAD * from 'c:\userfiles\data2.txt' (ansi, txt, delimiter is '\t', embedded labels);` Загрузка файла dif со встроенными заголовками: `LOAD * from file2.dif (ansi, dif, embedded labels);` Загрузка трех полей из файла с фиксированными записями без заголовков: `LOAD @1:2 as ID, @3:25 as Name, @57:80 as City from data4.fix (ansi, fix, no labels, header is 0, record is 80); ` Загрузка файла QVX, указывающего абсолютный путь: `LOAD * from C:\qdssamples\xyz.qvx (qvx);` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Выбор определенных полей, переименование и вычисление полей Загрузка только трех указанных полей из файла с разделителями: `LOAD FirstName, LastName, Number from data1.csv; ` Переименование первого поля на A, а второго на B при загрузке файла без меток: `LOAD @1 as A, @2 as B from data3.txt (ansi, txt, delimiter is '\t', no labels); ` Загрузка Name путем объединения FirstName, символа пробела и LastName: `LOAD FirstName&' '&LastName as Name from data1.csv; ` Загрузка Quantity, Price и Value (продукт Quantity и Price): `LOAD Quantity, Price, Quantity*Price as Value from data1.csv;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Выбор определенных записей Загрузка только уникальных символов, дубликаты будут удалены: `LOAD distinct FirstName, LastName, Number from data1.csv; ` Загрузка только записей, где поле Litres имеет значение больше нуля: `LOAD * from Consumption.csv where Litres>0; ` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Загрузка данных не из файла и автоматически генерируемых данных Загрузка таблицы с встроенными данными, двух полей с именамиCatID и Category: ` LOAD * Inline ` ` [CatID, Category ` ` 0,Regular ` ` 1,Occasional ` ` 2,Permanent]; ` Загрузка таблицы с встроенными данными, трех полей с именами UserID, Password и Access: ` LOAD * Inline [UserID, Password, Access ` ` A, ABC456, User ` ` B, VIP789, Admin]; ` Загрузка таблицы с 10 000 строк. Поле A будет содержать количество прочитанных записей (1,2,3,4,5...), а поле B будет содержать произвольное число в диапазоне от 0 до 1: `LOAD RecNo( ) as A, rand( ) as B autogenerate(10000);` Примечание к информацииСкобки после элемента autogenerate допускаются, но необязательны. [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Загрузка данных из ранее загруженной таблицы Сначала мы загружаем табличный файл с разделителями и присваиваем ему имя tab1: ` tab1: ` `SELECT A,B,C,D from transtable; ` Загрузка полей из уже загруженной таблицы tab1 в таблицу tab2: `tab2:` `LOAD A,B,month(C),A*B+D as E resident tab1;` Загрузка полей из уже загруженной таблицы tab1, но только записей, где A больше B: `tab3:` `LOAD A,A+B+C resident tab1 where A>B;` Загрузка полей из уже загруженной таблицы tab1, сортированных по значению A: `LOAD A,B*C as E resident tab1 order by A;` Загрузка полей из уже загруженной таблицы tab1, сортированных по первому полю, а затем по второму полю: `LOAD A,B*C as E resident tab1 order by 1,2;` Загрузка полей из уже загруженной таблицы tab1, сортированных по значению C в порядке убывания, затем по значению B в порядке возрастания, а затем по первому полю в порядке убывания: `LOAD A,B*C as E resident tab1 order by C desc, B asc, 1 des;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Загрузка данных из ранее загруженных полей Загрузка поля Types из ранее загруженной таблицы Characters в качестве A: `LOAD A from_field (Characters, Types);` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Загрузка данных из следующей таблицы (предварительная загрузка) Загрузка полей A, B, а также вычисляемых полей X и Y из таблицы Table1, которая загружается в следующем операторе SELECT: ` LOAD A, B, if(C>0,'positive','negative') as X, weekday(D) as Y; ` `SELECT A,B,C,D from Table1;` [Предшествующий оператор LOAD](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/preceding-load.htm) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Группировка данных Загрузка полей, группированных (агрегированных) по значению ArtNo: `LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo; ` Загрузка полей, группированных (агрегированных) по значениям Week и ArtNo: `LOAD Week, ArtNo, round(Avg(TransAmount),0.05) as WeekArtNoAverages from table.csv group by Week, ArtNo;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Последовательное чтение одной записи В этом примере имеется входной файл Grades.csv, содержащий оценки для каждого студента, собранные в одном поле: `Student,Grades` `Mike,5234` `John,3345` `Pete,1234` `Paul,3352` Оценки по 5-балльной шкале выставлены по предметам: Math, English, Science и History. Оценки можно выделить в отдельные значения путем многократного считывания каждой записи с помощью предложения while, использующего функцию IterNo( ) в качестве счетчика. При каждом считывании оценка извлекается функцией Mid и сохраняется в значении Grade, а предмет выбирается с помощью функции pick и сохраняется в значении Subject. Конечное выражение while содержит проверку на считывание всех оценок (четыре на студента в данном случае), что означает необходимость считывания записи о следующем студенте. ` MyTab: ` ` LOAD Student, ` ` mid(Grades,IterNo( ),1) as Grade, ` ` pick(IterNo( ), 'Math', 'English', 'Science', 'History') as Subject from Grades.csv ` `while IsNum(mid(Grades,IterNo(),1));` Результатом будет таблица, содержащая следующие данные: ![A table containing data for Students, Subjects, and Grades.](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/Resources/Images/ex_gen_LoadRepeated.png) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Загрузка из аналитических подключений Используются следующие данные образца. ``` Values: Load Rand() as A, Rand() as B, Rand() as C AutoGenerate(50); ``` Загрузка данных при помощи функции В этих примерах считается, что подключаемый модуль аналитического подключения с именем P содержит пользовательскую функцию Calculate(Parameter1, Parameter2). Функция возвращает таблицу Results, содержащую поля Field1 и Field2. ``` Load * Extension P.Calculate( Values{A, C} ); ``` Загрузка всех полей, возвращенных при отправке полей A и C в функцию. ``` Load Field1 Extension P.Calculate( Values{A, C} ); ``` Загрузка только поля Field1 при отправке полей A и C в функцию. ``` Load * Extension P.Calculate( Values ); ``` Загрузка всех полей, возвращенных при отправке полей A и B в функцию. Так как поля не указаны, используются поля A и B, находящиеся на первом месте в таблице. ``` Load * Extension P.Calculate( Values {C, C}); ``` Загрузка всех полей, возвращенных при отправке поля C в оба параметра функции. Load \* Extension P.Calculate( Values {String(A), Mixed(B)}); Загрузка всех полей, возвращенных при отправке в функцию поля A, принудительно обозначенного как строковое, и поля B, принудительно обозначенного как числовое. Загрузка данных при помощи оценки скрипта Load A as A\_echo, B as B\_echo Extension R.ScriptEval( 'q;', Values{A, B} ); Загрузка таблицы, возвращенной скриптом q при отправке значений A и B. Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{A, B} ); Загрузка таблицы, возвращенной скриптом, сохраненным в переменной My\_R\_Script при отправке значений A и B. Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{B as D, \*} ); Загрузка таблицы, возвращенной скриптом, сохраненным в переменной My\_R\_Script при отправке значений B, переименованных в D, A и C. Использование \* приводит к отправке оставшихся полей без ссылки. [Элементы спецификации формата](https://help.qlik.com/ru-RU/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptSpecifiers/format-specification-items.htm)