Краткая информация
Вводит функцию Кэширование растра (Cached Raster) в качестве последнего шага цепочки функций набора данных мозаики.
Использование
Функция Кэширование растра вводится в начало каждой последовательности функций. Таким образом, эта функция реализуется в цепочке в последнюю очередь.
Если в этом инструменте не проверяется параметр Создать кэш (Generate Cache) (задайте для generate_cache значение GENERATE_CACHE в Python) для создания кэша, можно в этих целях использовать инструмент Синхронизировать набор данных мозаики (Synchronize Mosaic Dataset).
Кэш не будет перемещаться вместе с набором данных мозаики при размещении (публикации) на сервере. Если планируется построение кэша для набора данных мозаики, который публикуется как сервис изображений, рекомендуется применить этот инструмент для набора данных мозаики после того, как он будет опубликован на сервере. Кроме того, необходимо убедиться в том, что путь к кэшу доступен для сервера. При построении кэша до публикации набора данных мозаики можно переместить кэш на сервер и обновить путь кэша, который хранится в наборе данных мозаики.
Синтаксис
BuildMosaicDatasetItemCache_management (in_mosaic_dataset, {where_clause}, {define_cache}, {generate_cache}, {item_cache_folder}, {compression_method}, {compression_quality}, {max_allowed_rows}, {max_allowed_columns}, {request_size_type}, {request_size})| Параметр | Объяснение | Тип данных |
in_mosaic_dataset | Набор данных мозаики, для которого вы хотите применить функцию кэша. | Mosaic Layer |
where_clause (дополнительно) | SQL-выражение для выбора определенных растров в наборе данных мозаики, для которого вы хотите построить кэш. | SQL Expression |
define_cache (дополнительно) | Определите кэш для набора данных мозаики. Функция «Кэширование растра» будет добавлена в выбранные элементы. Если элемент уже содержит функцию «Кэширование растра», повторное добавление функции не выполняется.
| Boolean |
generate_cache (дополнительно) | Сформируйте файлы кэша на основе свойств, определенных в функции «Кэширование растра», например расположение и сжатие кэша.
| Boolean |
item_cache_folder (дополнительно) | Выберите перезапись положения по умолчанию для сохранения кэша. Если набор данных мозаики находится внутри файловой базы геоданных, кэш по умолчанию сохраняется в папке с тем же именем, что и база, только с расширением .cache. Если набор данных мозаики находится внутри многопользовательской базы геоданных, кэш по умолчанию сохраняется внутри базы геоданных. После создания кэш всегда хранится в одном месте. Чтобы сохранить кэш в другом местоположении, сначала воспользуйтесь инструментом Восстановить набор данных мозаики (Repair Mosaic Dataset) для указания нового местоположения, а затем снова запустите этот инструмент. После того как кэш элемента создан, повторное его создание в другом расположении путем задания другого пути кэша и повторного запуска инструмента уже невозможно. Кэш элемента все равно будет создаваться в том расположении, где он был создан в первый раз. Тем не менее, можно удалить эту функцию и добавить новую, имеющую другой путь, или использовать инструмент Восстановление набора данных мозаики (Repair Mosaic Dataset) для изменения пути кэша, после чего запустить этот инструмент и создать кэш элемента в другом расположении. | Workspace |
compression_method (дополнительно) | Выберите, как вы хотите сжать свои данные для более быстрой передачи данных.
| String |
compression_quality (дополнительно) | Укажите качество сжатия при использования сжатия с потерями. Показатель качества сжатия – это значение в диапазоне от 1 до 100 процентов, где 100 соответствует минимальному сжатию. | Long |
max_allowed_rows (дополнительно) | Ограничивает размер набора данных кэша числом строк. Если значение меньше числа строк набора данных, кэш не будет создан. | Long |
max_allowed_columns (дополнительно) | Ограничивает размер набора данных кэша числом столбцов. Если значение меньше числа столбцов набора данных, кэш не будет создан. | Long |
request_size_type (дополнительно) | Пересчитывает растр с помощью одного из двух методов:
| String |
request_size (дополнительно) | Укажите значение, чтобы применить request_size_type. | Double |
Пример кода
BuildMosaicDatasetItemCache, пример 1 (окно Python)
Это пример Python для BuildMosaicDatasetItemCache.
import arcpy
arcpy.BuildMosaicDatasetItemCache_management(
"C:/Workspace/itemcache.gdb/md", "#", "DEFINE_CACHE",
"NO_GENERATE_CACHE", "C:/workspace/itemcache", "LOSSY",
"80", "#", "#")
BuildMosaicDatasetItemCache, пример 2 (автономный скрипт)
Это пример скрипта Python для инструмента BuildMosaicDatasetItemCache.
#Define mosaic dataset item cache without generating the cache file
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "itemcache.gdb/md"
query = "#"
definecache = "DEFINE_CACHE"
generatecache = "NO_GENERATE_CACHE"
cachepath = "C:/workspace/itemcache"
compression = "LOSSY"
compquality = "80"
maxrow = "#"
maxcolumn = "#"
arcpy.BuildMosaicDatasetItemCache_management(
mdname, query, definecache, generatecache, cachepath, compression,
compquality, maxrow, maxcolumn)