Comandos regulares de script
Comandos comuns geralmente são usados para manipular dados de uma forma ou de outra. Esses comandos podem ser escritos em qualquer quantidade de linhas no script e devem sempre ser encerrados por um ponto-e-vírgula ";".
Todas as palavras-chave do script podem ser digitadas com qualquer combinação de caracteres maiúsculos e minúsculos. No entanto, os nomes de campos e de variáveis usados nos comandos diferenciam maiúsculas de minúsculas.
Use a caixa suspensa em cada função para ver uma breve descrição e a sintaxe de cada função. Clique no nome da função na descrição da sintaxe para obter detalhes.
A instrução alias é usada para definir um alias de acordo com o qual um campo será renomeado sempre que ele ocorrer no script que segue.
Alias fieldname as aliasname {,fieldname as aliasname}
Esse comando cria um valor inteiro exclusivo para cada valor distinto avaliado em um campo encontrado durante a execução do script.
Autonumber fields [Using namespace] ]
O comando binary é usado para carregamento dos dados de outro aplicativo QlikView ou documento do , inclusive dados de acesso da seção.
Binary [[path] filename ]
Fornece um meio de exibir os comentários de tabela (metadados) das bases de dados ou planilhas.
comment-table tablelist using mapname
comment-table tablename with comment
O comando Declare é usado para criar definições de campo, em que você pode definir as relações entre campos ou funções. Um conjunto de definições de campo pode ser usado para gerar campos derivados automaticamente, o que pode ser usado como dimensões. Por exemplo, é possível criar uma definição de calendário e usá-la para gerar dimensões relacionadas, como ano, mês, semana e dia, a partir de um campo de data.
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> ]
O comando Derive é usado para gerar campos derivados com base em uma definição de campo criada com um comando Declare. Você pode especificar a partir de quais campos de dados derivar os campos ou derivá-los explicitamente ou implicitamente com base em tags de campos.
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
O comando Directory define o diretório para procurar os arquivos de dados em comandos LOAD subsequentes, até que um novo comando Directory seja feito.
Directory [path]
O comando Disconnect termina a conexão ODBC/OLE DB/Personalizada atual. Esse comando é opcional.
É possível descartar um ou vários campos do Qlik Sense do modelo de dados, e consequentemente da memória, a qualquer momento durante a execução do script usando um comando drop field. A propriedade "distinct" de uma tabela é removida após uma instrução drop field.
drop-field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
É possível descartar uma ou várias tabelas internas do Qlik Sense do modelo de dados, e consequentemente da memória, a qualquer momento durante a execução do script usando um comando drop table.
drop-table tablename [, tablename2 ...]
drop tables[ tablename [, tablename2 ...]
O comando FlushLog força o Qlik Sense a escrever o conteúdo do buffer do script em um arquivo de log do script.
O comando force força o Qlik Sense a interpretar os nomes de campo e valores de campo de comandos LOAD e SELECT subsequentes como se estivessem escritos apenas com letras maiúsculas, apenas com letras minúsculas, sempre em maiúsculas ou como aparecem (mistos). Esse comando permite associar os valores de campo das tabelas criadas de acordo com convenções diferentes.
Force ( capitalization | case upper | case lower | case mixed )
A declaração LOAD carrega campos de um arquivo, de dados definidos no script, de uma tabela de entrada carregada anteriormente, de uma página da Web, do resultado de um comando SELECT subsequente ou gerando dados automaticamente. Também é possível carregar dados de conexões analíticas.
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)]
O comando let é um complemento ao comando set, usado para definir variáveis de script. O comando let, ao contrário do comando set, avalia a expressão no lado direito do sinal de igual "=" no tempo de execução do script antes de ser atribuída à variável.
Let variablename=expression
Uma ou mais tabelas de dados internas do Qlik Sense podem ser declaradas explicitamente como parcialmente desconectadas durante a execução do script usando um comando Loosen Table. Quando uma tabela é parcialmente desconectada, todas as associações entre os valores de campo da tabela são removidos. Um efeito semelhante pode ser conseguido por meio do carregamento de cada campo da tabela parcialmente desconectada como tabelas independentes desconectadas. A tabela parcialmente desconectada pode ser útil durante os testes para isolar temporariamente diferentes partes da estrutura de dados. Uma tabela parcialmente desconectada pode ser identificada pelas linhas pontilhadas no visualizador de tabelas. O uso de um ou mais comandos Loosen Table no script fará com que o Qlik Sense desconsidere qualquer configuração das tabelas como parcialmente desconectadas feita antes da execução do script.
tablename [ , tablename2 ...]
Loosen Tables tablename [ , tablename2 ...]
O comando map ... using é usado para mapear um determinado valor de campo ou uma expressão para os valores de uma tabela de mapeamento específica. A tabela de mapeamento é criada pelo comando Mapping.
Map *fieldlist Using mapname
O comando NullAsNull desativa a conversão de valores NULL em strings anteriormente definidas pela declaração NullAsValue.
NullAsNull *fieldlist
O comando NullAsValue especifica para quais campos os NULL encontrados devem ser convertidos em um valor.
NullAsValue *fieldlist
O comando Qualify é usado para alterar a qualificação dos nomes de campo, ou seja, nomes de campo receberão o nome da tabela como um prefixo.
Qualify *fieldlist
A declaração rem é utilizada para inserir comentários no script ou para desativar temporariamente comandos do script sem removê-los.
Rem string
Essa função de script renomeia um ou mais campos do Qlik Sense existentes depois que eles foram carregados.
rename-field (using mapname | oldname to newname{ , oldname to newname })
Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Essa função de script renomeia uma ou mais tabelas internas existentes do Qlik Sense depois que elas foram carregadas.
rename-table (using mapname | oldname to newname{ , oldname to newname })
Rename Tables (using mapname | oldname to newname{ , oldname to newname })
Com o comando section, é possível definir se os comandos LOAD e SELECT subsequentes devem ser considerados como dados ou como uma definição dos direitos de acesso.
Section (access | application)
A seleção de campos de uma fonte de dados ODBC ou provedor OLE DB é feita usando declarações SQL SELECT padrão. No entanto, a aceitação dos comandos SELECT dependem do driver ODBC ou provedor OLE DB utilizados.
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 ]
O comando set é usado para definir as variáveis do script. Essas variáveis podem ser utilizadas para substituir strings, caminhos, unidades e assim por diante.
Set variablename=string
O comando sleep pausa a execução do script pelo tempo especificado.
Sleep n
O comando SQL permite enviar um comando SQL arbitrário usando uma conexão ODBC ou OLE DB.
SQL sql_command
O comando sqlcolumns retorna um conjunto de campos que descreve as colunas de uma fonte de dados ODBC ouOLE DB com a qual é feita uma connect.
O comando sqltables retorna um conjunto de campos que descreve as tabelas de uma fonte de dados ODBC ouOLE DB com a qual é feita uma connect.
O comando sqltypes retorna um conjunto de campos que descreve os tipos de uma fonte de dados ODBC ou OLE DB com a qual é feita uma connect.
É possível definir os caracteres utilizados para representar o conjunto de todos os valores de um campo na base de dados usando o comando star. Isso afeta os comandos LOAD e SELECT subsequentes.
Star is [ string ]
O comando Store cria um arquivo QVD, Parquet, CSV ou TXT.
Store [ *fieldlist from] table into filename [ format-spec ];
Esse comando de script fornece uma maneira de atribuir tags a um ou mais campos ou tabelas. Se for feita uma tentativa de marcar um campo ou uma tabela não presente no aplicativo, a marcação será ignorada. Se houver ocorrências de um nome de campo ou tag em conflito, o último valor será usado.
Tag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname
A declaração trace grava a string na janela Progresso da execução do script e no arquivo de log do script, quando utilizada. É muito útil para finalidades de depuração. Usando expansões $ de variáveis calculadas antes da declaração trace, você pode personalizar a mensagem.
Trace string
O comando Unmap desativa o mapeamento do valor de campo especificado por um comando Map … Using prévio de campos subsequentemente carregados.
Unmap *fieldlist
O comando Unqualify é utilizado para desativar a qualificação de nomes de campos previamente ativada pelo comando Qualify.
Unqualify *fieldlist
Esse comando de script fornece uma maneira de remover tags de campos ou tabelas. Se for feita uma tentativa de desmarcar um campo ou uma tabela não presente no aplicativo, a desmarcação será ignorada.
Untag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname