Usando carregamentos inline para carregar dados

Este exemplo demonstra como você pode usar crases para incluir os dados inline. Os dados no exemplo contêm caracteres de colchetes, o que torna os colchetes incompatíveis como delimitadores da instrução de LOAD.

Visão geral

Abra o Editor da carga de dados e adicione o script de carregamento a seguir a uma nova guia.

Script de carregamento

DataTable:

Load * inline 
`
custom_property, date, amount
[11402], 1/1/2024, 92.99
[11403], 1/2/2024, 102.34
[11404], 1/3/2024, 50.26
[11405], 1/4/2024, 153.69
[11406], 1/5/2024, 75.62
`;

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

• custom_property

• date

• amount

Visão geral

A troca do delimitador é útil quando os dados da tabela contêm vírgulas, o que de outra forma sinalizaria a mudança para a próxima coluna da tabela.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

• Quatro tabelas a serem carregadas. Elas são as seguintes:

  • Table1: o delimitador é uma barra vertical (barra). Os dados na coluna Phrase contêm vírgulas.

  • Table2: o delimitador é o símbolo de dois pontos.

  • Table3: o delimitador é uma barra invertida.

  • Table4: a tabela é delimitada pressionando a tecla Tab do teclado. Esta opção é útil quando você copia uma tabela de um processador de texto e a cola no script.

  Table1 mostra um caso de uso prático para usar um delimitador alternativo. As outras tabelas mostram mais opções de delimitador.

Script de carregamento

Table1:
LOAD * INLINE [
ID|Phrase
1 | 'The transaction was complete, but the order has not yet shipped.'
2 | 'We need to confirm the following details: sales rep number, order status, and shipping priority.'
] (Delimiter is '|');

Table2:
LOAD * INLINE [
Num1:Chr1
1:A
2:B ] (Delimiter is ':');

Table3:
LOAD * INLINE [
Num2\Chr2
1\A
2\B ] (Delimiter is \\);

Table4:
LOAD * INLINE [
Num3	Chr3
1	A
2	B ] (Delimiter is '\t');

Resultados

Carregue os dados e abra uma pasta. Crie quatro tabelas e adicione as dimensões a elas da seguinte forma:

• Table1: ID, Phrase

• Table2: Num1, Chr1

• Table3: Num2, Chr2

• Table4: Num3, Chr3

Visão geral

O script a seguir carrega primeiro uma série de campos de um conector e, em seguida, carrega uma tabela inline com um campo comum e um campo adicional. Este novo campo fornece outra propriedade sobre o item de linha que não foi carregado por meio da conexão de dados. Observe que isso só funciona perfeitamente quando há um único nome de campo em comum entre as duas tabelas. Se houver mais de um nome de campo comum, uma chave sintética será produzida.

Neste exemplo truncado, carregamos uma tabela de detalhes do pedido a partir de uma conexão de dados. Em seguida, usamos uma tabela inline para adicionar um campo adicional, Supplemental Info. Isso pode, por exemplo, conter detalhes sobre comentários especiais sobre IDs de pedidos específicos.

Script de carregamento

SET DateFormat='MM/DD/YYYY';

Orders:

LIB CONNECT TO 'My_Generic_Connection';

LOAD PRODUCT_DIVISION_A_ORDER_ID as Order ID, 
PRODUCT_DIVISION_A_ORDER_DATE as ISSUE_KEY as Order Date, 
PRODUCT_DIVISION_A_TYPE as Product Type, 
PRODUCT_DIVISION_A_SALES_MANAGER as Manager,
PRODUCT_DIVISION_A_SHIPPED_STATUS as Shipped Status;

SELECT PRODUCT_DIVISION_A_ORDER_ID,
PRODUCT_DIVISION_A_ORDER_DATE,
PRODUCT_DIVISION_A_TYPE,
PRODUCT_DIVISION_A_SALES_MANAGER,
PRODUCT_DIVISION_A_SHIPPED_STATUS

FROM SourceTable
WITH PROPERTIES (

[...]

);

Orders_Inline_Info:
load * inline [
Order ID,Supplemental Info
PSF-001014,'Bulk order, pending deal with Paracel.'
PSF-001625,'NOTE: Product damaged. Investigation required.'
];

Resultados

Depois de carregar os dados, digamos que adicionamos as seguintes dimensões a uma tabela:

• Order ID

• Order Date

• Product Type

• Manager

• Shipped Status

• Supplemental Info

O gráfico resultante poderia ser assim.

Observe como todos os campos de ambas as tabelas podem ser adicionados à mesma visualização. As tabelas estão associadas entre si no modelo de dados.

Visão geral

Este exemplo demonstra como você pode carregar uma tabela inline sem definir nomes de colunas.

Abra o Editor da carga de dados e adicione o script de carregamento a seguir a uma nova guia.

Script de carregamento

Expenses:

Load * inline
[
1,Category1,40566.49
2,Category2,3504.54
3,Category3,593206.30
] (no labels);

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

• @1

• @2

• @3

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

• Uma instrução de LOAD inline que define a tabela DataTable.
• O uso de fix (como parte da especificação Table format) para indicar que os dados a serem carregados estão em formato de registro fixo.

Script de carregamento

DataTable:
LOAD
"@1:4",
"@5:8",
"@9:12",
"@13:16"
INLINE [
a   b   c   d
1   2   3   4
x   y   z   w
] (fix, utf8, embedded labels);

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

• a

• b

• c

• d

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

• Um carregamento inline simples para definir a tabela T1.

• Uso do especificador Quotes (com o valor msq) para oferecer suporte a conteúdo multilinha.

• Valores de comprimento especificados em pés e polegadas.

• O símbolo de aspas duplas (") indica o final de uma entrada multilinha. Neste exemplo, o mesmo símbolo também é usado para denotar os valores em polegadas. Isso é feito para mostrar a sintaxe e o comportamento resultante se você precisar usar ambos na mesma instrução de LOAD. Essencialmente, inserir o símbolo " com dois caracteres consecutivos ("") indica que o código deve ser interpretado como uma única instância de texto do símbolo.

   

Script de carregamento

T1:
Load *, recno() as ID inline [
Length
"1' 2""
22' 10"""
14' 8"  ] (msq);

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

• ID

• Length

Para visualizar o conteúdo multilinha conforme pretendido, a configuração Quebrar texto nas células deve estar ativada no painel de propriedades. Além disso, o tema do aplicativo (ou configurações de visualização) deve permitir Altura de linha (em linhas) suficiente.

Na tabela acima, o registro com um valor ID de 1 contém conteúdo multilinha.

Visão geral

Abra o Editor da carga de dados e adicione o script de carregamento a seguir a uma nova guia.

Script de carregamento

ORDERS:

Load Original as Updated,
* Inline
[
Original
ProductA
ProductB
ProductC
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

• Original

• Updated

Visão geral

Este exemplo mostra como você pode definir um campo calculado para indicar o ID de cada linha de dados, sem digitar manualmente cada valor de ID.

Abra o Editor da carga de dados e adicione o script de carregamento a seguir a uma nova guia.

Script de carregamento

ORDERS:

Load RowNo() as ID,
* Inline
[
ProductName
A
B
C
D
E
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

• ID

• ProductName

Visão geral

Este exemplo mostra diversas maneiras pelas quais uma transformação simples pode ser aplicada a dados inline. Você pode usar uma ou várias instruções de LOAD e configurar a sintaxe de maneiras diferentes para definir se uma transformação substitui ou não o campo original ou se os campos original e novo serão carregados.

Em particular, observe as variações a seguir e como elas afetam a saída:

• Número de instruções de LOAD dentro da tabela.

• Presença ou ausência de símbolo * (carrega todos os campos subsequentes).

• Presença ou ausência de vírgulas (símbolo ,).

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

• Quatro tabelas, todas referenciando os mesmos dados. Os nomes dos campos são diferentes.

  • DerivedYears1: usa duas instruções de LOAD para carregar uma coluna inline e uma coluna contendo uma transformação da coluna inline.

  • DerivedYears2: usa duas instruções de LOAD. O script carrega uma coluna inline e, em seguida, carrega um campo calculado transformado da coluna original. Com a segunda instrução de LOAD, a coluna original não é carregada na tabela, tornando efetivamente o novo campo uma substituição do campo original.

  • DerivedYears3: usa uma única instrução de LOAD para carregar a coluna inline original e uma coluna transformada.

  • DerivedYears4: usa uma única instrução de LOAD para definir um campo inline e uma transformação desse campo original. Somente o campo transformado é carregado na tabela.

Script de carregamento

DerivedYears1:

Load *,
Year(initial_date1) as derived_year1
;
    
Load
* inline [
initial_date1
'1/1/2022'
'1/1/2023'
'1/1/2024'
];

DerivedYears2:

Load
Year(initial_date2) as derived_year2
;
    
Load
* inline [
initial_date2
'1/1/2022'
'1/1/2023'
'1/1/2024'
];

DerivedYears3:

Load Year(initial_date3) as derived_year3,
* inline [
initial_date3
'1/1/2022'
'1/1/2023'
'1/1/2024'
];

DerivedYears4:

Load Year(initial_date4) as derived_year4
inline [
initial_date4
'1/1/2022'
'1/1/2023'
'1/1/2024'
];

Resultados

Carregue os dados e abra uma pasta. Crie três tabelas e adicione as dimensões a elas da seguinte forma:

• DerivedYears1: initial_date1, derived_year1

• DerivedYears2: initial_date2

• DerivedYears3: initial_date3, derived_year3

Visão geral

Suponha que você esteja colando informações de um arquivo de texto grande no editor de script, mas queira realizar processamento adicional nos registros do conjunto de dados. Por exemplo, você deseja remover certos caracteres e prefixos e colocar cada palavra em maiúscula.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

• Uma tabela inline, Transformations, na qual uma transformação é definida para alterar o conteúdo de texto de um campo. O texto que está sendo transformado é adicionado depois disso.

• Duas instruções de LOAD. Com a configuração do exemplo, apenas o campo derivado ProductName_Trimmed é carregado na tabela.

Script de carregamento

Transformations:

Load 
Capitalize(TextBetween(OrigColumn, '{','}')) as ProductName_Trimmed;

Load * inline [
OrigColumn
Product: {soft drinks and other beverages}
Product:  {snack food}
Product: {electronics and video games}
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão: ProductName_Trimmed.

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

• Um carregamento inline simples para definir a tabela Purchases.

• A inserção de um campo calculado, OrderSize. Este campo é uma transformação do campo amount do conjunto de dados inline. Ele categoriza as compras como pequenas ou grandes, dependendo se o valor ultrapassa ou não US$ 2.000,00.

• Uma cláusula where que impede que os registros sejam carregados quando amount for inferior a US$ 0,05.

Script de carregamento

Purchases:

Load
If(amount<2000,'Small Purchase','Large Purchase') as OrderSize,

* inline
[
ID, amount
1,2660.39
2,100.01
3,500.42
4,5023.99
5,0.04
6,2002.39
7,31034.53
8,1643.58
9,3993.65
10,614.34
11,675.93
]
WHERE
amount>0.05
;

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

• ID

• amount

• OrderSize

Na tabela acima, a transação com um ID de 5 não foi carregada na tabela. Isso ocorre porque o valor amount é inferior a US$ 0,05.

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.

O script de carregamento contém:

• Um carregamento inline simples para definir a tabela T2.

• A variável NullInterpret definida como duas aspas simples. Quando o script é carregado, os registros que contêm esse valor são processados como valores nulos.

Script de carregamento

set nullinterpret = '';
T2:
Load * inline [
Test
''
x ];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão: Test.

Na tabela acima, o primeiro registro é um valor nulo. Portanto, não está incluído na visualização. Valores nulos existentes em tabelas com dimensões adicionais seriam indicados com um símbolo -.