Использование встроенных загрузок для загрузки данных

Данный пример демонстрирует, как можно использовать обратные кавычки для заключения встроенных данных. Данные в примере содержат квадратные скобки, по причине чего для оператора LOAD нельзя использовать квадратные скобки в качестве заключающих символов.

Обзор

Откройте Редактор загрузки данных и добавьте следующий скрипт загрузки на новую вкладку.

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

• custom_property

• date

• amount

Обзор

Изменение разделителя бывает полезным, когда данные в таблице содержат запятые, которые в ином случае будут рассматриваться как сигнал для перехода к следующему столбцу таблицы.

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.

Скрипт загрузки содержит следующее:

• Необходимо загрузить четыре таблицы, а именно:

  • Table1: разделитель ― вертикальная линия (|). Данные в столбце Phrase содержат запятые.

  • Table2: разделитель ― двоеточие (:).

  • Table3: разделитель ― обратная косая черта (\).

  • Table4: содержимое таблицы разделяется путем нажатия клавиши «Tab» на клавиатуре. Этот вариант полезен, когда таблица копируется из текстового редактора и вставляется в скрипт.

  Таблица Table1 демонстрирует пример практического применения альтернативного разделителя. В остальных таблицах показаны другие варианты разделителей.

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте четыре таблицы и добавьте в них измерения следующим образом:

• Table1: ID, Phrase

• Table2: Num1, Chr1

• Table3: Num2, Chr2

• Table4: Num3, Chr3

Обзор

Следующий скрипт сначала загружает последовательность полей из коннектора, после чего загружает встроенную таблицу с общим полем и дополнительным полем. Это новое поле передает другое свойство элемента строки, которое не было загружено через подключение к данным. Обратите внимание, что это бесперебойно работает, только когда в двух таблицах имеется одно общее имя поля. Если имеется несколько общих имен полей, создается синтетический ключ.

В данном усеченном примере загружается таблица сведений о заказах из подключения к данным. Затем с помощью встроенной таблицы добавляется дополнительное поле Supplemental Info. К примеру, оно может содержать подробные сведения об особых комментариях к заказам с конкретными идентификаторами.

Скрипт загрузки

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

Результаты

Допустим, после загрузки данных в таблицу добавляются следующие измерения:

• Order ID

• Order Date

• Product Type

• Manager

• Shipped Status

• Supplemental Info

Результирующая таблица может выглядеть следующим образом.

Обратите внимание, что все поля в обеих таблицах можно добавить в одну визуализацию. Таблицы связаны друг с другом в модели данных.

Обзор

Данный пример демонстрирует, как можно загрузить встроенную таблицу без определения имен столбцов.

Откройте Редактор загрузки данных и добавьте следующий скрипт загрузки на новую вкладку.

Скрипт загрузки

Expenses:

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

• @1

• @2

• @3

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.

Скрипт загрузки содержит следующее:

• Оператор встроенной загрузки, определяющий таблицу DataTable.
• Использование fix (в составе спецификации Table format) для указания того, что загружаемые данные имеют формат фиксированных записей.

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

• a

• b

• c

• d

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.

Скрипт загрузки содержит следующее:

• Простая встроенная загрузка для определения таблицы T1.

• Использование спецификатора Quotes (со значением msq) для поддержки многострочного содержимого.

• Значения длины, указанные в футах и дюймах.

• Символ двойных кавычек (") обозначает конец многострочной записи. В данном примере тот же символ используется для обозначения значений в дюймах. Так сделано, чтобы продемонстрировать синтаксис и результирующее поведение, если требуется использовать и то, и другое в одном операторе LOAD. По сути, ввод символа " для двух последовательных знаков ("") указывает на то, что код должен интерпретироваться как один текстовый экземпляр символа.

   

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

• ID

• Length

Для правильного отображения многострочного содержимого необходимо включить параметр Переносить текст ячеек на панели свойств. Кроме того, тема приложения (или параметры визуализации) должна обеспечивать достаточно большое значение для параметра Высота строки (в линиях).

В приведенной выше таблице запись со значением ID = 1 имеет многострочное содержимое.

Обзор

Откройте Редактор загрузки данных и добавьте следующий скрипт загрузки на новую вкладку.

Скрипт загрузки

ORDERS:

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

• Original

• Updated

Обзор

Этот пример демонстрирует, как можно определить вычисляемое поле, чтобы указать идентификатор каждой строки данных, не вводя каждое значение идентификатора вручную.

Откройте Редактор загрузки данных и добавьте следующий скрипт загрузки на новую вкладку.

Скрипт загрузки

ORDERS:

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

• ID

• ProductName

Обзор

Этот пример показывает несколько способов применения простого преобразования к встроенным данным. Можно использовать один или несколько операторов LOAD и по-разному настроить синтаксис, чтобы определить, заменяет ли преобразование исходное поле или загружаются оба поля: исходное и новое.

В частности, обратите внимание на следующие вариации и как они влияют на результат:

• Количество операторов LOAD в таблице.

• Присутствие или отсутствие символа * (загружает все последующие поля).

• Присутствие или отсутствие запятых (символ ,).

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.

Скрипт загрузки содержит следующее:

• Четыре таблицы, каждая из которых ссылается на одни и те же данные. Имена полей отличаются.

  • DerivedYears1: использует два оператора LOAD для загрузки встроенного столбца и столбца, содержащего преобразование встроенного столбца.

  • DerivedYears2: использует два оператора LOAD. Скрипт загружает встроенный столбец, затем загружает вычисляемое поле, преобразованное из исходного столбца. Благодаря использованию второго оператора LOAD исходный столбец не загружается в таблицу, что обеспечивает эффективную замену исходного поля новым полем.

  • DerivedYears3: использует один оператор LOAD для загрузки исходного встроенного столбца и преобразованного столбца вместе.

  • DerivedYears4: использует один оператор LOAD для определения встроенного поля и преобразования этого исходного поля. Только преобразованное поле загружается в таблицу.

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте три таблицы и добавьте в них измерения следующим образом:

• DerivedYears1: initial_date1, derived_year1

• DerivedYears2: initial_date2

• DerivedYears3: initial_date3, derived_year3

Обзор

Предположим, что вы вставляете информацию из большого текстового файла в редактор скриптов, но при этом требуется выполнить дополнительную обработку записей в наборе данных. Например, требуется удалить определенные символы и префиксы, а также заменить первую букву каждого слова на заглавную.

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.

Скрипт загрузки содержит следующее:

• Встроенная таблица Transformations, в которой определено преобразование для изменения текстового содержимого поля. Преобразуемый текст добавляется после этого.

• Два оператора LOAD. При использовании приведенной в примере конфигурации в таблицу загружается только производное поле ProductName_Trimmed.

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение: ProductName_Trimmed.

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.

Скрипт загрузки содержит следующее:

• Простая встроенная загрузка для определения таблицы Purchases.

• Вставка вычисляемого поля OrderSize. Это поле является преобразованием поля amount из встроенного набора данных. Она классифицирует покупки как мелкие или крупные в зависимости от того, превосходит ли их сумма $2000.00.

• Предложение where, которое препятствует загрузке записей, когда значение amount меньше $0.05.

Скрипт загрузки

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
;

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте эти поля как измерения:

• ID

• amount

• OrderSize

В таблице выше транзакция с ID = 5 не была загружена в таблицу. Это объясняется тем, что значение amount меньше $0.05.

Обзор

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки на новую вкладку.

Скрипт загрузки содержит следующее:

• Простая встроенная загрузка для определения таблицы T2.

• Переменная NullInterpret определена как две одиночных кавычки. Когда загружается скрипт, записи, содержащие это значение, обрабатываются как нулевые значения.

Скрипт загрузки

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

Результаты

Загрузите данные и откройте лист. Создайте новую таблицу и добавьте это поле как измерение: Test.

В приведенной выше таблице первая запись содержит нулевое значение. По этой причине оно не включается в визуализацию. Нулевые значения в таблицах с дополнительными измерениями будут обозначаться символом -.