マップサービスキャッシュのエクスポート (Export Map Server Cache) (サーバー)—ArcGIS Pro

サマリー

マップイメージレイヤーのキャッシュから、タイルをキャッシュデータセットまたはタイルパッケージとしてディスク上のフォルダーにエクスポートします。タイルは、他のキャッシュにインポートするか、またはサービスから独立したラスターデータセットとして ArcGIS Desktop またはモバイルデバイスからアクセスすることができます。

使用法

このツールを実行する前に、タイルを格納するためのフォルダーをディスク上に作成します。
ArcGIS Server アカウントには、エクスポート先のキャッシュフォルダーに対する書き込みアクセス権が必要です。 ArcGIS Server アカウントにエクスポート先のフォルダーに対する書き込みアクセス権を付与できないときに、ArcGIS Pro のクライアントにこのフォルダーへの書き込みアクセス権がある場合は、[データをサーバーからコピー] (copy_data_from_server) パラメーターを選択します。
[タイルの上書き] パラメーターにより、画像をブレンドするのではなく、出力先のキャッシュ内のタイルをエクスポートされたタイルで完全に上書きできるようになりました。エクスポートされたタイルは、対象エリアに制限されます。

パラメーター

ラベル	説明	データタイプ
入力サービス	エクスポートするキャッシュタイルを含むマップイメージレイヤー。ポータルで必要なサービスを参照してこれを選択できます。または、[プロジェクト] ウィンドウの [ポータル] タブから Web タイルレイヤーをドラッグして、このパラメーターを指定することもできます。	Image Service; Map Server
ターゲットキャッシュパス	キャッシュのエクスポート先のフォルダー。このフォルダーは、登録済みサーバーキャッシュディレクトリである必要はありません。 ArcGIS Server アカウントには、エクスポート先のキャッシュフォルダーに対する書き込みアクセス権が必要です。サーバーアカウントにエクスポート先のフォルダーに対する書き込みアクセス権を付与できないときに、ArcGIS Desktop または ArcGIS Pro のクライアントにこのフォルダーへの書き込みアクセス権がある場合は、[データをサーバーからコピー] パラメーターを選択します。	Folder
エクスポートするキャッシュのタイプ	キャッシュをキャッシュデータセットまたはタイルパッケージとしてエクスポートします。 ArcGIS Runtime および ArcGIS Mobile の配置では、タイルパッケージが適しています。キャッシュデータセット—ArcGIS Server を使用して生成されるマップまたはイメージサービスキャッシュ。これは、ArcGIS Desktop と、ArcGIS Server のマップまたはイメージサービスで使用できます。これがデフォルトです。タイルパッケージ—キャッシュデータセットがレイヤーとして追加され、共有できるように統合された単一の圧縮ファイル。これは、ArcGIS Desktop、ArcGIS Runtime、およびモバイルアプリで使用できます。	String
データをサーバーからコピー	ArcGIS Server アカウントにエクスポート先フォルダーに対する書き込みアクセス権を付与できないときに、ArcGIS Desktop または ArcGIS Pro のクライアントにこのフォルダーへの書き込みアクセス権がある場合のみ、このパラメーターをオンにします。ソフトウェアは、タイルをエクスポート先のフォルダーに移動する前に、サーバーの出力ディレクトリにエクスポートします。オン - タイルはサーバーの出力ディレクトリに配置された後、エクスポート先のフォルダーに移動されます。 ArcGIS Desktop クライアントには、エクスポート先のフォルダーに対する書き込みアクセス権が必要です。オフ - タイルは直接エクスポート先のフォルダーにエクスポートされます。 ArcGIS Server アカウントには、エクスポート先のフォルダーに対する書き込みアクセス権が必要です。	Boolean
格納形式タイプ	エクスポートしたキャッシュの格納形式。コンパクト—タイルは、ディスク領域の節約とキャッシュのコピーの高速化を可能にするために、bundle および bundlex ファイルにグループ化されます。 [エクスポートするキャッシュのタイプ] パラメーターが [タイルパッケージ] に設定されている場合は、これがデフォルトです。コンパクト V2—タイルはバンドルファイルのみにグループ化されます。この形式は、ネットワーク共有とクラウドストアディレクトリのパフォーマンスを向上させます。 [エクスポートするキャッシュのタイプ] パラメーターが [タイルパッケージ] に設定されている場合、タイルパッケージの拡張子は (*.tpkx) になります。これは、ArcGIS Online、ArcGIS Enterprise 11.2、ArcGIS Runtime 100.5 などの新しいバージョンの ArcGIS プラットフォームによってサポートされます。エクスプロード—各タイルは、個別のファイルとして格納されます (ArcGIS Server よりも前のバージョンでのキャッシュの格納方法)。	String
縮尺	タイルのエクスポート先の縮尺レベルのリスト。	Double
キャッシュサービスのインスタンス数 (オプション)	タイルの更新または生成に使用するインスタンスの数を指定します。このパラメーターの値は無制限 (-1) に設定され、変更できません。	Long
対象エリア (オプション)	キャッシュからタイルをエクスポートする範囲を空間的に制限する対象エリア。このパラメーターは不規則な形状のエリアをエクスポートする場合に有効です。ツールはキャッシュデータセットをピクセル解像度でクリップします。対象エリアを指定しない場合、マップ全体がエクスポートされます。	Feature Set
エクスポート範囲 (オプション)	エクスポートするタイルを定義する矩形の表示範囲。デフォルトでは、表示範囲は、インポートするマップサービスの全体表示に設定されます。このツールのオプションパラメーターの [対象エリア] を使用すると、矩形の代わりにポリゴンを使用してインポートを行えます。 1 つのジョブに対して両方のパラメーターを同時に指定しないようにすることをお勧めします。両方のパラメーターを指定した場合は、[対象エリア] パラメーターが [インポート範囲] よりも優先されます。 [現在の表示範囲] - 範囲は、アクティブなマップまたはシーンに基づきます。このオプションは、アクティブなマップが存在する場合にのみ使用できます。 [レイヤーの範囲] - 範囲は、アクティブなマップレイヤーに基づきます。ドロップダウンリストを使用して使用可能なレイヤーを選択するか、[すべてのレイヤーのデータの範囲] オプションを使用して、ベースマップを除くすべてのアクティブなマップレイヤーを組み合わせた範囲を取得します。このオプションは、レイヤーを含むアクティブなマップが存在する場合にのみ使用できます。 [参照] - 範囲は、既存のデータに基づきます。 [範囲をリセット] - 範囲はデフォルト値にリセットされます。手動入力した座標値 - 座標値は数値であり、アクティブなマップの座標系で表示する必要があります。マップで異なる表示単位が使用されていることがあります	Extent
タイルの上書き (オプション)	エクスポート先のキャッシュ内にある画像を、作成されたキャッシュのタイルとマージするか、タイルで上書きするかを指定します。オン - エクスポートにより、対象エリアのすべてのピクセルが置き換えられます。エクスポート先のキャッシュ内にあるタイルを、作成されたキャッシュのタイルで完全に上書きします。オフ - タイルのエクスポート時に、作成されたキャッシュ内の透明なピクセルはデフォルトで無視されます。この結果、エクスポート先のキャッシュはマージまたはブレンドされます。これがデフォルトです。	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})

名前	説明	データタイプ
input_service	エクスポートするキャッシュタイルを含むマップイメージレイヤー。	Image Service; Map Server
target_cache_path	キャッシュのエクスポート先のフォルダー。このフォルダーは、登録済みサーバーキャッシュディレクトリである必要はありません。 ArcGIS Server アカウントには、エクスポート先のキャッシュフォルダーに対する書き込みアクセス権が必要です。サーバーアカウントにエクスポート先のフォルダーに対する書き込みアクセス権を付与できないときに、ArcGIS Desktop または ArcGIS Pro のクライアントにこのフォルダーへの書き込みアクセス権がある場合は、[データをサーバーからコピー] パラメーターを選択します。	Folder
export_cache_type	キャッシュをキャッシュデータセットまたはタイルパッケージとしてエクスポートします。 ArcGIS Runtime および ArcGIS Mobile の配置では、タイルパッケージが適しています。 CACHE_DATASET—ArcGIS Server を使用して生成されるマップまたはイメージサービスキャッシュ。これは、ArcGIS Desktop と、ArcGIS Server のマップまたはイメージサービスで使用できます。これがデフォルトです。 TILE_PACKAGE—キャッシュデータセットがレイヤーとして追加され、共有できるように統合された単一の圧縮ファイル。これは、ArcGIS Desktop、ArcGIS Runtime、およびモバイルアプリで使用できます。	String
copy_data_from_server	ArcGIS Server アカウントにエクスポート先フォルダーに対する書き込みアクセス権を付与できないときに、ArcGIS Desktop または ArcGIS Pro のクライアントにこのフォルダーへの書き込みアクセス権がある場合、このパラメーターを COPY_DATA に設定します。ソフトウェアは、タイルをエクスポート先のフォルダーに移動する前に、サーバーの出力ディレクトリにエクスポートします。 COPY_DATA—タイルはサーバーの出力ディレクトリに配置された後、エクスポート先のフォルダーに移動されます。 ArcGIS Desktop または ArcGIS Pro のクライアントには、エクスポート先のフォルダーに対する書き込みアクセス権が必要です。 DO_NOT_COPY—タイルは直接エクスポート先のフォルダーにエクスポートされます。 ArcGIS Server アカウントには、エクスポート先のフォルダーに対する書き込みアクセス権が必要です。これがデフォルトです。	Boolean
storage_format_type	エクスポートしたキャッシュの格納形式。 COMPACT—タイルは、ディスク領域の節約とキャッシュのコピーの高速化を可能にするために、bundle および bundlex ファイルにグループ化されます。 export_cache_type パラメーターが Tile package に設定されている場合、これがデフォルトです。 COMPACT_V2—タイルはバンドルファイルのみにグループ化されます。この形式は、ネットワーク共有とクラウドストアディレクトリのパフォーマンスを向上させます。 export_cache_type パラメーターが Tile package に設定されている場合、タイルパッケージの拡張子は (*.tpkx) になります。これは、ArcGIS Online、ArcGIS Enterprise 11.2、ArcGIS Runtime 100.5 などの新しいバージョンの ArcGIS プラットフォームによってサポートされます。 EXPLODED—各タイルは、個別のファイルとして格納されます (ArcGIS Server よりも前のバージョンでのキャッシュの格納方法)。	String
scales [scales,...]	タイルのエクスポート先の縮尺レベルのリスト。	Double
num_of_caching_service_instances (オプション)	タイルの更新または生成に使用するインスタンスの数を指定します。このパラメーターの値は無制限 (-1) に設定され、変更できません。	Long
area_of_interest (オプション)	キャッシュからタイルをエクスポートする範囲を空間的に制限する対象エリア。このパラメーターは不規則な形状のエリアをエクスポートする場合に有効です。ツールはキャッシュデータセットをピクセル解像度でクリップします。対象エリアを指定しない場合、マップ全体がエクスポートされます。	Feature Set
export_extent (オプション)	エクスポートするタイルを定義する矩形の表示範囲。デフォルトでは、表示範囲は、インポートするマップサービスの全体表示に設定されます。このツールのオプションパラメーターの [対象エリア] を使用すると、矩形の代わりにポリゴンを使用してインポートを行えます。 1 つのジョブに対して両方のパラメーターを同時に指定しないようにすることをお勧めします。両方のパラメーターを指定した場合は、[対象エリア] パラメーターが [インポート範囲] よりも優先されます。 MAXOF - すべての入力データの最大範囲が使用されます。 MINOF - すべての入力データに共通する最小領域が使用されます。 DISPLAY - 範囲は、表示範囲と同じになります。レイヤー名 - 指定されたレイヤーの範囲が使用されます。 Extent オブジェクト - 指定されたオブジェクトの範囲が使用されます。スぺース区切りの座標文字列 - 指定された文字列の範囲が使用されます。座標値は、x-min、y-min、x-max、y-max という順序で表記されます。	Extent
overwrite (オプション)	エクスポート先のキャッシュ内にある画像を、作成されたキャッシュのタイルとマージするか、タイルで上書きするかを指定します。 OVERWRITE—エクスポートにより、対象エリアのすべてのピクセルが置き換えられます。エクスポート先のキャッシュ内にあるタイルを、作成されたキャッシュのタイルで完全に上書きします。 MERGE—タイルのインポート時に、作成されたキャッシュ内の透明なピクセルはデフォルトで無視されます。この結果、エクスポート先のキャッシュはマージまたはブレンドされます。これがデフォルトです。	Boolean

派生した出力

名前	説明	データタイプ
output_cache_path	キャッシュのエクスポート先のフォルダー。	String

コードのサンプル

ExportMapServerCache (マップサーバーキャッシュのエクスポート) の例 1 (スタンドアロンスクリプト)

格納形式を EXPLODED から COMPACT に変更して、フィーチャクラスのキャッシュタイルをエクスポートします。

# Name: ExportMapServerCache.py for ArcGIS Server
# Description: The following stand-alone script demonstrates how to export
# 		cache as CACHE_DATASET in COMPACT storage format and MERGE tiles
#               using an AREA_OF_INTEREST to TARGET_CACHE_PATH
#		which is accessible to server instances
# Requirements: os, sys, time and traceback modules

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
#                                                           "sys.argv[]"

# Import system modules
import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string

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

# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server 			= "arcgis on MyServer_6080 (publisher)"
serviceName 		= "Rainfall.MapServer"
inputService 		= connectionFile + "\\" + server + "\\" + serviceName
targetCachePath 	= "C:/data/temp"
exportCacheType 	= "CACHE_DATASET"
copyDataFromServer 	= "DO_NOT_COPY"
storageFormat 		= "COMPACT"
scales 			= [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest 		= "C:/data/101/Portland/Metro.shp"
exportExtents 		= ""
overwriteTiles 		= "MERGE"

currentTime = datetime.datetime.now()
arg1 	= currentTime.strftime("%H-%M")
arg2 	= currentTime.strftime("%Y-%m-%d %H:%M")
file 	= 'C:/data/report_%s.txt' % arg1

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

# use "scaleValues[0]","scaleValues[-1]","scaleValues[0:3]"

# Enter rectangular custom extent values for the "exportExtents" variable to
# constrain the exporting cache along the rectangular extents

try:
    starttime = time.clock()
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, exportExtents,
					       overwriteTiles)
    finishtime = time.clock()
    elapsedtime = finishtime - starttime

    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print("Exported cache successfully for mapservice " + serviceName + \
        " to " + targetCachePath + "\n using " + areaOfInterest + "\n in " + \
        str(elapsedtime) + " sec \n on " + arg2)

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

print("Exported Map server Cache  using area of Interest")

report.close()

ExportMapServerCache (マップサーバーキャッシュのエクスポート) の例 2 (スタンドアロンスクリプト)

ArcGIS Server インスタンスからエクスポート先のフォルダーにアクセスできない場合に、キャッシュを TILE_PACKAGE としてエクスポートします。

# Name: ExportMapServerCache.py
# Description: The following stand-alone script demonstrates how to export cache
#               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
# Requirements: os, sys, time and traceback modules

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
#                                                           "sys.argv[]"

# Import system modules
import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string

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

# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
targetCachePath = "C:/temp/usa"
exportCacheType = "TILE_PACKAGE"
copyDataFromServer = "COPY_DATA"
storageFormat = "COMPACT"
scaleValues = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
exportExtents = ""
areaOfInterest = ""
overwriteTiles = "MERGE"

currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1

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

# use "scaleValues[0]","scaleValues[-1]","scaleValues[0:3]"

try:
    starttime = time.clock()
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest,
                                               exportExtents, overwriteTiles)
    finishtime = time.clock()
    elapsedtime = finishtime - starttime

    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print("Exported cache successfully for mapservice " + serviceName + " to " + \
        targetCachePath + " in " + str(elapsedtime) + " sec \n on" + arg2)

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

print("Exported Map server Cache ")

report.close()

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

ARCGIS

機能

ArcGIS の購入

業種

サポートとサービス

セルフサービス

Esri に連絡

Esri ストーリー

Esri について

GIS について

イノベーションへの取り組み

派生した出力

派生した出力

コードのサンプル

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容