La herramienta Desanidar campo devuelve valores almacenados en campos de matriz, mapa o struct como nuevos campos o filas.
Ejemplos
La herramienta Desanidar campo puede utilizarse en situaciones como las siguientes:
- Aplanar matrices de valores en nuevas filas
- Devolver propiedades anidadas de un campo de mapa o struct como campos nuevos
Parámetros
La siguiente tabla muestra los parámetros utilizados en la herramienta Desanidar campo:
| Parámetro | Descripción |
|---|---|
Dataset de entrada | El dataset que contiene el campo de matriz, struct o de mapa que se va a desanidar. |
Desanidar campo | El campo de matriz, struct o de mapa que se desanidará. |
Nombre de campo de salida | El nombre del campo que contendrá los valores de la matriz desanidada. Este parámetro es opcional y solo está disponible cuando el campo desanidado es de tipo matriz. |
Nombre de campo de clave de salida | El nombre del campo que contendrá las claves del mapa desanidado. Este parámetro es opcional y solo está disponible cuando el campo desanidado es de tipo mapa. |
Nombre de campo de valor de salida | El nombre del campo que contendrá los valores del mapa desanidado. Este parámetro es opcional y solo está disponible cuando el campo desanidado es de tipo mapa. |
Notas de uso
Utilice el parámetro Dataset de entrada para seleccionar el dataset que contiene el campo que desea desanidar.
Utilice el parámetro Desanidar campo para especificar el campo de matriz, mapa o struct que se va a desanidar. La salida contendrá nuevas filas y campos con los valores del campo especificado.
El nombre del campo de salida está disponible opcionalmente cuando el campo que se va a desanidar es de tipo matriz. Utilice este parámetro para cambiar el nombre del campo resultante con los valores desanidados. De forma predeterminada, el campo de salida tendrá el mismo nombre que el campo de entrada que se va a desanidar.
El nombre del campo clave de salida y el nombre del campo de valor de salida están disponibles opcionalmente cuando el campo que se va a desanidar es de tipo mapa. Utilice este parámetro para cambiar el nombre de los campos resultantes con los valores y claves desanidados. De forma predeterminada, los campos de salida tendrán el mismo nombre que el campo de entrada, al que se le añade "_KEY" o "_VALUE".
Los campos struct se desanidarán en campos nuevos con nombres basados en las propiedades struct.
Salidas
La herramienta genera el dataset de entrada con nuevas filas o campos del campo desanidado. A continuación se describe cómo se desanidará cada tipo de campo admitido:
- Matriz: los valores de los campos de matriz se devolverán en un campo con una fila para cada valor de la matriz. La siguiente imagen es un ejemplo de cómo se desanidará un campo de matriz de entrada:
- Mapa: los valores de los campos de mapa se devolverán en dos campos nuevos que representan las claves y los valores del mapa. Los campos contendrán las claves y los valores, respectivamente. La siguiente imagen es un ejemplo de cómo se desanidará un campo de mapa de entrada:
- Struct: los campos struct se devolverán como campos nuevos para cada propiedad struct. Los campos contendrán los valores de cada propiedad. La siguiente imagen es un ejemplo de cómo se desanidará un campo struct de entrada:
Limitaciones
La herramienta solo resolverá un único nivel de anidamiento. Por ejemplo, si el campo de entrada es una matriz de structs, la salida serán nuevas filas con structs. Para desanidar structs, necesitará configurar otra herramienta de desanidación.
Requisitos de licencia
Se requieren las siguientes licencias y configuraciones:
- Tipo de usuario Creator o Professional
- Rol de publicador, moderador o administrador, o rol personalizado equivalente
Para obtener más información sobre los requisitos de Data Pipelines, consulte Requisitos.