Sincronizar dataset de mosaico (Gestión de datos)
Resumen
Recompila o actualiza cada elemento ráster en el dataset de mosaico y actualiza los campos afectados en la tabla de atributos, utilizando el tipo de ráster y las opciones que se utilizaron cuando se agregó originalmente.
La sincronización es una operación unidireccional: los cambios de los datos de origen se pueden sincronizar con la tabla de atributos del dataset de mosaico, pero los cambios de la tabla de atributos no afectan a los datos de origen (aunque es posible que se sobrescriban en la sincronización).
Los cambios realizados con la sincronización no se pueden deshacer. Es posible que desee crear una copia de seguridad si ha realizado modificaciones a sus datos de mosaico que se pueden sobrescribir.
Uso
-
Puede utilizar un conjunto de selección con esta herramienta para limitar los elementos ráster que se actualizan. Cuando hay una selección o consulta, solo se procesarán esos elementos.
La sincronización puede agregar nuevos elementos, actualizar los elementos existentes o quitar elementos.
Los elementos obsoletos son los rásteres de origen que se han cambiado desde que se creó el dataset de mosaico o desde la última vez que se sincronizó. Por ejemplo, puede que se haya actualizado la georreferenciación o se hayan construido pirámides.
Debido a que los elementos ráster se vuelven a crear, se perderá cualquier modificación realizada a estos elementos desde la última vez que se compilaron, como, por ejemplo, funciones de edición o el contenido de la tabla de atributos.
Si elige quitar los elementos que tienen fuentes de datos dañadas, asegúrese de que todas las conexiones de red están funcionando adecuadamente; esta herramienta quitará los elementos a los que no pueda acceder.
Esta herramienta también puede crear pirámides y calcular estadísticas de rásteres de origen, así como crear vistas en miniatura y una caché ráster para los elementos ráster.
Esta herramienta es particularmente útil para mantener los datasets de mosaico actualizados. Si se han agregado nuevos datasets ráster a los espacios de trabajo a los que tiene acceso este dataset de mosaico, los nuevos datasets ráster se pueden agregar al dataset de mosaico. Los datasets de mosaico que se completan con tablas que residen en una base de datos administrada externamente también se pueden actualizar con esta herramienta.
Una vez que se ha completado la sincronización, se realizarán las operaciones que se enumeran en Opciones del dataset de mosaico.
Esta herramienta se puede utilizar para generar la caché para un elemento en el dataset de mosaico. Los elementos que siempre se pueden almacenar en la caché se crean a partir de los siguientes datos: archivos LAS, datasets LAS y terrenos. Los elementos también se pueden almacenar en caché utilizando la función Ráster almacenado en caché.
La fragmentación de la base de datos y la manipulación de datos frecuentes puede aumentar enormemente el tamaño del dataset de mosaico. Si el tamaño de la base de datos se incrementa debido a la realización constante de transacciones, debe ejecutar la herramienta Compactar.
Sintaxis
Parámetro | Explicación | Tipo de datos |
in_mosaic_dataset |
Ruta y nombre del dataset de mosaico. | Image Service; Mosaic Layer; String |
where_clause (Opcional) |
Puede usar SQL para definir qué elementos del dataset de mosaico se sincronizarán. Si no se especifica ninguna consulta, se sincronizarán todos los elementos del dataset de mosaico. | SQL Expression |
new_items (Opcional) | Elija si desea sincronizar el dataset de mosaico con elementos recientemente agregados. Si elige utilizar esta opción, se buscará el espacio de trabajo del elemento para nuevos datos. Cuando se agregan datos al dataset de mosaico, se utilizará el mismo tipo de ráster que se utiliza para los otros elementos dentro del mismo espacio de trabajo. Si decide actualizarlo con los nuevos elementos, de manera opcional, puede elegir si desea actualizar los rangos de tamaño de celda, el límite, las vistas generales y si también se actualizan los elementos existentes.
| Boolean |
sync_only_stale (Opcional) |
Elija si desea actualizar todos los elementos principales o solo los elementos principales obsoletos. Un elemento se considera obsoleto si, tras la creación del elemento, se modifican los archivos de origen correspondientes que se utilizaron para crear los valores de ráster. Por ejemplo, puede que se haya actualizado la georreferenciación o se hayan construido pirámides.
| Boolean |
update_cellsize_ranges (Opcional) | Elija si desea actualizar los rangos de tamaño de celda.
| Boolean |
update_boundary (Opcional) | Elija si desea actualizar el límite.
| Boolean |
update_overviews (Opcional) | Elija si desea actualizar las vistas generales obsoletas. La vista general se vuelve obsoleta si se modifica cualquier ráster subyacente.
| Boolean |
build_pyramids (Opcional) |
Elija si desea crear pirámides para los elementos de dataset de mosaico especificados. Se pueden construir pirámides para cada elemento ráster del dataset de mosaico. Las pirámides pueden mejorar la velocidad en que se visualiza cada ráster.
Si los elementos se agregan en la misma instancia de ejecución de esta herramienta, no se crean pirámides para los elementos que se agregaron recientemente. | Boolean |
calculate_statistics (Opcional) |
Elija si desea calcular las estadísticas del ráster de fuente de los elementos de dataset de mosaico especificados. Las estadísticas para el dataset de mosaico son necesarias para realizar determinadas tareas, como aplicar un aumento de contraste.
Si los elementos se agregan en la misma instancia de ejecución de esta herramienta, no se crean estadísticas de los elementos que se agregaron recientemente. | Boolean |
build_thumbnails (Opcional) |
Elija si desea crear vistas en miniatura de los elementos de dataset de mosaico especificados. Las vistas en miniatura son pequeñas imágenes, altamente remuestreadas, que se pueden crear para cada elemento ráster en la definición de mosaico. Se puede acceder a las vistas en miniatura cuando se accede al dataset de mosaico como un servicio de imagen y se visualizarán como parte de los metadatos (Descripción de elemento).
Si los elementos se agregan en la misma instancia de ejecución de esta herramienta, no se crean vistas miniaturas de los elementos que se agregaron recientemente. | Boolean |
build_item_cache (Opcional) | Elija si desea compilar una caché para los elementos de dataset de mosaico especificados. Se puede crear una caché cuando ha agregado los datos mediante los tipos de ráster LAS, dataset LAS o de terreno. Los elementos también se pueden almacenar en caché utilizando la función Ráster almacenado en caché.
Si los elementos se agregan en la misma instancia de ejecución de esta herramienta, no se compila la caché para los elementos que se agregaron recientemente. | Boolean |
rebuild_raster (Opcional) | Elija si desea recompilar los elementos ráster desde la fuente de datos utilizando el tipo de ráster original.
Esto solo afectará los elementos que se sincronizarán. Este parámetro no es aplicable si selecciona UPDATE_WITH_NEW_ITEMS. | Boolean |
update_fields (Opcional) | Elija si desea actualizar los campos en la tabla. Esto solo afectará los elementos que se sincronizarán.
Si elige actualizar los campos, puede controlar qué campos se actualizan seleccionándolos en el parámetro fields_to_update. Si edita alguno de los campos, es posible que desee quitarlos en el parámetro fields_to_update. | Boolean |
fields_to_update [field_to_update,...] (Opcional) | Especifique qué campos se deben actualizar. Este parámetro solo es válido si la opción para el parámetro update_fields es UPDATE_FIELDS. Si edita alguno de los campos, es posible que desee asegurarse de que no están en la lista. La columna RASTER se puede actualizar, incluso si no se utiliza la palabra clave REBUILD_RASTER. Sin embargo, si se está utilizando REBUILD_RASTER, se recompila la columna RASTER, incluso cuando no se especifica este campo. | String |
existing_items (Opcional) | Elija si desea actualizar los elementos existentes en el dataset de mosaico. Si elige esta opción, puede seleccionar qué parámetros existentes desea actualizar: sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields o fields_to_update.
| Boolean |
broken_items (Opcional) | Elija si desea eliminar cualquier vínculo dañado. Asegúrese de que todas las conexiones de red están funcionando adecuadamente; esta herramienta quitará los elementos a los que no pueda acceder.
| Boolean |
skip_existing_items (Opcional) | Si se utiliza la palabra clave UPDATE_WITH_NEW_ITEMS, también puede elegir si desea omitir o actualizar los elementos del dataset de mosaico existentes con los archivos modificados del disco.
| Boolean |
Ejemplo de código
Esta es una muestra de Python para 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", "#", "#")
Esta es una muestra de secuencia de comandos de Python para 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)