Multifile-Feature-Verbindung aktualisieren (GeoAnalytics Desktop)

Zusammenfassung

Aktualisiert eine bestehende Multifile-Feature-Verbindung (MFC) und registriert neue Datasets, die zum Quellspeicherort hinzugefügt wurden.

Verwendung

• Dieses Werkzeug erfordert eine MFC. Verwenden Sie zur Erstellung einer MFC das Werkzeug Multifile-Feature-Verbindung erstellen.

• Verwenden Sie dieses Werkzeug, um ein oder mehrere Datasets zu einer bestehenden Multifile-Feature-Verbindung hinzuzufügen. Darüber hinaus registriert das Werkzeug alle Datasets neu, die mit dem Werkzeug Dataset aus Multifile-Feature-Verbindung entfernen entfernt wurden. Nachfolgend finden Sie Beispiele für den Einsatz dieses Werkzeugs:

  • Sie haben einen Ordner mit Daten in Ihren vorhandenen MFC-Quellordner kopiert und möchten, dass er als Dataset in der MFC dargestellt wird.
  • Sie haben das Werkzeug Dataset aus Multifile-Feature-Verbindung entfernen verwendet und möchten die entfernten Datasets wieder zur MFC hinzufügen.

• Mit diesem Werkzeug werden die vorhandenen Dataset-Eigenschaften, die mit dem Werkzeug Eigenschaften des Multifile-Feature-Verbindungs-Datasets aktualisieren bearbeitet wurden, nicht aktualisiert. Alle geänderten Eigenschaften bleiben erhalten. Die folgenden Szenarien enthalten empfohlene Workflows:

  • Sie haben das Schema eines vorhandenen Quellen-Datasets geändert: Ändern Sie die Felder mit dem Werkzeug Eigenschaften des Multifile-Feature-Verbindungs-Datasets aktualisieren. Sie können auch mit dem Werkzeug Dataset aus Multifile-Feature-Verbindung entfernen das Dataset entfernen und dann das Werkzeug Multifile-Feature-Verbindung aktualisieren verwenden, wenn es keine Änderungen am MFC-Dataset gibt, die Sie behalten möchten.
  • Sie haben neue Dateien zu einem vorhandenen Dataset hinzugefügt: Es sind keine weiteren Schritte erforderlich. Wenn Sie ein Geoverarbeitungswerkzeug zur Analyse Ihrer MFC-Daten ausführen, werden alle Dateien im MFC-Dataset für die Analyse berücksichtigt.
  • Sie haben ein vorhandenes Dataset gelöscht: Entfernen Sie das Dataset mit dem Werkzeug Dataset aus Multifile-Feature-Verbindung entfernen aus der MFC.

• Die Werkzeugmeldungen enthalten die folgenden Informationen zu den ermittelten Datasets und deren Status:

  • Übersprungen: Alle vorhandenen Datasets werden bei der Aktualisierung übersprungen und bleiben unverändert bestehen.
  • Erfolgreich: Neue Datasets, die ermittelt und zur MFC hinzugefügt wurden.
  • Fehlgeschlagen: Datasets, die nicht erfolgreich zur MFC hinzugefügt wurden.

  Beim Ermitteln von Datasets in Ihrer MFC können zwei Probleme auftreten:

  • Erwartete Datasets fehlen. Überprüfen Sie in diesem Fall, ob der als Quellordner angegebene Pfad, der die Unterordner enthält, richtig ist und einen unterstützten Datentyp aufweist.
  • Mindestens ein Dataset wird nicht registriert. Wenn Datasets nicht registriert werden, könnte Ihnen Folgendes auffallen:

    Problem	Lösung	Beispiel
    Das Dataset hat nicht das erwartete Format.	Öffnen Sie die Datei, um festzustellen, ob sie wie erwartet aussieht. Wenn die Daten falsch strukturiert sind, ändern Sie dies, und versuchen Sie es erneut.	Eine .csv-Datei enthält einige Zeilen und eine Zusammenfassung der Daten und dann nur leere Zeilen.
    Die Schemas von Datasets in einem Ordner stimmen nicht überein.	Alle Dateien in einem Dataset-Ordner müssen das gleiche Schema aufweisen. Öffnen Sie die Dateien, um die Schemas zu vergleichen. Beheben Sie Schemakonflikte, und wiederholen Sie das Registrieren des Datasets.	Sie haben eine .csv-Datei mit 10 Feldern und eine mit 8.
    Die Dateitypen eines Datasets in einem Ordner stimmen nicht überein.	Alle Dateien in einem Dataset-Ordner müssen die gleiche Erweiterung (Dateityp) aufweisen. Überprüfen Sie die Dateitypen des Datenquellenspeicherorts, und entfernen oder verschieben Sie falsch platzierte Dateien.	Ein Shapefile-Dataset befindet sich im gleichen Ordner wie eine Parquet-Datei.
    Ein Feldformat wurde nicht erkannt.	Dies ist unwahrscheinlich, aber möglich, wenn ORC und Parquet ein unerwartetes Format verwenden. Stellen Sie sicher, dass Sie gültige Feldformate verwenden.	Sie haben eine Parquet-Datei mit einem unbekannten Feldformat.

  Weitere Informationen zu den Gründen, aus denen Datasets nicht zu einer MFC-Datei hinzugefügt wurden

• Nachdem Sie eine MFC aktualisiert haben, überprüfen Sie mit dem Werkzeug Dataset beschreiben, ob das aktualisierte Dataset wie erwartet aussieht.

• Mit dem Werkzeug Multifile-Feature-Verbindung aktualisieren werden neue Datasets identifiziert. Eine MFC kann auch mit den folgenden Werkzeugen geändert werden:

  • 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.
  • 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 zehn Features im Dataset an, um zu überprüfen, ob sie richtig registriert wurden.
  • Dataset beschreiben: Um zu überprüfen, ob das Dataset wie erwartet dargestellt wird.

• Dieses Geoverarbeitungswerkzeug wird unterstützt durch Spark. Weitere Informationen zu Multifile-Feature-Verbindungen (MFC) und ihrer Verwendung finden Sie unter Multifile-Feature-Verbindungen.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Multifile-Feature-Verbindungsdatei	Die zu aktualisierende MFC-Datei.	File
Sichtbare Geometriefelder (optional)	Legt fest, ob die zum Identifizieren der Geometrie verwendeten Felder als Felder für die Analyse einbezogen werden (sichtbar sind), wenn die MFC-Datei in anderen Geoverarbeitungswerkzeugen genutzt wird. Auch wenn Geometriefelder nicht sichtbar sind, wird die Geometrie auf das Dataset angewendet. Die Einstellung für die Sichtbarkeit der Geometrie kann in der MFC geändert werden. Aktiviert: Geometriefelder werden als Felder für die Analyse einbezogen. Dies ist die Standardeinstellung. Deaktiviert: Geometriefelder werden als Felder für die Analyse nicht einbezogen.	Boolean
Sichtbare Zeitfelder (optional)	Legt fest, ob die zum Angeben der Zeit verwendeten Felder als Felder für die Analyse einbezogen werden (sichtbar sind), wenn die MFC-Datei in anderen Geoverarbeitungswerkzeugen genutzt wird. Auch wenn Zeitfelder nicht sichtbar sind, wird die Zeit auf das Dataset angewendet. Die Einstellung für die Sichtbarkeit der Zeit kann in der MFC geändert werden. Aktiviert: Zeitfelder werden als Felder für die Analyse einbezogen. Dies ist die Standardeinstellung. Deaktiviert: Zeitfelder werden als Felder für die Analyse nicht einbezogen.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte MFC	Die .mfc-Eingabedatei mit aktualisierten Datasets.	File

Python

arcpy.gapro.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})

Name	Erläuterung	Datentyp
bdc_file	Die zu aktualisierende MFC-Datei.	File
visible_geometry (optional)	Legt fest, ob die zum Identifizieren der Geometrie verwendeten Felder als Felder für die Analyse einbezogen werden (sichtbar sind), wenn die MFC-Datei in anderen Geoverarbeitungswerkzeugen genutzt wird. Auch wenn Geometriefelder nicht sichtbar sind, wird die Geometrie auf das Dataset angewendet. Die Einstellung für die Sichtbarkeit der Geometrie kann in der MFC geändert werden. GEOMETRY_VISIBLE—Geometriefelder werden als Felder für die Analyse einbezogen. Dies ist die Standardeinstellung. GEOMETRY_NOT_VISIBLE—Geometriefelder werden als Felder für die Analyse nicht einbezogen.	Boolean
visible_time (optional)	Legt fest, ob die zum Angeben der Zeit verwendeten Felder als Felder für die Analyse einbezogen werden (sichtbar sind), wenn die MFC-Datei in anderen Geoverarbeitungswerkzeugen genutzt wird. Auch wenn Zeitfelder nicht sichtbar sind, wird die Zeit auf das Dataset angewendet. Die Einstellung für die Sichtbarkeit der Zeit kann in der MFC geändert werden. TIME_VISIBLE—Zeitfelder werden als Felder für die Analyse einbezogen. Dies ist die Standardeinstellung. TIME_NOT_VISIBLE—Zeitfelder werden als Felder für die Analyse nicht einbezogen.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_bdc	Die .mfc-Eingabedatei mit aktualisierten Datasets.	File

Codebeispiel

RefreshBDC (eigenständiges Skript)

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

# Name: RefreshBDC.py
# Description: Refreshes a multifile feature connection to automatically discover datasets that 
#              have been added.
#
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
mfcFile = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc"

# Run Refresh Multifile Feature Connection
arcpy.gapro.RefreshBDC(mfcFile)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

• Basic: Nein
• Standard: Nein
• Advanced: Ja