Eigenschaften des Multifile-Feature-Verbindungs-Datasets aktualisieren (GeoAnalytics Desktop Tools)

Zusammenfassung

Aktualisiert die Eigenschaften eines Multifile-Feature-Verbindungs-Datasets (MFC). Mit diesem Werkzeug werden die Einstellungen für Feld, Geometrie, Zeit und Datei für ein angegebenes MFC-Dataset geändert.

Verwendung

Dieses Werkzeug erfordert eine MFC. Verwenden Sie zum Erstellen einer MFC das Dialogfeld Neue Multifile-Feature-Verbindung oder das Werkzeug Multifile-Feature-Verbindung erstellen.
Verwenden Sie dieses Werkzeug, um Schema, Geometrie oder Zeit eines MFC-Datasets zu ändern, damit Sie es in Analysen oder Visualisierungen beispielsweise in den folgenden Szenarien nutzen können:
- Ihr CSV-Dataset wurde nur mit Feldern vom Typ Zeichenfolge registriert, und Sie möchten die Felder als numerisch festlegen, um sie in Analysen zu verwenden.
- Ihr MFC-Dataset weist Attributwerte für zwei getrennte Standorte auf, z. B. Ein- und Ausstiegsorte von Taxis, und Sie möchten die Geometrie ändern, um sie in Analysen zu verwenden.
- Für Ihren Workflow muss die Zeit im Eingabe-Layer festgelegt sein.
- Sie möchten ein MFC-Dataset für einen Kollegen freigeben, für den nur eine Teilmenge der Features relevant ist, also fügen Sie einen Definitionsabfrageausdruck hinzu, und blenden einige nicht verwendete Felder aus.
Sie können die folgenden Eigenschaften ändern:
- Definition query: Ein Ausdruck, mit dem die in der Analyse verwendeten Features beschränkt werden.
- Fields: Feldname, Feldtyp und Sichtbarkeit.
- Geometry: Die Darstellung der Geometrie. Sie sind für Shapefiles nicht editierbar.
- Time: Die Darstellung der Zeit.
- File: Die zum Lesen des Datasets verwendeten Dateieigenschaften.
Verwenden Sie das Dialogfeld Neue Multifile-Feature-Verbindung, in dem Sie problemlos eine Multifile-Feature-Verbindung erstellen, bearbeiten und in der Vorschau anzeigen können.
Geben Sie mit dem Parameter Multifile-Feature-Verbindungs-Dataset das MFC-Dataset mit den Eigenschaften an, die Sie ändern möchten. Sie können zum Dataset navigieren oder es mit einem Pfad wie c:\<path>\MyMFC.mfc\<dataset_name> angeben, z. B. c:\MyMFCFolder\MyMFC.mfc\earthquakes_dataset.
Definieren Sie mit dem Parameter Ausdruck einen Ausdruck, um die in der Analyse verwendeten Features zu beschränken. Das Hinzufügen eines Filters zu einem MFC-Dataset ist mit dem Anwenden einer Definitionsabfrage auf ein Dataset in einer Karte vergleichbar: Sie geben einen SQL-Ausdruck an, um relevante Features zu filtern.
Sie können den Feldtyp für durch Trennzeichen getrennte Dateien aktualisieren. Für andere Datenquellen (wie Shapefiles, ORC- oder Parquet-Dateien) können Sie den Feldtyp nicht aktualisieren.
Sie können die Geometrie für durch Trennzeichen getrennte, ORC- und Parquet-Dateien ändern. Sie können die Geometrie nicht für ein Dataset mit einem Shapefile als Quelle ändern.

In der folgenden Tabelle ist dargestellt, wie Zeitformate für die Parameter Startzeit und Endzeit angegeben werden, wenn Sie ein MFC-Dataset bearbeiten. Das Beispiel zeigt, wie der 2. Januar 2016, um 21:45:02,05 Uhr dargestellt wird.

Zeitformate in Multifile-Feature-Verbindungen


Symbol	Bedeutung	Beispiel
yy	Das Jahr – durch zwei Ziffern dargestellt.	`16`
JJJJ	Das Jahr – durch vier Ziffern dargestellt.	`2016`
MM	Der Monat – als numerischer Wert dargestellt.	`01` oder `1`
MMM	Der Monat – durch drei Buchstaben dargestellt.	`Jan`
MMMM	Der Monat – vollständig ausgeschrieben.	`January`
dd	Der Tag.	`02` oder `2`
HH	Die Stunde – wobei das 24-Stunden-Format mit Werten von 0 bis 23 verwendet wird.	`21`
hh	Die Stunde – wobei das 12-Stunden-Format mit Werten von 1 bis 12 verwendet wird.	`9`
mm	Die Minute – Werte liegen zwischen 0 und 59.	`45`
ss	Die Sekunde – Werte liegen zwischen 0 und 59.	`02`
SSS	Die Millisekunde – Werte liegen zwischen 0 und 999.	`50`
a	Der AM/PM-Marker.	`PM`
epoch_millis	Die Zeit in Millisekunden von der Unixzeit.	`1509581781000`
epoch_seconds	Die Zeit in Sekunden von der Unixzeit.	`1509747601`
Z	Der Zeitzonenversatz, ausgedrückt in Stunden.	`-0100` oder `-01:00`
ZZZ	Der Zeitzonenversatz, ausgedrückt in Zeitzonen-IDs.	`America/Los_Angeles`
''	Verwenden Sie einzelne Anführungszeichen, um Text hinzuzufügen, der keinen in dieser Tabelle angegebenen Wert darstellt.	`'T'`

In der folgenden Tabelle sind Beispiele verschiedener Formate für dasselbe Datum, den 2. Januar 2016 um 21:45:02,05 Uhr, dargestellt:

Beispiele für Zeitformate


Eingabedatum	Datumsformat
01/02/2016 9:45:02PM	MM/dd/yyyy hh:mm:ssa
Jan02-16 21:45:02	MMMdd-yy HH:mm:ss
Januar 02 2016 9:45:02.050PM	MMMM dd yyyy hh:mm:ss.SSSa
01/02/2017T9:45:14:05-0000	MM/TT/JJJJ hh:mm:ssa

Sie können die Zeitzone auf eine der folgenden Arten festlegen:

Der vollständige Name der Zeitzone, z. B. "Pacific Normalzeit"
Mit dem Zeitzonenversatz, ausgedrückt in Stunden: -0100 oder -01:00
Mit der UTC- oder GMT-Abkürzung

Sie können die folgenden Eigenschaften einer durch Trennzeichen getrennten Datei ändern:
- Field Delimiter—Das Trennzeichen für jedes Feld. Gebräuchliche Trennzeichen sind Komma (,) und Semikolon (;).
- Record Terminator—Das Abschlusszeichen für jede Datenzeile. Gebräuchliche Datensatzabschlusszeichen sind \n und \t.
- Quote Character—Das verwendete Anführungszeichen im Quellen-Dataset.
- Has Header Row—Der Wert "True" oder "False" zur Angabe, ob das Quellen-Dataset Überschriften aufweist. Wenn eine Kopfzeile im Dataset enthalten ist, werden die Überschriften für die Feldnamen verwendet.
- Encoding—Der vom Quellen-Dataset verwendete Codierungstyp. Die Standardeinstellung ist UTF-8.
Das Werkzeug Eigenschaften des Multifile-Feature-Verbindungs-Datasets aktualisieren aktualisiert die Eigenschaften eines einzelnen Datasets. Mit den folgenden Werkzeugen können Sie die MFC ändern:
- Dataset aus Multifile-Feature-Verbindung kopieren: Kopiert ein Dataset aus einer MFC in eine Feature-Class.
- Dataset aus Multifile-Feature-Verbindung duplizieren: Erstellt eine Sicht eines vorhandenen MFC-Datasets.
- [Multifile-Feature-Verbindung aktualisieren]: Prüfen Sie auf neue Datasets, und fügen Sie sie der MFC hinzu.
- Dataset aus Multifile-Feature-Verbindung entfernen: Entfernt ein Dataset aus der MFC.
- Eigenschaften des Multifile-Feature-Verbindungs-Datasets aktualisieren: Ändert die Eigenschaften eines einzelnen MFC-Datasets.
- Vorschau von Dataset aus Multifile-Feature-Verbindung anzeigen: Zeigt eine Vorschau der ersten 10 Features im Dataset an, um zu überprüfen, ob sie richtig registriert wurden.
- Dataset beschreiben: Überprüft, ob das Dataset wie erwartet dargestellt wird.
Sie können optional die MFC-Datei manuell bearbeiten. In den folgenden Situationen sollten Sie die .mfc-Datei immer manuell ändern:
- Die X-, Y- oder Z-Position wird von einem oder mehreren Feldern dargestellt.
- Sie möchten den Quellenpfad aktualisieren.
Erfahren Sie mehr über die Formatierung von Multifile-Feature-Verbindungsdateien.
Dieses Geoverarbeitungswerkzeug wird unterstützt durch Spark. Weitere Informationen zu Multifile-Feature-Verbindungen (MFC) und ihrer Verwendung finden Sie unter "Multifile-Feature-Verbindungen".

Beschriftung	Erläuterung	Datentyp
Multifile-Feature-Verbindungs-Dataset	Das MFC-Dataset, das aktualisiert wird. Die Bearbeitungsoptionen hängen von den Quelldaten ab (Shapefile, durch Trennzeichen getrennte Datei, ORC- oder Parquet-Datei).	Table View
Ausdruck (Optional)	in Ausdruck, mit dem die in der Analyse verwendeten Features beschränkt werden.	SQL Expression
Feldeigenschaften (Optional)	Gibt die Feldnamen und -eigenschaften an, die geändert werden. Spalten der Wertetabelle: Name—The field name. Type—Specifies the field type. Short—The field will be type short. Long—The field will be type long. Double—The field will be type double. Float—The field will be type float. String—The field will be type string. Date—The field will be type date. Blob—The field will be type BLOB. Big Integer—The field will be type big integer. Show—Specifies whether fields will be visible or hidden for use in geoprocessing tools. Fields will be visible by default.	Value Table
Geometrie-Typ (Optional)	Gibt den Geometrietyp an, der für die räumliche Darstellung des Datasets verwendet wird. Die Geometrie kann für Datasets mit einem Shapefile als Quelle nicht geändert werden. Punkt—Der Geometrietyp lautet "Punkt". Polylinie—Der Geometrietyp lautet "Polylinie". Polygon—Der Geometrietyp lautet "Polygon". Keine—Es ist kein Geometrietyp angegeben.	String
Raumbezug (Optional)	Der WKID-Wert oder die WKT-Zeichenfolge für den Raumbezug des Datasets. Die Standardeinstellung ist WKID 4326 (WGS84). Der Raumbezug kann für Daten mit einem Shapefile als Quelle nicht geändert werden.	String
Geometrieformattyp (Optional)	Gibt an, wie die Geometrie formatiert wird. Die Geometrie kann für Daten mit einem Shapefile als Quelle nicht geändert werden. XYZ—Zwei oder mehr Felder stellen X, Y und optional Z dar. WKT—Die Geometrie wird mit einem einzelnen Feld in einem Well-Known-Text-Feld dargestellt. WKB—Die Geometrie wird mit einem einzelnen Feld in einem Well-Kown-Binary-Feld dargestellt. GeoJSON—Die Geometrie wird mit einem einzelnen Feld im GeoJSON-Format dargestellt. EsriJSON—Die Geometrie wird mit einem einzelnen Feld im EsriJSON-Format dargestellt. EsriShape—Die Geometrie wird mit einem einzelnen Feld im EsriShape-Format dargestellt.	String
Geometriefeld (Optional)	Ein einzelnes Feld zur Darstellung der Geometrie. Dieses Feld wird verwendet, wenn das Geometrieformat WKT, WKB, GeoJSON, EsriJSON oder EsriShape ist.	String
X-Feld (Optional)	Das Feld zur Darstellung der X-Position. Wenn mehr als ein Feld die X-Position darstellt, ändern Sie die `.mfc`-Datei manuell.	String
Y-Feld (Optional)	Das Feld zur Darstellung der Y-Position. Wenn mehr als ein Feld die Y-Position darstellt, ändern Sie die `.mfc`-Datei manuell.	String
Z-Feld (Optional)	Das Feld zur Darstellung der Z-Position. Wenn mehr als ein Feld die Z-Position darstellt, ändern Sie die `.mfc`-Datei manuell.	String
Zeittyp (Optional)	Gibt den Zeittyp an, mit dem das Dataset zeitlich dargestellt wird. Intervall—Der Zeittyp stellt eine Zeitdauer mit einer Start- und Endzeit dar. Zeitpunkt—Der Zeittyp stellt einen bestimmten Zeitpunkt dar. Keine—Zeit ist nicht aktiviert.	String
Zeitzone (Optional)	Die Zeitzone des Datasets.	String
Startzeit (Optional)	Die Felder, mit denen die Startzeit und die Zeitformatierung definiert werden. Spalten der Wertetabelle: Name—The field name. Short—The field type will be short. Long—The field type will be long. Big Integer—The field type will be big integer. Float—The field type will be float. Double—The field type will be double. Text—The field type will be text. Date—The field type will be date. Format—The field format.	Value Table
Endzeit (Optional)	Die Felder, mit denen die Endzeit und die Zeitformatierung definiert werden. Spalten der Wertetabelle: Name—The field name. Short—The field type will be short. Long—The field type will be long. Big Integer—The field type will be big integer. Float—The field type will be float. Double—The field type will be double. Text—The field type will be text. Date—The field type will be date. Format—The field format.	Value Table
Dateierweiterung (Optional)	Die Dateierweiterung des Quellen-Datasets. Der Parameterwert kann nicht geändert werden.	String
Feldtrennzeichen (Optional)	Das im Quellen-Dataset verwendete Feldtrennzeichen.	String
Datensatzabschlusszeichen (Optional)	Das im Quellen-Dataset verwendete Datensatzabschlusszeichen.	String
Anführungszeichen (Optional)	Das im Quellen-Dataset verwendete Anführungszeichen.	String
Hat Kopfzeile (Optional)	Gibt an, ob das Quellen-Dataset eine Kopfzeile aufweist. Aktiviert—Das Quellen-Dataset weist eine Kopfzeile auf. Deaktiviert—Das Quellen-Dataset weist keine Kopfzeile auf.	Boolean
Encodierung (Optional)	Der Typ der für das Quellen-Dataset verwendeten Codierung. Standardmäßig wird UTF-8 verwendet.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte MFC	Die aktualisierte MFC-Datei mit den bearbeiteten Eigenschaften, die auf das angegebene Dataset angewendet wird.	File

arcpy.gapro.UpdateBDCDatasetProperties(bdc_dataset, {expression}, {field_properties}, {geometry_type}, {spatial_reference}, {geometry_format_type}, {geometry_field}, {x_field}, {y_field}, {z_field}, {time_type}, {time_zone}, {start_time_format}, {end_time_format}, {file_extension}, {field_delimiter}, {record_terminator}, {quote_character}, {has_header_row}, {encoding})

Name	Erläuterung	Datentyp
bdc_dataset	Das MFC-Dataset, das aktualisiert wird. Die Bearbeitungsoptionen hängen von den Quelldaten ab (Shapefile, durch Trennzeichen getrennte Datei, ORC- oder Parquet-Datei).	Table View
expression (Optional)	in Ausdruck, mit dem die in der Analyse verwendeten Features beschränkt werden.	SQL Expression
field_properties [field_properties,...] (Optional)	Gibt die Feldnamen und -eigenschaften an, die geändert werden. Spalten der Wertetabelle: `Name`—The field name. `Type`—Specifies the field type. `SHORT`—The field will be type short. `LONG`—The field will be type long. `DOUBLE`—The field will be type double. `FLOAT`—The field will be type float. `STRING`—The field will be type string. `DATE`—The field will be type date. `BLOB`—The field will be type BLOB. `BIG_INTEGER`—The field will be type big integer. `Show`—Specifies whether fields will be visible or hidden for use in geoprocessing tools. Fields will be visible by default.	Value Table
geometry_type (Optional)	Gibt den Geometrietyp an, der für die räumliche Darstellung des Datasets verwendet wird. Die Geometrie kann für Datasets mit einem Shapefile als Quelle nicht geändert werden. `POINT`—Der Geometrietyp lautet "Punkt". `LINE`—Der Geometrietyp lautet "Polylinie". `POLYGON`—Der Geometrietyp lautet "Polygon". `NONE`—Es ist kein Geometrietyp angegeben.	String
spatial_reference (Optional)	Der WKID-Wert oder die WKT-Zeichenfolge für den Raumbezug des Datasets. Die Standardeinstellung ist WKID 4326 (WGS84). Der Raumbezug kann für Daten mit einem Shapefile als Quelle nicht geändert werden.	String
geometry_format_type (Optional)	Gibt an, wie die Geometrie formatiert wird. Die Geometrie kann für Daten mit einem Shapefile als Quelle nicht geändert werden. `XYZ`—Zwei oder mehr Felder stellen X, Y und optional Z dar. `WKT`—Die Geometrie wird mit einem einzelnen Feld in einem Well-Known-Text-Feld dargestellt. `WKB`—Die Geometrie wird mit einem einzelnen Feld in einem Well-Kown-Binary-Feld dargestellt. `GEOJSON`—Die Geometrie wird mit einem einzelnen Feld im GeoJSON-Format dargestellt. `ESRIJSON`—Die Geometrie wird mit einem einzelnen Feld im EsriJSON-Format dargestellt. `ESRISHAPE`—Die Geometrie wird mit einem einzelnen Feld im EsriShape-Format dargestellt.	String
geometry_field (Optional)	Ein einzelnes Feld zur Darstellung der Geometrie. Dieses Feld wird verwendet, wenn das Geometrieformat WKT, WKB, GeoJSON, EsriJSON oder EsriShape ist.	String
x_field (Optional)	Das Feld zur Darstellung der X-Position. Wenn mehr als ein Feld die X-Position darstellt, ändern Sie die `.mfc`-Datei manuell.	String
y_field (Optional)	Das Feld zur Darstellung der Y-Position. Wenn mehr als ein Feld die Y-Position darstellt, ändern Sie die `.mfc`-Datei manuell.	String
z_field (Optional)	Das Feld zur Darstellung der Z-Position. Wenn mehr als ein Feld die Z-Position darstellt, ändern Sie die `.mfc`-Datei manuell.	String
time_type (Optional)	Gibt den Zeittyp an, mit dem das Dataset zeitlich dargestellt wird. `INTERVAL`—Der Zeittyp stellt eine Zeitdauer mit einer Start- und Endzeit dar. `INSTANT`—Der Zeittyp stellt einen bestimmten Zeitpunkt dar. `NONE`—Zeit ist nicht aktiviert.	String
time_zone (Optional)	Die Zeitzone des Datasets.	String
start_time_format [start_time_format,...] (Optional)	Die Felder, mit denen die Startzeit und die Zeitformatierung definiert werden. Spalten der Wertetabelle: `Name`—The field name. `Short`—The field type will be short. `Long`—The field type will be long. `BigInteger`—The field type will be big integer. `Float`—The field type will be float. `Double`—The field type will be double. `Text`—The field type will be text. `Date`—The field type will be date. `Format`—The field format.	Value Table
end_time_format [end_time_format,...] (Optional)	Die Felder, mit denen die Endzeit und die Zeitformatierung definiert werden. Spalten der Wertetabelle: `Name`—The field name. `Short`—The field type will be short. `Long`—The field type will be long. `BigInteger`—The field type will be big integer. `Float`—The field type will be float. `Double`—The field type will be double. `Text`—The field type will be text. `Date`—The field type will be date. `Format`—The field format.	Value Table
file_extension (Optional)	Die Dateierweiterung des Quellen-Datasets. Der Parameterwert kann nicht geändert werden.	String
field_delimiter (Optional)	Das im Quellen-Dataset verwendete Feldtrennzeichen.	String
record_terminator (Optional)	Das im Quellen-Dataset verwendete Datensatzabschlusszeichen.	String
quote_character (Optional)	Das im Quellen-Dataset verwendete Anführungszeichen.	String
has_header_row (Optional)	Gibt an, ob das Quellen-Dataset eine Kopfzeile aufweist. `HAS_HEADER`—Das Quellen-Dataset weist eine Kopfzeile auf. `NO_HEADER`—Das Quellen-Dataset weist keine Kopfzeile auf.	Boolean
encoding (Optional)	Der Typ der für das Quellen-Dataset verwendeten Codierung. Standardmäßig wird UTF-8 verwendet.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_bdc	Die aktualisierte MFC-Datei mit den bearbeiteten Eigenschaften, die auf das angegebene Dataset angewendet wird.	File

Codebeispiel

UpdateBDCDatasetProperties: Beispiel (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion UpdateBDCDatasetProperties verwendet wird.

# Name: UpdateBDCDatasetProperties.py
# Description: Add a filter and modify the schema, time, and geometry for a MFC dataset
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
dataset = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc\myBigDataset"
filter = "COUNT > 500"
field_properties = "Field1 FLOAT true;Field2 STRING true;Field3 DOUBLE true"
geometry_type = "POINT"
sref = "4326"
geometry_format = "XYZ"
x_field = "Long"
y_field = "Lat"
z_field = ""
time_type = "INSTANT"
time_zone = "UTC"
time_formats = "Year yyyy"
file_extension = "csv"
file_delimiter = ","
file_terminator = r"\n"
file_quotechar = '"'
has_header_row = True
file_encoding = "UTF-8"

# Run Update MFC Dataset Properties
arcpy.gapro.UpdateBDCDatasetProperties(dataset, filter, field_properties, geometry_type, sref, geometry_format, "",
x_field, y_field, z_field, time_type, time_zone, time_formats, None, file_extension, file_delimiter, file_terminator,
file_quotechar, has_header_row, file_encoding)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Nein
Standard: Nein
Advanced: Ja

Eigenschaften des Multifile-Feature-Verbindungs-Datasets aktualisieren (GeoAnalytics Desktop Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen