Синхронизировать набор данных мозаики (Synchronize Mosaic Dataset) (Управление данными (Data Management))

Уровень лицензии:BasicStandardAdvanced

Краткая информация

Перестраивает или обновляет все элементы растра в наборе данных мозаики и обновляет доступные поля в таблице атрибутов, используя тип растра и опции, которые применялись исходно при добавлении.

Синхронизация протекает в одном направлении – изменения в исходных данных можно синхронизировать с таблицей атрибутов набора данных мозаики, но изменения в таблице атрибутов не отразятся на исходных данных (однако, исходные данные могут быть перезаписаны при синхронизации).

ВниманиеВнимание:

Изменения, выполненные во время синхронизации, отменить нельзя. Рекомендуется создать резервную копию, если изменения внесены в данные мозаики, которые могут быть перезаписаны.

Использование

Синтаксис

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})
ПараметрОбъяснениеТип данных
in_mosaic_dataset

Путь и имя набора данных мозаики.

Image Service; Mosaic Layer; String
where_clause
(дополнительно)

Для задания элементов набора данных мозаики для синхронизации можно использовать SQL. Если запрос не задан, синхронизироваться будут все элементы набора данных мозаики.

SQL Expression
new_items
(дополнительно)

Выберите, синхронизировать ли набор данных мозаики с заново обновленными элементами. При использовании этого параметра выполняется поиск новых данных в рабочей области элемента. При добавлении данных в набор данных мозаики используется тот же тип растра, что и для других элементов в той же рабочей области.

Если вы выбираете обновление новыми элементами, вы можете дополнительно выбрать, следует ли обновлять диапазоны размеров ячеек, границы или обзорные изображения, а также, следует ли обновлять существующие элементы.

  • NO_NEW_ITEMSНовые элементы, которые уже могли быть созданы ранее, не добавляются. Это значение используется по умолчанию.
  • UPDATE_WITH_NEW_ITEMSОбновляется набор данных мозаики, содержащий новые элементы в рабочих областях, где хранятся существующие элементы набора данных мозаики. Кроме того, вы можете изменить существующие элементы, используя ключевое слово OVERWRITE_EXISTING_ITEMS для параметра skip_existing_items.
Boolean
sync_only_stale
(дополнительно)

Укажите, следует ли обновлять все первичные элементы или только устаревшие первичные элементы.

Элемент считается устаревшим, если соответствующие исходные файлы, используемые при построении значений растра, изменены после создания элемента. Например, может быть выполнено обновление пространственной привязки или построение пирамид.

  • SYNC_STALEОбновляются только устаревшие элементы. Это значение используется по умолчанию.
  • SYNC_ALLОбновляются все выбранные элементы в наборе данных мозаики.
Boolean
update_cellsize_ranges
(дополнительно)

Укажите, следует ли обновлять диапазоны размеров ячеек.

  • UPDATE_CELL_SIZESДиапазоны размера ячейки будут пересчитаны для всего набора данных мозаики, однако, обновление выполняется только для элементов с недопустимой видимостью. Это значение используется по умолчанию.
  • NO_CELL_SIZES Диапазоны размера ячейки не пересчитываются.
Boolean
update_boundary
(дополнительно)

Укажите, следует ли обновлять границы.

  • UPDATE_BOUNDARY Граница будет перестроена после синхронизации набора данных мозаики. Это значение используется по умолчанию.
  • NO_BOUNDARY Перестроение границы не выполняется.
Boolean
update_overviews
(дополнительно)

Укажите, следует ли обновлять устаревшие обзорные изображения. Обзорное изображение считается устаревшим, если изменены какие-либо из базовых растров.

  • NO_OVERVIEWS Перестроение обзорных изображений не выполняется. Это значение используется по умолчанию.
  • UPDATE_OVERVIEWS Выполняется перестроение измененных обзорных изображений после синхронизации набора данных мозаики.
Boolean
build_pyramids
(дополнительно)

Выберите, следует ли выполнять построение пирамид для указанных элементов набора данных мозаики. Пирамидные слои могут быть построены для каждого элемента растра в наборе данных мозаики. Пирамидные слои могут увеличивать скорость, при которой будут отображаться растры.

  • NO_PYRAMIDSПирамидные слои не будут созданы. Это значение используется по умолчанию.
  • BUILD_PYRAMIDS Пирамидные слои будут создаваться для всех элементов растров, заданных этим инструментом.

Построение пирамид не выполняется для вновь добавленных элементов, если они добавлялись в том же экземпляре этого инструмента.

Boolean
calculate_statistics
(дополнительно)

Выберите, следует ли выполнять расчет статистики для исходного растра набора данных мозаики. Статистика требуется для набора данных мозаики при выполнении определенных задач, например, применение контрастной растяжки.

  • NO_STATISTICSСтатистика не рассчитывается. Это значение используется по умолчанию.
  • CALCULATE_STATISTICS Статистика рассчитывается для исходных растров набора данных мозаики, заданных этим инструментом.

Создание статистики не выполняется для вновь добавленных элементов, если они добавлялись в том же экземпляре этого инструмента.

Boolean
build_thumbnails
(дополнительно)

Выберите, следует ли выполнять построение образцов для указанных элементов набора данных мозаики. Образцы – это небольшие изображения с сильно заниженным разрешением, которые могут быть созданы для каждого растра в определении мозаики. Можно получить доступ к образцам, если наборы данных мозаики имеют доступ к сервису изображений и будут отображать как часть метаданных (Описание элемента).

  • NO_THUMBNAILSОбразцы не будут созданы или обновлены. Это значение используется по умолчанию.
  • BUILD_THUMBNAILSОбразцы будут созданы или обновлены для всех элементов растров, заданных этим инструментом.

Построение образцов не выполняется для вновь добавленных элементов, если они добавлялись в том же экземпляре выполнения этого инструмента.

Boolean
build_item_cache
(дополнительно)

Выберите, следует ли выполнять построение кэша для указанных элементов набора данных мозаики. Кэш будет создан при добавлении данных с помощью типов растров LAS, terrain или наборов данных LAS. Кэширование файлов также может выполняться с помощью функции Кэширование растра.

  • NO_ITEM_CACHEКэш не создается и не обновляется. Это значение используется по умолчанию.
  • BUILD_ITEM_CACHEКэш будет создан или обновлен для всех элементов растров, заданных этим инструментом.

Построение кэша не выполняется для вновь добавленных элементов, если они добавлялись в том же экземпляре этого инструмента.

Boolean
rebuild_raster
(дополнительно)

Укажите, следует ли выполнять перестроение элемента растра из источника данных с помощью исходного типа растра.

  • REBUILD_RASTERВыполняется перестроение растра из исходных данных. Все изменения, внесенные в выбранные элементы в наборе данных мозаики, будут утеряны. Это значение используется по умолчанию.
  • NO_RASTERПерестроение растров не выполняется. Остальные первичные поля будут сброшены, если выбран параметр update_fields.

Это влияет на только на те элементы, для которых выполняется синхронизация. Этот параметр неприменим в том случае, если выбран параметр UPDATE_WITH_NEW_ITEMS.

Boolean
update_fields
(дополнительно)

Укажите, следует ли обновлять поля в таблице. Это влияет на только на те элементы, для которых выполняется синхронизация.

  • UPDATE_FIELDSОбновить поля из исходных файлов. Это значение используется по умолчанию.
  • NO_FIELDS ― НЕТ_ПОЛЕЙНе сбрасывать поля в таблице из источника.

При выборе обновления полей можно определить поля для обновления, выбрав их в параметре fields_to_update (обновляемые поля). Если в какие-либо поля внесены изменения, возможно следует их удалить с помощью параметра fields_to_update.

Boolean
fields_to_update
[field_to_update,...]
(дополнительно)

Выберите, какие поля будут обновлены.

Этот параметр доступен, только если для параметра update_fields задано значение UPDATE_FIELDS.

Если в какие-либо поля внесены правки, рекомендуется убедиться в том, чтобы они не были включены в список.

Столбец RASTER можно обновить даже в том случае, если не используется ключевое слово REBUILD_RASTER. Однако, при использовании ключевого слова REBUILD_RASTER выполняется перестроение столбца RASTER даже в том случае, когда это поле не задано.

String
existing_items
(дополнительно)

Укажите, следует ли обновлять существующие элементы в наборе данных мозаики.

При выборе этой опции можно выбрать существующие параметры, которые вы хотите обновить: sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields или fields_to_update.

  • UPDATE_EXISTING_ITEMSСуществующие элементы будут обновлены с параметрами, выбранными для обновления. Это значение используется по умолчанию.
  • IGNORE_EXISTING_ITEMSСуществующие элементы не обновляются.
Boolean
broken_items
(дополнительно)

Укажите, следует ли удалять поврежденные ссылки.

Убедитесь в том, что все сетевые соединения работают корректно, так как этот инструмент удаляет все элементы, доступ к которым невозможен.

  • IGNORE_BROKEN_ITEMSЭлементы, содержащие поврежденные ссылки, не будут удаляться из набора данных мозаики. Это значение используется по умолчанию.
  • REMOVE_BROKEN_ITEMSЭлементы, содержащие поврежденные ссылки, будут удаляться из набора данных мозаики.
Boolean
skip_existing_items
(дополнительно)

Если используется ключевое слово UPDATE_WITH_NEW_ITEMS, вы также можете выбрать, пропускать или обновлять существующие элементы набора данных мозаики измененными файлами с диска.

  • SKIP_EXISTING_ITEMSПри добавлении новых элементов набора данных мозаики, инструмент не обновит существующие элементы. Это значение используется по умолчанию.
  • OVERWRITE_EXISTING_ITEMSПри добавлении новых элементов набора данных мозаики, инструмент обновит имеющиеся элементы, соответствующие измененным файлам на диске.
Boolean

Пример кода

SynchronizeMosaicDataset Пример 1 (окно Python)

Это пример Python для инструмента Синхронизировать набор данных мозаики (Synchronize Mosaic Dataset).

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", "#", "#")
SynchronizeMosaicDataset Пример 2 (автономный скрипт)

Это пример скрипта Python для инструмента Синхронизировать набор данных мозаики (Synchronize Mosaic Dataset).

# 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)

Параметры среды

Связанные темы

Информация о лицензировании

ArcGIS for Desktop Basic: Нет
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
5/10/2014