Mosaik-Dataset synchronisieren (Datenmanagement)
Zusammenfassung
Erstellt jedes Raster-Element im Mosaik-Dataset neu bzw. aktualisiert es und aktualisiert die zugehörigen Felder in der Attributtabelle mithilfe des Raster-Typs und der Optionen, die beim ursprünglichen Hinzufügen verwendet wurden.
Die Synchronisierung ist ein unidirektionaler Vorgang, in dem Änderungen an den Quelldaten mit der Attributtabelle des Mosaik-Datasets synchronisiert werden können. Änderungen an der Attributtabelle wirken sich aber nicht auf die Quelldaten aus (können jedoch durch die Synchronisierung überschrieben werden).
![Achtung Achtung](rsrc/caution.png)
Änderungen, die durch die Synchronisierung vorgenommen werden, können nicht mehr rückgängig gemacht werden. Sie sollten eventuell eine Sicherungskopie erstellen, wenn Sie Änderungen an Ihren Mosaik-Daten vorgenommen haben, die überschrieben werden könnten.
Verwendung
-
Sie können einen Auswahlsatz bei diesem Werkzeug verwenden, um die Raster-Elemente einzugrenzen, die aktualisiert werden. Wenn eine Auswahl oder Abfrage vorhanden ist, werden nur die entsprechenden Elemente verarbeitet.
Durch die Synchronisierung können neue Elemente hinzufügt, vorhandene Elemente aktualisiert oder Elemente entfernt werden.
Veraltete Elemente beziehen sich auf Quell-Raster, die seit dem Erstellen des Mosaik-Datasets oder der letzten Synchronisierung des Mosaik-Datasets geändert wurden. So kann beispielsweise die Georeferenzierung aktualisiert worden sein oder die Pyramiden können erstellt worden sein.
Da die Raster-Elemente neu erstellt werden, gehen sämtliche seit ihrer Erstellung an diesen Elementen vorgenommenen Änderungen verloren, beispielsweise die Bearbeitungsfunktionen oder Inhalte in der Attributtabelle.
Wenn Sie entscheiden, Elemente zu entfernen, deren Datenquellen ungültig ist, stellen Sie sicher, dass alle Ihre Netzwerkverbindungen ordnungsgemäß funktionieren, da durch dieses Werkzeug alle Elemente entfernt werden, auf die nicht zugegriffen werden kann.
Sie können dieses Werkzeug auch verwenden, um Pyramiden und Statistiken für die Quell-Raster zu berechnen, und um Miniaturansichten und Raster-Cache für die Raster-Elemente zu erstellen.
Das Werkzeug eignet sich insbesondere dazu, Mosaik-Datasets auf dem neuesten Stand zu halten. Wenn dem Workspace, auf den dieses Mosaik-Dataset zugreift, neue Raster-Datasets hinzugefügt wurden, können die neuen Raster-Datasets dem Mosaik-Dataset hinzugefügt werden. Auch Mosaik-Datasets, die mithilfe von Tabellen aus extern verwalteten Datenbanken ausgefüllt werden, lassen sich mit diesem Werkzeug aktualisieren.
Nachdem die Synchronisierung abgeschlossen ist, werden die unter Mosaik-Dataset-Optionen aufgelisteten Vorgänge ausgeführt.
Dieses Werkzeug kann verwendet werden, um den Cache für ein Element im Mosaik-Dataset zu generieren. Elemente, die immer gecacht werden können, werden aus den folgenden Daten erstellt: LAS-Dateien, LAS-Datasets und Terrains. Elemente können auch mithilfe der Funktion "Gecachte Raster" gecacht werden.
Datenbankfragmentierung und häufige Datenänderungen können das Mosaik-Dataset erheblich vergrößern. Wenn die Datenbank aufgrund konstanter Transaktionen erheblich vergrößert ist, sollten Sie das Werkzeug Komprimieren verwenden.
Syntax
Parameter | Erläuterung | Datentyp |
in_mosaic_dataset |
Der Pfad und der Name des Mosaik-Datasets. | Image Service; Mosaic Layer; String |
where_clause (optional) |
Sie können SQL verwenden, um festzulegen, welche Mosaik-Dataset-Elemente synchronisiert werden sollen. Wenn keine Abfrage angegeben wird, werden alle Mosaik-Dataset-Elemente synchronisiert. | SQL Expression |
new_items (optional) | Wählen Sie aus, ob das Mosaik-Dataset mit neu hinzugefügten Elementen synchronisiert werden soll. Wenn Sie diese Option verwenden, wird der Workspace des Elements nach neuen Daten durchsucht. Wenn Daten zum Mosaik-Dataset hinzugefügt werden, verwenden diese den gleichen Raster-Typ wie die anderen Elemente im gleichen Workspace. Soll eine Aktualisierung stattfinden, können Sie optional wählen, ob die Zellengrößenbereiche, die Grenze, die Übersichten und auch vorhandene Elemente aktualisiert werden sollen.
| Boolean |
sync_only_stale (optional) |
Wählen Sie, ob alle primären Elemente oder nur veraltete primäre Elemente aktualisiert werden sollen. Ein Element wird als veraltet betrachtet, wenn die entsprechenden Quelldateien, die zum Erstellen der Raster-Werte verwendet werden, nach dem Erstellen des Elements geändert werden. So kann beispielsweise die Georeferenzierung aktualisiert worden sein oder die Pyramiden können erstellt worden sein.
| Boolean |
update_cellsize_ranges (optional) | Wählen Sie aus, ob die Zellengrößenbereiche aktualisiert werden sollen.
| Boolean |
update_boundary (optional) | Wählen Sie aus, ob die Grenze aktualisiert werden soll.
| Boolean |
update_overviews (optional) | Wählen Sie aus, ob veraltete Übersichten aktualisiert werden sollen. Die Übersicht ist veraltet, nachdem zugrunde liegende Raster geändert wurden.
| Boolean |
build_pyramids (optional) |
Legen Sie fest, ob Pyramiden für die angegebenen Mosaik-Dataset-Elemente berechnet werden sollen. Für jedes Rasterelement im Mosaik-Dataset können Pyramiden erstellt werden. Mit ihnen lässt sich die Geschwindigkeit steigern, mit der die einzelnen Raster angezeigt werden.
Für neu hinzugefügte Elemente werden keine Pyramiden erstellt, wenn die Elemente in derselben Instanz hinzugefügt werden, in der dieses Werkzeug ausgeführt wird. | Boolean |
calculate_statistics (optional) |
Legen Sie fest, ob Statistiken für die Quell-Raster der angegebenen Mosaik-Dataset-Elemente berechnet werden sollen. Statistikwerte sind erforderlich, damit das Mosaik-Dataset bestimmte Tasks ausführen kann, wie beispielsweise eine Kontraststreckung.
Für neu hinzugefügte Elemente werden keine Statistiken erstellt, wenn die Elemente in derselben Instanz hinzugefügt werden, in der dieses Werkzeug ausgeführt wird. | Boolean |
build_thumbnails (optional) |
Wählen Sie, ob Miniaturansichten für die angegebenen Mosaik-Dataset-Elemente erstellt werden sollen. Miniaturansichten sind kleine Bilder und können für jedes Rasterelement in der Mosaikdefinition erstellt werden. Miniaturansichten stehen beim Zugriff auf ein Mosaik-Dataset als Image-Service zur Verfügung und werden als Teil der Metadaten (Elementbeschreibung) angezeigt.
Für neu hinzugefügte Elemente werden keine Miniaturansichten erstellt, wenn die Elemente in derselben Instanz hinzugefügt werden, in der dieses Werkzeug ausgeführt wird. | Boolean |
build_item_cache (optional) | Legen Sie fest, ob ein Cache für die angegebenen Mosaik-Dataset-Elemente erstellt werden soll. Ein Cache kann erstellt werden, wenn Sie Daten mithilfe der Raster-Typen LAS, Terrain oder LAS-Dataset hinzugefügt haben. Elemente können auch mithilfe der Funktion "Gecachte Raster" gecacht werden.
Für neu hinzugefügte Elemente wird kein Cache erstellt, wenn die Elemente in derselben Instanz hinzugefügt werden, in der dieses Werkzeug ausgeführt wird. | Boolean |
rebuild_raster (optional) | Wählen Sie, ob die Raster-Elemente mithilfe des ursprünglichen Raster-Typs aus der Datenquelle neu aufgebaut werden sollen.
Dies wirkt sich nur auf Elemente aus, die synchronisiert werden. Dieser Parameter ist nicht anwendbar, wenn UPDATE_WITH_NEW_ITEMS gewählt wurde. | Boolean |
update_fields (optional) | Wählen Sie, ob die Felder in der Tabelle aktualisiert werden sollen. Dies wirkt sich nur auf Elemente aus, die synchronisiert werden.
Soll eine Aktualisierung der Felder stattfinden, können Sie festlegen, welche Felder aktualisiert werden, indem sie diese im Parameter fields_to_update auswählen. Wenn Sie einige der Felder bearbeitet haben, sollten Sie diese im Parameter fields_to_update entfernen. | Boolean |
fields_to_update [field_to_update,...] (optional) | Geben Sie die Felder an, die aktualisiert werden sollen. Dieser Parameter ist nur gültig, wenn als Option für den Parameter update_fields "UPDATE_FIELDS" angegeben ist. Wenn Sie einige der Felder bearbeitet haben, sollten Sie sicherstellen, dass diese nicht aufgelistet werden. Die Spalte RASTER kann aktualisiert werden, auch wenn das Schlüsselwort REBUILD_RASTER nicht verwendet wird. Wird jedoch REBUILD_RASTER verwendet, so wird die Spalte RASTER neu aufgebaut, auch wenn das Feld nicht angegeben ist. | String |
existing_items (optional) | Wählen Sie aus, ob Sie vorhandene Elemente im Mosaik-Dataset aktualisieren möchten. Bei Auswahl dieser Option können Sie festlegen, welche vorhandenen Parameter aktualisiert werden sollen: sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields oder fields_to_update.
| Boolean |
broken_items (optional) | Wählen Sie, ob ungültige Verweise entfernt werden sollen. Stellen Sie sicher, dass alle Ihre Netzwerkverbindungen ordnungsgemäß funktionieren, da durch dieses Werkzeug alle Elemente entfernt werden, auf die nicht zugegriffen werden kann.
| Boolean |
skip_existing_items (optional) | Wenn das Schlüsselwort "UPDATE_WITH_NEW_ITEMS" verwendet wird, können Sie ebenfalls festlegen, ob vorhandene Mosaik-Dataset-Elemente mit den geänderten Dateien von der Festplatte übersprungen oder aktualisiert werden sollen.
| Boolean |
Codebeispiel
Dies ist ein Python-Beispiel für "SynchronizeMosaicDataset".
import arcpy
arcpy.SynchronizeMosaicDataset_management(
"c:/data/syncmd.gdb/md", "Year>1999", "NO_NEW_ITEMS", "SYNC_STALE",
"#", "#", "#", "NO_PYRAMIDS", "NO_STATISTICS", "NO_THUMBNAILS",
"NO_ITEM_CACHE", "NO_RASTER", "NO_FIELDS", "#", "#")
Dies ist ein Python-Skriptbeispiel für "SynchronizeMosaicDataset".
# Synchronize source and add new data
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "syncmd.gdb/mdnew"
query = "#"
updatenew = "UPDATE_WITH_NEW_ITEMS"
syncstale = "SYNC_STALE"
updatecs = "#"
updatebnd = "#"
updateovr = "#"
buildpy = "NO_PYRAMIDS"
calcstats = "NO_STATISTICS"
buildthumb = "NO_THUMBNAILS"
buildcache = "NO_ITEM_CACHE"
updateras = "NO_RASTER"
updatefield = "NO_FIELDS"
fields = "#"
arcpy.SynchronizeMosaicDataset_management(
mdname, query, updatenew, syncstale, updatecs, updatebnd,
updateovr, buildpy, calcstats, buildthumb, buildcache,
updateras, updatefield, fields)