Zusammenfassung
Synchronisiert ein Mosaik-Dataset, um es auf dem neuesten Stand zu halten. 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. Verwenden Sie zum Reparieren von Pfaden das Werkzeug Mosaik-Dataset-Pfade reparieren.
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.
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 der Erstellung 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 der letzten Erstellung an diesen Elementen vorgenommenen Änderungen verloren, beispielsweise die Bearbeitungsfunktionen oder Inhalte in der Attributtabelle.
Wenn Sie Elemente mit defekten Datenquellen entfernen, müssen Sie sicherstellen, dass alle Verbindungen ordnungsgemäß funktionieren. Dieses Werkzeug entfernt alle Elemente, auf die der Zugriff nicht möglich ist.
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.
Um den Parameter Aggregierte Informationen aktualisieren zu verwenden, deaktivieren Sie den Parameter Vorhandene Elemente aktualisieren. Bei multidimensionalen Mosaik-Datasets aktualisiert der Parameter Aggregierte Informationen aktualisieren die multidimensionalen Eigenschaften des Mosaiks basierend auf dem Inhalt der Attributtabelle des Mosaik-Datasets.
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. 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 zu synchronisierende Mosaik-Dataset. | 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) | Gibt an, ob neue Elemente beim Synchronisieren einbezogen werden und welche Optionen zum Aktualisieren der neuen Elemente verwendet werden. 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) | Legt fest, dass Mosaik-Dataset-Elemente nur dann aktualisiert werden, wenn die zugrunde liegenden Raster-Datasets durch die 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) | Gibt an, ob die Zellgrößenbereiche für das Mosaik-Dataset neu berechnet werden.
| Boolean |
update_boundary (optional) | Gibt an, ob die Grenze, die die volle Ausdehnung des Mosaik-Datasets zeigt, neu erstellt wird. Wählen Sie UPDATE_BOUNDARY aus, wenn die Ausdehnung des Mosaik-Datasets durch die Synchronisierung geändert wird.
| Boolean |
update_overviews (optional) | Gibt an, ob veraltete Übersichten aktualisiert werden. Die Übersicht ist veraltet, wenn zugrunde liegende Raster aufgrund der Synchronisierung geändert wurden.
| Boolean |
build_pyramids (optional) | Gibt an, ob Pyramiden für die angegebenen Mosaik-Dataset-Elemente erstellt werden. 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) | Gibt an, ob Statistiken für die angegebenen Mosaik-Dataset-Elemente berechnet werden. Statistikwerte sind erforderlich, damit in einem Mosaik-Dataset bestimmte Tasks ausgeführt werden können, wie beispielsweise eine Kontraststreckung.
Statistiken werden nicht für Elemente berechnet, die aufgrund der Synchronisierung hinzugefügt wurden. | Boolean |
build_thumbnails (optional) | Gibt an, ob Miniaturansichten für die angegebenen Mosaik-Dataset-Elemente erstellt werden. 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) | Gibt an, ob ein Cache für die angegebenen Mosaik-Dataset-Elemente erstellt wird. 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 Elemente, die aufgrund der Synchronisierung hinzugefügt wurden, wird kein Cache erstellt. | Boolean |
rebuild_raster (optional) | Gibt an, ob die Raster-Elemente mithilfe des ursprünglichen Raster-Typs aus der Datenquelle neu erstellt werden.
Dies wirkt sich nur auf Elemente aus, die synchronisiert werden. Dieser Parameter findet keine Anwendung, wenn der Parameter new_items auf UPDATE_WITH_NEW_ITEMS festgelegt wurde. | Boolean |
update_fields (optional) | Gibt an, ob die Felder in der Tabelle aktualisiert werden. Dies wirkt sich nur auf Elemente aus, die synchronisiert werden.
Wenn Sie die Felder aktualisieren, können Sie mit dem Parameter fields_to_update steuern, welche Felder aktualisiert werden. Wenn Sie einige der Felder bearbeitet haben, können Sie sie aus dem Parameter fields_to_update entfernen. | Boolean |
fields_to_update [field_to_update,...] (optional) | Die zu aktualisierenden Felder. Dieser Parameter ist nur gültig, wenn der Parameter update_fields auf UPDATE_FIELDS festgelegt wurde. Wenn Sie einige der Felder bearbeitet haben, sollten Sie sicherstellen, dass diese nicht aufgelistet sind. Das Feld RASTER kann auch dann aktualisiert werden, wenn REBUILD_RASTER nicht angegeben wurde. Wenn jedoch REBUILD_RASTER angegeben wurde, wird das Feld RASTER auch dann neu erstellt, wenn der Parameterwert fields_to_update nicht angegeben wurde. | String |
existing_items (optional) | Gibt an, ob vorhandene Elemente im Mosaik-Dataset aktualisiert werden. Bei Verwendung dieses Parameters 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) | Gibt an, ob die Elemente mit ungültigen Verweisen entfernt werden. Stellen Sie sicher, dass alle Netzwerkverbindungen ordnungsgemäß funktionieren. Dieses Werkzeug entfernt alle Elemente, auf die der Zugriff nicht möglich ist.
| Boolean |
skip_existing_items (optional) | Gibt an, ob vorhandene Mosaik-Dataset-Elemente übersprungen oder mit den geänderten Dateien auf der Festplatte aktualisiert werden. Damit dieser Parameter verwendet werden kann, muss der Parameter new_items auf UPDATE_WITH_NEW_ITEMS festgelegt sein.
| Boolean |
refresh_aggregate_info (optional) | Legt fest, ob Daten eingeschlossen werden sollen, die möglicherweise aus dem Mosaik-Dataset entfernt wurden. Damit dieser Parameter verwendet werden kann, muss der Parameter existing_items auf IGNORE_EXISTING_ITEMS festgelegt sein.
| Boolean |
estimate_statistics | Gibt an, ob Statistiken für das Mosaik-Dataset geschätzt werden.
| Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_mosaic_dataset | Das aktualisierte Mosaik-Dataset. | Mosaic Layer |
Codebeispiel
SynchronizeMosaicDataset - Beispiel 1 (Python-Fenster)
Dies ist ein Python-Beispiel für die Funktion 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", "#", "#")
SynchronizeMosaicDataset - Beispiel 2 (eigenständiges Skript)
Dies ist ein Python-Skriptbeispiel für die Funktion 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)
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja