Synchroniser une mosaïque (Gestion des données)

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.

Attention :

Les modifications apportées lors de la synchronisation ne peuvent pas être annulées. Par conséquent, il est conseillé de créer une copie de sauvegarde si vous avez modifié des données de mosaïque pouvant être écrasées.

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 sont exécutées.

  • Pour utiliser le paramètre Refresh Aggregate Information (Actualiser les informations d’agrégat), désactivez le paramètre Update Existing Items (Mettre à jour les éléments existants). Pour les jeux de données mosaïque multidimensionnels, ce paramètre actualise les propriétés multidimensionnelles de la mosaïque en fonction du contenu de la table attributaire du jeu de données mosaïque.

  • 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(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ètreExplicationType de données
in_mosaic_dataset

Mosaïque à synchroniser.

Mosaic Layer
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 de 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_ITEMSLes nouveaux éléments ne sont pas ajoutés lors de la synchronisation. Il s’agit de l’option par défaut.
  • UPDATE_WITH_NEW_ITEMSMet à 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 de rasters influe sur le rendu des vues d'ensemble.

  • SYNC_STALENe 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_ALLMet à 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_SIZESRecalcule les plages des tailles de cellules 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_PYRAMIDSAucune 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_STATISTICSLes 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 calculé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_THUMBNAILSAucune miniature n'est créée ou mise à jour. Il s’agit de l’option par défaut.
  • BUILD_THUMBNAILSDes 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_CACHEAucun cache n'est créé ni mis à jour. Il s’agit de l’option par défaut.
  • BUILD_ITEM_CACHELe 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_RASTERPermet 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_RASTERLes 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 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.

  • UPDATE_FIELDSPermet de mettre à jour les champs à partir des fichiers source. Il s’agit de l’option par défaut.
  • NO_FIELDSLes champs de la table ne sont pas réinitialisés à partir de la source.

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, vérifiez 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é. Toutefois, 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 les éléments existants de votre mosaïque doivent être mis à jour.

Si vous choisissez cette option, vous pouvez ensuite sélectionner les paramètres existants à mettre à jour : sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields ou fields_to_update.

  • UPDATE_EXISTING_ITEMSLes é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_ITEMSLes é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_ITEMSLes é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_ITEMSLes éléments présentant des liens rompus sont supprimés de la mosaïque.
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.

  • SKIP_EXISTING_ITEMSPendant 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_ITEMSPendant 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 intégrées ou non.

  • NO_REFRESH_INFOLors 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_INFOLors de la synchronisation, les rasters qui ont pu être supprimés de la mosaïque sont inclus. Pour utiliser le paramètre refresh_aggregate_info, le paramètre existing_items doit être défini sur IGNORE_EXISTING_ITEMS.
Boolean
estimate_statistics

Décidez si vous souhaitez estimer les statistiques de la mosaïque.

  • NO_STATISTICSLors de la synchronisation, n'estimez pas les statistiques de la mosaïque. Il s’agit de l’option par défaut.
  • ESTIMATE_STATISTICSLors de la synchronisation, estimez les statistiques de la mosaïque.
Boolean

Sortie dérivée

NomExplicationType de données
out_mosaic_dataset

Jeu de données mosaïque mis à jour.

Couche de mosaïque

Exemple de code

Exemple 1 d'utilisation de l'outil SynchronizeMosaicDataset (fenêtre Python)

Il s’agit d'un exemple 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 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)

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes