L’outil Désimbriquer le champ renvoie des valeurs stockées dans des champs de type tableau, carte ou struct sous la forme de nouveaux champs ou de nouvelles lignes.
Exemples
L’outil Désimbriquer le champ peut, par exemple, être utilisé dans les scénarios suivants :
- Pour aplatir les tableaux de valeurs en nouvelles lignes
- Pour renvoyer les propriétés imbriquées depuis un champ de type struct ou carte sous la forme de nouveaux champs
Paramètres
Le tableau suivant décrit les paramètres utilisés dans l’outil Désimbriquer le champ :
| Paramètre | Description |
|---|---|
Jeu de données en entrée | Jeu de données comprenant le champ de type tableau, struct ou carte à désimbriquer. |
Unnest field (Désimbriquer le champ) | Champ de type tableau, struct ou carte à désimbriquer. |
Nom de champ en sortie | Nom du champ qui comprend les valeurs de tableau désimbriquées. Ce paramètre est facultatif et est disponible uniquement si le champ à désimbriquer est de type tableau. |
Output key field name (Nom du champ de clé en sortie) | Nom du champ qui comprend les clés de carte désimbriquées. Ce paramètre est facultatif et est disponible uniquement si le champ à désimbriquer est de type carte. |
Output value field name (Nom du champ de la valeur en sortie) | Nom du champ qui comprend les valeurs de carte désimbriquées. Ce paramètre est facultatif et est disponible uniquement si le champ à désimbriquer est de type carte. |
Remarques sur l’utilisation
Utilisez le paramètre Input dataset (Jeu de données en entrée) pour sélectionner le jeu de données contenant le champ à désimbriquer.
Utilisez le paramètre Unnest field (Désimbriquer le champ) pour spécifier le champ de type tableau, carte ou struct à désimbriquer. La sortie comporte de nouvelles lignes et de nouveaux champs contenant les valeurs du champ spécifié.
Le paramètre Output field name (Nom du champ en sortie) est facultatif et disponible lorsque le champ à désimbriquer est de type tableau. Utilisez ce paramètre pour renommer le champ obtenu comprenant les valeurs désimbriquées. Par défaut, le champ en sortie porte le même nom que le champ en entrée à désimbriquer.
Les paramètres Output key field name (Nom du champ de clé en sortie) et Output value field name (Nom du champ de la valeur en sortie) sont facultatifs et disponibles lorsque le champ à désimbriquer est de type carte. Utilisez ce paramètre pour renommer les champs obtenus comprenant les clés et valeurs désimbriquées. Par défaut, les champs en sortie portent le même nom que le champ en entrée, auquel "_KEY" ou "_VALUE" est ajouté.
Les champs struct sont désimbriqués vers de nouveaux champs dont le nom repose sur les propriétés struct.
Sorties
L’outil génère en sortie le jeu de données en entrée contenant de nouvelles lignes ou de nouveaux champs issus du champ désimbriqué. Chaque type de champ pris en charge est désimbriqué comme suit :
- Array (Tableau) – Les valeurs d’un champ de type tableau sont renvoyées dans un champ contenant une ligne pour chaque valeur du tableau. L’image suivante est un exemple de désimbrication d’un champ de type tableau en entrée :
- Map (Carte) – Les valeurs d’un champ de type carte sont renvoyées dans deux nouveaux champs qui représentent les clés et les valeurs dans la carte. Les champs contiennent respectivement les clés et les valeurs. L’image suivante est un exemple de désimbrication d’un champ de type carte en entrée :
- Struct – Les champs struct sont renvoyés sous la forme de nouveaux champs pour chaque propriété du champ struct. Les champs contiennent les valeurs de chaque propriété. L’image suivante est un exemple de désimbrication d’un champ struct en entrée :
Limitations
L’outil ne résout qu’un seul niveau de désimbrication. Par exemple, si le champ en entrée est un tableau de structures, la sortie correspond à de nouvelles lignes contenant les structures. Pour désimbriquer les structures, vous devez configurer un autre outil Désimbriquer.
Licences requises
Les licences et configurations suivantes sont requises :
- Type d’utilisateur Creator ou Professional
- Rôle d’éditeur, de facilitateur ou d’administrateur, ou rôle personnalisé équivalent
Afin d’en savoir plus sur la configuration requise pour Data Pipelines, reportez-vous à la rubrique Conditions requises.
Vous avez un commentaire à formuler concernant cette rubrique ?