Utilisation de chargements inline pour charger des données

Cet exemple montre comment utiliser des backticks pour encadrer les données inline. Les données de l'exemple contiennent des caractères de type crochet, ce qui rend les crochets incompatibles comme encadrements pour l'instruction LOAD.

Vue d'ensemble

Ouvrez l'Éditeur de chargement de données et ajoutez le script de chargement suivant à un nouvel onglet.

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

• custom_property

• date

• amount

Vue d'ensemble

Le remplacement du délimiteur s'avère utile lorsque les données de la table contiennent des virgules, ce qui, sinon, signalerait le passage à la colonne suivante de la table.

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

• Quatre tables à charger. Il s'agit des suivantes :

  • Table1 : le délimiteur est une barre verticale (pipe). Les données de la colonne Phrase contiennent des virgules.

  • Table2 : le délimiteur est un point-virgule.

  • Table3 : le délimiteur est une barre oblique inversée.

  • Table4 : la table est délimitée par une pression sur la touche Tab du clavier. Cette option s'avère utile lorsque vous copiez une table d'un traitement de texte et que vous la collez dans le script.

  Le Table1 montre un cas d'utilisation pratique d'un autre délimiteur. Les autres tableaux montrent d'autres options de délimiteur.

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez quatre tables et ajoutez-y les dimensions comme suit :

• Table1 : ID, Phrase

• Table2 : Num1, Chr1

• Table3 : Num2, Chr2

• Table4 : Num3, Chr3

Vue d'ensemble

Le script suivant commence par charger une série de champs provenant d'un connecteur, puis charge une table inline avec un champ commun et un champ supplémentaire. Ce nouveau champ fournit une autre propriété sur l'élément de ligne qui n'a pas été chargé via la connexion de données. Notez que cela fonctionne bien uniquement lorsqu'il existe un seul nom de champ en commun entre les deux tables. S'il existe plusieurs noms de champ en commun, une clé synthétique est produite.

Dans cet exemple tronqué, nous chargeons une table de détails de commandes provenant d'une connexion de données. Nous utilisons ensuite une table inline pour ajouter un champ supplémentaire, Supplemental Info. Celui-ci peut, par exemple, contenir des détails sur des commentaires spéciaux sur des ID de commande spécifiques.

Script de chargement

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

Résultats

Après avoir chargé les données, imaginons que nous ajoutions les dimensions suivantes à une table :

• Order ID

• Order Date

• Product Type

• Manager

• Shipped Status

• Supplemental Info

Le graphique obtenu pourrait prendre la forme suivante.

Notez comment tous les champs des deux tables peuvent être ajoutés à la même visualisation. Les tables sont associées l'une à l'autre dans le modèle de données.

Vue d'ensemble

Cet exemple montre comment charger une table inline sans définir de noms de colonne.

Ouvrez l'Éditeur de chargement de données et ajoutez le script de chargement suivant à un nouvel onglet.

Script de chargement

Expenses:

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

• @1

• @2

• @3

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

• Instruction inline load définissant la table DataTable.
• Utilisation de fix (dans le cadre de la spécification Table format) pour indiquer que les données à charger se présentent dans un format d'enregistrement fixe.

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

• a

• b

• c

• d

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

• Chargement inline simple permettant de définir la table T1.

• Utilisation du spécificateur Quotes (avec la valeur msq) pour prendre en charge le contenu multiligne.

• Valeurs de longueur spécifiées en pieds et en pouces.

• Le symbole de guillemet double (") indique la fin d'une entrée multiligne. Dans cet exemple, le même symbole est également utilisé pour indiquer des valeurs en pouces. Cet exemple montre la syntaxe et le comportement qui en découle si vous devez utiliser les deux dans la même instruction LOAD. En fait, la saisie du symbole " pour deux caractères consécutifs ("") indique que le code doit être interprété comme une seule instance de texte du symbole.

   

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

• ID

• Length

Pour afficher le contenu multiligne comme souhaité, le paramètre Renvoi à la ligne du texte des cellules doit être activé dans le panneau des propriétés. De plus, le thème de l'application (our les paramètres de la visualisation) doit accepter la Hauteur de ligne (des lignes) suffisante.

Dans le tableau ci-dessus, l'enregistrement avec une valeur ID égal à 1 inclut un contenu multiligne.

Vue d'ensemble

Ouvrez l'Éditeur de chargement de données et ajoutez le script de chargement suivant à un nouvel onglet.

Script de chargement

ORDERS:

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

• Original

• Updated

Vue d'ensemble

Cet exemple montre comment définir un champ calculé pour indiquer l'ID de chaque ligne de données, sans avoir à saisir manuellement chaque valeur d'ID.

Ouvrez l'Éditeur de chargement de données et ajoutez le script de chargement suivant à un nouvel onglet.

Script de chargement

ORDERS:

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

• ID

• ProductName

Vue d'ensemble

Cet exemple montre plusieurs manières d'appliquer une simple transformation à des données inline. Vous pouvez utiliser une ou plusieurs instructions LOAD et configurer la syntaxe de différentes manières afin de déterminer si une transformation remplace ou non le champ d'origine ou si le champ d'origine et le nouveau champ sont tous les deux chargés.

Notez surtout les variations des éléments suivants et comment elles affectent le résultat :

• Nombre d'instructions LOAD dans la table.

• Présence ou absence de symbole * (charge tous les champs suivants).

• Présence ou absence de virgules (symbole ,).

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

• Quatre tables, chacune référençant les mêmes données. Les noms de champ sont différents.

  • DerivedYears1 : utilise deux instructions LOAD pour charger une colonne inline et une colonne contenant une transformation de la colonne inline.

  • DerivedYears2 : utilise deux instructions LOAD. Le script charge une colonne inline, puis charge un champ calculé transformé à partir de la colonne d'origine. Avec la deuxième instruction LOAD, la colonne d'origine n'est pas chargée dans la table, entraînant effectivement le remplacement du champ d'origine par le nouveau champ.

  • DerivedYears3 : utilise une seule instruction LOAD pour charger la colonne inline d'origine et une colonne transformée.

  • DerivedYears4 : utilise une seule instruction LOAD pour définir un champ inline et une transformation de ce champ d'origine. Seul le champ transformé est chargé dans la table.

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez trois tables et ajoutez-y les dimensions comme suit :

• DerivedYears1 : initial_date1, derived_year1

• DerivedYears2 : initial_date2

• DerivedYears3 : initial_date3, derived_year3

Vue d'ensemble

Supposons que vous colliez dans l'éditeur de script des informations provenant d'un fichier texte volumineux, puis que vous souhaitiez appliquer un traitement supplémentaire aux enregistrements du jeu de données. Par exemple, vous voulez supprimer certains caractères et préfixes et capitaliser chaque terme.

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

• Table inline, Transformations, dans laquelle une transformation est définie de sorte à modifier le contenu textuel d'un champ. Le texte en cours de transformation est ajouté après cela.

• Deux instructions LOAD. Avec la configuration de l'exemple, seul le champ dérivé ProductName_Trimmed est chargé dans la table.

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension : ProductName_Trimmed.

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

• Chargement inline simple permettant de définir la table Purchases.

• Insertion d'un champ calculé, OrderSize. Ce champ est une transformation du champ amount du jeu de données inline. Il catégorise des achats comme peu importants ou importants, suivant que le montant dépasse ou non $2000.00.

• Clause where empêchant le chargement des enregistrements lorsque la valeur de amount est inférieure à $0.05.

Script de chargement

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
;

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

• ID

• amount

• OrderSize

Dans le tableau ci-dessus, la transaction avec un ID égal à 5 n'a pas été chargée dans la table. Cela est dû au fait que la valeur amount est inférieure à $0.05.

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

• Chargement inline simple permettant de définir la table T2.

• Variable NullInterpret définie sous forme de deux guillemets simples. Lors du chargement du script, les enregistrements contenant cette valeur sont traités comme des valeurs nulles.

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension : Test.

Dans le tableau ci-dessus, le premier enregistrement est une valeur nulle. Par conséquent, il n'est pas inclus dans la visualisation. Les valeurs nulles existant dans les tables avec des dimensions supplémentaires seraient indiquées par un symbole -.