Używanie wbudowanych ładowań do ładowania danych

Ten przykład pokazuje, jak można użyć grawisów do ujęcia danych wbudowanych. Dane w przykładzie zawierają nawiasy kwadratowe, co powoduje, że nawiasy kwadratowe nie są kompatybilne jako znaki do ujmowania danych w instrukcji LOAD .

Przegląd

Otwórz Edytor ładowania danych i dodaj następujący skrypt ładowania do nowej karty.

Skrypt ładowania

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
`;

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

• custom_property

• date

• amount

Przegląd

Zamiana ogranicznika jest przydatna, gdy dane w tabeli zawierają przecinki, które w przeciwnym razie sygnalizowałyby przejście do następnej kolumny w tabeli.

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.

Skrypt ładowania zawiera:

• Cztery tabele do załadowania. Są to:

  • Table1: ogranicznik to kreska pionowa. Dane w kolumnie Phrase zawierają przecinki.

  • Table2: ogranicznikiem jest dwukropek.

  • Table3: ogranicznikiem jest ukośnik odwrotny.

  • Table4: tabela jest rozdzielana przez naciśnięcie klawisza Tab na klawiaturze. Ta opcja jest przydatna podczas kopiowania tabeli z edytora tekstu i wklejania jej do skryptu.

  Table1 przedstawia praktyczne zastosowanie alternatywnego ogranicznika. Pozostałe tabele pokazują więcej opcji ograniczników.

Skrypt ładowania

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');

Wyniki

Załaduj dane i otwórz arkusz. Utwórz cztery tabele i dodaj do nich wymiary następująco:

• Table1: ID, Phrase

• Table2: Num1, Chr1

• Table3: Num2, Chr2

• Table4: Num3, Chr3

Przegląd

Poniższy skrypt najpierw ładuje serię pól z łącznika, a następnie ładuje tabelę wbudowaną ze wspólnym polem i dodatkowym polem. To nowe pole udostępnia inną właściwość dotyczącą elementu wiersza, który nie został załadowany za pośrednictwem połączenia danych. Należy pamiętać, że działa to sprawnie tylko wtedy, gdy w obu tabelach występuje wspólna nazwa jednego pola. Jeśli istnieje więcej niż jedna wspólna nazwa pola, tworzony jest klucz syntetyczny.

W tym okrojonym przykładzie ładujemy tabelę szczegółów zamówienia z połączenia danych. Następnie używamy tabeli wbudowanej, aby dodać pole Supplemental Info. Może ono na przykład zawierać szczegółowe informacje na temat specjalnych komentarzy dotyczących określonych identyfikatorów zamówień.

Skrypt ładowania

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.'
];

Wyniki

Załóżmy, że po załadowaniu danych dodajemy do tabeli następujące wymiary:

• Order ID

• Order Date

• Product Type

• Manager

• Shipped Status

• Supplemental Info

Wynikowy wykres może wyglądać następująco.

Zwróć uwagę, że wszystkie pola z obu tabel można dodać do tej samej wizualizacji. Tabele są ze sobą powiązane w modelu danych.

Przegląd

Ten przykład ilustruje sposób ładowania tabeli wbudowanej bez definiowania nazw kolumn.

Otwórz Edytor ładowania danych i dodaj następujący skrypt ładowania do nowej karty.

Skrypt ładowania

Expenses:

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

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

• @1

• @2

• @3

Przegląd

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.

Skrypt ładowania zawiera:

• Instrukcja ładowania wbudowanego definiująca tabelę DataTable.
• Użycie fix (jako części specyfikacji Table format) do wskazania, że dane do załadowania mają ustalony format rekordu.

Skrypt ładowania

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);

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

• a

• b

• c

• d

Przegląd

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.

Skrypt ładowania zawiera:

• Proste ładowanie wbudowane w celu zdefiniowania tabeli T1.

• Użycie specyfikatora Quotes (z wartością msq) do obsługi zawartości wielowierszowej.

• Wartości długości są określone w stopach i calach.

• Symbol podwójnego cudzysłowu (") oznacza koniec wpisu wielowierszowego. W tym przykładzie ten sam symbol jest również używany do oznaczenia wartości w calach. Ma to na celu pokazanie składni i wynikającego z niej postępowania, jeśli trzeba użyć obu w tej samej instrukcji LOAD. Wprowadzenie symbolu " składającego się z dwóch kolejnych znaków ("") oznacza zasadniczo, że kod należy interpretować jako pojedynczą instancję tekstową symbolu.

   

Skrypt ładowania

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

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

• ID

• Length

Aby zawartość wielowierszowa była wyświetlana zgodnie z zamierzeniami, w panelu właściwości musi być włączone ustawienie Zawijaj tekst w komórkach. Dodatkowo kompozycja aplikacji (lub ustawienia wizualizacji) musi umożliwiać odpowiednią Wysokość wiersza (w liniach).

W powyższej tabeli rekord o wartości ID wynoszącej 1 zawiera treść wielowierszową.

Przegląd

Otwórz Edytor ładowania danych i dodaj następujący skrypt ładowania do nowej karty.

Skrypt ładowania

ORDERS:

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

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

• Original

• Updated

Przegląd

Ten przykład pokazuje, jak można zdefiniować pole wyliczane wskazujące identyfikator każdego wiersza danych, bez konieczności ręcznego wpisywania każdej wartości identyfikatora.

Otwórz Edytor ładowania danych i dodaj następujący skrypt ładowania do nowej karty.

Skrypt ładowania

ORDERS:

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

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

• ID

• ProductName

Przegląd

Ten przykład pokazuje kilka sposobów zastosowania prostej transformacji do danych wbudowanych. Można użyć jednej lub wielu instrukcji LOAD oraz skonfigurować składnię na różne sposoby, aby określić, czy transformacja zastępuje oryginalne pole, nie zastępuje, czy też ładowane są zarówno oryginalne, jak i nowe pole.

W szczególności zwróć uwagę na następujące różnice i ich wpływ na wynik:

• Liczba instrukcji LOAD w tabeli.

• Obecność lub brak symbolu * (ładuje wszystkie kolejne pola).

• Obecność lub brak przecinków (symbol ,).

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.

Skrypt ładowania zawiera:

• Cztery tabele, z których wszystkie odwołują się do tych samych danych. Nazwy pól są różne.

  • DerivedYears1: używa dwóch instrukcji LOAD do załadowania kolumny wbudowanej i kolumny zawierającej transformację kolumny wbudowanej.

  • DerivedYears2: używa dwóch instrukcji LOAD. Skrypt ładuje kolumnę wbudowaną, a następnie ładuje pole wyliczane przekształcone z oryginalnej kolumny. W przypadku drugiej instrukcji LOAD pierwotna kolumna nie jest ładowana do tabeli, co w efekcie powoduje, że nowe pole zastępuje pole pierwotne.

  • DerivedYears3: używa pojedynczej instrukcji LOAD do załadowania zarówno pierwotnej kolumny wbudowanej, jak i kolumny przekształconej.

  • DerivedYears4: używa pojedynczej instrukcji LOAD do zdefiniowania pola wbudowanego i transformacji tego pierwotnego pola. Do tabeli ładowane jest tylko przekształcone pole.

Skrypt ładowania

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'
];

Wyniki

Załaduj dane i otwórz arkusz. Utwórz trzy tabele i dodaj do nich wymiary w następujący sposób:

• DerivedYears1: initial_date1, derived_year1

• DerivedYears2: initial_date2

• DerivedYears3: initial_date3, derived_year3

Przegląd

Załóżmy, że wklejasz informacje z dużego pliku tekstowego do edytora skryptów, ale chcesz dodatkowo przetworzyć rekordy w zestawie danych. Na przykład chcesz usunąć określone znaki oraz prefiksy i zapisać każde słowo wielką literą.

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.

Skrypt ładowania zawiera:

• Tabela wbudowana Transformations, w której zdefiniowano transformację zmieniającą zawartość tekstową pola. Następnie dodawany jest przekształcany tekst.

• Dwie instrukcje LOAD. W przypadku konfiguracji z przykładu do tabeli ładowane jest tylko pochodne pole ProductName_Trimmed.

Skrypt ładowania

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}
];

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj to pole jako wymiar: ProductName_Trimmed.

Przegląd

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.

Skrypt ładowania zawiera:

• Proste ładowanie wbudowane w celu zdefiniowania tabeli Purchases.

• Wstawienie pola wyliczanego, OrderSize. To pole jest transformacją pola amount z wbudowanego zestawu danych. Klasyfikuje zakupy jako małe i duże w zależności od tego, czy kwota przekracza 2000,00 USD.

• Klauzula where uniemożliwiająca ładowanie rekordów, gdy wartość amount jest mniejsza niż 0,05 USD.

Skrypt ładowania

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
;

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

• ID

• amount

• OrderSize

W powyższej tabeli transakcja z ID 5 nie została załadowana do tabeli. Jest tak dlatego, że wartość amount wynosi mniej niż 0,05 USD.

Przegląd

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.

Skrypt ładowania zawiera:

• Proste ładowanie wbudowane w celu zdefiniowania tabeli T2.

• Zmienna NullInterpret zdefiniowana jako dwa pojedyncze cudzysłowy. Po załadowaniu skryptu rekordy zawierające tę wartość są przetwarzane jako wartości null.

Skrypt ładowania

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

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj to pole jako wymiar: Test.

W powyższej tabeli pierwszy rekord ma wartość null. W związku z tym nie jest uwzględniony w wizualizacji. Wartości null występujące w tabelach z dodatkowymi wymiarami zostałyby oznaczone symbolem -.