Die Dateiausgabe schreibt die Ergebnisse der Data Pipeline in eine CSV-, GeoJSON- oder Apache Parquet-Datei, die in Ihren Inhalten gespeichert ist. Sie können eine neue Datei erstellen oder eine vorhandene Datei überschreiben.
Parameter
In der folgenden Tabelle werden die Parameter beschrieben, die in der Dateiausgabe verwendet werden:
| Parameter | Beschreibung |
|---|---|
Eingabe-Dataset | Das Dataset, das als Datei geschrieben wird. |
Ausgabemethode | Gibt die Methode an, die zum Schreiben der Ausgabeergebnisse verwendet wird. Die verfügbaren Optionen sind Erstellen (die Standardeinstellung) und Überschreiben. |
Dateiformat | Das Format der Datei, die geschrieben wird. Die verfügbaren Optionen sind CSV, GeoJSON und Apache Parquet. |
Geometriefeld | Das Geometriefeld, das in der resultierenden GeoJSON-Datei dargestellt wird. Dieser Parameter ist für die Dateiformate CSV und Apache Parquet nicht verfügbar. |
Räumliches Format | Das räumliche Format, das zum Schreiben der Ausgabe der Apache-Parquet-Datei verwendet wird. Gegenwärtig ist nur die Option GeoParquet 1.1 verfügbar. Dieser Parameter ist für die Dateiformate CSV und GeoJSON nicht verfügbar. |
Feld für primäre Geometrie | Das Feld für primäre Geometrie, das zum Schreiben der Ausgabe der Apache-Parquet-Datei verwendet wird. Für die GeoParquet 1.1-Spezifikationen ist ein Feld für primäre Geometrie erforderlich. Dieser Parameter ist für die Dateiformate CSV und GeoJSON nicht verfügbar. |
Titel | Der Titel des Ausgabe-Dateielements. |
Überschreiben, wenn Element bereits vorhanden ist | Gibt an, ob ein vorhandenes Element mit dem eingegebenen Ausgabenamen überschrieben wird (aktiviert). Das Überschreiben ist standardmäßig aktiviert. |
Ordner | Der Ausgabeordner, in dem die Datei gespeichert wird. |
Dateielement | Eine vorhandene Datei, die bei der nächsten Ausführung der Data Pipeline überschrieben werden soll. Diese Option ist nur verfügbar, wenn der Parameter Ausgabemethode auf Überschreiben festgelegt ist. |
Verwendungshinweise
Zum Ausführen einer Data Pipeline muss mindestens eine Ausgabe konfiguriert sein.
Verwenden Sie den Parameter Eingabe-Dataset, um das Dataset zu identifizieren, das als Datei geschrieben wird.
Verwenden Sie den Parameter Ausgabemethode, um anzugeben, wie die Data-Pipeline-Ergebnisse geschrieben werden. Die folgenden Optionen sind verfügbar:
- Erstellen: In Ihren Inhalten wird eine neue Datei erstellt. Optional können Sie den Parameter Überschreiben, wenn Element bereits vorhanden ist verwenden, um die Datei bei jeder Ausführung der Data Pipeline zu überschreiben.
- Überschreiben: Eine bereits vorhandene Datei wird vollständig überschrieben.
Die folgenden Parameter sind verfügbar, wenn die Ausgabemethode Erstellen ausgewählt ist:
- Der Parameter Dateiformat legt fest, welcher Dateityp geschrieben wird. Die verfügbaren Optionen sind CSV, GeoJSON und Apache Parquet.
- Der Parameter Geometriefeld ist nur für Dateien im Format GeoJSON verfügbar und dient zur Festlegung der Geometrie der resultierenden GeoJSON-Datei. GeoJSON-Dateien unterstützen ausschließlich das Koordinatensystem WGS84 (4326). Wenn das Geometriefeld ein anderes Koordinatensystem als WGS84 (4326) verwendet, wird es vor dem Schreiben der Daten automatisch projiziert.
- Der Parameter Feld für primäre Geometrie legt fest, welches Geometriefeld beim Schreiben einer Apache-Parquet-Datei verwendet wird. Dieser Parameter ist nur für Dateien im Format Apache-Parquet-verfügbar und gemäß den GeoParquet-1.1-Spezifikationen erforderlich. Derzeit ist GeoParquet 1.1 die einzige unterstützte Option für den Parameter Räumliches Format.
- Der Parameter Titel gibt den Namen des Elements an, das erstellt oder überschrieben wird.
- Mit dem Parameter Überschreiben, wenn Element bereits vorhanden ist können Sie die Data Pipeline erneut ausführen, ohne den Ausgabenamen zu ändern. Dieser Vorgang überschreibt eine Datei mit dem angegebenen Titel, die im angegebenen Ordner gespeichert ist, vollständig. Dieser Parameter ist standardmäßig aktiviert.
- Der Parameter Ordner legt fest, in welchem Ordner das neu erstellte Ergebnis gespeichert wird bzw. in welchem Ordner sich das zu überschreibende Element derzeit befindet.
Wenn die Ausgabemethode Überschreiben ausgewählt ist, steht der Parameter Dateielement zur Verfügung. Verwenden Sie diesen Parameter, um zu dem Element zu navigieren, das überschrieben werden soll, und es auszuwählen. Sie können Elemente überschreiben, die Sie besitzen, oder Elemente, die in einer Gruppe mit gemeinsamer Aktualisierung für Sie freigegeben sind. Wenn es sich bei dem ausgewählten Element um den Typ "GeoJSON" oder "Apache Parquet" handelt, steht ein Parameter für das Geometriefeld zur Verfügung, mit dem festgelegt werden kann, welche Geometrie aus dem Eingabe-Dataset beim Überschreiben der vorhandenen Datei verwendet werden soll.
Zum Planen automatischer Aktualisierungen von Dateien wird empfohlen, die Ausgabemethode Überschreiben anstelle der Option Überschreiben, wenn Element bereits vorhanden ist zu verwenden.
Zum Ändern der Elementeigenschaften wie beispielsweise der Zusammenfassung oder der Tags navigieren Sie im Portal zur Seite "Inhalt", und bearbeiten Sie das Element direkt.
Einschränkungen
Für die Dateiausgabe sind die folgenden Einschränkungen bekannt:
- CSV-Dateien werden immer in Tabellenform ausgegeben. Zum Speichern von Zeichenfolgen-Darstellungen einer Geometrie in einer CSV-Datei verwenden Sie das Werkzeug Felder aktualisieren, um das Geometrie-Feld in eine Zeichenfolge zu konvertieren. Verwenden Sie das Werkzeug Felder auswählen, um Geometriefelder aus einem Dataset zu entfernen, bevor dieses in eine CSV-Datei geschrieben wird.
- Ausgaben von GeoJSON-Dateien erfordern eine Geometrie und speichern Geometrien stets im Koordinatensystem WGS84 (4326), um den offiziellen GeoJSON-Spezifikationen zu entsprechen. Wenn das Geometriefeld ein anderes Koordinatensystem als WGS84 (4326) verwendet, wird es vor dem Schreiben des Elements automatisch projiziert. Wenn es sich bei dem Koordinatensystem um eine benutzerdefinierte WKT-Zeichenfolge handelt, kann die Transformation in WGS1984 (4326) möglicherweise fehlschlagen. Verwenden Sie stattdessen die Ausgabe des Feature-Layers.
- Bei der Ausgabe von Apache-Parquet-Dateien wird die Geometrie stets in einer binären Spalte gespeichert. Einige benutzerdefinierte Koordinatensysteme (WKT) werden bei der Ausgabe von Apache-Parquet-Dateien nicht unterstützt, sodass das Schreiben der Dateiausgaben fehlschlagen kann. Verwenden Sie stattdessen die Ausgabe des Feature-Layers.
- Überschreibungen werden nicht zurückgesetzt, wenn ein Schreibfehler auftritt, was zum Verlust des Elements führen kann, bis die Data Pipeline erneut ausgeführt wird.
- Beim Schreiben von Ergebnissen in Dateien werden nicht alle in Eingabequellen unterstützten Feldtypen beibehalten. Die Feldtypen werden zur Gewährleistung der Kompatibilität mit dem ausgewählten Dateiformat automatisch konvertiert.
- Sie können die Option Überschreiben nicht für Dateien verwenden, wenn Sie nicht deren Besitzer sind, es sei denn, Sie sind ein Administrator oder die Datei ist für eine Gruppe mit gemeinsamer Aktualisierung freigegeben, deren Mitglied Sie sind.
- Wenn Sie eine Kombination der Ausgabeoptionen Erstellen und Überschreiben, wenn Element bereits vorhanden ist verwenden, gelten die folgenden Einschränkungen:
- Diese Option wird für geplante oder automatisierte Ausführungen nicht empfohlen. Um eine zuverlässigere geplante Aktualisierung von Dateien zu gewährleisten, verwenden Sie die Ausgabemethode Überschreiben, navigieren Sie zu dem Dateielement, das überschrieben werden soll, und wählen Sie es explizit aus.
- Sie müssen der Besitzer des zu überschreibenden Elements sein, und es muss im angegebenen Ordner gespeichert sein. Wenn die Datei in einem anderen Ordner denselben Namen hat, wird sie nicht überschrieben.
- Überschreibungen werden nicht zurückgesetzt, wenn ein Schreibfehler auftritt, was zum Verlust des Elements führen kann, bis die Data Pipeline erneut ausgeführt wird.
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.
Verwandte Themen
Weitere Informationen finden Sie in den folgenden Themen:
- Weitere Informationen zum Aktualisieren von Elementen nach einem automatisierten Zeitplan finden Sie unter Planen eines Data-Pipeline-Tasks.
- Weitere Informationen zu Elementen finden Sie unter In ArcGIS Online unterstützte Elemente.