Ir para conteúdo principal Pular para conteúdo complementar

Usando carregamentos inline para carregar dados

Digite os dados manualmente em um script para definir uma tabela inline, que pode ser carregada em um aplicativo. Você pode trabalhar com carregamentos inline no Editor da carga de dados e no Editor de script.

Você cria tabelas inline digitando dados manualmente no script, em vez de conectar-se a arquivos e bancos de dados. Use a sintaxe necessária para indicar que o texto do script deve ser interpretado como dados inline. Os dados adicionados com carregamentos inline estarão contidos no aplicativo se ele for exportado. As tabelas inline podem ser lidas e editadas no script de carregamento.

Um carregamento inline básico cria uma tabela e insere os campos de dados e registros.

Carregamento inline no editor de carregamento de dados

Carregamento inline no editor de carregamento de dados.

Exemplo de sintaxe básica

O script a seguir contém um carregamento inline simples.

MyTable:
Load * Inline [
Country, Year, Sales
Argentina, 2014, 66295.03
Argentina, 2015, 140037.89
Austria, 2014, 54166.09
Austria, 2015, 182739.87
];

A seguinte sintaxe é usada para o carregamento inline acima:

  • O Load * Inline instrui o Qlik Sense a carregar todos os campos da tabela inline a seguir.

  • MyTable: define o nome da tabela. A lista de tabelas no aplicativo pode ser acessada em Visualizador do modelo de dados e outras áreas.

  • Colchetes delimitam os dados.

  • A primeira linha da instrução de LOAD define os campos de dados.

  • Vírgulas separam campos de dados e registros.

  • Um ponto e vírgula fecha a instrução de LOAD.

Carregando uma tabela inline

  1. Em um aplicativo, abra Editor da carga de dados.

  2. Em uma nova linha, defina a tabela usando a sintaxe necessária.

    Exemplo de sintaxe básica

  3. Quando terminar, clique em Carregar dados.

Por que usar carregamentos inline?

Carregamentos inline podem ser úteis em vários casos de uso:

  • Administração e edição de dados sem necessidade de conexão com fontes externas.

  • Complementando os dados existentes no modelo de dados. Por exemplo, você poderia adicionar uma tabela adicional a um modelo de dados que provém principalmente de fontes de banco de dados.

  • Adicionar dados que você gostaria de evitar o carregamento contínuo de fontes externas. Isso pode economizar tempo se você souber que a fonte de dados poderá mudar no futuro, mas os valores dos dados permanecerão os mesmos.

  • Facilidade de uso para copiar e colar conteúdo de outros arquivos no script. Por exemplo, arquivos .csv ou tabelas de documentos de processadores de texto.

  • Criação de scripts de teste que podem ser copiados e colados rapidamente.

Visão geral da sintaxe

Nomeando a tabela

Você pode adicionar um nome para a tabela inline, como faria para outras tabelas carregadas. Definir o nome da tabela é opcional.

Após o nome da tabela, insira dois pontos.

Comandos LOAD e inline

Uma tabela inline é carregada com a cláusula inline quando você usa a instrução de LOAD do script. A cláusula inline indica que o texto subsequente na tabela conterá dados digitados manualmente no editor. A menos que você indique o contrário, uma tabela inline usa o formato txt que segue a estrutura de um arquivo de texto delimitado.

Para obter mais informações sobre o comando LOAD, consulte Load.

Anexos e entrada de dados

Os dados inseridos por meio de uma cláusula inline devem ser colocados entre caracteres específicos. As seguintes combinações de caracteres são aceitas para incluir os dados:

  • Colchetes: [ e ]

  • Aspas duplas: " e "

  • Aspas simples: ' e '

  • Crases: ` e `

O caractere escolhido como anexo pode ajudá-lo a carregar dados inline que contenham caracteres conflitantes. Por exemplo, se seus dados contiverem registros entre colchetes, você poderá colocá-los entre aspas ou crases.

Para obter um exemplo de anexos alternativos, consulte Exemplo – Anexos de dados alternativos.

A menos que você especifique um formato de tabela alternativo (o padrão é txt), o texto entre os anexos 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.

Finalizando o carregamento inline

O final da instrução de LOAD inline é indicado com ponto e vírgula.

Transformações de dados

Em um carregamento inline simples sem transformações, o número de colunas é definido pela primeira linha. Existem três colunas na tabela carregadas pelo exemplo a seguir: Product_ID, Supplier_Name e Product_Category.

Products:

Load * Inline [
Product_ID, Supplier_Name, Product_Category
1, Paracel, Home Decor
2, PageWave, Electronics
3, Talarian, Software
4, Userland, Appliances
];

Você também pode realizar transformações e criar novas colunas na mesma tabela inline. Você pode usar carregamentos anteriores e mais de uma instrução de LOAD pode ser usada para carregar a mesma tabela.

Para obter exemplos específicos, consulte Exemplos – Carregamentos inline com transformações.

Configurando a especificação de formato em um carregamento inline

Como acontece com outras tabelas carregadas, você pode modificar a especificação de formato da tabela inline usando itens de especificação de formato. A especificação do formato é adicionada entre colchetes. Deve ser adicionado após os delimitadores de dados, mas antes do ponto e vírgula que encerra a instrução de LOAD. Algumas das personalizações que você pode adicionar incluem:

Para usar vários itens de especificação de formato na mesma tabela, separe-os com vírgulas. Por exemplo: (Delimiter is '|', no labels)

Para obter detalhes completos sobre a especificação do formato, consulte Itens de especificação de formato.

Operadores e outras cláusulas

Além disso, como um carregamento inline é uma instrução de LOAD, você pode combinar outros argumentos da instrução de LOAD no carregamento inline. Por exemplo, use a cláusula where ou while para definir se uma linha específica deve ser carregada ou não, com base no texto dentro dela.

Da mesma forma, você também pode usar operadores fora do próprio conteúdo do texto. Com os operadores, você pode personalizar a forma como transforma os dados inline e também definir quando carregar determinados dados ou não.

Para ver um exemplo específico, consulte Exemplo – Operadores para transformações e cláusulas.

Exemplo – Anexos de dados alternativos

Você pode usar colchetes, aspas ou crases para delimitar um carregamento inline. Esta seção ilustra isso com um exemplo. Para obter mais informações, consulte Anexos e entrada de dados.

Exemplos – Delimitadores alternativos

Você pode usar um caractere diferente de vírgula para delimitar os valores das colunas na tabela. Para obter mais informações, consulte Configurando a especificação de formato em um carregamento inline.

Exemplo – Combinação de carregamentos inline e carregamentos de outras fontes de dados

Exemplo – Omitindo cabeçalhos de coluna

Edite a especificação de formato para carregar uma tabela inline sem definir cabeçalhos de coluna. Isso é feito com a especificação labels (definindo-a com um valor de no labels). Para obter mais informações, consulte Configurando a especificação de formato em um carregamento inline.

Quando você carrega uma tabela sem definir nomes de colunas, os nomes de colunas definidos pelo sistema são usados automaticamente.

Exemplo – Carregando outro tipo de dados

Este exemplo demonstra como você pode carregar uma tabela inline em formato de registro fixo. Consulte Configurando a especificação de formato em um carregamento inline.

Exemplo – Conteúdo multilinha

Este exemplo demonstra como você pode inserir conteúdo de campo multilinha em uma tabela inline. Consulte Configurando a especificação de formato em um carregamento inline.

Exemplos – Carregamentos inline com transformações

Estes exemplos mostram como você pode realizar cálculos em campos carregados inline para criar novos campos no modelo de dados.

Para obter mais informações, consulte Transformações de dados.

Exemplo – Operadores para transformações e cláusulas

Você pode usar operadores para definir transformações e cláusulas específicas na instrução de LOAD. Para obter mais informações, consulte Operadores e outras cláusulas.

Operadores

Exemplo – Criando valores nulos em uma tabela inline

Este exemplo demonstra como você pode usar a variável NullInterpret para criar valores nulos em seus dados inline.

NullInterpret

Mais exemplos

Para exemplos adicionais, consulte Load.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!