Обычные операторы скриптов
Как правило, обычные операторы используются для управления данными тем или иным образом. Эти операторы могут быть перезаписаны любым числом линий в скрипте и всегда должны заканчиваться точкой с запятой, «;».
Все ключевые слова скрипта можно вводить в любой комбинации символов в нижнем и верхнем регистре. В именах полей и переменных, используемых в операторах, учитывается регистр.
Пользуйтесь информацией из раскрывающегося списка по каждой функции, чтобы увидеть краткое описание и синтаксис каждой функции. Дополнительную информацию можно получить, если щелкнуть имя функции в описании синтаксиса.
Оператор alias используется для установки псевдонима, по которому будет переименовано поле при включении в следующий скрипт.
Alias fieldname as aliasname {,fieldname as aliasname}
Этот оператор создает уникальное значение целого для каждого определенного оцененного значения поля, возникающего в процессе выполнения скрипта.
Autonumber fields [Using namespace] ]
Оператор binary используется для загрузки данных из другого документа QlikView, включая данные Section Access.
Binary [path] filename
Позволяет отображать комментарии таблицы (метаданные) из баз данных или электронных таблиц.
comment-table tablelist using mapname
comment-table tablename with comment
Оператор CONNECT используется для определения доступа программы Qlik Sense к общей базе данных с помощью интерфейса OLE DB/ODBC. Для интерфейса ODBC необходимо сначала задать источник данных с помощью администратора ODBC.
ODBC CONNECT TO connect-string [ ( access_info ) ]
OLEDB CONNECT TO connect-string [ ( access_info ) ]
CUSTOM CONNECT TO connect-string [ ( access_info ) ]
LIB CONNECT TO connection
Оператор Declare используется для создания определений полей, где можно определить отношения между полями или функциями. Ряд определений полей можно использовать для автоматического создания производных полей, которые можно использовать как измерения. Например можно создать определение календаря и использовать его для создания соответствующих измерений, таких как год, месяц, неделя и день, на основе поля даты.
definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
[Groups group_list ]
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]
Оператор Derive используется для создания производных полей на основе определения поля, созданного с помощью оператора Declare. Можно указать, для каких полей данных необходимо извлечь поля, или извлечь их явно или неявно на основе тегов полей.
Derive [Field[s]] From [Field[s]] field_list Using definition
Derive [Field[s]] From Explicit [Tag[s]] (tag_list) Using definition
Derive [Field[s]] From Implicit [Tag[s]] Using definition
Оператор DIRECT QUERY обеспечивает доступ к таблицам через подключение ODBC или OLE DB с помощью функции Direct Discovery.
direct-query [path]
Оператор Directory задает каталог, в котором будет выполняться поиск файлов данных в последующих операторах LOAD до создания нового оператора Directory.
Directory [path]
Оператор Disconnect разрывает текущее соединение ODBC/OLE DB/Custom. Этот оператор является дополнительным.
Одно или несколько полей Qlik Sense можно удалить из модели данных, а, значит, и из памяти в любой момент выполнения скрипта с помощью оператора drop field. Свойство distinct таблицы удаляется после оператора drop field.
drop-field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
Одну или несколько внутренних таблиц Qlik Sense можно удалить из модели данных, а значит и из памяти в любой момент выполнения скрипта с помощью оператора drop table.
drop-table tablename [, tablename2 ...]
drop tables[ tablename [, tablename2 ...]
Оператор Execute используется для запуска других программ в ходе загрузки данных Qlik Sense. Например, для выполнения необходимых преобразований.
Execute commandline
Оператор FlushLog инициирует запись содержимого буфера скрипта в файл журнала скрипта Qlik Sense.
Оператор force инициирует интерпретацию программой Qlik Sense имен и значений полей последующих операторов LOAD и SELECT как записанных только символами верхнего регистра, только символами нижнего регистра, всегда приписными буквами или как есть (смешанными). Этот оператор позволяет ассоциировать значения полей в таблицах, выполненных в соответствии с различными условными обозначениями.
Force ( capitalization | case upper | case lower | case mixed )
Оператор 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 ]
[extension pluginname.functionname(tabledescription)]
Оператор let создан как дополнение к оператору set, используемому для определения переменных скрипта. Оператор let, в отличие от оператора set, вычисляет выражение, расположенное справа от знака «=» во время выполнения скрипта до присваивания его переменной.
Let variablename=expression
Одну или несколько внутренних таблиц данных в программе Qlik Sense можно явно объявить слабосвязанными в ходе выполнения скрипта с помощью оператора Loosen Table. При преобразовании таблицы в слабосвязанную все связи между значениями полей в таблице удаляются. Похожего эффекта можно добиться, загрузив каждое поле слабосвязанной таблицы в качестве независимой несвязанной таблицы. Слабосвязанная таблица может применяться в ходе проверки для временной изоляции различных частей структуры данных. Слабосвязанная таблица обозначена в обозревателе таблиц пунктирной линией. Использование одного или нескольких операторов Loosen Table в скрипте приведет к тому, что программа Qlik Sense будет игнорировать параметры таблиц, считая их ставшими слабосвязанными до выполнения скрипта.
tablename [ , tablename2 ...]
Loosen Tables tablename [ , tablename2 ...]
Оператор map ... using используется для сопоставления определенных значений полей или выражений со значениями в определенной таблице сопоставления. Таблицу сопоставления можно создать с помощью оператора Mapping.
Map *fieldlist Using mapname
Оператор NullAsNull отключает преобразование значений NULL в строчные значения, ранее заданные с помощью оператора NullAsValue.
NullAsNull *fieldlist
Оператор NullAsValue указывает, для каких из полей обнаруженные значения NULL должны быть преобразованы в значения.
NullAsValue *fieldlist
Оператор Qualify используется для включения квалификации имен полей, т. е. имена полей получат имя таблицы в качестве префикса.
Qualify *fieldlist
Оператор rem служит для вставки замечаний или комментариев в скрипт или для временного отключения операторов скрипта без их удаления.
Rem string
Эта функция скрипта переименовывает одно или несколько существующих полей в программе Qlik Sense после их загрузки.
rename-field (using mapname | oldname to newname{ , oldname to newname })
Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Эта функция скрипта переименовывает одну или несколько существующих внутренних таблиц в программе Qlik Sense после их загрузки.
rename-table (using mapname | oldname to newname{ , oldname to newname })
Rename Tables (using mapname | oldname to newname{ , oldname to newname })
Оператор section позволяет определить, следует ли рассматривать последующие операторы LOAD и SELECT в качестве данных или определения прав доступа.
Section (access | application)
Выбор полей из источника данных 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 variablename=string
Оператор sleep приостанавливает выполнение скрипта на указанное время.
Sleep n
Оператор SQL позволяет отправлять произвольную команду SQL посредством подключения ODBC или OLE DB.
SQL sql_command
Оператор sqlcolumns возвращает набор полей с описанием столбцов источника данных ODBC или OLE DB, с которыми выполнена операция connect.
Оператор sqltables возвращает набор полей с описанием таблиц источника данных ODBC или OLE DB, с которыми выполнена операция connect.
Оператор sqltypes возвращает набор полей с описанием типов источника данных ODBC или OLE DB, с которыми выполнена операция connect.
Строку, которая представляет набор всех значений поля в базе данных, можно определить с помощью оператора star. Она влияет на последующие операторы LOAD и SELECT.
Star is [ string ]
Оператор Store создает файл QVD, Parquet, CSV или TXT.
Store [ *fieldlist from] table into filename [ format-spec ];
Этот оператор скрипта позволяет присваивать теги одному или нескольким полям или таблицам. Если делается попытка присвоить тег полю или таблице, отсутствующим в приложении, то эта операция будет проигнорирована. Если обнаружены конфликты между именами полей или тегов, то используется последнее значение.
Tag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname
Оператор trace записывает строку в окно Ход выполнения скрипта и в файл журнала скрипта, если тот используется. Он очень полезен для отладки. Расширение $, добавляемое к переменным, вычисляемым до оператора trace, позволяет настроить сообщение.
Trace string
Оператор Unmap деактивирует значение поля mapping, заданное предыдущим оператором Map … Using для последующих загружаемых полей.
Unmap *fieldlist
Оператор Unqualify используется для снятия уточнения имен полей, которое ранее было включено оператором Qualify.
Unqualify *fieldlist
Этот оператор скрипта позволяет удалять теги из полей или таблиц. Если делается попытка удалить тег из поля или таблицы, отсутствующим в приложении, то эта операция будет проигнорирована.
Untag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname