Экспортировать кэш картографического сервиса (Серверные инструменты)

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

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

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

Перед запуском инструмента создайте папку на диске, в которой будут храниться экспортированные листы.
Учетная запись ArcGIS Server должна иметь право на запись в целевую папку кэша. Если учетной записи ArcGIS Server не может быть предоставлен доступ на запись в целевую папку кэша, но у клиента ArcGIS Pro такой доступ есть, отметьте параметр Копировать данные с сервера.
Параметр Перезаписать листы позволяет полностью перезаписать экспортируемыми листами листы в кэше назначения, вместо смешения изображений. Экспортируемые листы по-прежнему могут быть ограничены областью интереса.
Если отмечен параметр Формат, готовый к использованию, содержимое кэша генерируется с использованием открытой спецификации пакета листов. Формат кэша — Compact V2, но схема кэша хранится в формате JSON, а не XML. Содержимое этого кэша может быть упаковано в zip-архив в виде пакета листов для публикации и автономных рабочих процессов. Содержание этого кэша готово к использованию с применением рабочих процессов, описанных в разделе Публикация слоя листов из набора данных кэша. Этот параметр доступен только, когда значением параметра Экспортировать тип кэша является Набор данных кэша.

Подпись	Объяснение	Тип данных
Входной сервис	Слой изображения карты с полистным кэшем для экспорта. Его можно выбрать, указав сервис на портале или перетащив веб-слой листов со вкладки Портал на панели Проект, чтобы задать значение этого параметра.	Image Service; Map Server
Путь целевого кэша	Папка, в которую будет экспортирован кэш. Эта папка не обязательно должна быть зарегистрированной директорией кэша сервера. Учетная запись ArcGIS Server должна иметь право на запись в целевую папку кэша. Если учетной записи сервера не может быть предоставлен доступ на запись в целевую папку кэша, но у клиента ArcGIS Desktop или ArcGIS Pro такой доступ есть, поставьте отметку для параметра Копировать данные с сервера.	Folder
Экспортировать тип кэша	Определяет тип кэша, который будет экспортирован. Пакеты листов подходят для использования с ArcGIS Maps SDKs for Native Apps. Набор данных кэша–Будет экспортирован кэш картографического сервиса или сервиса изображений, созданный ArcGIS Server. Он используется в ArcGIS Desktop и картографическими сервисами и сервисами изображений ArcGIS Server. Эта опция позволяет вам создать ресурсы в готовом для обслуживания формате. Используется по умолчанию. Пакет листов–Будет импортирован один сжатый файл, в котором набор данных кэша добавлен в виде слоя и объединен для совместного использования. Он может использоваться в ArcGIS Pro и ArcGIS Maps SDKs for Native Apps.	String
Копировать данные с сервера	Определяет, как листы будут перемещены в целевую папку. Отметьте этот параметр, если учетной записи ArcGIS Server не может быть предоставлен доступ на запись в целевую папку, а у клиента ArcGIS Desktop или ArcGIS Pro такой доступ есть. Программное обеспечение экспортирует листы в выходную директорию сервера, прежде чем переместить их в целевую папку. Отмечено–Листы помещаются в выходную директорию сервера, а затем перемещаются в целевую папку. У клиента ArcGIS Desktop или ArcGIS Pro должно быть право на запись в целевую папку. Не отмечено–Листы экспортируются непосредственно в целевую папку. У учетной записи ArcGIS Server должно быть право на запись в целевую папку. Используется по умолчанию.	Boolean
Тип формата хранения	Определяет формат хранения, который будет использоваться для экспортируемого кэша. Сжатый–Листы группируются в пакетные файлы для экономии места на диске и ускорения копирования кэша. Если для параметра Экспортировать тип кэша задано Пакет листов, это происходит по умолчанию. Уплотнить V2–Листы группируются только в пакетные файлы. Этот формат обеспечивает повышенную производительность работы в общих сетевых директориях и облачных хранилищах. Если для параметра Экспортировать тип кэша задано значение Пакет листов, то расширением этого пакета листов будет `.tpkx`, которое поддерживается более новыми версиями продуктов ArcGIS, например, ArcGIS Online, ArcGIS Enterprise 12.0, ArcGIS Maps SDKs for Native Apps 200.0 или позднее и ArcGIS Runtime 100.5-100.15. Полистный–Каждый лист будет храниться как отдельный файл.	String
Масштабы	Список уровней масштаба, на которых будут экспортированы листы.	Double
Число экземпляров кэшированного сервиса (Дополнительный)	Число экземпляров, использующихся для обновления или создания листов. Значение этого параметра установлено как – без ограничений (-1) и не может быть изменено.	Long
Область интереса (Дополнительный)	Область интереса, ограничивающая область экспорта листов из кэша. Этот параметр полезен, если вы хотите экспортировать области неправильной формы, т.к. инструмент обрезает набор данных кэша на пиксельном разрешении. Если область интереса не указана, экспортируется полный экстент карты.	Feature Set
Экстент экспорта (Дополнительный)	Прямоугольный экстент определяет листы, которые будут экспортированы. По умолчанию экстент соответствует полному экстенту картографического сервиса, в который вы производите импорт. Дополнительный параметр Область интереса позволяет импортировать альтернативно с помощью полигона. Рекомендуется не указывать значения обоих параметров. Если значения приведены для обоих параметров, параметр Область интереса имеет приоритет над этим параметром. Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Нарисовать экстент - Экстент будет основан на прямоугольнике, нарисованном на карте или в сцене. Экстент слоя — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции: Все объекты - Экстент всех объектов. Выбранные объекты - используйте экстент выбранных объектов. Отображаемые объекты - Экстент отображаемых объектов. Обзор — Экстент будет основан на наборе данных. Буфер обмена - Экстент может быть скопирован в буфер обмена и вставлен из него. Копировать экстент - Копирует координаты экстента и систему координат в буфер обмена. Вставить экстент - Вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержит систему координат, экстент будет использовать систему координат карты. Сбросить экстент — Экстент будет сброшен до значения по умолчанию. Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.	Extent
Перезаписать листы (Дополнительный)	Задает, будут ли изображения в кэше назначения объединены с листами из исходного кэша или они будут перезаписаны ими. Отмечено–Все пикселы области интереса будут заменены, что позволяет перезаписать кэш назначения листами из исходного кэша. Не отмечено–При экспорте листов прозрачные пикселы исходного кэша игнорируются. Это позволяет получить объединенное или смешанное изображение в кэше назначения. Используется по умолчанию.	Boolean
Готовый для обслуживания формат (Дополнительный)	Указывает, будет ли содержание кэша создаваться с использованием открытой спецификации пакета листов, а также формат файла схемы кэша. Этот параметр может использоваться только в случае, если значением параметра Экспортировать тип кэша является Набор данных кэша. Отмечено–Содержимое кэша будет сгенерировано с использованием открытой спецификации пакета листов (`https://github.com/Esri/tile-package-spec`). Пакет листов может быть упакован в zip-архив как пакет листов для автономных рабочих процессов. Формат кэша будет Compact V2, а схема кэша будет храниться в формате JSON. Не отмечено–Содержимое кэша будет сгенерировано с использованием схемы, хранящейся в формате XML. Используйте эту опцию для копирования кэша в предыдущие версии ArcGIS Enterprise. Используется по умолчанию.	Boolean

Производные выходные данные

Подпись	Объяснение	Тип данных
Путь к выходному кэшу	Папка, в которую был экспортирован кэш.	String

arcpy.server.ExportMapServerCache(input_service, target_cache_path, export_cache_type, copy_data_from_server, storage_format_type, scales, {num_of_caching_service_instances}, {area_of_interest}, {export_extent}, {overwrite}, {ready_to_serve_format})

Имя	Объяснение	Тип данных
input_service	Слой изображения карты с полистным кэшем для экспорта.	Image Service; Map Server
target_cache_path	Папка, в которую будет экспортирован кэш. Эта папка не обязательно должна быть зарегистрированной директорией кэша сервера. Учетная запись ArcGIS Server должна иметь право на запись в целевую папку кэша. Если учетной записи сервера не может быть предоставлен доступ на запись в целевую папку кэша, но у клиента ArcGIS Desktop или ArcGIS Pro такой доступ есть, поставьте отметку для параметра Копировать данные с сервера.	Folder
export_cache_type	Определяет тип кэша, который будет экспортирован. Пакеты листов подходят для использования с ArcGIS Maps SDKs for Native Apps. `CACHE_DATASET`–Будет экспортирован кэш картографического сервиса или сервиса изображений, созданный ArcGIS Server. Он используется в ArcGIS Desktop и картографическими сервисами и сервисами изображений ArcGIS Server. Эта опция позволяет вам создать ресурсы в готовом для обслуживания формате. Используется по умолчанию. `TILE_PACKAGE`–Будет импортирован один сжатый файл, в котором набор данных кэша добавлен в виде слоя и объединен для совместного использования. Он может использоваться в ArcGIS Pro и ArcGIS Maps SDKs for Native Apps.	String
copy_data_from_server	Определяет, как листы будут перемещены в целевую папку. Установите этот параметр на `COPY_DATA`, если учетной записи ArcGIS Server не может быть предоставлен доступ на запись в целевую папку, а у клиента ArcGIS Desktop или ArcGIS Pro такой доступ есть. Программное обеспечение экспортирует листы в выходную директорию сервера, прежде чем переместить их в целевую папку. `COPY_DATA`–Листы помещаются в выходную директорию сервера, а затем перемещаются в целевую папку. У клиента ArcGIS Desktop или ArcGIS Pro должно быть право на запись в целевую папку. `DO_NOT_COPY`–Листы экспортируются непосредственно в целевую папку. У учетной записи ArcGIS Server должно быть право на запись в целевую папку. Используется по умолчанию.	Boolean
storage_format_type	Определяет формат хранения, который будет использоваться для экспортируемого кэша. `COMPACT`–Листы группируются в пакетные файлы для экономии места на диске и ускорения копирования кэша. Если для параметра `export_cache_type` задано `TILE_PACKAGE`, это происходит по умолчанию. `COMPACT_V2`–Листы группируются только в пакетные файлы. Этот формат обеспечивает повышенную производительность работы в общих сетевых директориях и облачных хранилищах. Если для параметра `export_cache_type` задано значение `TILE_PACKAGE`, то расширением этого пакета листов будет `.tpkx`, которое поддерживается более новыми версиями продуктов ArcGIS, например, ArcGIS Online, ArcGIS Enterprise 12.0, ArcGIS Maps SDKs for Native Apps 200.0 или позднее и ArcGIS Runtime 100.5-100.15. `EXPLODED`–Каждый лист будет храниться как отдельный файл.	String
scales [scales,...]	Список уровней масштаба, на которых будут экспортированы листы.	Double
num_of_caching_service_instances (Дополнительный)	Число экземпляров, использующихся для обновления или создания листов. Значение этого параметра установлено как – без ограничений (-1) и не может быть изменено.	Long
area_of_interest (Дополнительный)	Область интереса, ограничивающая область экспорта листов из кэша. Этот параметр полезен, если вы хотите экспортировать области неправильной формы, т.к. инструмент обрезает набор данных кэша на пиксельном разрешении. Если область интереса не указана, экспортируется полный экстент карты.	Feature Set
export_extent (Дополнительный)	Прямоугольный экстент определяет листы, которые будут экспортированы. По умолчанию экстент соответствует полному экстенту картографического сервиса, в который вы производите импорт. Дополнительный параметр Область интереса позволяет импортировать альтернативно с помощью полигона. Рекомендуется не указывать значения обоих параметров. Если значения приведены для обоих параметров, параметр Область интереса имеет приоритет над этим параметром. `MAXOF` – Будет использоваться максимальный экстент всех входных данных. `MINOF` – Будет использоваться минимальная область, которая является общей для всех входных данных. `DISPLAY` — Экстент равен видимому отображению. Имя слоя — Будет использоваться экстент указанного слоя. `Extent` Объект — будет использоваться экстент указанного объекта. Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.	Extent
overwrite (Дополнительный)	Задает, будут ли изображения в кэше назначения объединены с листами из исходного кэша или они будут перезаписаны ими. `OVERWRITE`–Все пикселы области интереса будут заменены, что позволяет перезаписать кэш назначения листами из исходного кэша. `MERGE`–При экспорте листов прозрачные пикселы исходного кэша игнорируются. Это позволяет получить объединенное или смешанное изображение в кэше назначения. Используется по умолчанию.	Boolean
ready_to_serve_format (Дополнительный)	Указывает, будет ли содержание кэша создаваться с использованием открытой спецификации пакета листов, а также формат файла схемы кэша. Этот параметр используется только в том случае, когда значение параметра `export_cache_type` равно `CACHE_DATASET`. `READY_TO_SERVE_FORMAT`–Содержимое кэша будет сгенерировано с использованием открытой спецификации пакета листов (`https://github.com/Esri/tile-package-spec`). Пакет листов может быть упакован в zip-архив как пакет листов для автономных рабочих процессов. Формат кэша будет Compact V2, а схема кэша будет храниться в формате JSON. `NON_READY_TO_SERVE_FORMAT`–Содержимое кэша будет сгенерировано с использованием схемы, хранящейся в формате XML. Используйте эту опцию для копирования кэша в предыдущие версии ArcGIS Enterprise. Используется по умолчанию.	Boolean

Производные выходные данные

Имя	Объяснение	Тип данных
output_cache_path	Папка, в которую был экспортирован кэш.	String

Пример кода

ExportMapServerCache, пример 1 (автономный скрипт)

Экспорт листов кэша для класса объектов при изменении формата хранения с EXPLODED на COMPACT.

# Name: ExportMapServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to export
#              cache from a map layer in ArcGIS Enterprise portal,
#              as CACHE_DATASET in COMPACT_V2 storage format and MERGE tiles
#              using an AREA_OF_INTEREST to TARGET_CACHE_PATH
#              which is accessible to server instances

# Example: This sample script updates map cache tiles.

import arcpy
from arcpy import env
import sys
import time
import datetime

# Set environment settings
env.workspace = "C:/data"

# Sign in to ArcGIS Enterprise
myPortal= "https://MyPortal.domain.com/portalwebadaptor"
arcpy.SignInToPortal(myPortal, "siteadminValue", "siteadminPassword")
myServer="https://Myserver.domain.com/serverwebadaptor"
serviceName= "SampleWorldCities"
serviceType= "MapServer"
myPortalServiceURL = (myServer + "/" + "rest/services" +"/" + serviceName + "/"
                      + serviceType)

# Stand alone ArcGIS Server
##target_server_connection = r"C:\share\python3\arcgis on MyServer.ags"
##serviceName= "MyServiceName"
##serviceType= ".MapServer"
##myPortalServiceURL = (target_server_connection +  "\\" + serviceName + serviceType)

print (myPortalServiceURL)

#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = r'C:\test\report_%s.txt'% arg1

# List of input variables for map or image service
targetCachePath     = "C:/data/temp"
exportCacheType     = "CACHE_DATASET"
copyDataFromServer     = "DO_NOT_COPY"
storageFormat         = "COMPACT_V2"
scales             = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest         = "C:/data/101/Portland/Metro.shp"
exportExtents         = ""
overwriteTiles         = "MERGE"
ready_to_serve_format   = "NON_READY_TO_SERVE_FORMAT"

# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ExportMapServerCache(myPortalServiceURL, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, exportExtents,
                                               overwriteTiles,
                                               ready_to_serve_format)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Exported cache successfully for " + serviceName )

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))
report.close()

ExportMapServerCache, пример 2 (автономный скрипт)

Экспорт кэша с помощью TILE_PACKAGE, когда папка назначения недоступна для экземпляров ArcGIS Server.

# Name: ExportMapServerCacheTiles2.py
# Description: The following stand-alone script demonstrates how to export cache
#               on a map service on standalone server as TILE_PACKAGE for default number of scales of a service, to a
#               TARGET_CACHE_PATH which is inaccessible to server instances using
#               COPY_DATA_FROM_SERVER

# Example: This sample script updates map cache tiles.

import arcpy
from arcpy import env
import sys
import time
import datetime

# Set environment settings
env.workspace = "C:/data"

### Sign in to ArcGIS Enterprise
##myPortal= "https://MyPortal.domain.com/portalwebadaptor"
##arcpy.SignInToPortal(myPortal, "siteadminValue", "siteadminPassword")
##myServer="https://Myserver.domain.com/serverwebadaptor"
##serviceName= "SampleWorldCities"
##serviceType= "MapServer"
##myPortalServiceURL = (myServer + "/" + "rest/services" +"/" + serviceName + "/"
##                      + serviceType)

# Stand alone ArcGIS Server
target_server_connection = r"C:\share\python3\arcgis on MyServer.ags"
serviceName= "MyServiceName"
serviceType= ".MapServer"
myPortalServiceURL = (target_server_connection +  "\\" + serviceName + serviceType)

print (myPortalServiceURL)

#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = r'C:\test\report_%s.txt'% arg1

# List of input variables for map or image service
targetCachePath = "C:/temp/usa"
exportCacheType = "TILE_PACKAGE"
copyDataFromServer = "COPY_DATA"
storageFormat = "COMPACT_V2"
scaleValues = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
exportExtents = ""
areaOfInterest = ""
overwriteTiles = "MERGE"
ready_to_serve_format = "NON_READY_TO_SERVE_FORMAT"

# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest,
                                               exportExtents, overwriteTiles,
                                               ready_to_serve_format)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Exported cache successfully for " + serviceName )

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))
report.close()

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

Этот инструмент не использует параметры среды геообработки.

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

Basic: Да
Standard: Да
Advanced: Да

Экспортировать кэш картографического сервиса (Серверные инструменты)

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

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

Параметры

Производные выходные данные

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

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

Связанные разделы