マップ サービス キャッシュのエクスポート（Export Map Server Cache） (サーバ)
サマリ
マップまたはイメージ サービスのキャッシュから、タイルをキャッシュ データセットまたはタイル パッケージとしてディスク上のフォルダにエクスポートします。タイルは、他のキャッシュにインポートするか、またはサービスから独立したラスタ データセットとして ArcGIS for Desktop またはモバイル デバイスからアクセスすることができます。
使用法
このツールを実行する前に、タイルを格納するためのフォルダをディスク上に作成します。
ArcGIS Server アカウントには、エクスポート先のキャッシュ フォルダに対する書き込みアクセス権が必要です。ArcGIS Server アカウントにエクスポート先のキャッシュ フォルダに対する書き込みアクセス権を付与できない場合、ArcGIS for Desktop クライアントにこのフォルダへの書き込みアクセス権があるときは、[データをサーバからコピー]（copy_data_from_server）パラメータを選択します。
10.1 Service Pack 1 では、このツールに [タイルの上書き] パラメータが追加され、画像をブレンドするのではなく、出力先のキャッシュ内のタイルをエクスポートされたタイルで完全に上書きできるようになりました。エクスポートされたタイルは、対象エリアに制限されます。
注意:このツールはバージョン 10.1 で、パラメータが変更されました。このツールを使用するモデルとスクリプトのうち 10.1 より前に作成されたものは、10.1 で動作するように変更する必要があります。
10.1 Service Pack 1 へ移行する場合、このツールには新しいパラメータがあるため、このツールを使用するモデルを開いて整合チェックする必要があります。この処理の詳細については、「ジオプロセシングによるキャッシュの作成と更新の自動化」をご参照ください。
構文
| パラメータ | 説明 | データ タイプ |
input_service | エクスポートするキャッシュ タイルを含むマップまたはイメージ サービス。 これは、サーバとサービスの両方の情報を含む文字列です。この文字列の構築方法を確認するには、ArcCatalog を開き、カタログ ツリーでサービスを選択して、[場所] ツールバーに表示されているテキストを記録します。バックスラッシュをスラッシュに変更します（たとえば、GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer）。 | String |
target_cache_path |
キャッシュのエクスポート先のフォルダ。このフォルダは、登録済みサーバ キャッシュ ディレクトリである必要はありません。ArcGIS Server アカウントには、エクスポート先のキャッシュ フォルダに対する書き込みアクセス権が必要です。サーバ アカウントにエクスポート先のフォルダに対する書き込みアクセス権を付与できないときに、ArcGIS for Desktop クライアントにこのフォルダへの書き込みアクセス権がある場合は、[データをサーバからコピー] パラメータを選択します。 | Folder |
export_cache_type |
キャッシュをキャッシュ データセットとしてエクスポートするか、タイル パッケージとしてエクスポートするかを選択します。ArcGIS Runtime および ArcGIS Mobile の配置では、タイル パッケージが適しています。
| String |
copy_data_from_server | ArcGIS Server アカウントにエクスポート先フォルダに対する書き込みアクセス権を付与できないときに、ArcGIS for Desktop クライアントにこのフォルダへの書き込みアクセス権がある場合のみ、COPY_DATA に対するこのオプションをオンにします。ソフトウェアは、タイルをエクスポート先のフォルダに移動する前に、サーバの出力ディレクトリにエクスポートします。
| Boolean |
storage_format_type |
エクスポートしたキャッシュの格納形式。
| String |
scales [scales,...] |
タイルのエクスポート先の縮尺レベルのリスト。 | Double |
num_of_caching_service_instances (オプション) |
このツールの実行に専用で使用する、システム/CachingTools サービスのインスタンス数の合計。ArcGIS Server への管理者接続を通して使用できる [サービス エディタ] ウィンドウで、システム/CachingTools サービスの [コンピュータごとのインスタンスの最大数] の値を大きく変更することができます。選択したインスタンス数を、サーバ コンピュータでサポートできることを確認してください。 | Long |
area_of_interest (オプション) |
キャッシュからタイルをエクスポートする範囲を空間的に制限する対象エリア（ポリゴン）。フィーチャクラスを指定するか、ArcMap で対話的に定義するフィーチャを指定できます。このパラメータは不規則な形状のエリアをエクスポートする場合に有効です。ツールはキャッシュ データセットをピクセル解像度でクリップします。 対象エリアを指定しない場合、マップ全体がエクスポートされます。 | Feature Set |
export_extent (オプション) |
エクスポートするタイルを定義する矩形の表示範囲。デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。このツールのオプション パラメータの [対象地域] を使用すると、矩形の代わりにポリゴンを使用してインポートを行えます。1 つのジョブに対して両方のパラメータを同時に指定しないようにすることをお勧めします。両方のパラメータを指定した場合は、[対象地域] パラメータが [インポート範囲] よりも優先されます。 | Extent |
overwrite (オプション) |
| Boolean |
コードのサンプル
ExportMapServerCache（マップ サービス キャッシュのエクスポート）の例 1
格納形式をエクスプロードからコンパクトに変更して、フィーチャクラスのキャッシュ タイルをエクスポートします。
# 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.ExportMapServerCache_server(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, 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(e.message)
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.ExportMapServerCache_server(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, 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(e.message)
print "Exported Map server Cache "
report.close()