Zusammenfassung
Hält das Mosaik-Dataset auf dem neuesten Stand. Neben dem Synchronisieren von Daten können Sie Übersichten aktualisieren, wenn die zugrunde liegenden Bilddaten geändert wurden, neue Übersichten und Cache erstellen sowie die ursprüngliche Konfiguration von Mosaik-Dataset-Elementen wiederherstellen. Sie haben außerdem die Möglichkeit, Pfade zu Quelldaten mit diesem Werkzeug zu entfernen. Um Pfade zu reparieren, müssen Sie das Werkzeug Mosaik-Dataset-Pfade reparieren verwenden.
Die Synchronisierung ist ein unidirektionaler Vorgang: Änderungen an den Quelldaten können mit der Attributtabelle des Mosaik-Datasets synchronisiert werden, wodurch die Attributtabelle des Mosaik-Datasets aktualisiert wird. Änderungen an der Attributtabelle des Mosaik-Datasets haben keine Auswirkungen auf die Quelldaten.
Vorsicht:
Ä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.
Dieses 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.
Um den Parameter Aggregierte Informationen aktualisieren zu verwenden, deaktivieren Sie den Parameter Vorhandene Elemente aktualisieren. Bei multidimensionalen Mosaik-Datasets aktualisiert dieser Parameter die multidimensionalen Eigenschaften des Mosaiks basierend auf dem Inhalt der Attributtabelle des Mosaik-Datasets.
Datenbankfragmentierung und häufige Datenänderungen können das Mosaik-Dataset erheblich vergrößern. Verwenden Sie das Werkzeug Komprimieren, wenn die Datenbank aufgrund konstanter Transaktionen erheblich vergrößert ist.
Syntax
arcpy.management.SynchronizeMosaicDataset(in_mosaic_dataset, {where_clause}, {new_items}, {sync_only_stale}, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {build_item_cache}, {rebuild_raster}, {update_fields}, {fields_to_update}, {existing_items}, {broken_items}, {skip_existing_items}, {refresh_aggregate_info}, estimate_statistics)
Parameter | Erklärung | Datentyp |
in_mosaic_dataset | Das Mosaik-Dataset, das Sie synchronisieren möchten. | Mosaic Layer |
where_clause (optional) | Ein SQL-Ausdruck, um festzulegen, welche Mosaik-Dataset-Elemente synchronisiert werden sollen. Wenn kein Ausdruck bereitgestellt wird, werden alle Dataset-Elemente aktualisiert. | SQL Expression |
new_items (optional) | Legen Sie fest, ob neue Elemente beim Synchronisieren eingeschlossen werden sollen, und geben Sie an, mit welchen Optionen die neuen Elemente aktualisiert werden sollen. 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.
| Boolean |
sync_only_stale (optional) | Legen Sie fest, ob Mosaik-Dataset-Elemente aktualisiert werden sollen, deren zugrunde liegende Raster-Datasets aufgrund der Synchronisierung geändert wurden. Die Berechnung von Pyramiden oder die Aktualisierung der Georeferenzierung der Raster wirkt sich beispielsweise darauf aus, wie die Übersichten gerendert werden.
| 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, wenn zugrunde liegende Raster aufgrund der Synchronisierung 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.
Pyramiden werden nicht für Elemente berechnet, die aufgrund der Synchronisierung hinzugefügt wurden. | Boolean |
calculate_statistics (optional) | Legen Sie fest, ob Statistiken für die angegebenen Mosaik-Dataset-Elemente berechnet werden sollen. Statistikwerte sind erforderlich, damit das Mosaik-Dataset bestimmte Tasks ausführen kann, wie beispielsweise eine Kontraststreckung.
Statistiken werden nicht für Elemente berechnet, die aufgrund der Synchronisierung hinzugefügt wurden. | 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 Elementbeschreibung angezeigt.
Miniaturansichten werden nicht für Elemente berechnet, die aufgrund der Synchronisierung hinzugefügt wurden. | 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.
Der Cache wird nicht für Elemente berechnet, die aufgrund der Synchronisierung hinzugefügt wurden. | 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 der Parameter new_items auf UPDATE_WITH_NEW_ITEMS gesetzt ist. | 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 angeben. 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 die Option für den Parameter update_fields auf UPDATE_FIELDS festgelegt ist. Wenn Sie einige der Felder bearbeitet haben, sollten Sie sicherstellen, dass diese nicht aufgelistet werden. Das Feld RASTER kann auch dann aktualisiert werden, wenn REBUILD_RASTER nicht angegeben wurde. Wenn REBUILD_RASTER jedoch angegeben wurde, wird das Feld RASTER auch dann neu erstellt, wenn dieses Feld nicht angegeben wurde. | String |
existing_items (optional) | Wählen Sie aus, ob vorhandene Elemente im Mosaik-Dataset aktualisiert werden sollen. 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) | Legen Sie fest, 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 UPDATE_WITH_NEW_ITEMS im Parameter new_items angegeben wurde, können Sie ebenfalls festlegen, ob vorhandene Mosaik-Dataset-Elemente mit den geänderten Dateien von der Festplatte übersprungen oder aktualisiert werden sollen.
| Boolean |
refresh_aggregate_info (optional) | Legt fest, ob Daten eingeschlossen werden sollen, die möglicherweise aus dem Mosaik-Dataset entfernt wurden.
| Boolean |
estimate_statistics | Legen Sie fest, ob Statistiken für das Mosaik-Dataset geschätzt werden sollen.
| Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_mosaic_dataset | Das aktualisierte Mosaik-Dataset. | Mosaik-Layer |
Codebeispiel
Dies ist ein Python-Beispiel für das Werkzeug 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 das Werkzeug 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)
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja