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 ]
Аргументы:
Аргумент | Описание |
---|---|
distinct |
Можно использовать distinct в качестве предиката, если нужно загрузить только уникальные записи. Если имеются дублирующиеся записи, то будет загружен первый экземпляр. При использовании предшествующих операторов load необходимо поместить 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 может быть числовой или строковой функцией на основе одного или нескольких других полей в этой же таблице. Дополнительные сведения см. в справке по синтаксису выражений. |
from |
from используется в случае, если данные должны быть загружены из файла. file ::= [ path ] filename
Если путь отсутствует, приложение QlikView выполняет поиск файла в каталоге, указанном оператором Directory. Если оператор Directory отсутствует, приложение QlikView выполняет поиск в рабочем каталоге, который обычно является каталогом, в котором находится файл QlikView. Примечание к информацииПри серверной установке QlikView рабочим каталогом по умолчанию является C:\ProgramData\QlikTech\Documents. Рабочий каталог по умолчанию можно изменить в QlikView Management Console.
Элемент filename может содержать стандартные знаки подстановки DOS ( * и ? ). В результате будут загружены все файлы в указанном каталоге, удовлетворяющие критериям. format-spec ::= ( fspec-item { , fspec-item } )Спецификация формата состоит из списка нескольких элементов спецификации формата, заключенных в скобки. |
from_field | from_field используется в случае, если данные должны быть загружены из ранее загруженного поля. fieldassource::=(tablename, fieldname) Поле — это имя ранее загруженных tablename и fieldname. format-spec ::= ( fspec-item {, fspec-item } )Спецификация формата состоит из списка нескольких элементов спецификации формата, заключенных в скобки. |
inline | inline используется в случае, если данные должны быть введены в скрипте, а не загружены из файла. data ::= [ text ] Данные, введенные с использованием предложения inline, должны быть заключены в двойные кавычки или квадратные скобки. Текст между ними интерпретируется так же, как и содержимое файла. Поэтому при вставке новой строки в текстовый файл ее также необходимо вставить в текст предложения inline, например, нажав клавишу Enter при вводе скрипта. Количество столбцов определяется по первой строке. format-spec ::= ( fspec-item {, fspec-item } )Спецификация формата состоит из списка нескольких элементов спецификации формата, заключенных в скобки. |
resident | Элемент resident используется в случае, если данные должны быть загружены из ранее загруженной таблицы. table label — это метка, предшествующая оператору(-ам) LOAD или SELECT, используемым для создания исходной таблицы. В конце метки должно быть указано двоеточие. При использовании сочетания операторов LOAD distinct и resident в версии QlikView 12.00 или более поздней версии порядок загрузки отличается от принятого в QlikView 11.20. Чтобы определить порядок загрузки, добавьте предложение order by. |
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 см. в разделе: Аналитические подключения Ознакомиться с подробными сведениями об аналитических подключениях можно в репозитории GitHub. qlik-oss/server-side-extension |
where | where — предложение, которое используется для указания того, нужно ли включить запись в выборку или нет. Выборка включается, если элемент criterion имеет значение True. criterion — это логическое выражение. |
while |
while — это предложение, используемое для указания необходимости повторного чтения записи. Эта же запись читается, если для элемента criterion указано значение True. Чтобы быть полезным, предложение while обычно должно содержать функцию IterNo( ). criterion — это логическое выражение. |
group_by |
group by — это выражение, используемое для определения полей данных для агрегирования (группировки). Поля агрегирования должны быть включены таким же образом в загруженные выражения. Вне функций агрегирования в загруженных выражениях могут использоваться только поля агрегирования. groupbyfieldlist ::= (fieldname { ,fieldname } ) |
order_by | order by — это предложение, используемое для сортировки записей резидентной таблицы до их обработки оператором load. Резидентная таблица может быть отсортирована по одному или нескольким полям в возрастающем или убывающем порядке. Сортировка осуществляется первично по числовому значению и дополнительно в порядке соответствия национальных параметров. Это предложение может использоваться, только если источником данных является резидентная таблица. Поля упорядочения указывают поле для сортировки резидентной таблицы. Поле может быть указано по имени или по числу в резидентной таблице (первое поле имеет номер 1). orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] } sortorder имеет значение asc для сортировки по возрастанию или desc для сортировки по убыванию. Если sortorder не указан, используется asc. fieldname, path, filename и aliasname — это текстовые строки, представляющие подразумеваемые соответствующие имена. Любое поле в исходной таблице может использоваться в качестве fieldname. Однако поля, созданные с помощью предложения as (aliasname), не рассматриваются и не могут использоваться внутри одного оператора load. |
Если источник данных не указан с помощью предложений from, inline, resident, from_field или autogenerate, данные будут загружены из результата сразу после выполнения оператора SELECT или LOAD. Последующий оператор не должен иметь префикс.
Примеры: