Sincronizar dataset de mosaico (Administración de datos)

Resumen

Mantiene su dataset de mosaico actualizado. Además de sincronizar los datos, puede actualizar las vistas generales si la imagen subyacente ha cambiado, generar nuevas vistas generales y caché y restaurar la configuración original de los elementos del dataset de mosaico. Con esta herramienta también puede eliminar rutas a los datos de origen. Para reparar rutas, tiene que utilizar la herramienta Reparar rutas de datasets de mosaico.

La sincronización es una operación de una vía: los cambios en los datos de origen se pueden sincronizar con la tabla de atributos del dataset de mosaico, actualizando por tanto la tabla de atributos del dataset de mosaico. Los cambios de la tabla de atributos del dataset de mosaico no afectarán a los datos de origen.

Precaució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é de rásteres 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.

  • Para usar el parámetro Actualizar información agregada, desactive el parámetro Actualizar elementos existentes. En el caso de datasets de mosaico multidimensionales, este parámetro refresca las propiedades multidimensionales del mosaico en función de lo que hay en la tabla de atributos o dataset de mosaico.

  • 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, ejecute la herramienta Compactar.

Sintaxis

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)
ParámetroExplicaciónTipo de datos
in_mosaic_dataset

El dataset de mosaico que desea sincronizar.

Mosaic Layer
where_clause
(Opcional)

Una expresión SQL para seleccionar qué elementos del dataset de mosaico se sincronizarán. Si no facilita ninguna expresión, se actualizan todos los elementos del dataset de mosaico.

SQL Expression
new_items
(Opcional)

Elija si desea incluir nuevos elementos al sincronizar y especifique las opciones con las que desea actualizar los nuevos elementos.

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 del mismo espacio de trabajo.

  • NO_NEW_ITEMSLos elementos nuevos no se agregarán al sincronizar. Esta es la opción predeterminada.
  • UPDATE_WITH_NEW_ITEMSSe actualiza el dataset de mosaico con los nuevos elementos en los espacios de trabajo. También puede modificar los elementos existentes utilizando la palabra clave OVERWRITE_EXISTING_ITEMS en el parámetro skip_existing_items.
Boolean
sync_only_stale
(Opcional)

Elija si desea actualizar los elementos del dataset de mosaico donde los datasets de rásteres subyacentes se han modificado debido a la sincronización. Por ejemplo, la creación de pirámides o la actualización de la georreferenciación de los rásteres afectará al renderizado de las vistas generales.

  • SYNC_STALESolo actualizar los elementos donde los datasets de rásteres subyacentes se han modificado. Esta es la opción predeterminada.
  • SYNC_ALLActualiza todos los elementos del dataset de mosaico.
Boolean
update_cellsize_ranges
(Opcional)

Elija si desea actualizar los rangos de tamaño de celda.

  • UPDATE_CELL_SIZESRecalcule los rangos de tamaño de celda para el dataset de mosaico completo, pero solo para los elementos que tienen una visibilidad no válida. Esta es la opción predeterminada.
  • NO_CELL_SIZES No recalcula los rangos de tamaños de celda.
Boolean
update_boundary
(Opcional)

Elija si desea actualizar el límite.

  • UPDATE_BOUNDARY El límite se vuelve a generar después de sincronizar el dataset de mosaico. Use esta opción si la sincronización cambiará la extensión del dataset de mosaico. Esta es la opción predeterminada.
  • NO_BOUNDARY El límite no se vuelve a generar.
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 debido a la sincronización.

  • NO_OVERVIEWS Las vistas generales no se volverán a generar. Esta es la opción predeterminada.
  • UPDATE_OVERVIEWS Las vistas generales afectadas se recompilan después de sincronizar el dataset de mosaico.
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.

  • NO_PYRAMIDSNo se generarán las pirámides. Esta es la opción predeterminada.
  • BUILD_PYRAMIDS Se generarán pirámides para todos los elementos ráster que se actualizaron debido a la sincronización.

No se crearán pirámides para los elementos que se agregaron debido a la sincronización.

Boolean
calculate_statistics
(Opcional)

Elija si desea calcular las estadísticas 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.

  • NO_STATISTICSNo se calcularán las estadísticas. Esta es la opción predeterminada.
  • CALCULATE_STATISTICS Se calcularán estadísticas para los elementos de dataset de mosaico que se actualizaron debido a la sincronización.

No se calcularán estadísticas para los elementos que se agregaron debido a la sincronización.

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 la descripción de elemento.

  • NO_THUMBNAILSNo se crearán ni se actualizarán las vistas en miniatura. Esta es la opción predeterminada.
  • BUILD_THUMBNAILSSe generarán o se actualizarán miniaturas para todos los elementos ráster que se actualizaron debido a la sincronización.

No se crearán miniaturas para los elementos que se agregaron debido a la sincronización.

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é.

  • NO_ITEM_CACHENo se crea o se actualiza ninguna caché. Esta es la opción predeterminada.
  • BUILD_ITEM_CACHESe generará o se actualizará la caché para todos los elementos ráster que se actualizaron debido a la sincronización.

No se creará la caché para los elementos que se agregaron debido a la sincronización.

Boolean
rebuild_raster
(Opcional)

Elija si desea volver a generar los elementos ráster desde la fuente de datos utilizando el tipo de ráster original.

  • REBUILD_RASTERVuelve a generar los rásteres de los datos de origen. Se perderá cualquier cambio que haya realizado en los elementos seleccionados en el dataset de mosaico. Esta es la opción predeterminada.
  • NO_RASTERNo vuelve a generar los rásteres. Se restablecen otros campos principales si el parámetro update_fields está establecido en UPDATE_FIELDS.

Esto solo afectará los elementos que se sincronizarán. Este parámetro no es aplicable si el parámetro new_items se ha establecido en UPDATE_WITH_NEW_ITEMS.

Boolean
update_fields
(Opcional)

Elija si desea actualizar los campos de la tabla. Esto solo afectará los elementos que se sincronizarán.

  • UPDATE_FIELDSSe actualizan los campos de los archivos de origen. Esta es la opción predeterminada.
  • NO_FIELDSNo se restablecen los campos en la tabla de origen.

Si elige actualizar los campos, puede controlar qué campos se actualizan especificá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 se establece en UPDATE_FIELDS.

Si edita alguno de los campos, es posible que desee asegurarse de que no están en la lista.

El campo RASTER se puede refrescar, incluso aunque no se haya especificado REBUILD_RASTER. Sin embargo, si se especifica REBUILD_RASTER, se reconstruye el campo RASTER, incluso si este campo no está especificado.

String
existing_items
(Opcional)

Elija si desea actualizar los elementos existentes en el dataset de mosaico.

Si elige esta opción, puede elegir qué parámetros existentes desea actualizar: sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields o fields_to_update.

  • UPDATE_EXISTING_ITEMSLos elementos existentes se actualizan con los parámetros de actualización que ha elegido. Esta es la opción predeterminada.
  • IGNORE_EXISTING_ITEMSNo se actualizan los elementos existentes.
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.

  • IGNORE_BROKEN_ITEMSLos elementos que tienen vínculos dañados no se quitan del dataset de mosaico. Esta es la opción predeterminada.
  • REMOVE_BROKEN_ITEMSLos elementos que tienen vínculos dañados se quitan del dataset de mosaico.
Boolean
skip_existing_items
(Opcional)

Si se especifica UPDATE_WITH_NEW_ITEMS en el parámetro new_items, también puede elegir si desea omitir o actualizar los elementos del dataset de mosaico existentes con los archivos modificados del disco.

  • SKIP_EXISTING_ITEMSMientras se añaden nuevos elementos del dataset de mosaico, la herramienta no actualizará los elementos del dataset de mosaico existentes. Esta es la opción predeterminada.
  • OVERWRITE_EXISTING_ITEMSMientras se añaden nuevos elementos del dataset de mosaico, la herramienta no actualizará los elementos del dataset de mosaico existentes que se corresponden con los archivos del disco.
Boolean
refresh_aggregate_info
(Opcional)

Elija si desea volver a incluir los datos que se hayan podido eliminar del dataset de mosaico.

  • NO_REFRESH_INFOAl sincronizar, no incluir ningún ráster que se haya podido eliminar del dataset de mosaico. Esta es la opción predeterminada.
  • REFRESH_INFOAl sincronizar, incluir los rásteres que se hayan podido eliminar del dataset de mosaico. Para usar el parámetro refresh_aggregate_info, el parámetro existing_items se debe definir como IGNORE_EXISTING_ITEMS.
Boolean
estimate_statistics

Elija si desea calcular las estadísticas en el dataset de mosaico.

  • NO_STATISTICSAl sincronizar, no calcular las estadísticas en el dataset de mosaico. Esta es la opción predeterminada.
  • ESTIMATE_STATISTICSAl sincronizar, calcular las estadísticas en el dataset de mosaico.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_mosaic_dataset

El dataset de mosaico actualizado.

Capa de mosaico

Muestra de código

Ejemplo 1 de SynchronizeMosaicDataset (ventana de Python)

Esta es una muestra de Python para la herramienta 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", "#", "#")
Ejemplo 2 de SynchronizeMosaicDataset (script independiente)

Esta es una muestra del script de Python para la herramienta 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)

Información de licenciamiento

  • Basic: No
  • Standard: Sí
  • Advanced: Sí

Temas relacionados