Synchroniser une mosaïque—Aide

Récapitulatif
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Récapitulatif

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 les chemins d'accès, 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 en cache permet également de les mettre 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})

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é. NO_NEW_ITEMS —Les nouveaux éléments ne sont pas ajoutés lors de la synchronisation. Il s'agit de l'option par défaut. UPDATE_WITH_NEW_ITEMS —Met à jour la mosaïque avec les nouveaux éléments des espaces de travail. Vous pouvez également modifier les éléments existants en utilisant le mot-clé OVERWRITE_EXISTING_ITEMS dans le paramètre skip_existing_items.	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. SYNC_STALE —Ne met à jour que les éléments dans lesquels les jeux de données raster sous-jacents ont été modifiés. Il s'agit de l'option par défaut. SYNC_ALL —Met à jour tous les éléments de la mosaïque.	Boolean
update_cellsize_ranges (Facultatif)	Choisissez s'il faut mettre à jour les plages de tailles de cellules. UPDATE_CELL_SIZES —Recalcule la taille de cellule de toute la mosaïque, mais uniquement pour les éléments dont la visibilité est incorrecte. Il s'agit de l'option par défaut. NO_CELL_SIZES — Ne recalcule pas les plages de taille de cellule.	Boolean
update_boundary (Facultatif)	Choisissez s'il faut mettre à jour la limite. UPDATE_BOUNDARY — La limite est régénérée après la synchronisation de la mosaïque. Utilisez cette option si la synchronisation va modifier l'étendue de la mosaïque. Il s'agit de l'option par défaut. NO_BOUNDARY — La limite n'est pas régénérée.	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. NO_OVERVIEWS — Les vues d'ensemble ne sont pas régénérées. Il s'agit de l'option par défaut. UPDATE_OVERVIEWS — Les vues d'ensemble affectées sont régénérées après la synchronisation de la mosaïque.	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é. NO_PYRAMIDS —Aucune pyramide n'est générée. Il s'agit de l'option par défaut. BUILD_PYRAMIDS — Des pyramides sont générées pour tous les éléments raster qui ont été mis à jour suite à la synchronisation. 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. NO_STATISTICS —Les statistiques ne sont pas calculées. Il s'agit de l'option par défaut. CALCULATE_STATISTICS — Des statistiques sont calculées pour les éléments de mosaïque qui ont été mis à jour suite à la synchronisation. 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. NO_THUMBNAILS —Aucune miniature n'est créée ou mise à jour. Il s'agit de l'option par défaut. BUILD_THUMBNAILS —Des miniatures sont générées ou mises à jour pour tous les éléments raster qui ont été mis à jour suite à la synchronisation. 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. NO_ITEM_CACHE —Aucun cache n'est créé ni mis à jour. Il s'agit de l'option par défaut. BUILD_ITEM_CACHE —Le cache est généré ou mis à jour pour tous les éléments raster qui ont été mis à jour suite à la synchronisation. 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. REBUILD_RASTER —Permet de régénérer les rasters à partir des données source. Toutes les modifications apportées aux éléments sélectionnés dans la mosaïque sont perdues. Il s'agit de l'option par défaut. NO_RASTER —Les rasters ne sont pas régénérés. Les autres champs principaux sont réinitialisés si le paramètre update_fields est défini sur UPDATE_FIELDS. Cela ne concerne que les éléments qui seront synchronisés. Ce paramètre ne s'applique pas si le paramètre new_items a été 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. UPDATE_FIELDS —Permet de mettre à jour les champs à partir des fichiers source. Il s'agit de l'option par défaut. NO_FIELDS —Les champs de la table ne sont pas réinitialisés à partir de la source. Si vous choisissez la mise à jour des champs, vous pouvez déterminer ceux que vous voulez mettre à jour en les désignant dans le paramètre fields_to_update. Si vous avez mis certains champs à jour, 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 le paramètre update_fields est défini sur 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 existants que vous souhaitez mettre à jour : sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields ou fields_to_update. UPDATE_EXISTING_ITEMS —Les éléments existants sont mis à jour avec les paramètres que vous avez choisis de mettre à jour. Il s'agit de l'option par défaut. IGNORE_EXISTING_ITEMS —Les éléments existants ne sont pas mis à jour.	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. IGNORE_BROKEN_ITEMS —Les éléments présentant des liens rompus ne sont pas supprimés de la mosaïque. Il s'agit de l'option par défaut. REMOVE_BROKEN_ITEMS —Les éléments présentant des liens rompus sont supprimés de la mosaïque.	Boolean
skip_existing_items (Facultatif)	Si le mot-clé UPDATE_WITH_NEW_ITEMS est spécifié dans le paramètre new_items, vous pouvez également choisir d'ignorer ou de mettre à jour les éléments de mosaïque existants avec les fichiers modifiés sur le disque. SKIP_EXISTING_ITEMS —Pendant l'ajout de nouveaux éléments de mosaïque, l'outil ne mettra pas à jour les éléments de mosaïque existants. Il s'agit de l'option par défaut. OVERWRITE_EXISTING_ITEMS —Pendant l'ajout de nouveaux éléments de mosaïque, l'outil mettra à jour les éléments de mosaïque existants qui correspondent aux 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. NO_REFRESH_INFO —Lors de la synchronisation, les rasters qui ont pu être supprimés de la mosaïque ne sont pas inclus. Il s'agit de l'option par défaut. REFRESH_INFO —Lors de la synchronisation, les rasters qui ont pu être supprimés de la mosaïque sont inclus.	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)