Résumé
Maintenez votre mosaïque à jour. Outre la synchronisation des données, vous pouvez également mettre à jour les vues d'ensemble si l'imagerie sous-jacente a changé, générer de nouvelles vues d'ensemble et un nouveau cache, et restaurer la configuration d'origine des éléments de mosaïque. Vous pouvez également supprimer les chemins d'accès aux données source avec cet outil. Pour réparer des chemins, vous devez utiliser l'outil Réparer les chemins de la mosaïque.
La synchronisation est une opération monodirectionnelle. Les modifications apportées aux données source peuvent être synchronisées dans la table attributaire de la mosaïque, ce qui actualise la table attributaire de la mosaïque. Les modifications appliquées à la table attributaire de la mosaïque n'affectent pas les données source.
Utilisation
Vous pouvez utiliser un ensemble de sélection avec cet outil pour limiter les éléments raster mis à jour. Seuls ces éléments sont traités en cas de sélection ou de requête.
La synchronisation peut ajouter de nouveaux éléments, mettre à jour des éléments existants ou en supprimer.
Les éléments obsolètes concernent des rasters source qui ont été modifiés depuis la création de la mosaïque ou depuis sa dernière synchronisation. Il se peut, par exemple, que le géoréférencement ait été mis à jour ou que des pyramides aient été construites.
Etant donné que les éléments raster sont reconstruits, toutes les modifications qui leur ont été apportées depuis la dernière construction sont perdues, comme certaines fonctions ou certains contenus de mise à jour de la table attributaire.
Si vous choisissez de supprimer des éléments contenant des sources de données rompues, assurez-vous que toutes vos connexions réseau sont opérationnelles. Cet outil supprimera tout élément auquel il est impossible d'accéder.
En outre, vous pouvez créer des pyramides et calculer des statistiques sur les rasters source, ou encore créer des miniatures et un cache raster pour les éléments raster.
Cet outil est particulièrement utile pour garder les mosaïques à jour. Si de nouveaux jeux de données raster ont été ajoutés aux espaces de travail auxquels cette mosaïque accède, les nouveaux jeux de données raster peuvent être ajoutés à la mosaïque. Vous pouvez également mettre à jour les mosaïques alimentées par des tables résidant dans une base de données gérée en externe.
Une fois la synchronisation terminée, les opérations répertoriées dans Options de mosaïque (paramètres update_cellsize_ranges, update_boundary et update_overviews dans Python) sont exécutées.
Cet outil peut servir à générer le cache pour un élément de la mosaïque. Les éléments qui peuvent toujours être mis en cache sont créés à partir des données suivantes : fichiers LAS, jeu de données LAS et MNT. La fonction Raster mis en cache permet également de mettre des éléments en cache.
La fragmentation des bases de données et la manipulation fréquente des données peut augmenter considérablement la taille de votre mosaïque. Si la taille de votre base de données augmente en raison de constantes transactions, exécutez l'outil Compacter.
Syntaxe
SynchronizeMosaicDataset_management (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)
Paramètre | Explication | Type de données |
in_mosaic_dataset | Mosaïque que vous voulez synchroniser. | Image Service; Mosaic Layer; String |
where_clause (Facultatif) | Expression SQL permettant de sélectionner les éléments de mosaïque à synchroniser. Si aucune expression n'est fournie, tous les éléments de mosaïque sont mis à jour. | SQL Expression |
new_items (Facultatif) | Indiquez si vous souhaitez inclure les nouveaux éléments lors de la synchronisation, puis spécifiez les options avec lesquelles mettre à jour les nouveaux éléments. Si vous choisissez cette option, la recherche porte sur les nouvelles données dans l'espace de travail de l'élément. Lorsque des données sont ajoutées à la mosaïque, le même type de raster que les autres éléments figurant dans le même espace de travail est utilisé.
| Boolean |
sync_only_stale (Facultatif) | Indiquez si vous souhaitez mettre à jour les éléments de mosaïque dans lesquels les jeux de données raster sous-jacents ont été modifiés suite à la synchronisation. Par exemple, la génération de pyramides ou la mise à jour du géoréférencement des rasters influe sur le rendu des vues d'ensemble.
| Boolean |
update_cellsize_ranges (Facultatif) | Choisissez s'il faut mettre à jour les plages de tailles de cellules.
| Boolean |
update_boundary (Facultatif) | Choisissez s'il faut mettre à jour la limite.
| Boolean |
update_overviews (Facultatif) | Choisissez s'il faut mettre à jour les vues d'ensemble obsolètes. La vue d'ensemble devient obsolète si des rasters sous-jacents ont été modifiés suite à la synchronisation.
| Boolean |
build_pyramids (Facultatif) | Choisissez s'il faut construire des pyramides pour les éléments de mosaïque spécifiés. Les pyramides peuvent être construites pour chaque élément raster de la mosaïque. Les pyramides peuvent améliorer la vitesse à laquelle chaque raster est affiché.
Aucune pyramide n'est générée pour les éléments qui ont été ajoutés suite à la synchronisation. | Boolean |
calculate_statistics (Facultatif) | Choisissez s'il faut calculer les statistiques pour les éléments de mosaïque spécifiés. Les statistiques sont obligatoires pour effectuer certaines tâches avec votre mosaïque, par exemple appliquer un étirement de contraste.
Aucune statistique n'est générée pour les éléments qui ont été ajoutés suite à la synchronisation. | Boolean |
build_thumbnails (Facultatif) | Choisissez s'il faut créer des miniatures pour les éléments de mosaïque spécifiés. Les miniatures sont de petites images fortement rééchantillonnées qui peuvent être créées pour chaque élément raster dans la définition de la mosaïque. Les miniatures sont accessibles lorsque vous accédez à la mosaïque en tant que service d'imagerie et s'affichent dans la description de l'élément.
Aucune miniature n'est générée pour les éléments qui ont été ajoutés suite à la synchronisation. | Boolean |
build_item_cache (Facultatif) | Choisissez s'il faut construire un cache pour les éléments de mosaïque spécifiés. Vous pouvez créer un cache lorsque vous avez ajouté des données à l'aide des types raster LAS, MNT ou Jeu de données LAS. La fonction Raster en cache permet également de les mettre en cache.
Aucun cache n'est généré pour les éléments qui ont été ajoutés suite à la synchronisation. | Boolean |
rebuild_raster (Facultatif) | Choisissez s'il faut régénérer les éléments raster à partir de la source de données à l'aide du type de raster d'origine.
Cela ne concerne que les éléments qui seront synchronisés. Ce paramètre ne s'applique pas si le paramètre new_items est défini sur UPDATE_WITH_NEW_ITEMS. | Boolean |
update_fields (Facultatif) | Choisissez s'il faut mettre à jour les champs de la table. Cela ne concerne que les éléments qui seront synchronisés.
Si vous décidez de mettre des champs à jour, vous pouvez les identifier dans le paramètre fields_to_update. Si vous avez apporté des modifications à certains champs, vous pouvez les supprimer dans le paramètre fields_to_update. | Boolean |
fields_to_update [field_to_update,...] (Facultatif) | Spécifiez les champs à mettre à jour. Ce paramètre est valide uniquement si la valeur du paramètre update_fields est UPDATE_FIELDS. Si vous avez mis certains champs à jour, assurez-vous qu'ils ne sont pas répertoriés dans la liste. Le champ RASTER peut être actualisé, même si le paramètre REBUILD_RASTER n'est pas précisé. Cependant, si REBUILD_RASTER est spécifié, le champ RASTER est reconstruit, même si ce champ n'est pas spécifié. | String |
existing_items (Facultatif) | Indiquez si vous souhaitez mettre à jour les éléments de votre mosaïque. Si vous choisissez cette option, vous pouvez ensuite désigner les paramètres que vous souhaitez mettre à jour : sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields ou fields_to_update.
| Boolean |
broken_items (Facultatif) | Indiquez si vous souhaitez supprimer les liens rompus. Assurez-vous que toutes vos connexions réseau sont opérationnelles. Cet outil supprimera tout élément auquel il est impossible d'accéder.
| Boolean |
skip_existing_items (Facultatif) | Si UPDATE_WITH_NEW_ITEMS est spécifié dans le paramètre new_items, vous pouvez également choisir d'ignorer ou de mettre à jour des éléments de mosaïque existants avec les fichiers modifiés sur le disque.
| Boolean |
refresh_aggregate_info (Facultatif) | Indiquez si les données qui ont pu être supprimées de la mosaïque doivent être réintégrées ou non.
| Boolean |
estimate_statistics | Décidez si vous souhaitez estimer les statistiques de la mosaïque.
| Boolean |
Exemple de code
Exemple 1 d'utilisation de l'outil SynchronizeMosaicDataset (fenêtre Python)
Il s'agit d"un exemple en Python d'utilisation de l'outil 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", "#", "#")
Exemple 2 d'utilisation de l'outil SynchronizeMosaicDataset (script autonome)
Il s'agit d"un exemple de script en Python d'utilisation de l'outil 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)
Environnements
Informations de licence
- ArcGIS Desktop Basic: Non
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui