Load
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.
Sintaxe:
LOAD [ distinct ] fieldlist
[( from file [ format-spec ] |
from_field fieldassource [format-spec]|
inline data [ format-spec ] |
resident table-label |
autogenerate size ) |extension pluginname.functionname([script] tabledescription)]
[ where criterion | while criterion ]
[order by orderbyfieldlist ]
Argumento | Descrição |
---|---|
distinct | Você pode usar distinct como predicado se deseja carregar apenas registros exclusivos. Se houver registros duplicados, a primeira instância será carregada. Se você estiver usando cargas anteriores, precisará colocar distinct na primeira instrução de carga, pois distinct afeta apenas a tabela de destino. |
fieldlist | fieldlist ::= ( * | field{, * | field } ) Uma lista dos campos a serem carregados. O uso de * como lista de campos indica todos os campos da tabela. field ::= ( fieldref | expression ) [as aliasname ]A definição de campo deve conter sempre um literal, uma referência a um campo existente ou a uma expressão. fieldref ::= ( fieldname |@fieldnumber |@startpos:endpos [ I | U | R | B | T] )fieldname é um texto idêntico a um nome de campo da tabela. Observe que o nome do campo deverá estar entre aspas duplas ou colchetes se contiver espaços, por exemplo. Às vezes, os nomes de campo não estão explicitamente disponíveis. Assim, uma notação diferente será usada: @fieldnumber representa o número de campo em um arquivo de tabela delimitado. Deve ser um inteiro positivo, precedido de “@”. A numeração sempre inicia no número 1 até o número de campos. @startpos:endpos representa as posições inicial e final de um campo em um arquivo com registros de comprimento fixo. As posições devem ser inteiros positivos. Os dois números devem ser precedidos de "@" e separados por dois-pontos. A numeração sempre inicia no número 1 até o número de posições. No último campo, n é usado como posição final do campo.
expression pode ser uma função numérica ou uma função de string baseada em um ou vários outros campos da mesma tabela. Para obter mais informações, consulte a sintaxe das expressões. |
from | from será usado se os dados precisarem ser carregados de um arquivo usando uma pasta. Ao carregar de um arquivo no espaço no Qlik Cloud Analytics, um caminho válido deve ser usado. Consulte Regras para caminhos válidos de pastas de espaço. file ::= [ path ] filename No Qlik Cloud Analytics, há suporte para estruturas de pastas hierárquicas e elas podem ser referenciadas na instrução. Exemplos:
Para obter mais informações e exemplos, consulte Carregando arquivos de espaços no Qlik Cloud Analytics. |
from_field | from_field é usado se for necessário carregar dados de um campo anteriormente carregado. fieldassource::=(tablename, fieldname) O campo é o nome de tablename e fieldname carregados anteriormente. format-spec ::= ( fspec-item {, fspec-item } )A especificação do formato consiste em uma lista de vários itens de especificação de formato, entre colchetes. Para obter mais informações, consulte Itens de especificação de formato. Nota informativafrom_field oferece suporte apenas a vírgulas como delimitador de lista ao separar campos em tabelas. |
inline | inline será usado se os dados precisarem ser digitados no script, e não carregados de um arquivo. data ::= [ text ] Os dados inseridos por meio de uma cláusula inline devem ser colocados entre caracteres específicos – colchetes, aspas ou crases. O texto entre esses elementos será interpretado da mesma maneira que o conteúdo de um arquivo. Portanto, no local em que uma nova linha for inserida em um arquivo de texto, você também deverá inseri-la no texto de uma cláusula inline: pressionando a tecla Enter ao digitar o script. Em um carregamento inline simples, o número de colunas é definido pela primeira linha. format-spec ::= ( fspec-item {, fspec-item } )Você pode personalizar o carregamento inline com muitos dos mesmos itens de especificação de formato que estão disponíveis para outras tabelas carregadas. Esses itens estão listados entre colchetes. Para obter mais informações, consulte Itens de especificação de formato. Para obter mais informações sobre carregamentos inline, consulte Usando carregamentos inline para carregar dados. |
resident | resident é usado se for necessário carregar dados de uma tabela anteriormente carregada. table label é um rótulo que precede o comando LOAD ou SELECT que criou a tabela original. O rótulo deve ter dois-pontos no final. |
autogenerate | autogenerate será usado se for necessário gerar os dados automaticamente pelo Qlik Sense. size ::= number Number é um inteiro que indica o número de registros a serem gerados. A lista de campos não deve conter expressões que precisem de dados de uma fonte de dados externa ou de uma tabela carregada anteriormente, a menos que você faça referência a um único valor de campo em uma tabela carregada anteriormente com a função Peek. |
where | where é uma cláusula utilizada para declarar se um registro deve ou não ser incluído na seleção. A seleção será incluída se criterion for True. criterion é uma expressão lógica. |
while | while é uma cláusula usada para declarar que um registro deve ser lido repetidamente. O mesmo registro será lido se criterion forTrue. Para que possa ser útil, a cláusula while normalmente deve incluir a função IterNo( ). criterion é uma expressão lógica. |
group by | group by é uma cláusula usada para definir os campos de agregação (agrupamento) dos dados. Os campos de agregação devem ser incluídos de alguma maneira nas expressões carregadas. Nenhum outro campo diferente desses poderá ser usado fora das funções de agregação nas expressões carregadas. groupbyfieldlist ::= (fieldname { ,fieldname } ) |
order by | order by é uma cláusula usada para classificar os registros de uma tabela residente antes de seu processamento pela declaração load. A tabela residente pode ser classificada por um ou mais campos, em ordem ascendente ou descendente. A classificação é feita, principalmente, pelo valor numérico e, em seguida, pela ordem nacional de colação. Essa cláusula somente poderá ser usada quando a fonte de dados for uma tabela residente. Os campos de classificação especificam por qual campo a tabela residente é classificada. O campo pode ser especificado por seu nome ou número na tabela residente (o primeiro campo é o número 1). orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] } sortorder é asc para ascendente ou desc para descendente. Se nenhuma sortorder for especificada, asc será assumido. fieldname, path, filename e aliasname são strings de texto que indicam o que seus respectivos nomes implicitamente representam. Qualquer campo na tabela de origem pode ser usado como fieldname. No entanto, campos criados por meio da cláusula (aliasname) estão fora de escopo e não podem ser usados dentro de uma mesma declaração load. |
Se nenhuma fonte de dados for fornecida por meio de uma cláusula from, inline, resident, from_field, extension ou autogenerate, os dados serão carregados a partir do resultado imediatamente após a instrução SELECT ou LOAD. O comando sucessivo não deverá ter prefixo.
Carregando dados de uma tabela carregada anteriormente
Exemplos:
Carregando arquivos de espaços no Qlik Cloud Analytics
No Qlik Cloud Analytics, ao carregar dados de um arquivo de dados em um script de carregamento, você pode usar uma instrução LOAD ou inserir o código QVS. Em ambos os casos, as estruturas hierárquicas de pastas de espaço podem ser referenciadas em sua instrução de script. Siga as regras para caminhos válidos de pastas de espaço. Além disso, o arquivo e todas as pastas referenciadas precisam já existir na localização especificada. Caso contrário, a recarga falhará.
Exemplos: Referência ao arquivo no caminho de nível superior de um espaço
Esse exemplo carrega o arquivo orders.csv de um espaço pessoal. O arquivo não está localizado em nenhuma pasta específica, mas sim no caminho de nível superior no espaço.
LOAD * FROM [lib://DataFiles/orders.csv];
Esse exemplo carrega o arquivo orders.csv de um espaço compartilhado, um espaço gerenciado ou um espaço de dados. O nome do espaço é TeamSharedSpace. O arquivo não está localizado em nenhuma pasta específica, mas sim no caminho de nível superior no espaço.
LOAD * FROM [lib://TeamSharedSpace:DataFiles/orders.csv];
Exemplos: Referências a um caminho de pasta específico em um espaço
Esse exemplo carrega o arquivo orders_Europe.csv da pasta Orders By Region em um espaço pessoal.
LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];
Esse exemplo carrega o arquivo orders_Europe.csv da pasta Orders By Region em um espaço compartilhado, um espaço gerenciado ou um espaço de dados. O nome do espaço é SalesSpace.
LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];
Para obter mais informações sobre como referenciar a estrutura da pasta de espaço em scripts de carregamento, consulte Fazendo referência da estrutura de pastas do espaço no desenvolvimento de aplicativos e scripts.