Das Werkzeug Verschachtelung des Feldes aufheben gibt in Feldern des Typs "Array", "Karte" oder "Struct" gespeicherte Werte als neue Felder oder Zeilen zurück.
Beispiele
Das Werkzeug Verschachtelung des Feldes aufheben kann beispielsweise in folgenden Szenarien verwendet werden:
- Reduzieren von Werte-Arrays in neue Zeilen
- Zurückgeben von verschachtelten Eigenschaften aus Feldern des Typs "Struct" oder "Karte" als neue Felder
Parameter
In der folgenden Tabelle werden die Parameter beschrieben, die im Werkzeug Verschachtelung des Feldes aufheben verwendet werden:
| Parameter | Beschreibung |
|---|---|
Eingabe-Dataset | Das Dataset, das das Feld des Typs "Array", "Struct" oder "Karte" enthält, dessen Verschachtelung aufgehoben werden soll. |
Verschachtelung des Feldes aufheben | Das Feld des Typs "Array", "Struct" oder "Karte", dessen Verschachtelung aufgehoben wird. |
Ausgabefeldname | Der Name des Feldes, das die nicht verschachtelten Array-Werte enthalten soll. Dieser Parameter ist optional und nur verfügbar, wenn das nicht verschachtelte Feld des Typs "Array" ist. |
Ausgabeschlüssel-Feldname | Der Name des Feldes, das die nicht verschachtelten Legendenelemente enthalten soll. Dieser Parameter ist optional und nur verfügbar, wenn das nicht verschachtelte Feld des Typs "Karte" ist. |
Ausgabewert-Feldname | Der Name des Feldes, das die nicht verschachtelten Kartenwerte enthalten soll. Dieser Parameter ist optional und nur verfügbar, wenn das nicht verschachtelte Feld des Typs "Karte" ist. |
Verwendungshinweise
Wählen Sie mithilfe des Parameters Eingabe-Dataset das Dataset aus, das das Feld enthält, dessen Verschachtelung aufgehoben werden soll.
Geben Sie mit dem Parameter Verschachtelung des Feldes aufheben das Feld des Typs "Array", "Karte" oder "Struct" an, dessen Verschachtelung aufgehoben werden soll. Die Ausgabe enthält neue Zeilen und Felder mit den Werten aus dem angegebenen Feld.
Ausgabefeldname ist optional verfügbar, wenn das Feld, dessen Verschachtelung aufgehoben werden soll, des Typs "Array" ist. Verwenden Sie diesen Parameter, um das resultierende Feld, das die nicht verschachtelten Werte enthält, umzubenennen. Standardmäßig heißt das Ausgabefeld genauso wie das Eingabefeld, dessen Verschachtelung aufgehoben werden soll.
Ausgabeschlüssel-Feldname und Ausgabewert-Feldname sind optional verfügbar, wenn das Feld, dessen Verschachtelung aufgehoben werden soll, des Typs "Karte" ist. Verwenden Sie diesen Parameter, um das resultierende Feld, das die nicht verschachtelten Schlüssel und Werte enthält, umzubenennen. Standardmäßig heißen die Ausgabefelder genauso wie das Name des Eingabefeldes mit dem Zusatz "_KEY" oder "_VALUE".
Die Verschachtelung von Struct-Felder wird aufgehoben, und es werden neue Felder mit Namen basierend auf den Struct-Eigenschaften erstellt.
Ausgaben
Das Werkzeug gibt das Eingabe-Datenset mit neuen Zeilen oder Feldern aus dem nicht verschachtelten Feld aus. Im Folgenden wird erläutert, wie die Verschachtelung der einzelnen unterstützten Feldtypen aufgehoben wird:
- Array: Die Werte im Feld des Typs "Array" werden in einem Feld zurückgegeben, das für jeden Wert im Array eine Zeile enthält. In der folgenden Abbildung sehen Sie an einem Beispiel, wie die Verschachtelung eines Eingabefeldes des Typs "Array" aufgehoben wird:
- Karte: Die Werte im Feld des Typs "Karte" werden in zwei neuen Feldern zurückgegeben, die die Schlüssel und Werte in der Karte darstellen. Die Felder enthalten die Schlüssel bzw. Werte. In der folgenden Abbildung sehen Sie an einem Beispiel, wie die Verschachtelung eines Eingabefeldes des Typs "Karte" aufgehoben wird:
- Struct: Felder des Typs "Struct" werden als neue Felder für jede Struct-Eigenschaft zurückgegeben. Die Felder enthalten die Werte für jede Eigenschaft. In der folgenden Abbildung sehen Sie an einem Beispiel, wie die Verschachtelung eines Eingabefeldes des Typs "Struct" aufgehoben wird:
Einschränkungen
Das Werkzeug löst nur eine einzelne Verschachtelungsebene. Wenn das Eingabefeld beispielsweise ein Array von Strukturen ist, besteht die Ausgabe aus neuen Zeilen, die Strukturen enthalten. Um die Verschachtelung der Strukturen aufzuheben, muss ein weiteres Werkzeug zum Aufheben der Verschachtelung konfiguriert werden.
Lizenzanforderungen
Die folgenden Lizenzen und Konfigurationen werden benötigt:
- Benutzertyp Creator oder Professional
- Publisher-, Vermittler- oder Administratorrolle oder eine entsprechende benutzerdefinierte Rolle
Weitere Informationen zu den Anforderungen für Data Pipelines finden Sie unter Anforderungen.