Часть 7. Операторы и ключевые слова скрипта

Учебник QlikView (Qlik Sense). Часть 7. Операторы и ключевые слова скрипта.

Содержание

Операторы и ключевые слова скрипта. Общее.

Скрипт QlikView (и Qlik Sense) (и Qlik Sense) состоит из ряда операторов. В качестве оператора может выступать обычный оператор скрипта или оператор управления скрипта. Перед некоторыми операторами могут стоять префиксы.

Как правило, обычные операторы используются для управления данными тем или иным образом. Эти операторы могут быть перезаписаны любым числом линий в скрипте и всегда должны заканчиваться точкой с запятой, «;».

Как правило, операторы управления используются для контроля хода выполнения скрипта. Каждое предложение оператора управления должно находиться внутри одной строки скрипта и может заканчиваться на точку с запятой или знак конца строки.

Префиксы можно использовать с соответствующими обычными операторами, но не с операторами управления. Тем не менее префиксы when и unless можно использовать в качестве суффиксов с некоторыми выражениями определенных операторов управления.

В следующем подразделе перечислены все существующие операторы скрипта, операторы управления и префиксы в алфавитном порядке.

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

Операторы управления скриптом

Скрипт QlikView (и Qlik Sense) (и Qlik Sense) состоит из ряда операторов. В качестве оператора может выступать обычный оператор скрипта или оператор управления скрипта.

Как правило, операторы управления используются для контроля хода выполнения скрипта. Каждое предложение оператора управления должно находиться внутри одной строки скрипта и может заканчиваться на точку с запятой или знак конца строки.

Операторы управления никогда не применяются с префиксами, за исключением префиксов when и unless, использование которых допускается с несколькими особыми операторами управления.

Все ключевые слова скрипта можно вводить в любой комбинации символов в нижнем и верхнем регистре.

В таблице ниже представлена краткое описание и синтаксис каждой функции. Дополнительную информацию можно получить, если щелкнуть имя функции в описании синтаксиса.

Call	Оператор управления call вызывает подпрограмму, которую необходимо задать с помощью предыдущего оператора sub. Call name ( [ paramlist ])
Do..loop	Оператор управления do..loop является компонентом итерации скрипта, который выполняет один или несколько операторов до выполнения логического условия. do[ ( while | until ) condition ] [statements] [exit do [ ( when | unless ) condition ] [statements] loop [ ( while | until ) condition ]
Exit script	Этот оператор управления останавливает выполнение скрипта. Его можно вставить в любое место скрипта. exit script[ (when | unless) condition ]
For each ..next	Оператор управления for each..next является компонентом итерации скрипта, который выполняет один или несколько операторов для каждого значения в списке, разделенном запятой. Операторы внутри цикла, заключенного с помощью for и next, выполняются для каждого значения списка. For Each var in list [statements] [exit for [ ( when | unless ) condition ] [statements] next [var]
For..next	Оператор управления for..next представляет собой компонент итерации скрипта со счетчиком. Операторы внутри цикла, которые находятся между разделами for и next, будут выполняться для каждого значения переменной счетчика в пределах указанных минимального и максимального значений (включительно). For counter = expr1 to expr2 [ step expr3 ] [statements] [exit for [ ( when | unless ) condition ] [statements] Next [counter]
If..then	Оператор управления if..then является компонентом выбора скрипта, который позволяет выполнять скрипт по различным путям в зависимости от одного или нескольких логических условий. Поскольку оператор if..then является оператором управления и заканчивается точкой с запятой или знаком конца линии, каждое из четырех его возможных выражений (if..then, elseif..then, else и end if) не должно выходить за границу строки. If condition then [ statements ] { elseif condition then [ statements ] } [ else [ statements ] ] end if
Sub	Оператор управления sub..end sub определяет подпрограмму, которая должна вызываться оператором call. Sub name [ ( paramlist )] statements end sub
Switch	Оператор управления switch является компонентом выбора скрипта, который позволяет выполнять скрипт по различным путям в зависимости от значения выражения. Switch expression {case valuelist [ statements ]} [default statements] end switch

Call

Оператор управления call вызывает подпрограмму, которую необходимо задать с помощью предыдущего оператора sub.

Аргументы:

Аргумент	Описание
name	Имя подпрограммы.
paramlist	Список фактических параметров, отправляемых в подпрограмму и перечисленных через запятую. Элементы списка могут быть именами полей, переменными или произвольными выражениями.

Подпрограмма, вызываемая оператором call, должна быть задана оператором sub ранее при выполнении скрипта.

Параметры копируются в подпрограмму и, если параметр оператора call является переменной, а не выражением, снова копируются назад при выходе из подпрограммы.

Ограничения:

Поскольку оператор call является оператором управления и заканчивается точкой с запятой или знаком конца строки, он не должен выходить за границу строки.

Do..loop

Оператор управления do..loop является компонентом итерации скрипта, который выполняет один или несколько операторов до выполнения логического условия.

Аргументы:

Аргумент	Описание
condition	Логическое выражение, имеющее значение True или False.
statements	Любая группа, состоящая из одного или нескольких операторов скрипта QlikView (и Qlik Sense).
while / until	Условное предложение while или until должно появиться только один раз в любом операторе do..loop, то есть после do или после loop. Каждое условие интерпретируется только при первом появлении, однако вычисляется при каждом появлении в цикле.
exit do	Если в цикле появляется предложение exit do, выполнение скрипта будет передано первому оператору после предложения loop, указывающего на конец цикла. Предложение exit do можно сделать условным с помощью дополнительного использования суффикса when или unless.

Exit script

Этот оператор управления останавливает выполнение скрипта. Его можно вставить в любое место скрипта.

Поскольку оператор exit script является оператором управления и заканчивается точкой с запятой или знаком конца строки, он не должен выходить за границу строки.

Аргументы:

Аргумент	Описание
condition	Логическое выражение, имеющее значение True или False.
when / unless	Оператор exit script можно сделать условным с помощью дополнительного использования предложения when или unless.

For each..next

Оператор управления for each..next является компонентом итерации скрипта, который выполняет один или несколько операторов для каждого значения в списке, разделенном запятой. Операторы внутри цикла, заключенного с помощью for и next, выполняются для каждого значения списка.

Аргументы:

Аргумент	Описание
var	Имя переменной скрипта, которое получает новое значение из списка для каждого выполнения цикла. Если переменная var задана после next, она должна иметь такое же имя переменной, как указано после соответствующего предложения for each.

Значение переменной var может быть изменено операторами внутри цикла, однако это делать не рекомендуется.

Если в цикле появляется предложение exit for, выполнение скрипта будет передано первому оператору после предложения next, указывающего на конец цикла. Предложение exit for можно сделать условным с помощью дополнительного использования суффикса when или unless.

Аргумент	Описание
constant	Любое число или строка. Обратите внимание на то, что строка, непосредственно записываемая в скрипте, должна быть заключена в одинарные кавычки. Строка без одинарных кавычек будет интерпретироваться как переменная с использованием значения переменной. Числа не нужно заключать в одинарные кавычки.
expression	Произвольное выражение.
mask	Маска имени файла или папки, которая может включать в себя любые допустимые в имени файла символы и стандартные знаки подстановки, * и ?.
condition	Логическое выражение, имеющее значение True или False.
statements	Любая группа, состоящая из одного или нескольких операторов скрипта QlikView (и Qlik Sense).
filelist mask	Такой синтаксис создает разделенный запятыми список всех файлов в текущем каталоге, соответствующих маске имени файла.
dirlist mask	Такой синтаксис создает разделенный запятыми список всех папок в текущей папке, соответствующей маске имени папки.
fieldvaluelist mask	Этот синтаксис повторяется в значениях поля, которое уже загружено в QlikView (и Qlik Sense).

Полученная таблица выглядит следующим образом:

NEWFIELD
one-1
one-2
two-1
two-2
three-1
three-2

For..next

Оператор управления for..next представляет собой компонент итерации скрипта со счетчиком. Операторы внутри цикла, которые находятся между разделами for и next, будут выполняться для каждого значения переменной счетчика в пределах указанных минимального и максимального значений (включительно).

Выражения expr1, expr2 и expr3 рассчитываются только при первом входе в цикл. Значение переменной counter может быть изменено операторами внутри цикла, однако это делать не рекомендуется.

Если в цикле появляется предложение exit for, выполнение скрипта будет передано первому оператору после предложения next, указывающего на конец цикла. Предложение exit for можно сделать условным с помощью дополнительного использования суффикса when или unless.

Аргументы:

Аргумент	Описание
counter	Имя переменной. Если переменная counter задана после next, она должна иметь такое же имя переменной, как указано после соответствующего предложения for.
expr1	Выражение, определяющее первое значение переменной counter, для которой должен выполняться цикл.
expr2	Выражение, определяющее максимальное значение переменной counter, для которой должен выполняться цикл.
expr3	Выражение, которое определяет значение приращения переменной counter при каждом выполнении цикла.
condition	логическое выражение, имеющее значение True или False.
statements	Любая группа, состоящая из одного или нескольких операторов скрипта QlikView (и Qlik Sense).

If..then..elseif..else..end if

Оператор управления if..then является компонентом выбора скрипта, который позволяет выполнять скрипт по различным путям в зависимости от одного или нескольких логических условий.

Поскольку оператор if..then является оператором управления и заканчивается точкой с запятой или знаком конца линии, каждое из четырех его возможных выражений (if..then, elseif..then, else и end if) не должно выходить за границу строки.

Аргументы:

Аргумент	Описание
condition	Логическое выражение, которое может иметь значение True или False.
statements	Любая группа, состоящая из одного или нескольких операторов скрипта QlikView (и Qlik Sense).

Sub..end sub

Оператор управления sub..end sub определяет подпрограмму, которая должна вызываться оператором call.

Аргументы копируются в подпрограмму и снова копируются обратно при выходе из подпрограммы, если соответствующий фактический параметр в операторе call представляет собой имя переменной.

Если в подпрограмме присутствует больше формальных параметров, чем фактических параметров, передаваемых оператором call, то дополнительные параметры инициализируются со значением NULL, и их можно использовать в качестве локальных переменных в подпрограмме.

Поскольку оператор sub является оператором управления и заканчивается точкой с запятой или знаком конца линии, каждое из двух его возможных выражений (sub и end sub) не должно выходить за границу строки.

Аргументы:

Аргумент	Описание
name	Имя подпрограммы.
paramlist	Список имен переменных, разделенных запятой, для формальных параметров подпрограммы. Они могут использоваться как любая другая переменная в подпрограмме.
statements	Любая группа, состоящая из одного или нескольких операторов скрипта QlikView (и Qlik Sense).

В результате этого локально внутри подпрограммы A будет инициализировано как 1, B как 4 и C как NULL.

При выходе из подпрограммы глобальная переменная А получает значение 2 (скопированное из подпрограммы). Второй фактический параметр (X+1)*2 не будет копироваться, поскольку не является переменной. Наконец, глобальная переменная С не будет изменена вследствие вызова подпрограммы.

Switch..case..default..end switch

Оператор управления switch является компонентом выбора скрипта, который позволяет выполнять скрипт по различным путям в зависимости от значения выражения.

Аргументы:

Аргумент	Описание
expression	Произвольное выражение.
valuelist	Список значений, разделенных запятой, с которыми будет сравниваться значение expression. Выполнение скрипта продолжится с операторов в первой группе, в которой значение valuelist будет равно значению expression. Каждое значение valuelist может быть произвольным выражением. Если совпадение не найдено ни в одном из предложений case, то будут выполнены операторы в выражении default при их наличии.
statements	Любая группа, состоящая из одного или нескольких операторов скрипта QlikView (и Qlik Sense).

Префиксы скрипта

Префиксы можно использовать с соответствующими обычными операторами, но не с операторами управления. Тем не менее префиксы when и unless можно использовать в качестве суффиксов с некоторыми выражениями определенных операторов управления.

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

Пользуйтесь информацией из раскрывающегося списка по каждой функции, чтобы увидеть краткое описание и синтаксис каждой функции. Дополнительную информацию можно получить, если щелкнуть имя функции в описании синтаксиса.

Add	Префикс add можно добавить в любой оператор LOAD, SELECT или map…using в скрипте. Он применяется только во время частичной загрузки. Add [only] (loadstatement | selectstatement | mapstatement)
Buffer	Файлы QVD могут создаваться и обслуживаться автоматически посредством префикса buffer. Этот префикс может использоваться на большинстве операторов LOAD и SELECT в скрипте. Он указывает на то, что файлы QVD используются для кэширования/буферизации результата оператора. Buffer[(option [ , option])] ( loadstatement | selectstatement ) option::= incremental | stale [after] amount [(days | hours)]
Bundle	Префикс Bundle используется для включения внешних файлов, таких как файлы изображений и звуковые файлы, или объектов, связанных со значением поля, для сохранения в файле qvw. Bundle [Info] ( loadstatement | selectstatement)
Concatenate	Если для двух таблиц необходимо выполнить объединение, и они имеют разные наборы полей, объединение двух таблиц может быть выполнено принудительно с помощью префикса Concatenate. concatenate [ (tablename ) ] ( loadstatement | selectstatement )
Crosstable	Префикс crosstable используется для преобразования перекрестной таблицы в прямую, т. е. широкая таблица со множеством столбцов преобразуется в длинную таблицу с размещением заголовков столбцов в одном столбце атрибутов. crosstable (attribute field name, data field name [ , n ] ) ( loadstatement | selectstatement )
First	Префикс First операторов LOAD или SELECT (SQL) используется для загрузки заданного максимального числа записей из таблицы источника данных. First n( loadstatement | selectstatement )
Generic	Префикс generic распаковывает длинную таблицу и создает одно поле на каждое значение атрибута. Эта операция похожа на операцию создания сводной таблицы, но в отличие от нее приводит к появлению отдельной таблицы для каждого поля. Generic ( loadstatement | selectstatement )
Hierarchy	Префикс hierarchy используется для преобразования таблицы с родительско-дочерней иерархией в полезную таблицу модели данных QlikView (и Qlik Sense). Его можно поставить перед оператором LOAD или SELECT. Он будет использовать результат оператора загрузки в качестве ввода для преобразования таблицы. Hierarchy (NodeID, ParentID, NodeName, [ParentName], [PathSource], [PathName], [PathDelimiter], [Depth])(loadstatement | selectstatement)
HierarchyBelongsTo	Префикс используется для преобразования таблицы с родительско-дочерней иерархией в полезную таблицу модели данных QlikView (и Qlik Sense). Его можно поставить перед оператором LOAD или SELECT. Он будет использовать результат оператора загрузки в качестве ввода для преобразования таблицы. HierarchyBelongsTo (NodeID, ParentID, NodeName, AncestorID, AncestorName, [DepthDiff])(loadstatement | selectstatement)
Image_Size	Это предложение используется вместе с префиксами Info или Bundle для изменения размера изображений из СУБД в соответствии с размерами полей. Info [Image_Size(width,height)] ( loadstatement | selectstatement)
Info	Префикс info используется для связи внешней информации, такой как текстовый файл, изображение или видео, со значением поля. Info( loadstatement | selectstatement )
Inner	Перед префиксами join и keep может стоять префикс inner.Если этот префикс используется перед join, то он указывает, что необходимо выполнить внутреннее объединение. Результирующая таблица, таким образом, будет содержать только комбинации значений полей из таблиц исходных данных с представлением связанных значений полей в обеих таблицах. Если этот префикс используется перед keep, он указывает, что обе таблицы с исходными данными следует уменьшить до области взаимного пересечения, прежде чем они смогут быть сохранены в программе QlikView (и Qlik Sense). . Inner ( Join | Keep) [ (tablename) ](loadstatement |selectstatement )
Inputfield	Чтобы пометить поле как поле ввода, укажите его в операторе inputfield до упоминания в операторах load или select. Inputfield fieldlist
IntervalMatch	Префикс IntervalMatch используется для создания таблиц сравнения дискретных числовых значений с одним или несколькими числовыми интервалами, а также сравнения значений с одним или несколькими дополнительными ключами. IntervalMatch (matchfield)(loadstatement | selectstatement ) IntervalMatch (matchfield,keyfield1 [ , keyfield2, ... keyfield5 ] ) (loadstatement | selectstatement )
Join	Префикс join объединяет загруженную таблицу с существующей таблицей, для которой задано имя, или с последней созданной таблицей данных. [Inner | Outer | Left | Right ]Join[(tablename )]( loadstatement | selectstatement )
Keep	Префикс keep подобен префиксу join. Также как префикс join, этот префикс сравнивает загруженную таблицу с существующей таблицей, для которой задано имя, или с последней созданной таблицей данных, но вместо объединения загруженной таблицы с существующей он позволяет сократить одну или обе таблицы до сохранения в программе QlikView (и Qlik Sense) путем пересечения данных таблиц. Выполняемое сравнение аналогично натуральному объединению по всем общим полям, т. е. выполняется так же, как и при соответствующем объединении. Однако две таблицы не соединяются и сохраняются в программе QlikView (и Qlik Sense) в виде двух отдельных таблиц с заданными именами. (Inner | Left | Right) Keep [(tablename ) ]( loadstatement | selectstatement )
Left	Перед префиксами Join и Keep может стоять префикс left. Если этот префикс используется перед join, то он указывает, что необходимо выполнить левое объединение. Результирующая таблица будет содержать только комбинации значений полей из таблиц исходных данных с представлением связанных значений полей в первой таблице. Если этот префикс используется перед префиксом keep, он указывает, что вторую таблицу с исходными данными следует уменьшить до области взаимного пересечения с первой таблицей, прежде чем они смогут быть сохранены в программе QlikView (и Qlik Sense). Left ( Join | Keep) [(tablename) ](loadstatement | selectstatement )
Mapping	Префикс mapping используется для создания таблицы сопоставления, которую можно использовать, например, для замены значений полей и имен полей в ходе выполнения скрипта. Mapping ( loadstatement | selectstatement )
NoConcatenate	Префикс NoConcatenate определяет, что две загруженные таблицы с идентичными наборами полей будут обрабатываться как две отдельные внутренние таблицы вместо автоматического объединения. NoConcatenate( loadstatement | selectstatement )
Outer	Для указания внешнего объединения перед явным префиксом Join может стоять префикс outer. При внешнем объединении создаются все возможные комбинации двух таблиц. Результирующая таблица, таким образом, будет содержать комбинации значений полей из таблиц исходных данных с представлением связанных значений полей в одной или обеих таблицах. Ключевое слово outer является дополнительным. Outer Join [ (tablename) ](loadstatement |selectstatement )
Replace	Префикс replace используется для удаления таблицы в программе QlikView (и Qlik Sense) полностью и ее замены загруженной или выбранной таблицей. Replace[only](loadstatement |selectstatement |map...usingstatement)
Right	Перед префиксами Join и Keep может стоять префикс right. Если этот префикс используется перед join, то он указывает, что необходимо выполнить правое объединение. Результирующая таблица будет содержать только комбинации значений полей из таблиц исходных данных с представлением связанных значений полей во второй таблице. Если этот префикс используется перед префиксом keep, он указывает, что первую таблицу с исходными данными следует уменьшить до области взаимного пересечения со второй таблицей, прежде чем они смогут быть сохранены в программе QlikView (и Qlik Sense). Right (Join | Keep) [(tablename)](loadstatement |selectstatement )
Sample	Префикс sample операторов LOAD или SELECT используется для загрузки произвольного образца записей из источника данных. Sample p ( loadstatement | selectstatement )
Semantic	Таблицы, содержащие связи между записями, можно загрузить с помощью префикса semantic. Это могут быть, например, рекурсивные ссылки в пределах таблицы, где одна запись указывает на другую, такую как родительская, та, которой она принадлежит, или предшествующая. Semantic ( loadstatement | selectstatement)
Unless	Префикс и суффикс unless используется для создания условного предложения, определяющего вычисление или невычисление оператора либо условия «exit». Это короткое утверждение можно использовать вместо полного оператора if..end if. (Unless condition statement | exitstatement Unless condition )
When	Префикс и суффикс when используется для создания условного предложения, определяющего исполнение или неисполнение оператора либо условия «exit». Это короткое утверждение можно использовать вместо полного оператора if..end if. ( When condition statement | exitstatement when condition )

Add

Префикс add можно добавить в любой оператор LOAD, SELECT или map…using в скрипте. Он применяется только во время частичной загрузки.

Во время частичной перезагрузки таблица QlikView (и Qlik Sense), для которой создается имя с помощью оператора add LOAD/add SELECT (если такая таблица существует), дополняется результатом выполнения оператора add LOAD/add SELECT. Проверка дубликатов не выполняется. Таким образом, оператор, использующий префикс add, будет, как правило, включать в себя квалификатор distinct или защитные дубликаты выражения where. Оператор map…using запускает сопоставление данных также и во время частичного выполнения скрипта.

Аргументы:

Аргумент	Описание
only	Дополнительный квалификатор, указывающий на то, что оператор следует игнорировать в ходе нормальной (не частичной) перезагрузки.

Buffer

Файлы QVD могут создаваться и обслуживаться автоматически посредством префикса buffer. Этот префикс может использоваться на большинстве операторов LOAD и SELECT в скрипте. Он указывает на то, что файлы QVD используются для кэширования/буферизации результата оператора.

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

Буферы QVD по умолчанию хранятся в папке C:\ProgramData\QlikTech\QlikView (и Qlik Sense)\Buffers.

Обычно буферы QVD удаляются, если к ним больше не обращаются на любом этапе выполнения всего скрипта в документе, его создавшем, либо в том случае, если документ, его создавший, уже не существует.

Аргументы:

Аргумент	Описание
incremental	Параметр incremental дает возможность прочитать только часть базового файла. Данные о предыдущем размере файла находятся в заголовке XML файла QVD. Это особенно полезно при работе с файлами журнала. Все записи, загруженные в предыдущий раз, считываются из файла QVD, в то время как последующие новые записи считываются из оригинального источника, в результате чего создается обновленный файл QVD. Обратите внимание, что параметр incremental может использоваться только с операторами LOAD и текстовыми файлами, а инкрементальная загрузка не может использоваться там, где устаревшие данные изменены или удалены!
stale [after] amount [(days | hours)]	amount — число, обозначающее период времени. Могут использоваться десятичные числа. Единицей измерения являются дни, если не указано иное. Опция stale after обычно используется с источниками баз данных, если нет простой метки времени на первоначальных данных. Вместо этого можно указать, насколько старым может быть описание используемого снимка QVD. Предложение stale after просто указывает период времени с момента создания буфера QVD, после которого он будет считаться недействительным. До этого времени в качестве источника данных будет использоваться буфер QVD, а после этого — оригинальный источник данных. Файл буфера QVD будет автоматически обновлен, и начнется новый период.

Ограничения:

Среди многочисленных ограничений необходимо отметить наиболее важное, которое заключается в том, что в центре любого составного оператора должен быть оператор для файла LOAD либо SELECT.

Bundle

Префикс Bundle используется для включения внешних файлов, таких как файлы изображений и звуковые файлы, или объектов, связанных со значением поля, для сохранения в файле qvw.

Для удобства переноса внешние файлы можно включить в файл .qvw. Для этого следует использовать префикс Bundle. Включенные в пакет файлы info сжимаются в ходе этого процесса, однако все равно занимают дополнительное место в файле и ОЗУ. Поэтому, выбирая такое решение, следует отслеживать и размер, и число пакетных файлов.

Информацию можно получать в виде ссылки из макета (в виде обычной информации), с помощью функции диаграммы info или в виде внутреннего файла, для их вызова может использоваться специальный синтаксис: qmem:// fieldname / fieldvalue или qmem:// fieldname / < index >, где index — внутренний индекс значения поля.

Аргументы:

Аргумент	Описание
loadstatement | selectstatement	Если часть внешних данных, например изображение или звуковой файл, необходимо связать со значением поля, то это можно сделать в таблице, загружаемой с префиксом Info. Префиксом Info можно пренебречь при использовании префикса Bundle.

Concatenate

Если для двух таблиц необходимо выполнить объединение, и они имеют разные наборы полей, объединение двух таблиц может быть выполнено принудительно с помощью префикса Concatenate. Этот оператор выполняет принудительное объединение с существующей именованной таблицей или последней созданной логической таблицей. Если две таблицы содержат поля с одинаковыми именами, объединение выполняется автоматически.

Объединение, по сути, совпадает с оператором SQL UNION, но с двумя отличиями:

• Префикс Concatenate может использоваться независимо от того, имеют ли таблицы идентичные имена полей.
• Идентичные записи при наличии префикса Concatenate не удаляются.

Аргументы:

Аргумент	Описание
tablename	Имя существующей таблицы.

Crosstable

Префикс crosstable используется для преобразования перекрестной таблицы в прямую, т. е. широкая таблица со множеством столбцов преобразуется в длинную таблицу с размещением заголовков столбцов в одном столбце атрибутов.

Аргументы:

Аргумент	Описание
attribute field name	Поле, которое содержит значения атрибутов.
data field name	Поле, которое содержит значения данных.
n	Число полей описателя перед таблицей, которые следует преобразовать в общий формат. По умолчанию задается 1.

Crosstable — это распространенный тип таблиц, включающих матрицу значений, расположенную между двумя и более ортогональными списками данных в заголовках, один из которых используется в качестве заголовков столбцов. Типичный пример — один столбец для каждого месяца. В результате использования префикса crosstable заголовки столбцов (например, названия месяцев) будут сохранены в одном поле (поле атрибутов), а данные столбцов (номера месяцев) будут сохранены во втором поле (поле данных).

Результат:

Person,	Location,	Month,	Sales
Bob,	London,	Jan,	100
Bob,	London,	Feb,	200
Bob,	London,	Mar,	300
Kate,	New York,	Jan,	400
Kate,	New York,	Feb,	500
Kate,	New York,	Mar,	600

Мастер создания перекрестной таблицы

Мастер создания перекрестной таблицы представляет собой диалоговое окно, позволяющее создавать операторы перекрестной таблицы. Чтобы открыть диалоговое окно, нажмите кнопку Перекрестная таблица на странице Параметры мастера создания файлов. В мастере создания перекрестной таблицы можно выбрать следующие параметры:

Определяющие поля	Число определяющих полей, предшествующих преобразуемым полям.
Поле атрибута	Имя нового поля, которое будет содержать все поля (значения атрибутов), подлежащие преобразованию.
Поле данных	Имя нового поля, которое будет содержать данные значений атрибутов.

First

Префикс First операторов LOAD или SELECT (SQL) используется для загрузки заданного максимального числа записей из таблицы источника данных.

Аргументы:

Аргумент	Описание
n	Произвольное выражение, результатом которого является целое число, обозначающее максимальное число считываемых записей. Элемент n может быть заключен в скобки, например (n), но это необязательно.

Generic

Префикс generic распаковывает длинную таблицу и создает одно поле на каждое значение атрибута. Эта операция похожа на операцию создания сводной таблицы, но в отличие от нее приводит к появлению отдельной таблицы для каждого поля.

Таблицы, загружаемые с помощью оператора generic, автоматически не объединяются.

Результат:

В результате будут созданы 3 таблицы:

Table1.Jan:

Key,	Jan
Bob,	100
Kate,	400

Table1.Feb:

Key,	Feb
Bob,	200
Kate,	500

Table1.Mar:

Key,	Mar
Bob,	300
Kate,	600

Hierarchy

Префикс hierarchy используется для преобразования таблицы с родительско-дочерней иерархией в полезную таблицу модели данных QlikView (и Qlik Sense). Его можно поставить перед оператором LOAD или SELECT. Он будет использовать результат оператора загрузки в качестве ввода для преобразования таблицы.

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

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

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

Все узлы с родительским идентификатором, не найденные в столбце идентификаторов узлов (включая узлы с отсутствующими родительскими идентификаторами), будут расцениваться как корневые. К тому же загружаться будут только узлы с соединением с корневым узлом, прямым или косвенным, что тем самым позволит избежать циклических ссылок.

Можно создать дополнительные поля, содержащие имя родительского узла, путь узла и глубину узла.

Аргументы:

Аргумент	Описание
NodeID	Имя поля, содержащего идентификатор узла. Это поле должно существовать во входной таблице.
ParentID	Имя поля, содержащего идентификатор родительского узла. Это поле должно существовать во входной таблице.
NodeName	Имя поля, содержащего имя узла. Это поле должно существовать во входной таблице.
ParentName	Строка, которая используется для наименования нового поля ParentName. При его отсутствии это поле не создается.
ParentSource	Имя поля, которое содержит имя узла, используемого для создания пути к узлу. Необязательный параметр. Если не указано, используется NodeName.
PathName	Строка, которая используется для наименования нового поля Path, содержащего путь от корневого каталога к узлу. Необязательный параметр. При его отсутствии это поле не создается.
PathDelimiter	Строка, которая используется в качестве разделителя в новом поле Path. Необязательный параметр. При его отсутствии используется ‘/’.
Depth	Строка, которая используется для наименования нового поля Depth, содержащего глубину узла в иерархии. Необязательный параметр. При его отсутствии это поле не создается.

Результат:

NodeID	NodeName	ParentID	ParentName	NodeName1	NodeName2	NodeName3	PathName	Depth
5	Europe		-	Europe	-	-	Europe	1
3	Germany	5	Europe	Europe	Germany	-	Europe\Germany	2
2	Munich	3	Germany	Europe	Germany	Munich	Europe\Germany\Munich	3
4	UK	5	Europe	Europe	UK	-	Europe\UK	2
1	London	4	UK	Europe	UK	London	Europe\UK\London	3

HierarchyBelongsTo

Префикс используется для преобразования таблицы с родительско-дочерней иерархией в полезную таблицу модели данных QlikView (и Qlik Sense). Его можно поставить перед оператором LOAD или SELECT. Он будет использовать результат оператора загрузки в качестве ввода для преобразования таблицы.

Префикс позволяет создавать таблицу, которая содержит все связи родительский-дочерний элемент иерархии. Родительские поля затем могут использоваться для выбора целых деревьев в иерархии. Выходная таблица, как правило, включает несколько записей на каждый узел.

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

Можно создать дополнительные поля, содержащие разницу глубины узлов.

Аргументы:

Аргумент	Описание
NodeID	Имя поля, содержащего идентификатор узла. Это поле должно существовать во входной таблице.
ParentID	Имя поля, содержащего идентификатор родительского узла. Это поле должно существовать во входной таблице.
NodeName	Имя поля, содержащего имя узла. Это поле должно существовать во входной таблице.
AncestorID	Строка имени нового поля идентификатора родительского узла, которое содержит идентификатор родительского узла.
AncestorName	Строка имени нового поля родительского узла, которое содержит имя родительского узла.
DepthDiff	Строка имени нового поля DepthDiff, содержащего глубину узла в иерархии по отношению к родительскому узлу. Необязательный параметр. При его отсутствии это поле не создается.

Результат:

NodeID	AncestorID	NodeName	AncestorName	DepthDiff
1	1	London	London	0
1	4	London	UK	1
1	5	London	Europe	2
2	2	Munich	Munich	0
2	3	Munich	Germany	1
2	5	Munich	Europe	2
3	3	Germany	Germany	0
3	5	Germany	Europe	1
4	4	UK	UK	0
4	5	UK	Europe	1
5	5	Europe	Europe	0

Image_Size

Это предложение используется вместе с префиксами Info или Bundle для изменения размера изображений из СУБД в соответствии с размерами полей.

Аргументы:

Аргумент	Описание
width	Ширина изображения, указанная в пикселах.
height	Высота изображения, указанная в пикселах.

Info

Префикс info используется для связи внешней информации, такой как текстовый файл, изображение или видео, со значением поля.

Если часть внешней информации, например текстовый файл, изображение или видеофайл, необходимо связать со значением поля, то это делается в таблице, загружаемой с помощью префикса info. В некоторых случаях предпочтительнее хранить информацию внутри файла qvw, используя префикс bundle. Таблица должна содержать только два столбца: первый должен отображать значения полей, которые формируют ключи к информации, а второй должен содержать элементы информации, то есть имена файлов изображений и т. п.

Это касается, например, изображений, полученных из СУБД. В двоичном поле (blob) оператор info select выполняет неявную операцию bundle, т. е. двоичные данные будут немедленно выбраны и сохранены в файле qvw. Двоичные данные должны записываться во второе поле оператора SELECT.

Результат:

В качестве имени поля будет видно только LinkedField.

Если добавить текстовый объект на лист, для представления которого задан параметр Изображение, и ввести текст =Info(LinkedField), текстовый объект отобразит имя файла изображения.

Inner

Перед префиксами join и keep может стоять префикс inner.Если этот префикс используется перед join, то он указывает, что необходимо выполнить внутреннее объединение. Результирующая таблица, таким образом, будет содержать только комбинации значений полей из таблиц исходных данных с представлением связанных значений полей в обеих таблицах. Если этот префикс используется перед keep, он указывает, что обе таблицы с исходными данными следует уменьшить до области взаимного пересечения, прежде чем они смогут быть сохранены в программе QlikView (и Qlik Sense).

Аргументы:

Аргумент	Описание
tablename	Будет выполнено сравнение именованной таблицы с загруженной таблицей.
Операторы loadstatementили selectstatement	Оператор LOAD или SELECT для загруженной таблицы.

Inputfield

Чтобы пометить поле как поле ввода, укажите его в операторе inputfield до упоминания в операторах LOAD или SELECT.

fieldlist представляет собой список полей, разделенных запятыми, которые должны быть помечены как поля ввода. В именах полей разрешается использовать знаки подстановки * и ?. При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки.

Поле ввода отличается от обычного поля. Основным его отличием является способность принимать изменения значений поля (в интерактивном режиме или через программирование) без запуска скрипта. Значения поля загружаются в поле с помощью операторов LOAD или SELECT. Каждое значение поля, загружаемое в скрипт, создает заполнитель для значения, которым будет заменено значение поля. Таким образом в интерактивном режиме или путем программирования можно изменять только существующие значения поля. Заменяющее значение задается пользователем, т.е. если поле ввода используется на сервере, разные пользователи будут видеть разные наборы значений в поле ввода. В полях ввода все значения поля считаются различными, даже если некоторые из них одинаковы. Обычно ранее указанные значения сохраняются в полях ввода после загрузки.

IntervalMatch

Префикс IntervalMatch используется для создания таблиц сравнения дискретных числовых значений с одним или несколькими числовыми интервалами, а также сравнения значений с одним или несколькими дополнительными ключами.

Префикс IntervalMatch устанавливается перед оператором LOAD или SELECT, который загружает интервалы. До оператора с префиксом IntervalMatch поле, которое содержит дискретные точки диаграммы (Time в приведенном ниже примере) и дополнительные ключи, уже должно быть загружено в QlikView (и Qlik Sense). Данный префикс не считывает это поле из таблицы базы данных сам по себе. Он преобразует загруженную таблицу интервалов и ключей в таблицу, содержащую дополнительный столбец дискретных числовых точек диаграммы. Здесь также разворачиваются различные записи, что позволяет включать в новую таблицу одну запись на возможную комбинацию дискретных точек диаграммы, интервалов и значений ключевых полей.

Интервалы могут накладываться друг на друга, а дискретные значения будут связаны со всеми соответствующими интервалами.

Расширенный префикс IntervalMatch используется для создания таблиц связывания дискретных числовых значений с одним или несколькими числовыми интервалами, а также связывания значений с одним или несколькими дополнительными ключами. Это очень мощная и гибкая функция, которую можно использовать для связывания транзакций с изменяющимися в динамике по времени измерениями: медленно изменяющимися измерениями.

Во избежание игнорирования неопределенных границ интервалов может потребоваться разрешить сопоставление значений NULL с другими полями, которые образуют нижнюю или верхнюю границы интервала. Это выполняется с помощью оператора NullAsValue или явного теста, который заменяет значения NULL числовыми значениями, расположенными на достаточном расстоянии перед или после дискретных числовых точек диаграммы.

Аргументы:

Аргумент	Описание
matchfield	Поле, содержащее дискретные числовые значения, которые нужно связать с интервалами.
keyfield	Поля, содержащие дополнительные атрибуты, сопоставляемые при преобразовании.
loadstatement or selectstatement	Должна быть получена таблица, где первое поле содержит нижнюю границу каждого интервала, второе поле содержит верхнюю границу каждого интервала, а в случае использования сопоставления ключей третье и все последующие поля содержат ключевые поля, присутствующие в операторе IntervalMatch. Интервалы всегда закрытые, т. е. конечные точки включены в интервал. Нечисловые границы приводят к тому, что интервал игнорируется (неопределенный).

Результат:

Теперь таблица OrderLog содержит дополнительный столбец: Time. Число записей также увеличивается.

Time	Start	End	Order
00:00	-	-	-
01:18	01:00	03:35	A
02:23	01:00	03:35	A
04:15	02:30	07:58	B
04:15	03:04	10:27	C
08:00	03:04	10:27	C
08:00	07:23	11:43	D
11:43	07:23	11:43	D

Результат:

Теперь простую таблицу можно создать следующим образом:

ProductionLine	Time	Event	Comment	Order	Start	End
P1	00:00	0	Start of shift 1	-	-	-
P2	01:00	0	Start of shift 1	-	-	-
P1	01:18	1	Line stop	A	01:00	03:35
P1	02:23	2	Line restart 50%	A	01:00	03:35
P1	04:15	3	Line speed 100%	B	02:30	07:58
P1	04:15	3	Line speed 100%	C	03:04	10:27
P1	08:00	4	Start of shift 2	C	03:04	10:27
P2	09:00	4	Start of shift 2	D	07:23	11:43
P1	11:43	5	End of production	-	-	-
P2	11:43	5	End of production	D	07:23	11:43

IntervalMatch (расширенный синтаксис)

Расширенный префикс IntervalMatch используется для создания таблиц связывания дискретных числовых значений с одним или несколькими числовыми интервалами, а также связывания значений с одним или несколькими дополнительными ключами.

Это очень мощная и гибкая функция, которую можно использовать для связывания транзакций с изменяющимися в динамике по времени измерениями: медленно изменяющимися измерениями.

Префикс IntervalMatch устанавливается перед оператором LOAD или SELECT, который загружает интервалы. В QlikView (и Qlik Sense) до оператора с префиксом IntervalMatch уже должна быть загружена таблица, которая содержит дискретные точки диаграммы и дополнительные ключи. Он преобразует загруженную таблицу интервалов и ключей в таблицу, содержащую дополнительный столбец дискретных числовых точек диаграммы. Здесь также разворачиваются различные записи, что позволяет включать в новую таблицу одну запись на возможную комбинацию дискретных точек диаграммы, интервалов и значений ключевых полей.

matchfield — это поле, содержащее дискретные числовые значения, которые нужно связать с интервалами.

keyfield(s) — это поля, содержащие дополнительные атрибуты, сопоставляемые при преобразовании.

loadstatement или selectstatement должен выдавать таблицу, в которой первые два поля содержат верхний и нижний предел каждого интервала, а третье и последующие поля содержат keyfield(s), существующие в операторе IntervalMatch. Интервалы всегда закрытые, т. е. конечные точки включены в интервал. Нечисловые границы приводят к тому, что интервал игнорируется (неопределенный).

Во избежание игнорирования неопределенных границ интервалов может потребоваться разрешить сопоставление значений NULL с другими полями, которые образуют нижнюю или верхнюю границы интервала. Это выполняется с помощью оператора NullAsValue или явного теста, который заменяет значения NULL числовыми значениями, расположенными на достаточном расстоянии перед или после дискретных числовых точек диаграммы.

Join

Префикс join объединяет загруженную таблицу с существующей таблицей, для которой задано имя, или с последней созданной таблицей данных.

Join — это естественное объединение, образуемое по всем общим полям. Перед оператором join можно задать один из префиксов inner, outer, left или right.

Аргументы:

Аргумент	Описание
tablename	Будет выполнено сравнение именованной таблицы с загруженной таблицей.
Операторы loadstatement или selectstatement	Оператор LOAD или SELECT для загруженной таблицы.

Keep

Префикс keep подобен префиксу join. Также как префикс join, этот префикс сравнивает загруженную таблицу с существующей таблицей, для которой задано имя, или с последней созданной таблицей данных, но вместо объединения загруженной таблицы с существующей он позволяет сократить одну или обе таблицы до сохранения в программе QlikView (и Qlik Sense) путем пересечения данных таблиц. Выполняемое сравнение аналогично натуральному объединению по всем общим полям, т. е. выполняется так же, как и при соответствующем объединении. Однако две таблицы не соединяются и сохраняются в программе QlikView (и Qlik Sense) в виде двух отдельных таблиц с заданными именами.

Перед префиксом keep следует задать один из префиксов inner, left или right.

Явный префикс join в языке скриптов в программе QlikView (и Qlik Sense) выполняет полное объединение двух таблиц. В результате получается одна таблица. Во многих случаях такое объединение приводит к созданию очень больших таблиц. Одной из основных функций QlikView (и Qlik Sense) является возможность связывания нескольких таблиц вместо их объединения, что позволяет значительно сократить использование памяти, повысить скорость обработки и гибкость. По этой причине явных объединений в скриптах QlikView (и Qlik Sense) следует, как правило, избегать. Функция keep предназначена для сокращения числа случаев необходимого использования явных объединений.

Аргументы:

Аргумент	Описание
tablename	Будет выполнено сравнение именованной таблицы с загруженной таблицей.
Операторы loadstatement или selectstatement	Оператор LOAD или SELECT для загруженной таблицы.

Left

Перед префиксами join и keep может стоять префикс left.

Если этот префикс используется перед join, то он указывает, что необходимо выполнить левое объединение. Результирующая таблица будет содержать только комбинации значений полей из таблиц исходных данных с представлением связанных значений полей в первой таблице. Если этот префикс используется перед префиксом keep, он указывает, что вторую таблицу с исходными данными следует уменьшить до области взаимного пересечения с первой таблицей, прежде чем они смогут быть сохранены в программе QlikView (и Qlik Sense).

Аргументы:

Аргумент	Описание
tablename	Будет выполнено сравнение именованной таблицы с загруженной таблицей.
Операторы loadstatement или selectstatement	Оператор LOAD или SELECT для загруженной таблицы.

Mapping

Префикс mapping используется для создания таблицы сопоставления, которую можно использовать, например, для замены значений полей и имен полей в ходе выполнения скрипта.

Префикс mapping можно поставить перед оператором LOAD или SELECT. Он будет сохранять результат оператора загрузки в качестве таблицы сопоставления. Mapping — эффективный способ замены значений полей во время выполнения скрипта, например замены значений «СШ», «С.Ш.» или «Америка» значением «США». Таблица сопоставления состоит из двух столбцов, первый из которых содержит значения, используемые для сравнения, а второй — желаемые значения для сопоставления. Таблицы сопоставления временно хранятся в памяти и автоматически удаляются после выполнения скрипта.

К содержанию таблицы сопоставления доступ осуществляется с помощью, например, оператора Map … Using, Rename Field, функции Applymap() или Mapsubstring().

Полученная таблица выглядит следующим образом:

Salesperson	Country
John	Sweden
Mary	Sweden
Per	Sweden
Preben	Denmark
Olle	Denmark
Ole	Norway
Risttu	Rest of the world

NoConcatenate

Префикс NoConcatenate определяет, что две загруженные таблицы с идентичными наборами полей будут обрабатываться как две отдельные внутренние таблицы вместо автоматического объединения.

Outer

Для указания outer join перед явным префиксом join может стоять префикс outer. При выборе outer join создаются все возможные комбинации двух таблиц. Результирующая таблица, таким образом, будет содержать комбинации значений полей из таблиц исходных данных с представлением связанных значений полей в одной или обеих таблицах.

Ключевое слово outer является необязательным и представляет собой тип объединения по умолчанию, используемый в том случае, если не указан префикс join.

Аргументы:

Аргумент	Описание
tablename	Будет выполнено сравнение именованной таблицы с загруженной таблицей.
Операторы loadstatement или selectstatement	Оператор LOAD или SELECT для загруженной таблицы.

Replace

Префикс replace используется для удаления таблицы в программе QlikView (и Qlik Sense) полностью и ее замены загруженной или выбранной таблицей.

Префикс replace можно добавить в любой оператор LOAD, SELECT или map…using в скрипте. Оператор replace LOAD/replace SELECT отбрасывает всю таблицу QlikView (и Qlik Sense), для которой имя сгенерировано оператором replace LOAD/replace SELECT, и заменяет ее новой таблицей, содержащей результат оператора replace LOAD/replace SELECT. Аналогичный результат достигается во время частичной и полной перезагрузки. Оператор replace map…using запускает сопоставление данных также и во время частичного выполнения скрипта.

Аргументы:

Аргумент	Описание
only	Дополнительный квалификатор, указывающий на то, что оператор следует игнорировать в ходе нормальной (не частичной) перезагрузки.

Right

Перед префиксами join и keep может стоять префикс right.

Если этот префикс используется перед join, то он указывает, что необходимо выполнить правое объединение. Результирующая таблица будет содержать только комбинации значений полей из таблиц исходных данных с представлением связанных значений полей во второй таблице. Если этот префикс используется перед префиксом keep, он указывает, что первую таблицу с исходными данными следует уменьшить до области взаимного пересечения со второй таблицей, прежде чем они смогут быть сохранены в программе QlikView (и Qlik Sense).

Аргументы:

Аргумент	Описание
tablename	Будет выполнено сравнение именованной таблицы с загруженной таблицей.
Операторы loadstatement или selectstatement	Оператор LOAD или SELECT для загруженной таблицы.

Sample

Префикс sample операторов LOAD или SELECT используется для загрузки произвольного образца записей из источника данных.

Аргументы:

Аргумент	Описание
p	Произвольное выражение, которое определяет число больше 0 и меньше или равное 1. Число обозначает вероятность считывания определенной записи. Все записи будут считаны, но только некоторые из них будут загружены в программу QlikView (и Qlik Sense).

Semantic

Таблицы, содержащие связи между записями, можно загрузить с помощью префикса semantic. Это могут быть, например, рекурсивные ссылки в пределах таблицы, где одна запись указывает на другую, такую как родительская, та, которой она принадлежит, или предшествующая.

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

Таблицы, загруженные посредством оператора semantic, не могут быть объединены.

Unless

Префикс и суффикс unless используется для создания условного предложения, определяющего вычисление или невычисление оператора либо условия «exit». Это короткое утверждение можно использовать вместо полного оператора if..end if.

Действия statement или exitstatement выполняются, только если элемент condition имеет значение False.

Префикс unless можно использовать в операторах, включающих в себя один или несколько других операторов, в том числе дополнительные префиксы when или unless.

Аргументы:

Аргумент	Описание
condition	Логическое выражение, имеющее значение True или False.
statement	Любой оператор скрипта QlikView (и Qlik Sense), за исключением операторов управления.
exitstatement	Предложение exit for, exit do или exit sub или оператор exit script.

When

Префикс и суффикс when используется для создания условного предложения, определяющего исполнение или неисполнение оператора либо условия «exit». Это короткое утверждение можно использовать вместо полного оператора if..end if.

Действия statement или exitstatement выполняются, только если условие имеет значение True.

Префикс when можно использовать в операторах, включающих в себя один или несколько других операторов, в том числе дополнительные префиксы when или unless.

Обычные операторы скриптов

Как правило, обычные операторы используются для управления данными тем или иным образом. Эти операторы могут быть перезаписаны любым числом линий в скрипте и всегда должны заканчиваться точкой с запятой, «;».

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

Пользуйтесь информацией из раскрывающегося списка по каждой функции, чтобы увидеть краткое описание и синтаксис каждой функции. Дополнительную информацию можно получить, если щелкнуть имя функции в описании синтаксиса.

Alias	Оператор alias используется для установки псевдонима, по которому будет переименовано поле при включении в следующий скрипт. Alias fieldname as aliasname {,fieldname as aliasname}
Binary	Оператор binary используется для загрузки данных из другого документа QlikView (и Qlik Sense), включая данные секции доступа. Binary file file ::= [ path ] filename
Comment field	Позволяет отображать комментарии поля (метаданные) из баз данных и электронных таблиц. Имена полей, отсутствующие в документе, будут игнорироваться. Если имя поля встречается несколько раз, используется последнее значение. comment *fieldlist using mapname comment fieldname with comment
Comment table	Позволяет отображать комментарии таблицы (метаданные) из баз данных или электронных таблиц. comment-table tablelist using mapname comment-table tablename with comment
Direct Query	Оператор DIRECT QUERY обеспечивает доступ к таблицам через подключение ODBC или OLE DB с помощью функции Direct Discovery. direct-query [path]
Directory	Оператор Directory задает каталог, в котором будет выполняться поиск файлов данных в последующих операторах LOAD до создания нового оператора Directory. Directory [path]
Disconnect	Оператор Disconnect разрывает текущее соединение ODBC/OLE DB/Custom. Этот оператор является дополнительным. Disconnect
drop field	Одно или несколько полей QlikView (и Qlik Sense) можно удалить из модели данных, а, значит, и из памяти в любой момент выполнения скрипта с помощью оператора drop field. Допустимыми являются оба оператора drop field и drop fields, причем оба они выполняют одно и то же действие. Если таблица не задана, поле удаляется из всех таблиц, в которых оно встречается. drop-field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]] drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
drop table	Одну или несколько внутренних таблиц QlikView (и Qlik Sense) можно удалить из модели данных, а значит и из памяти в любой момент выполнения скрипта с помощью оператора drop table. Допустимыми являются оба оператора: drop table и drop tables. drop-table tablename [, tablename2 ...] drop tables [ tablename [, tablename2 ...]
Execute	Оператор Execute используется для запуска других программ в ходе загрузки данных QlikView (и Qlik Sense). Например, для выполнения необходимых преобразований. Execute commandline
Force	Оператор force инициирует интерпретацию в программе QlikView (и Qlik Sense) имен и значений полей последующих операторов LOAD и SELECT, как записанных только символами верхнего регистра, только символами нижнего регистра, всегда прописными буквами или как есть (смешанными). Этот оператор позволяет ассоциировать значения полей в таблицах, выполненных в соответствии с различными условными обозначениями. Force ( capitalization | case upper | case lower | case mixed )
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 ]
Let	Оператор let создан как дополнение к оператору set, используемому для определения переменных скрипта. Оператор let, в отличие от оператора set, вычисляет выражение, расположенное справа от знака «=» до присваивания его переменной. Let variablename=expression
Loosen Table	Одну или несколько внутренних таблиц данных в программе QlikView (и Qlik Sense) можно явно объявить слабосвязанными в ходе выполнения скрипта с помощью оператора Loosen Table. Использование одного или нескольких операторов Loosen Table в скрипте приведет к тому, что программа QlikView (и Qlik Sense) будет игнорировать параметры таблиц, считая их ставшими слабосвязанными до выполнения скрипта. loosen-table tablename [ , tablename2 ...] Loosen Tables tablename [ , tablename2 ...]
Map … using	Оператор map … using используется для сопоставления определенных значений полей или выражений со значениями в определенной таблице сопоставления. Таблицу сопоставления можно создать с помощью оператора Mapping. Map *fieldlist Using mapname
NullAsNull	Оператор NullAsNull отключает преобразование значений NULL в строчные значения, ранее заданные с помощью оператора NullAsValue. NullAsNull *fieldlist
NullAsValue	Оператор NullAsValue указывает, для каких из полей обнаруженные значения NULL должны быть преобразованы в значения. NullAsValue *fieldlist
Qualify	Оператор Qualify используется для включения квалификации имен полей, т. е. имена полей получат имя таблицы в качестве префикса. Qualify *fieldlist
Rem	Оператор rem служит для вставки замечаний или комментариев в скрипт или для временного отключения операторов скрипта без их удаления. Rem string
Rename Field	Эта функция скрипта переименовывает одно или несколько существующих полей в программе QlikView (и Qlik Sense) после их загрузки. rename-field (using mapname | oldname to newname{ , oldname to newname }) Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Rename Table	Эта функция скрипта переименовывает одну или несколько существующих внутренних таблиц в программе QlikView (и Qlik Sense) после их загрузки. rename-table (using mapname | oldname to newname{ , oldname to newname }) Rename Tables (using mapname | oldname to newname{ , oldname to newname })
Section	Оператор section позволяет определить, следует ли рассматривать последующие операторы LOAD и SELECT в качестве данных или определения прав доступа. Section (access | application)
Select	Выбор полей из источника данных ODBC или поставщика OLE DB осуществляется с помощью стандартных операторов SQL SELECT. Однако то, принимаются операторы SELECT или нет, зависит в основном от используемого драйвера ODBC или поставщика OLE DB. Select [all | distinct | distinctrow | top n [percent] ] *fieldlist From tablelist [Where criterion ] [Group by fieldlist [having criterion ] ] [Order by fieldlist [asc | desc] ] [ (Inner | Left | Right | Full)Join tablename on fieldref = fieldref ]
Set	Оператор set используется для определения переменных скрипта. Эти переменные можно использовать для подстановки строк, путей, драйверов и т. д. Set variablename=string
Sleep	Оператор sleep приостанавливает выполнение скрипта на указанное время. Sleep n
SQL	Оператор SQL позволяет отправлять произвольную команду SQL посредством подключения ODBC или OLE DB. SQL sql_command
SQLColumns	Оператор sqlcolumns возвращает набор полей с описанием столбцов источника данных ODBC или OLE DB, с которыми выполнена операция connect. SQLColumns
SQLTables	Оператор sqltables возвращает набор полей с описанием таблиц источника данных ODBC или OLE DB, с которыми выполнена операция connect. SQLTables
SQLTypes	Оператор sqltypes возвращает набор полей с описанием типов источника данных ODBC или OLE DB, с которыми выполнена операция connect. SQLTypes
Star	Строку, которая представляет набор всех значений поля в базе данных, можно определить с помощью оператора star. Она влияет на последующие операторы LOAD и SELECT. Star is [string ]
Store	Эта функция скрипта создает файл QVD или CSV. Store [ *fieldlist from] table into filename [ format-spec ];
Tag	Эта функция скрипта предоставляет возможность присваивать теги одному или нескольким полям. Если делается попытка присвоить тег имени поля, отсутствующему в документе, то эта операция будет проигнорирована. Если обнаружены конфликты между именами полей или тегов, то используется последнее значение. Tag fields fieldlist using mapname Tag field fieldname with tagname
Trace	Оператор trace записывает строку в окно Ход выполнения скрипта и в файл журнала скрипта, если тот используется. Он очень полезен для отладки. Расширение $, добавляемое к переменным, вычисляемым до оператора trace, позволяет настроить сообщение. Trace string
Unmap	Оператор Unmap деактивирует значение поля mapping, заданное предыдущим оператором Map … Using для последующих загружаемых полей. Unmap *fieldlist
Unqualify	Оператор Unqualify используется для снятия уточнения имен полей, которое ранее было включено оператором Qualify. Unqualify *fieldlist
Untag	Предоставляет возможность удалить теги из одного или нескольких полей. Если делается попытка снять тег с имени поля, отсутствующего в документе, то эта операция будет проигнорирована. Если обнаружены конфликты между именами полей или тегов, то используется последнее значение. Untag fields fieldlist using mapname Untag field fieldname with tagname

Alias

Оператор alias используется для установки псевдонима, по которому будет переименовано поле при включении в следующий скрипт.

Аргументы:

Аргумент	Описание
fieldname	Имя поля в исходных данных
aliasname	Имя псевдонима, которое требуется использовать взамен.

Binary

Оператор binary используется для загрузки данных из другого документа QlikView (и Qlik Sense), включая данные секции доступа. Он не загружает данные макета или переменные.

Аргументы:

Аргумент	Описание
filename	Имя файла, включая расширение файла .qvw
path	Абсолютный или относительный путь к файлу ..qvw, содержащему эту строку скрипта. Абсолютный путь необходим, если файл находится в расположении, отличном от QlikView (и Qlik Sense). абсолютный Пример: c:\data\ относительно документа, содержащего эту строку скрипта. Пример: data\

Comment field

Позволяет отображать комментарии поля (метаданные) из баз данных и электронных таблиц. Имена полей, отсутствующие в документе, будут игнорироваться. Если имя поля встречается несколько раз, используется последнее значение.

Таблица сопоставления должна включать в себя два столбца: в первом содержатся имена полей, а во втором — комментарии.

Аргументы:

Аргумент	Описание
*fieldlist	Список разделенных запятыми полей, подлежащих комментированию. Символ * в качестве списка полей обозначает все поля. В именах полей разрешается использовать знаки подстановки * и ? . При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки.
mapname	Имя таблицы сопоставления, считанной ранее в операторе сопоставления LOAD или SELECT.
fieldname	Имя поля, для которого необходимо добавить комментарий.
comment	Комментарий, который следует добавить к полю.

Comment table

Позволяет отображать комментарии таблицы (метаданные) из баз данных или электронных таблиц.

Имена таблиц, отсутствующие в документе, будут игнорироваться. Если имя таблицы встречается несколько раз, используется последнее значение. Для чтения комментариев из источника данных может использоваться ключевое слово.

Аргументы:

Аргумент	Описание
tablelist	(table{,table})
mapname	Имя таблицы сопоставления, считанной ранее в операторе сопоставления LOAD или SELECT.
tablename	Имя таблицы, для которой необходимо добавить комментарий.
comment	Комментарий, который следует добавить в таблицу.

Direct Query

Оператор DIRECT QUERY обеспечивает доступ к таблицам через подключение ODBC или OLE DB с помощью функции Direct Discovery.

Ключевые слова DIMENSION, MEASURE и DETAIL можно использовать в любом порядке.

Предложения ключевых слов DIMENSION и FROM требуются во всех операторах DIRECT QUERY. Ключевое слово FROM должно стоять после ключевого слова DIMENSION.

Поля, указанные сразу после ключевого слова DIMENSION, загружаются в память и могут использоваться для создания связей между данными в памяти и данными Direct Discovery.

С помощью ключевого слова MEASURE можно определить поля, которые QlikView (и Qlik Sense) будет распознавать на «уровне метаданных». Фактические данные поля «Мера» находятся только в базе данных во время процесса загрузки данных. Они извлекаются через прямое подключение с помощью выражений, используемых в диаграмме.

Обычно поля с дискретными значениями, которые используются в качестве измерений, загружаются с ключевым словом DIMENSION, тогда как числа, используемые только при агрегировании, должны быть выбраны с ключевым словом MEASURE.

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

Оператор DIRECT QUERY не зависит от источника данных для источников, поддерживающих SQL. Поэтому один и тот же оператор DIRECT QUERY можно использовать для разных баз данных SQL без внесения изменений. Direct Discovery создает запросы для конкретных баз данных, если необходимо.

Синтаксис источника данных NATIVE можно использовать, если пользователь знает, какая база данных запрашивается, и хочет использовать специальные расширения для базы данных SQL. Синтаксис источника данных NATIVE поддерживается:

• В качестве выражения поля в предложениях DIMENSION и MEASURE
• В качестве содержимого предложения WHERE

Аргументы:

Аргумент	Описание
fieldlist	Список спецификаций поля, разделенных запятыми, fieldname {, fieldname}. Спецификация поля может быть именем поля. В этом случае такое же имя используется для имени столбца базы данных и имени поля QlikView (и Qlik Sense). Также спецификация поля может быть «полем alias». В этом случае выражению базы данных или имени столбца задается имя поля QlikView (и Qlik Sense).
tablelist	Список имен таблиц или видов в базе данных, из которых загружаются данные. Как правило, это просмотры, содержащие оператор JOIN, выполненный над базой данных.
where_clause	Здесь не приведено полное описание синтаксиса предложений базы данных WHERE, но большинство «реляционных выражений» SQL разрешено использовать, включая вызовы функций, оператор LIKE для строк, IS NULL и IS NOT NULL, а оператор IN. BETWEEN не включен. NOT — это унарный оператор, в отличие от модификатора на определенные ключевые слова. Примеры: WHERE x > 100 AND "Region Code" IN ('south', 'west') WHERE Code IS NOT NULL and Code LIKE '%prospect' WHERE NOT X in (1,2,3) Последний пример не может быть записан как: WHERE X NOT in (1,2,3)

Списки полей Direct Discovery

Список полей — это список спецификаций поля, разделенных запятыми: fieldname {, fieldname}. Спецификация поля может быть именем поля. В этом случае такое же имя используется для имени столбца базы данных и имени поля. Также спецификация поля может быть «полем alias». В этом случае выражению базы данных или имени столбца задается имя поля QlikView (и Qlik Sense).

Имена полей могут быть простыми именами или заключенными в кавычки. Простое имя начинается с буквенного символа Юникода и состоит из комбинации букв, цифр и знаков подчеркивания. Имена в кавычках начинаются с двойной кавычки и содержат любую последовательность символов. Если имя, заключенное в кавычки, содержит двойные кавычки, эти кавычки представляются в виде двух смежных двойных кавычек.

Имена полей QlikView (и Qlik Sense) используются с учетом регистра. Имена полей базы данных могут учитывать или не учитывать регистр, в зависимости от базы данных. Запрос Direct Discovery сохраняет регистр всех идентификаторов полей и псевдонимов. В следующем примере псевдоним "MyState" используется для внутренних целей для сохранения данных из столбца базы данных "STATEID".

Это отличается от результата использования оператора SQL Select с псевдонимом. Если псевдоним не заключен в кавычки, результат будет содержать регистр по умолчанию столбца, возвращенного целевой базой данных. В следующем примере оператор SQL Select для базы данных Oracle создает "MYSTATE," со всеми буквами в верхнем регистре, как и внутренний псевдоним QlikView (и Qlik Sense), даже если в псевдониме используются символы в разном регистре. Оператор SQL Select использует имя столбца, возвращенное базой данных, которое в случае Oracle состоит из всех символов в верхнем регистре.

Чтобы избежать такого поведения, для указания псевдонима используйте оператор LOAD.

В данном примере столбец "STATEID" сохраняется QlikView (и Qlik Sense) для внутренних целей в качестве "MyState".

Большинство скалярных выражений базы данных разрешено использовать в качестве спецификаций поля. Вызовы функций также можно использовать в качестве спецификаций поля. Выражения могут содержать константы: булевы, числовые или строки, заключенные в одиночные кавычки (встроенные одинарные кавычки представляются в виде двух смежных одинарных кавычек.).

Directory

Оператор Directory задает каталог, в котором будет выполняться поиск файлов данных в последующих операторах LOAD до создания нового оператора Directory.

Если оператор Directory задается без параметра path или вообще опускается, программа QlikView (и Qlik Sense) будет искать в рабочем каталоге QlikView (и Qlik Sense).

Аргументы:

Аргумент	Описание
path	Текст может интерпретироваться как путь к файлу qvw. Path — путь к файлу: абсолютный Пример: c:\data\ относительно пути документа QlikView (и Qlik Sense). Пример: data\ URL-адрес (HTTP или FTP), указывающий на местоположение в Интернете или интрасети. Пример: http://www.qlik.com

Disconnect

Оператор Disconnect разрывает текущее соединение ODBC/OLE DB/Custom. Этот оператор является дополнительным.

Подключение будет разорвано автоматически при выполнении нового оператора connect или после завершения выполнения скрипта.

Drop field

Одно или несколько полей QlikView (и Qlik Sense) можно удалить из модели данных, а, значит, и из памяти в любой момент выполнения скрипта с помощью оператора drop field.

Drop table

Одну или несколько внутренних таблиц QlikView (и Qlik Sense) можно удалить из модели данных, а значит и из памяти в любой момент выполнения скрипта с помощью оператора drop table.

В результате выполнения этого действия произойдет удаление следующих элементов:

• Реальной таблицы.
• Всех полей, которые не относятся к остальным таблицам.
• Значений полей в остальных полях, относящихся только к отброшенным таблицам.

Execute

Оператор Execute используется для запуска других программ в ходе загрузки данных QlikView (и Qlik Sense). Например, для выполнения необходимых преобразований.

Аргументы:

Аргумент	Описание
commandline	Текст, который может интерпретироваться операционной системой как командная строка.

Force

Оператор force инициирует интерпретацию в программе QlikView (и Qlik Sense) имен и значений полей последующих операторов LOAD и SELECT, как записанных только символами верхнего регистра, только символами нижнего регистра, всегда прописными буквами или как есть (смешанными). Этот оператор позволяет ассоциировать значения полей в таблицах, выполненных в соответствии с различными условными обозначениями.

Если не указан ни один параметр, применяется force case mixed. Оператор force действует до создания следующего оператора force.

Оператор force не влияет на секцию доступа: регистр во всех загруженных значениях полей не учитывается.

Пример	Результат
В данном примере показано принудительное использование прописных букв. FORCE Capitalization; Capitalization: LOAD * Inline [ ab Cd eF GH ];	Таблица Capitalization содержит следующие значения: Ab Cd Ef Gh Все значения вводятся с первой прописной буквой.
В данном примере показано принудительное использование верхнего регистра. FORCE Case Upper; CaseUpper: LOAD * Inline [ ab Cd eF GH ];	Таблица CaseUpper содержит следующие значения: AB CD EF GH Все значения вводятся в верхнем регистре.
В данном примере показано принудительное использование нижнего регистра. FORCE Case Lower; CaseLower: LOAD * Inline [ ab Cd eF GH ];	Таблица CaseLower содержит следующие значения: ab cd ef gh Все значения вводятся в нижнем регистре.
В данном примере показано принудительное использование смешанного регистра. FORCE Case Mixed; CaseMixed: LOAD * Inline [ ab Cd eF GH ];	Таблица CaseMixed содержит следующие значения: ab Cd eF GH Все значения вводятся в том виде, в котором они отображаются в скрипте.

Load

Оператор LOAD загружает поля из файла, из определенных в скрипте данных, из ранее загруженной таблицы, из веб-страницы, из результата последующего оператора SELECT или путем создания данных.

Аргументы:

Аргумент	Описание
distinct	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 используется как конечное положение. Если после @startpos:endpos указаны символы I или U, прочитанные байты будут интерпретированы как двоичное целое число со знаком (I) или без знака (U) (порядок байтов Intel). Прочитанное число позиций должно быть 1, 2 или 4. Если после @startpos:endpos указан символ R, прочитанные байты будут интерпретированы как двоичное действительное число (32-разрядное IEEE или 64-разрядное с плавающей запятой). Прочитанное число позиций должно быть 4 или 8. Если после @startpos:endpos указан символ B, прочитанные байты будут интерпретироваться как числа в двоичной кодировке BCD (Binary Coded Decimal) в соответствии со стандартом COMP-3. Может быть указано любое число байтов. expression может быть числовой или строковой функцией на основе одного или нескольких других полей в этой же таблице. Дополнительные сведения см. в справке по синтаксису выражений. as используется для назначения полю нового имени.
from	from используется в случае, если данные должны быть загружены из файла. file ::= [ path ] filename абсолютный Пример: c:\data\ относительно пути документа QlikView (и Qlik Sense). Пример: data\ URL-адрес (HTTP или FTP), указывающий на местоположение в Интернете или интрасети. URL-адрес должен быть представлен в кодировке URL, к примеру, в случае, если он содержит пробелы. Пример: http://www.qlik.com Пример: http://www.enterprise.com/project%20files (http://www.enterprise.com/project files) Если путь отсутствует, программа QlikView (и Qlik Sense) выполняет поиск файла в каталоге, указанном оператором Directory. Если оператор Directory отсутствует, приложение QlikView (и Qlik Sense) выполняет поиск в рабочем каталоге, который обычно является каталогом, в котором находится файл QlikView (и Qlik Sense). При серверной установке QlikView (и Qlik Sense) рабочим каталогом по умолчанию является C:\ProgramData\QlikTech\Documents. Рабочий каталог по умолчанию можно изменить в QlikView (и Qlik Sense) 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, используемым для создания исходной таблицы. В конце метки должно быть указано двоеточие.
autogenerate	autogenerate используется в случае, если данные должны быть автоматически созданы программой QlikView (и Qlik Sense). size ::= number Number — это целое число, обозначающее число создаваемых записей. Список полей не должно содержать выражения, для которых требуются данные из базы данных. В выражениях допускается использовать только константы и функции без параметров (такие как rand() или recno()).
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. Однако поля, созданные с помощью выражения (aliasname), не рассматриваются и не могут использоваться внутри одного оператора LOAD.

Если источник данных не указан с помощью выражений from, inline, resident, from_field или autogenerate, данные будут загружены из результата сразу после выполнения оператора SELECT или LOAD. Последующий оператор не должен иметь префикс.

Элементы спецификации формата

Каждый элемент спецификации формата задает определенное свойство табличного файла:

Пользуйтесь информацией из таблицы по каждой функции, чтобы увидеть краткое описание и синтаксис каждой функции.

Character set	Набор символов — это спецификатор файла для оператора LOAD, который определяет набор символов, используемый в файле. ansi | oem | mac | UTF-8 | Unicode | codepage is | См.: Набор символов
Table format	Формат таблицы — это спецификатор файла для оператора LOAD, который определяет тип файла. Если ничего не было указано, то используется формат .txt. txt | fix | dif | biff | ooxml | html | xml | qvd | qvx См.: Table format
Delimiter	Для табличных файлов с разделителями можно указать произвольный разделитель с помощью описателя delimiter is. Этот описатель применяется только к файлам с разделителем формата .txt. delimiter is char
Header is	Задает размер заголовка в табличных файлах. Произвольная длина заголовка задается с помощью описателя header is. Заголовок представляет собой текстовый раздел, не используемый программой QlikView (и Qlik Sense). header-is n Header is line Header is n lines
Comment is	Если в файле с исходными данными есть строки, являющиеся комментариями, префикс комментария можно определить с помощью элемента Comment is. Задайте элемент commentprefix для символа или строки, с которой начинается строка комментария, и при загрузке данных эти строки будут игнорироваться. Comment is commentprefix
labels	Labels — это спецификатор файла для оператора LOAD, который определяет нахождение имен полей в файле. embedded labels | explicit labels| no labels
no eof	Спецификатор no eof используется для игнорирования символа конца файла при загрузке файлов с разделителями в формате .txt. no-eof
quotes	Элемент Quotes представляет собой файловый спецификатор для оператора LOAD, который определяет, могут ли использоваться кавычки, а также последовательность кавычек и разделителей. Только текстовые файлы. no quotes msq
Record is	При использовании файлов с фиксированной длиной записи укажите длину записи с помощью описателя record is. record-is n Record is line Record is n lines
XML	Этот спецификатор скрипта используется при загрузке файлов xml. Допустимые параметры для спецификатора XML перечислены в синтаксических правилах. xmlsax xmlsimple pattern is path См.: XML

Набор символов

Набор символов — это спецификатор файла для оператора LOAD, который определяет набор символов, используемый в файле.

Аргументы:

Аргумент	Описание
utf8	Набор символов UTF-8
unicode	Набор символов Unicode
ansi	Windows, кодовая страница 1252
oem	DOS, OS/2, AS400 и другие
mac	Кодовая страница 10000
codepage is	Со спецификатором codepage можно использовать любую кодовую страницу Windows как N .

Ограничения:

Преобразование из набора символов oem не реализовано для MacOS. Если не выбран ни один набор, используется кодовая страница 1252 для Windows.

Table format

Формат таблицы — это спецификатор файла для оператора LOAD, который определяет тип файла. Если ничего не было указано, то используется формат .txt.

txt	В текстовом файле с разделителями столбцы в таблице разделены символом разделителя. См.: Delimiter
fix	В файле с записями фиксированной длины каждое поле ограничено точным числом символов. Обычно многие файлы с фиксированной длиной содержат записи, разделенные символом перевода строки. Но существует много других вариантов, как указать размер записи в байтах или охватить более одной линии с помощью Record is. См.: Record is Если данные содержат многобайтовые символы, разрывы полей могут сместиться, поскольку этот формат основан на фиксированной длине в байтах.
dif	В файле .dif (Data Interchange Format — формат обмена данными) для определения таблицы используется особый формат.
biff	Программа QlikView (и Qlik Sense) может также интерпретировать данные в стандартных файлах Excel средствами формата biff (Binary Interchange File Format).
ooxml	Для файлов Excel 2007 и более поздних версий используется формат ooxml .xslx.
html	Если таблица является частью html-страницы или файла, используйте формат html.
xml	xml (расширяемый язык разметки) — это обычный язык разметки, используемый для представления структур данных в текстовом формате.
qvd	Формат qvd представляет собой собственный формат файлов QVD, экспортируемых из документа QlikView (и Qlik Sense).
qvx	Формат qvx представляет собой формат файла или потока для высокоэффективной передачи в программу QlikView (и Qlik Sense).

Delimiter

Для табличных файлов с разделителями можно указать произвольный разделитель с помощью описателя delimiter is. Этот описатель применяется только к файлам с разделителем формата .txt.

Аргументы:

Аргумент	Описание
char	Указывает один символ из 127 ASCII символов.

Могут использоваться следующие значения:

'\t'	представляет знак табуляции и указывается с кавычками или без них.
'\\'	представляет обратную косую черту ( \ ).
'spaces'	представляет все комбинации одного или нескольких пробелов. Непечатные символы ASCII с кодом менее 32, за исключением CR и LF, будут интерпретироваться как пробелы.

Если ничего не указано, используется delimiter is ','.

No eof

Спецификатор no eof используется для игнорирования символа конца файла при загрузке файлов с разделителями в формате .txt.

Если используется спецификатор no eof, символ с кодовой точкой 26, который в противном случае обозначает конец файла, игнорируется и может быть частью значения поля.

Этот спецификатор применяется только к текстовым файлам с разделителями.

Labels

Labels — это спецификатор файла для оператора LOAD, который определяет нахождение имен полей в файле.

Имена полей могут находиться в разных местах файла. Если первая запись содержит имена полей, следует использовать embedded labels. Если имена полей не найдены, следует использовать no labels. В файлах dif иногда используются отдельные разделы заголовка с явными именами полей. В таких случаях следует использовать explicit labels. Если не выбран ни один параметр, для файлов dif также используются embedded labels.

Header is

Задает размер заголовка в табличных файлах. Произвольная длина заголовка задается с помощью описателя header is. Заголовок представляет собой текстовый раздел, не используемый программой QlikView (и Qlik Sense).

Длина заголовка может быть задана в байтах (header is n) или в строках (header is line или header is n lines). n должно быть положительным целым числом, представляющим длину заголовка. Если ничего не указано, используется header is 0. Спецификатор header is применяется только к табличным файлам.

Record is

При использовании файлов с фиксированной длиной записи укажите длину записи с помощью описателя record is.

Аргументы:

Аргумент	Описание
n	Указывает длину записи в байтах.
line	Указывает длину записи в качестве одной строки.
n lines	Указывает длину записи в строках, где n — это положительное целое число, представляющее длину записи.

Ограничения:

Спецификатор record is применяется только к файлам fix.

Quotes

Элемент Quotes представляет собой файловый спецификатор для оператора LOAD, который определяет, могут ли использоваться кавычки, а также последовательность кавычек и разделителей. Только текстовые файлы.

Если спецификатор опущен, можно использовать стандартные кавычки " " или ' ', но только в том случае, если они являются первым и последним непустым символом в значении поля.

Аргументы:

Аргумент	Описание
no quotes	Используется, если кавычки не должны приниматься в текстовом файле.
msq	Используется для задания современного стиля кавычек, которые позволяют вводить в поля многострочное содержимое. Поля, содержащие символы конца строки, необходимо заключать в двойные кавычки. Существует одно ограничение для параметра msq: если в качестве первого или последнего символа в содержимом строки указан один символ двойных кавычек («/»), то он будет интерпретирован как начало многострочного содержимого, что в свою очередь может привести к непредсказуемым результатам при загрузке набора данных. В этом случае следует использовать стандартные кавычки для пропуска спецификатора.

XML

Этот спецификатор скрипта используется при загрузке файлов xml. Допустимые параметры для спецификатора XML перечислены в синтаксических правилах.

Элементы xmlsax и xmlsimple взаимоисключающие. При использовании xml можно указать только один вариант. При использовании pattern считывание файла начинается с начала указанного тега и идет до его конца. Если path содержит пробелы, то такой путь необходимо заключить в кавычки.

Let

Оператор let создан как дополнение к оператору set, используемому для определения переменных скрипта. Оператор let, в отличие от оператора set, вычисляет выражение, расположенное справа от знака «=» до присваивания его переменной.

Слово let может игнорироваться, но при этом этот оператор становится оператором управления. Такой оператор без ключевого слова let должен находиться в одной строке скрипта и может заканчиваться точкой с запятой или символом конца строки.

Loosen Table

Одну или несколько внутренних таблиц данных в программе QlikView (и Qlik Sense) можно явно объявить слабосвязанными в ходе выполнения скрипта с помощью оператора Loosen Table. Когда таблица становится слабо связанной, все ассоциации между значениями полей в таблице удаляются. Похожего эффекта можно добиться, если загрузить все поля слабо связанной таблицы в качестве независимых несвязанных таблиц. Слабо связанные таблицы можно использовать во время проверки для временного разделения частей структуры данных. Слабо связанная таблица в обозревателе таблиц обозначается пунктирной линией и стрелкой. Использование одного или нескольких операторов Loosen Table в скрипте приведет к тому, что программа QlikView (и Qlik Sense) будет игнорировать параметры таблиц, считая их ставшими слабосвязанными до выполнения скрипта.

Можно использовать оба варианта синтаксиса: Loosen Table или Loosen Tables.

Map

Оператор map … using используется для сопоставления определенных значений полей или выражений со значениями в определенной таблице сопоставления. Таблицу сопоставления можно создать с помощью оператора Mapping.

Автоматическое сопоставление выполняется для полей, загруженных после выполнения оператора Map … Using вплоть до конца выполнения скрипта или появления оператора Unmap.

Сопоставление в цепочке событий, заканчивающейся сохранением поля во внутренней таблице QlikView (и Qlik Sense), выполняется в последнюю очередь. Таким образом, сопоставление выполняется не при каждом появлении имени поля в выражении, а тогда, когда значение сохранено во внутренней таблице под определенным именем поля. Если необходимо выполнить сопоставление на уровне выражения, используйте функцию Applymap().

Аргументы:

Аргумент	Описание
*fieldlist	Разделенный запятыми список полей, которые следует сопоставить, начиная с этой точки выполнения скрипта. Символ * в качестве списка полей обозначает все поля. В именах полей разрешается использовать знаки подстановки * и ?. При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки.
mapname	Имя таблицы сопоставления, считанной ранее в операторе mapping load или mapping select.

NullAsNull

Оператор NullAsNull отключает преобразование значений NULL в строчные значения, ранее заданные с помощью оператора NullAsValue.

Оператор NullAsValue работает как переключатель и может быть включен/выключен несколько раз в рамках скрипта с помощью оператора NullAsValue или NullAsNull.

Аргументы:

Аргумент	Описание
*fieldlist	Список полей, разделенных запятыми, для которых следует включить NullAsNull. Символ * в качестве списка полей обозначает все поля. В именах полей разрешается использовать знаки подстановки * и ?. При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки.

NullAsValue

Оператор NullAsValue указывает, для каких из полей обнаруженные значения NULL должны быть преобразованы в значения.

По умолчанию программа QlikView (и Qlik Sense) рассматривает значения NULL как отсутствующие или неопределенные сущности. Тем не менее, в некоторых контекстах баз данных значения NULL считаются особыми значениями, а не просто отсутствующими значениями. Связь значений NULL с другими значениями NULL, которая обычно запрещена, можно создать с помощью оператора NullAsValue.

Оператор NullAsValue работает как переключатель и выполняется для последующих операторов загрузки. Его можно снова выключить с помощью оператора NullAsNull.

Аргументы:

Аргумент	Описание
*fieldlist	Список полей, разделенных запятыми, для которых следует включить NullAsValue. Символ * в качестве списка полей обозначает все поля. В именах полей разрешается использовать знаки подстановки * и ?. При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки.

Qualify

Оператор Qualify используется для включения квалификации имен полей, т. е. имена полей получат имя таблицы в качестве префикса.

Автоматическое объединение полей с одинаковыми именами в разных таблицах можно отключить с помощью оператора qualify, который уточняет имя поля с помощью имени таблицы. В случае уточнения имена полей будут изменены после их нахождения в таблице. Новое имя будет иметь вид tablename.fieldname. Tablename соответствует метке текущей таблицы или, при отсутствии метки, имени после слова from в операторах LOAD и SELECT.

Уточнение будет выполнено для всех полей, загруженных после оператора qualify.

Когда запускается скрипт, функция уточнения всегда отключена по умолчанию. Уточнение имени поля можно включить в любое время с помощью оператора qualify. Уточнение можно выключить в любое время с помощью оператора Unqualify.

Аргументы:

Аргумент	Описание
*fieldlist	Список полей, разделенных запятыми, для которых следует включить уточнение. Символ * в качестве списка полей обозначает все поля. В именах полей разрешается использовать знаки подстановки * и ?. При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки.

Rem

Оператор rem служит для вставки замечаний или комментариев в скрипт или для временного отключения операторов скрипта без их удаления.

Весь текст между элементом rem и следующей точкой с запятой ; считается комментарием.

В скрипт можно добавить комментарии двумя другими способами:

1. Можно создать комментарий в любом месте в скрипте, за исключением текста между двумя кавычками, для чего необходимо заключить необходимый фрагмент в символы /* и */.
2. При вводе // в скрипте весь последующий текст справа в той же строке становится комментарием. (Обратите внимание на исключение //:, которое обычно является частью интернет-адреса).

Аргументы:

Аргумент	Описание
string	Произвольный текст.

Rename field

Эта функция скрипта переименовывает одно или несколько существующих полей в программе QlikView (и Qlik Sense) после их загрузки.

Можно использовать оба варианта синтаксиса: rename field или rename fields.

Аргументы:

Аргумент	Описание
mapname	Имя ранее загруженной таблицы сопоставления, в которой содержится одна или несколько пар старых и новых имен полей.
oldname	Старое имя поля.
newname	Новое имя поля.

Ограничения:

Два поля с разными именами не могут получить одинаковые имена при переименовании. Скрипт будет выполнен без ошибок, но второе поле не будет переименовано.

Rename table

Эта функция скрипта переименовывает одну или несколько существующих внутренних таблиц в программе QlikView (и Qlik Sense) после их загрузки.

Можно использовать оба варианта синтаксиса: rename table или rename tables.

Аргументы:

Аргумент	Описание
mapname	Имя ранее загруженной таблицы сопоставления, в которой содержится одна или несколько пар старых и новых имен таблиц.
oldname	Старое имя таблицы.
newname	Новое имя таблицы.

Ограничения:

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

Search

Оператор Search используется для включения или исключения полей из функции поиска.

Можно использовать несколько операторов Search, чтобы обновить выборку полей, которые необходимо включить. Операторы оцениваются сверху вниз.

Аргументы:

Аргумент	Описание
*fieldlist	Список полей, разделенных запятыми, которые необходимо включить или исключить из поиска. Символ * в качестве списка полей обозначает все поля. В именах полей разрешается использовать знаки подстановки * и ?. При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки.

Комбинированным результатом этих трех операторов в такой последовательности будет исключение из поиска всех полей, оканчивающихся элементом ID, за исключением ProductID.

Section

Оператор section позволяет определить, следует ли рассматривать последующие операторы LOAD и SELECT в качестве данных или определения прав доступа.

Если ничего не указано, используется section application. Определение section действительно до тех пор, пока не будет создан новый оператор section.

Select

Выбор полей из источника данных ODBC или поставщика OLE DB осуществляется с помощью стандартных операторов SQL SELECT. Однако то, принимаются операторы SELECT или нет, зависит в основном от используемого драйвера ODBC или поставщика OLE DB.

Более того, несколько операторов SELECT иногда могут соединяться в один посредством использования оператора union:

selectstatement Union selectstatement

Оператор SELECT интерпретируется драйвером ODBC или поставщиком OLE DB, поэтому могут возникать отклонения от общего синтаксиса SQL в зависимости от возможностей драйверов ODBC или поставщика OLE DB, например:

• as иногда недопустим, то есть aliasname должен сразу следовать за fieldname.
• as иногда является обязательным при использовании aliasname.
• distinct, as,where, group by, order by или union иногда не поддерживаются.
• Драйвер ODBC иногда допускает не все различные кавычки, перечисленные выше.

Аргументы:

Аргумент	Описание
distinct	distinct — это логическое условие, используемое в случае, если копии комбинаций значений в выбранных полях должны быть загружены только один раз.
distinctrow	distinctrow — это логическое условие, используемое в случае, если копии записей в таблице источника должны быть загружены только один раз.
fieldlist	fieldlist ::= (*| field ) {, field } Список полей, которые необходимо выбрать. Символ «*» в качестве списка полей обозначает все поля таблицы. fieldlist ::= field {, field } Список одного или нескольких полей, разделенных запятыми. field ::= ( fieldref | expression ) [as aliasname ] Выражение может, к примеру, быть числовой или строковой функцией, основанной на одном или нескольких других полях. Некоторые из обычно принимаемых операторов и функций: +, -, *, /, & (объединение строк),sum(fieldname), count(fieldname), avg(fieldname)(average), month(fieldname) и т. д. Дополнительную информацию см. в документации к драйверу ODBC. fieldref ::= [ tablename. ] fieldname tablename и fieldname являются текстовыми строками, идентичными тому, что они подразумевают. Они должны быть заключены в прямые двойные кавычки, если они содержат, например, пробелы. Предложение as используется для назначения полю нового имени.
from	tablelist ::= table {, table } Список таблиц, из которых выбираются поля. table ::= tablename [ [as ] aliasname ] Элемент tablename может быть в кавычках, а может и не быть.
where	where — предложение, которое используется для указания того, нужно ли включить запись в выборку или нет. criterion является логическим выражением, которое иногда может быть очень сложным. Некоторые из принимаемых операторов: числовые операторы и функции, =,?<> или #(не равно), >,?>=,?<,?<=,?and, or,not, exists,some, all,in, а также новые операторы SELECT. Дополнительную информацию можно получить в документации драйвера ODBC или поставщика OLE DB.
group by	group by — выражение, используемое для агрегирования (группировки) нескольких записей в одну. Внутри одной группы для определенного поля все записи должны иметь одинаковое значение или поле может использоваться только изнутри выражения, например, в виде суммы или среднего значения. Выражение, основанное на одном или нескольких полях, определяется в выражении символа поля.
having	having — это предложение, используемое для классификации групп подобно тому, как предложение where используется для классификации записей.
order by	order by — предложение, используемое для указания порядка сортировки результирующей таблицы оператора SELECT.
join	join — это префикс, который указывает, необходимо ли объединить несколько таблиц в одну. Имена полей и имена таблиц должны заключаться в кавычки, если в них содержатся пробелы или буквы из национальных наборов символов. Когда программа QlikView (и Qlik Sense) автоматически создаст скрипт, драйвер ODBC или поставщик OLE DB, указанный в определении источника данных в операторе Connect, определит используемые кавычки.

Set

Оператор set используется для определения переменных скрипта. Эти переменные можно использовать для подстановки строк, путей, драйверов и т. д.

Sleep

Оператор sleep приостанавливает выполнение скрипта на указанное время.

Аргументы:

Аргумент	Описание
n	Задается в миллисекундах, где n — положительное целое число, не превышающее 3600000 (то есть 1 час). В качестве значения может выступать выражение.

SQL

Оператор SQL позволяет отправлять произвольную команду SQL посредством подключения ODBC или OLE DB.

При отправке операторов SQL, которые обновляют базу данных, будет возвращаться ошибка, если программа QlikView (и Qlik Sense) открыла подключение ODBC в режиме «только чтение».

допускается и будет предпочтительным синтаксисом для SELECT с целью обеспечения согласованности. Тем не менее префикс SQL для операторов SELECT будет необязательным.

Аргументы:

Аргумент	Описание
sql_command	Допустимая команда SQL.

SQLColumns

Оператор sqlcolumns возвращает набор полей с описанием столбцов источника данных ODBC или OLE DB, с которыми выполнена операция connect.

Эти поля можно объединить с полями, созданными командами sqltables и sqltypes, что позволит получить представление об определенной базе данных. Ниже перечислены 12 стандартных полей:

Подробное описание этих полей см. в справочном руководстве по ODBC.

SQLTables

Оператор sqltables возвращает набор полей с описанием таблиц источника данных ODBC или OLE DB, с которыми выполнена операция connect.

Эти поля можно объединить с полями, созданными командами sqlcolumns и sqltypes, что позволит получить представление об определенной базе данных. Ниже перечислены пять стандартных полей:

Подробное описание этих полей см. в справочном руководстве по ODBC.

SQLTypes

Оператор sqltypes возвращает набор полей с описанием типов источника данных ODBC или OLE DB, с которыми выполнена операция connect.

Эти поля можно объединить с полями, созданными командами sqlcolumns и sqltables, что позволит получить представление об определенной базе данных. Ниже перечислены 15 стандартных полей:

Подробное описание этих полей см. в справочном руководстве по ODBC.

Star

Строку, которая представляет набор всех значений поля в базе данных, можно определить с помощью оператора star. Она влияет на последующие операторы LOAD и SELECT.

Аргументы:

Аргумент	Описание
string	Произвольный текст. Обратите внимание, что при наличии в строке пробелов она должна быть заключена в кавычки. Если значение не указано, то по умолчанию используется star is;; то есть символ звездочки отсутствует, если он не будет указан явным образом. Это действительно до тех пор, пока не будет создан новый оператор star.

Применяется следующее:

• Знак Star  — *.
• Пользователю USER1 не удается просмотреть поле SALES.
• Пользователю USER2 не удается просмотреть поле WAREHOUSE .
• Пользователю USER3 не удается просмотреть поле EMPLOYEES.
• Пользователь USER4 добавлен дважды к решению OMIT к двум полям для данного пользователя, SALES и WAREHOUSE.
• Для пользователя USER5 добавлен знак “*”, значит все поля в списке OMIT недоступны. Знак * "звезда" означает все перечисленные значения, а не все значения поля.
• Пользователю USER5 не удается просмотреть поля SALES, WAREHOUSE и EMPLOYEES ,но пользователю доступно поле ORDERS.

Store

Эта функция скрипта создает файл QVD или CSV.

Оператор создаст файл QVD или CSV с заданным именем. Оператор может экспортировать поля только из одной таблицы данных. Если требуется экспортировать поля из нескольких таблиц, необходимо заранее сформировать явное объединение join в скрипте для создания таблицы данных, которую следует экспортировать.

Текстовые значения экспортируются в файл CSV в формате UTF-8. Можно указать разделитель. См. LOAD. Оператор store для файла CSV не поддерживает экспорт BIFF.

Аргументы:

Аргумент	Описание
*fieldlist::= ( * | field ) { , field } )	Список полей, которые необходимо выбрать. Символ «*» в качестве списка полей обозначает все поля. field::= fieldname [asaliasname ] fieldname — это текст, идентичный имени поля в элементе table. (Обратите внимание, что для указания имени поля необходимо заключить его в прямые двойные кавычки или квадратные скобки, если имя содержит пробелы или другие нестандартные символы.) aliasname — альтернативное имя поля, которое предназначено для использования в результирующем файле QVD или CSV.
table	Метка скрипта, представляющая уже загруженную таблицу, которую планируется использовать в качестве источника данных.
filename	Имя целевого файла, включающее допустимый путь. абсолютный Пример: c:\data\sales.qvd относительно пути документа QlikView (и Qlik Sense). Пример: data\sales.qvd Если путь отсутствует, программа QlikView (и Qlik Sense) сохраняет файл в каталоге, указанном оператором Directory. Если оператор Directory отсутствует, программа QlikView (и Qlik Sense) сохраняет файл в рабочем каталоге.
format-spec ::=( ( txt | qvd ) )	C целью указания формата используется текст txt для обозначения текстовых файлов или текст qvd — для файлов QVD. Если формат не указан, то используется qvd.

Tag

Эта функция скрипта предоставляет возможность присваивать теги одному или нескольким полям. Если делается попытка присвоить тег имени поля, отсутствующему в документе, то эта операция будет проигнорирована. Если обнаружены конфликты между именами полей или тегов, то используется последнее значение.

Аргументы:

Аргумент	Описание
fieldlist	Разделенный запятыми список полей, которые следует разметить, начиная с этой точки выполнения скрипта.
mapname	Имя таблицы сопоставления, считанной ранее в операторе mapping Load или mapping Select.
fieldname	Имя поля, для которого необходимо добавить тег.
tagname	Имя тега, применяемого к полю.

Trace

Оператор trace записывает строку в окно Ход выполнения скрипта и в файл журнала скрипта, если тот используется. Он очень полезен для отладки. Расширение $, добавляемое к переменным, вычисляемым до оператора trace, позволяет настроить сообщение.

Unmap

Оператор Unmap деактивирует значение поля mapping, заданное предыдущим оператором Map … Using для последующих загружаемых полей.

Аргументы:

Аргумент	Описание
*fieldlist	разделенный запятыми список полей, которые не нужно больше сопоставлять, начиная с этой точки выполнения скрипта. Символ * в качестве списка полей обозначает все поля. В именах полей разрешается использовать знаки подстановки * и ?. При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки.

Unqualify

Оператор Unqualify используется для снятия уточнения имен полей, которое ранее было включено оператором Qualify.

Аргументы:

Аргумент	Описание
*fieldlist	Список полей, разделенных запятыми, для которых следует включить уточнение. Символ * в качестве списка полей обозначает все поля. В именах полей разрешается использовать знаки подстановки * и ?. При использовании знаков подстановки, возможно, понадобится заключать имена полей в кавычки. Дополнительные сведения см. в документации по оператору Qualify.

Untag

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

Аргументы:

Аргумент	Описание
fieldlist	Список полей, разделенных запятыми, теги которых следует удалить.
mapname	Имя таблицы сопоставления, загруженной ранее в оператор сопоставления LOAD или SELECT.
fieldname	Имя поля, с которого необходимо снять тег.
tagname	Имя тега, который следует снять с поля.

Переменные скрипта

Переменная в QlikView (и Qlik Sense) является контейнером, содержащим статическое значение или вычисление, например числовое или буквенно-числовое значение. При использовании этой переменной в документе любое изменение, выполненное в переменной, применяется везде, где эта переменная используется. Переменные определяются в скрипте с помощью редактора скриптов, переменная получает свое значение от операторов управления Let, Set или других операторов управления в скрипте загрузки.

Если первый символ в значении переменной — это знак равенства «=», то программа QlikView (и Qlik Sense) рассчитывает значение по формуле (выражение QlikView (и Qlik Sense)) и выводит или возвращает результат, а не визуальное написание формулы.

При использовании вместо переменной подставляется его значение. Переменные можно использовать в скрипте для расширения со знаком доллара и в различных операторах управления. Это очень удобно, если одна и та же строка повторяется в скрипте множество раз, например путь.

В начале выполнения скрипта программа QlikView (и Qlik Sense) устанавливает некоторые особые системные переменные независимо от их предыдущих значений.

Ниже представлен синтаксис для определения переменной:

используется. Команда Set присваивает текст справа от знака равенства переменной, в то время как команда Let вычисляет выражение.

В переменных учитывается регистр.

Вычисление переменной

Существует несколько способов использования переменных с вычисляемыми значениями в программе QlikView (и Qlik Sense). Результат зависит от того, как это будет определено и названо в выражении.

В этом примере загружаются некоторые встроенные данные:

Давайте определим две переменные.

Во второй переменной мы добавляем знак равенства перед выражением. В результате переменная будет вычислена до того, как она будет расширена, а выражение оценено.

При использовании неизмененной переменной vSales, например, в мере, результатом будет строка Sum(Sales), то есть вычисления не будут выполнены.

В случае добавления расширения со знаком доллара и вызова элемента $(vSales) в выражении переменная будет расширена, а сумма Sales отобразится.

Наконец, если будет вызван элемент $(vSales2), вычисление переменной будет выполнено до ее расширения. Это означает, что отображаемый результат — это итоговая сумма элементов Sales. Разницу использования элементов =$(vSales) и =$(vSales2) в качестве выражений мер можно увидеть в этой диаграмме с отображением результатов:

Dim	$(vSales)	$(vSales2)
A	350	1560
B	470	1560
C	740	1560

Как можно увидеть, элемент $(vSales) показывает частичную сумму для значения измерения, а элемент $(vSales2) показывает итоговую сумму.

Переменные ошибок

Значения всех переменных ошибок остаются после выполнения скрипта. Первая переменная, ErrorMode, — это входные данные от пользователя, а последние три — выходные данные от программы QlikView (и Qlik Sense) с информацией об ошибках в скрипте.

Пользуйтесь информацией из раскрывающегося списка по каждой функции, чтобы увидеть краткое описание и синтаксис каждой функции. Дополнительную информацию можно получить, если щелкнуть имя функции в описании синтаксиса.

ErrorMode	Эта переменная ошибки определяет действие, которое должно быть предпринято в программе QlikView (и Qlik Sense) при обнаружении ошибки в ходе выполнения скрипта. ErrorMode
ScriptError	Эта переменная ошибки возвращает код ошибки для последнего выполненного оператора скрипта. ScriptError
ScriptErrorCount	Эта переменная ошибки возвращает общее число операторов, которые привели к возникновению ошибки в ходе выполнения текущего скрипта. В начале выполнения скрипта для этой переменной всегда восстанавливается значение 0. ScriptErrorCount
ScriptErrorList	Эта переменная ошибки будет содержать объединенный список всех ошибок в скрипте, возникших в ходе выполнения последнего скрипта. Каждая ошибка отделяется символом перевода строки. ScriptErrorList

ErrorMode

Эта переменная ошибки определяет действие, которое должно быть предпринято в программе QlikView (и Qlik Sense) при обнаружении ошибки в ходе выполнения скрипта.

Аргументы:

Аргумент	Описание
ErrorMode=1	Настройка по умолчанию. Выполнение скрипта останавливается, и пользователь получает запрос на выполнение действия (в непакетном режиме).
ErrorMode =0	Программа QlikView (и Qlik Sense) просто проигнорирует ошибку и продолжит выполнение скрипта со следующего оператора скрипта.
ErrorMode =2	Программа QlikView (и Qlik Sense) отобразит сообщение об ошибке «Сбой выполнения скрипта…» при возникновении ошибки без предварительного запроса о действии пользователя.

ScriptError

Эта переменная ошибки возвращает код ошибки для последнего выполненного оператора скрипта.

Эта переменная сбрасывается на 0 после каждого успешно выполненного оператора скрипта. При возникновении ошибки переменной присваивается внутренний код ошибки QlikView (и Qlik Sense). Коды ошибок являются двойными значениями, включающими текстовый и числовой компонент. Существуют следующие коды ошибок:

Код ошибки	Описание
0	Нет ошибки
1	Общая ошибка
2	Ошибка синтаксиса
3	Общая ошибка ODBC
4	Общая ошибка OLE DB
5	Общая ошибка настраиваемой базы данных
6	Общая ошибка XML
7	Общая ошибка HTML
8	Файл не найден
9	База данных не найдена
10	Таблица не найдена
11	Поле не найдено
12	Неверный формат файла
13	Ошибка BIFF
14	Зашифрованная ошибка BIFF
15	Ошибка BIFF неподдерживаемой версии
16	Семантическая ошибка

ScriptErrorCount

Эта переменная ошибки возвращает общее число операторов, которые привели к возникновению ошибки в ходе выполнения текущего скрипта. В начале выполнения скрипта для этой переменной всегда восстанавливается значение 0.

ScriptErrorList

Эта переменная ошибки будет содержать объединенный список всех ошибок в скрипте, возникших в ходе выполнения последнего скрипта. Каждая ошибка отделяется символом перевода строки.

Переменные интерпретации числа

Переменные интерпретации числа определяет система, то есть они создаются автоматически при создании нового документа в соответствии с текущими региональными настройками операционной системы. В QlikView (и Qlik Sense) Desktop это выполняется согласно настройкам операционной системы компьютера, а в QlikView (и Qlik Sense) это выполняется согласно операционной системе сервера, на котором установлена программа QlikView (и Qlik Sense).

Переменные указываются в верхней части скрипта нового документа QlikView (и Qlik Sense) и заменяют стандартные настройки операционной системы для определенных параметров формата чисел во время выполнения скрипта. Эти переменные можно свободно удалять, редактировать или копировать.

Пользуйтесь информацией из раскрывающегося списка по каждой функции, чтобы увидеть краткое описание и синтаксис каждой функции. Дополнительную информацию можно получить, если щелкнуть имя функции в описании синтаксиса.

Форматирование валюты

MoneyDecimalSep	Указанный десятичный разделитель заменяет символ десятичного знака для валюты, используемый в операционной системе (региональные настройки). MoneyDecimalSep
MoneyFormat	Указанный символ заменяет символ валюты, используемый в операционной системе (региональные настройки). MoneyFormat
MoneyThousandSep	Указанный разделитель тысяч заменяет группирующий символ знаков для валюты, используемый в операционной системе (региональные настройки). MoneyThousandSep

Форматирование чисел

DecimalSep	Заданный десятичный разделитель заменяет символ десятичного знака, используемый в операционной системе (региональные настройки). DecimalSep
ThousandSep	Указанный разделитель тысяч заменяет группирующий символ знаков, используемый в операционной системе (региональные настройки). ThousandSep

Форматирование времени

DateFormat	Указанный формат заменяет формат даты, используемый в операционной системе (региональные настройки). DateFormat
TimeFormat	Указанный формат заменяет формат времени, используемый в операционной системе (региональные настройки). TimeFormat
TimestampFormat	Указанный формат заменяет форматы даты и времени, используемые в операционной системе (региональные настройки). TimestampFormat
MonthNames	Указанный формат заменяет обозначение имен месяцев, используемое в операционной системе (региональные настройки). MonthNames
LongMonthNames	Указанный формат заменяет обозначение полных имен месяцев, используемое в операционной системе (региональные настройки). LongMonthNames
DayNames	Указанный формат заменяет имена дней недели, используемые в операционной системе (региональные настройки). DayNames
LongDayNames	Указанный формат заменяет обозначение полных имен дней недели, используемое в операционной системе (региональные настройки). LongDayNames
FirstWeekDay	Целое число определяет, какой день использовать в качестве первого дня недели. FirstWeekDay
BrokenWeeks	этот параметр определяет, какими должны быть недели: целыми или разбитыми. BrokenWeeks
ReferenceDay	Этот параметр определяет, какой день в январе должен быть задан в качестве дня ссылки, чтобы определить неделю 1. По умолчанию в функциях QlikView (и Qlik Sense) используется 4 как день ссылки. Это значит, что неделя 1 должна содержать значение «январь 4» , или, другими словами, в неделе 1 всегда должно быть не меньше 4 дней в январе. Используйте следующие значения, чтобы задать день ссылки: 1 (= январь 1) 2 (= январь 2) 3 (= январь 3) 4 (= январь 4) 5 (= январь 5) 6 (= январь 6) 7 (= январь 7) ReferenceDay
FirstMonthOfYear	С помощью этой настройки определяется месяц, который будет использован в качестве первого месяца года. Его можно использовать для определения финансовых годов, в которых используется смещение по месяцам, например, начало будет 1 апреля. FirstMonthOfYear

BrokenWeeks

этот параметр определяет, какими должны быть недели: целыми или разбитыми.

По умолчанию в функциях QlikView (и Qlik Sense) используются целые недели. Это означает следующее:

• В одних годах 1-я неделя начинается в декабре, а в других годах 52-я или 53-я неделя заканчивается в январе.
• В 1-ой неделе всегда не менее четырех дней в январе.

В качестве альтернативы можно использовать разбиение недель.

• 52-я или 53-я неделя не будет продолжена в январе следующего года.
• 1-я неделя будет начинаться 1 января и в большинстве случаев она будет неполной.

Могут использоваться следующие значения:

• 0 (= использовать целые недели)
• 1 (= использовать разбитые недели)

DateFormat

Указанный формат заменяет формат даты, используемый в операционной системе (региональные настройки).

DayNames

Указанный формат заменяет имена дней недели, используемые в операционной системе (региональные настройки).

DecimalSep

Заданный десятичный разделитель заменяет символ десятичного знака, используемый в операционной системе (региональные настройки).

FirstWeekDay

Целое число определяет, какой день использовать в качестве первого дня недели.

В функциях QlikView (и Qlik Sense) понедельник является первым днем недели по умолчанию. Могут использоваться следующие значения:

• 0 (= понедельник)
• 1 (= вторник)
• 2 (= среда)
• 3 (= четверг)
• 4 (= пятница)
• 5 (= суббота)
• 6 (= воскресенье)

LongDayNames

Указанный формат заменяет обозначение полных имен дней недели, используемое в операционной системе (региональные настройки).

LongMonthNames

Указанный формат заменяет обозначение полных имен месяцев, используемое в операционной системе (региональные настройки).

MoneyDecimalSep

Указанный десятичный разделитель заменяет символ десятичного знака для валюты, используемый в операционной системе (региональные настройки).

MoneyFormat

Указанный символ заменяет символ валюты, используемый в операционной системе (региональные настройки).

MoneyThousandSep

Указанный разделитель тысяч заменяет группирующий символ знаков для валюты, используемый в операционной системе (региональные настройки).

MonthNames

Указанный формат заменяет обозначение имен месяцев, используемое в операционной системе (региональные настройки).

ReferenceDay

Этот параметр определяет, какой день в январе должен быть задан в качестве дня ссылки, чтобы определить неделю 1. По умолчанию в функциях QlikView (и Qlik Sense) используется 4 как день ссылки. Это значит, что неделя 1 должна содержать значение «январь 4» , или, другими словами, в неделе 1 всегда должно быть не меньше 4 дней в январе.

Используйте следующие значения, чтобы задать день ссылки:

• 1 (= январь 1)
• 2 (= январь 2)
• 3 (= январь 3)
• 4 (= январь 4)
• 5 (= январь 5)
• 6 (= январь 6)
• 7 (= январь 7)

По умолчанию в функциях QlikView (и Qlik Sense) используется 4 как день ссылки. Это значит, что неделя 1 должна содержать значение «январь 4» , или, другими словами, в неделе 1 всегда должно быть не меньше 4 дней в январе.

Используйте следующие значения, чтобы задать день ссылки:

• 1 (= январь 1)
• 2 (= январь 2)
• 3 (= январь 3)
• 4 (= январь 4)
• 5 (= январь 5)
• 6 (= январь 6)
• 7 (= январь 7)

FirstMonthOfYear

С помощью этой настройки определяется месяц, который будет использован в качестве первого месяца года. Его можно использовать для определения финансовых годов, в которых используется смещение по месяцам, например, начало будет 1 апреля.

Допустимые настройки: от 1 (январь) до 12 (декабрь). Параметр по умолчанию — 1.

ThousandSep

Указанный разделитель тысяч заменяет группирующий символ знаков, используемый в операционной системе (региональные настройки).

TimeFormat

Указанный формат заменяет формат времени, используемый в операционной системе (региональные настройки).

TimestampFormat

Указанный формат заменяет форматы даты и времени, используемые в операционной системе (региональные настройки).

Системные переменные

Системные переменные, некоторые из которых определяются системой, предоставляют информацию о системе и документе QlikView (и Qlik Sense).

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

Floppy	Возвращает буквенное обозначение первого найденного дисковода гибких дисков, обычно a:. Эта переменная определяется системой. Floppy
CD	Возвращает буквенное обозначение первого найденного дисковода CD-ROM. Если дисковод CD-ROM не найден, возвращается c:. Эта переменная определяется системой. CD
Include	Переменная Include/Must_Include указывает файл, содержащий текст, который необходимо включить в скрипт и который рассматривается в качестве кода скрипта. Можно сохранить часть кода скрипта в отдельный текстовый файл и использовать его в разных документах. Эта переменная определяется пользователем. $(Include=filename) $(Must_Include=filename)
HidePrefix	Все имена полей, начинающиеся этой строкой текста, будут скрыты так же, как и системные поля. Эта переменная определяется пользователем. HidePrefix
HideSuffix	Все имена полей, которые заканчиваются этой строкой текста, будут скрыты так же, как и системные поля. Эта переменная определяется пользователем. HideSuffix
QvPath	Возвращает строку обзора в выполняемый модуль QlikView (и Qlik Sense). Эта переменная определяется системой. QvPath
QvRoot	Возвращает корневой каталог выполняемого модуля QlikView (и Qlik Sense). Эта переменная определяется системой. QvRoot
QvWorkPath	Возвращает строку обзора в текущий документ QlikView (и Qlik Sense). Эта переменная определяется системой. QvWorkPath
QvWorkRoot	Возвращает корневой каталог текущего документа QlikView (и Qlik Sense). Эта переменная определяется системой. QvWorkRoot
StripComments	Если для этой переменной установлено значение 0, исключение комментариев /*..*/ и // в скрипте будет блокироваться. Если эта переменная не определена, всегда выполняется исключение комментариев. StripComments
Verbatim	Обычно предшествующие и завершающие символы пробела (ASCII 32) автоматически исключаются из всех значений поля до их загрузки в базу данных QlikView (и Qlik Sense). Установка для этой переменной значения 1 приостанавливает исключение символов пробела. Символ табуляции (ASCII 9) и твердый пробел (ANSI 160) никогда не исключаются. Verbatim
OpenUrlTimeout	Эта переменная определяет время ожидания в секундах, которое программа QlikView (и Qlik Sense) использует при получении данных из источников URL (например, HTML-страниц). При отсутствии данной переменной время ожидания составляет 20 минут. OpenUrlTimeout
WinPath	Возвращает строку обзора в Windows. Эта переменная определяется системой. WinPath
WinRoot	Возвращает корневой каталог Windows. Эта переменная определяется системой. WinRoot
CollationLocale	Указывает, какую локаль использовать для порядка сортировки и сопоставления поиска. Значением является имя культуры локали, например, «en-US».Эта переменная определяется системой. CollationLocale

HidePrefix

Все имена полей, начинающиеся этой строкой текста, будут скрыты так же, как и системные поля. Эта переменная определяется пользователем.

При использовании этого оператора имена полей, начинающиеся с нижнего подчеркивания, не отображаются в списках имен полей, если скрыты системные поля.

HideSuffix

Все имена полей, которые заканчиваются этой строкой текста, будут скрыты так же, как и системные поля. Эта переменная определяется пользователем.

При использовании этого оператора имена полей, заканчивающиеся знаком %, не отображаются в списках имен полей, если скрыты системные поля.

Include

Переменная Include/Must_Include указывает файл, содержащий текст, который необходимо включить в скрипт и который рассматривается в качестве кода скрипта. Можно сохранить часть кода скрипта в отдельный текстовый файл и использовать его в разных документах. Эта переменная определяется пользователем.

Существует две версии переменной.

• Переменная Include не создает ошибку, если не удалось найти файл, и сообщение об ошибке не отображается.
• Переменная Must_Include создает ошибку, если не удалось найти файл.

Если не указать путь, имя файла будет отнесено к рабочему каталогу документа QlikView (и Qlik Sense). Также можно указать абсолютный путь к файлу.

OpenUrlTimeout

Эта переменная определяет время ожидания в секундах, которое программа QlikView (и Qlik Sense) использует при получении данных из источников URL (например, HTML-страниц). При отсутствии данной переменной время ожидания составляет 20 минут.

StripComments

Если для этой переменной установлено значение 0, исключение комментариев /*..*/ и // в скрипте будет блокироваться. Если эта переменная не определена, всегда выполняется исключение комментариев.

В определенных драйверах базы данных используются /*..*/ в качестве подсказок по оптимизации в операторах SELECT. В таком случае комментарии не должны исключаться перед отправкой оператора SELECT в драйвер базы данных.

Verbatim

Обычно предшествующие и завершающие символы пробела (ASCII 32) автоматически исключаются из всех значений поля до их загрузки в базу данных QlikView (и Qlik Sense). Установка для этой переменной значения 1 приостанавливает исключение символов пробела. Символ табуляции (ASCII 9) и твердый пробел (ANSI 160) никогда не исключаются.

Значение, Обрабатывающее Переменные

В этом разделе описаны переменные, которые используются для обработки значений NULL и других значений.

Пользуйтесь информацией из раскрывающегося списка по каждой функции, чтобы увидеть краткое описание и синтаксис каждой функции. Дополнительную информацию можно получить, если щелкнуть имя функции в описании синтаксиса.

NullDisplay	Указанным символом заменяются все значения NULL из источника данных ODBC соединители на самом нижнем уровне данных. Эта переменная определяется пользователем. NullDisplay
NullInterpret	При нахождении указанного символа в текстовом файле, файле Excel или во встроенном операторе он интерпретируется как значение NULL. Эта переменная определяется пользователем. NullInterpret
NullValue	Если используется оператор NullAsValue, определенный символ будет заменять все значения NULL в указанных полях NullAsValue указанной строкой. NullValue
OtherSymbol	Определяет символ, который будет обрабатываться как все другие значения перед оператором LOAD/SELECT. Эта переменная определяется пользователем. OtherSymbol

NullDisplay

Указанным символом заменяются все значения NULL из источника данных ODBC соединители на самом нижнем уровне данных. Эта переменная определяется пользователем.

NullInterpret

При нахождении указанного символа в текстовом файле, файле Excel или во встроенном операторе он интерпретируется как значение NULL. Эта переменная определяется пользователем.

NullValue

Если используется оператор NullAsValue, определенный символ будет заменять все значения NULL в указанных полях NullAsValue указанной строкой.

OtherSymbol

Определяет символ, который будет обрабатываться как все другие значения перед оператором LOAD/SELECT. Эта переменная определяется пользователем.

Переменные Direct Discovery

Системные переменные Direct Discovery

DirectCacheSeconds	Можно установить предел кэширования для результатов выполнения запросов Direct Discovery для диаграмм. При достижении этого предела времени QlikView (и Qlik Sense) очищает кэш, когда создаются новые запросы Direct Discovery. QlikView (и Qlik Sense) запрашивает исходные данные для выборок и создает кэш снова для указанного временного предела. Кэширование результатов для каждой комбинации выборок выполняется независимо друг от друга. Иначе говоря, кэш обновляется для каждой выборки отдельно таким образом, что одна выборка обновляет кэш только для выбранных полей, а вторая выборка обновляет кэш для соответствующих полей. Если вторая выборка включает в себя поля, обновленные в первой выборке, они не обновляются в кэше повторно, если не достигнут предел кэширования. Кэш Direct Discovery не применяется к диаграммам Таблица. Выборки таблицы каждый раз запрашивают источник данных. Предельное значение должно быть указано в секундах. Предел кэша по умолчанию составляет 1800 секунд (30 минут). Значение, используемое для DirectCacheSeconds, представляет собой значение, которое устанавливается во время выполнения оператора DIRECT QUERY. Это значение невозможно изменить во время выполнения. Пример: SET DirectCacheSeconds=1800
DirectConnectionMax	Можно выполнять асинхронные параллельные вызовы базы данных с помощью функции объединения подключений. Синтаксис загрузки скрипта для настройки функции объединения: SET DirectConnectionMax=10 Числовой параметр указывает максимальное количество подключений к базе данных, которые можно использовать коду Direct Discovery при обновлении листа. По умолчанию параметр имеет значение 1. Эту переменную следует использовать с осторожностью. Значение параметра больше 1 может привести к возникновению проблем при подключении к Microsoft SQL Server.
DirectUnicodeStrings	Direct Discovery поддерживает выбор расширенных данных Юникода путем использования стандартного формата SQL для строковых литералов расширенных символов (N’<расширенная строка>’), как это требуют некоторые базы данных (в частности SQL Server). Этот синтаксис можно включить для Direct Discovery с помощью переменной скрипта DirectUnicodeStrings. Если установить для этой переменной значение «true», то перед строковыми литералами будет использоваться “N” — строковый маркер ANSI стандартной ширины. Не все базы данных поддерживают этот стандарт. По умолчанию параметр имеет значение «false».
DirectDistinctSupport	Когда значение поля DIMENSION выбрано в объекте QlikView (и Qlik Sense), для исходной базы данных создается запрос. Если для запроса требуется группировка, Direct Discovery использует ключевое слово DISTINCT для выбора только уникальных значений. Однако для некоторых баз данных необходимо ключевое слово GROUP BY. Установите для параметра DirectDistinctSupport значение 'false', чтобы создавать запросы GROUP BY вместо DISTINCT для получения уникальных значений. SET DirectDistinctSupport='false' Если для параметра DirectDistinctSupport установлено значение «true», будет использоваться DISTINCT. Если значение не установлено, по умолчанию используется DISTINCT.
DirectEnableSubquery	В многотабличных сценариях с большим количеством элементов можно создавать запросы, вложенные в запрос SQL, вместо создания длинного предложения IN. Для этого активируйте параметр DirectEnableSubquery, выбрав значение 'true'. По умолчанию установлено значение 'false'. Если параметр DirectEnableSubquery включен, невозможно загружать таблицы, которые не в режиме Direct Discovery. SET DirectEnableSubquery='true'

Переменные чередования запросов Teradata

Чередование запросов Teradata — это функция, которая позволяет корпоративным приложениям работать совместно с основной базой данных Teradata для повышения эффективности учета, определения приоритетов и управления рабочей нагрузкой. Чередование запросов позволяет переносить метаданные, такие как учетные данные пользователя, в запросе.

Доступны две переменные, которые являются строками. Они оцениваются и отправляются в базу данных.

SQLSessionPrefix	Эта строка отправляется, когда создается подключение к базе данных. SET SQLSessionPrefix = 'SET QUERY_BAND = ' & Chr(39) & 'Who=' & OSuser() & ';' & Chr(39) & ' FOR SESSION;'; Например, если OSuser() возвращает WA\sbt, это будет оценено как SET QUERY_BAND = 'Who=WA\sbt;' FOR SESSION;, что и будет отправлено в базу данных при создании подключения.
SQLQueryPrefix	Эта строка отправляется для каждого одиночного запроса. SET SQLSessionPrefix = 'SET QUERY_BAND = ' & Chr(39) & 'Who=' & OSuser() & ';' & Chr(39) & ' FOR TRANSACTION;';

Символьные переменные Direct Discovery

DirectFieldColumnDelimiter	Можно задать символ, используемый в качестве разделителя полей в операторах Direct Query для баз данных, где в качестве разделителя требуется символ, отличный от запятой. В операторе SETуказанный символ должен быть заключен в одинарные кавычки. SET DirectFieldColumnDelimiter= '|'
DirectStringQuoteChar	Можно задать символ, чтобы заключать строки в кавычки в созданном запросе. По умолчанию это одинарные кавычки. В операторе SETуказанный символ должен быть заключен в одинарные кавычки. SET DirectStringQuoteChar= '"'
DirectIdentifierQuoteStyle	Можно указать, что в созданных запросах можно использовать кавычки не в кодировке ANSI для идентификаторов. В настоящее время доступные кавычки не в кодировке ANSI — только GoogleBQ. По умолчанию используется элемент ANSI. Можно использовать символы в верхнем регистре, в нижнем регистре и в разных регистрах (ANSI, ansi, Ansi). SET DirectIdentifierQuoteStyle="GoogleBQ" Например, кавычки ANSI используются в следующем операторе SELECT: SELECT [Quarter] FROM [qvTest].[sales] GROUP BY [Quarter] Если для параметра DirectIdentifierQuoteStyle установлено значение "GoogleBQ", оператор SELECT будет использовать следующие кавычки: SELECT [Quarter] FROM [qvTest.sales] GROUP BY [Quarter]
DirectIdentifierQuoteChar	Можно задать символ, чтобы управлять заключением идентификаторов в кавычки в созданном запросе. Можно задать как один символ (двойные кавычки), так и два символа (квадратные скобки). По умолчанию это двойные кавычки. SET DirectIdentifierQuoteChar='YYYY-MM-DD'
DirectTableBoxListThreshold	Когда поля Direct Discovery используются в диаграмме Таблица, устанавливается пороговое значение, чтобы ограничить количество отображаемых строк. Пороговое значение по умолчанию равно 1000 записям. Пороговое значение по умолчанию можно изменить, настроив переменную DirectTableBoxListThreshold в скрипте загрузки. Например: SET DirectTableBoxListThreshold=5000 Параметр порогового значения применим только к диаграммам Таблица, содержащим поля Direct Discovery. Диаграммы Таблица, содержащие только поля в памяти, не ограничены параметром DirectTableBoxListThreshold. В диаграмме Таблица не будут отображаться поля, пока количество записей в выборке не будет меньше порогового значения.

Переменные интерпретации числа Direct Discovery

DirectMoneyDecimalSep	Заданный разделитель десятичной части заменяет символ десятичного разделителя для валюты в операторе SQL, созданном для загрузки данных с помощью Direct Discovery. Этот символ должен совпадать с символом, используемом в DirectMoneyFormat. По умолчанию используется значение '.' Пример: Set DirectMoneyDecimalSep='.';
DirectMoneyFormat	Заданный разделитель заменяет формат валюты в операторе SQL, созданном для загрузки данных с помощью Direct Discovery. Символ валюты для разделителя тысяч не включается. По умолчанию используется значение '#.0000' Пример: Set DirectMoneyFormat='#.0000';
DirectTimeFormat	Заданный формат времени заменяет формат времени в операторе SQL, созданном для загрузки данных с помощью Direct Discovery. Пример: Set DirectTimeFormat='hh:mm:ss';
DirectDateFormat	Заданный формат даты заменяет формат даты в операторе SQL, созданном для загрузки данных с помощью Direct Discovery. Пример: Set DirectDateFormat='MM/DD/YYYY';
DirectTimeStampFormat	Заданный формат заменяет формат даты и времени в операторе SQL, созданном в операторе SQL для загрузки данных с помощью Direct Discovery. Пример: Set DirectTimestampFormat='M/D/YY hh:mm:ss[.fff]';