マップ サービス キャッシュのインポート(Import Map Server Cache) (サーバ)

ライセンス レベル:BasicStandardAdvanced

サマリ

マップまたはイメージ サービスのキャッシュに、ディスク上のフォルダからタイルをインポートします。ソース フォルダには、登録済みサーバ キャッシュ ディレクトリの子、以前にキャッシュをエクスポートしたフォルダ、またはタイル パッケージ(*.tpk)を指定できます。ターゲット サービスのタイル スキーマと格納形式は、ソース キャッシュと同じである必要があります。

使用法

構文

ImportMapServerCache_server (input_service, source_cache_type, {source_cache_dataset}, {source_tile_package}, {upload_data_to_server}, {scales}, {num_of_caching_service_instances}, {import_extent}, {area_of_interest}, {overwrite})
パラメータ説明データ タイプ
input_service

タイルのインポート先となるマップまたはイメージ サービス。

これは、サーバとサービスの両方の情報を含む文字列です。この文字列の構築方法を確認するには、ArcCatalog を開き、カタログ ツリーでサービスを選択して、[場所] ツールバーに表示されているテキストを記録します。バックスラッシュをスラッシュに変更します(たとえば、GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer)。

String
source_cache_type

サーバで実行中のキャッシュされたマップまたはイメージ サービスに対して、CACHE_DATASET または TILE_PACKAGE のどちらからキャッシュをインポートするかを選択します。

  • CACHE_DATASETArcGIS Server を使用して生成されるマップまたはイメージ サービス キャッシュ。ArcMap と、ArcGIS Server のマップまたはイメージ サービスで使用されます。
  • TILE_PACKAGEキャッシュ データセットがレイヤとして追加され、簡単に共有できるように統合された単一の圧縮ファイル。ArcGIS for Desktop や、ArcGIS Runtime およびモバイル アプリケーションで使用できます。
String
source_cache_dataset
(オプション)

データ フレーム名に一致するキャッシュ フォルダのパス。登録済みのサーバ キャッシュ ディレクトリを入力する必要はありません。ほとんどの場合は、以前にタイルをエクスポートしたディスク上の場所を入力します。このパラメータには、ArcGIS Server アカウントがアクセスできる場所を指定します。この場所へのアクセス権を ArcGIS Server アカウントに付与できない場合は、upload_data_to_server を UPLOAD_DATA に設定します。

Raster Dataset
source_tile_package
(オプション)

インポートするタイル パッケージ(*.tpk)のパス。このパラメータには、ArcGIS Server アカウントがアクセスできる場所を指定します。タイル パッケージ ファイルをキャッシュされたマップまたはイメージ サービスにインポートする場合、upload_data_to_server パラメータは無視され、自動的に UPLOAD_DATA に設定されます。

File
upload_data_to_server
(オプション)

ArcGIS Server アカウントにソース キャッシュに対する読み取りアクセス権がない場合は、このパラメータを UPLOAD_DATA に設定します。キャッシュが ArcGIS Server のキャッシュ ディレクトリに移動される前に、ソース キャッシュが ArcGIS Server のアップロード ディレクトリにアップロードされます。

  • UPLOAD_DATAタイルはサーバのアップロード ディレクトリに配置された後、サーバのキャッシュ ディレクトリに移動されます。storage_format_type が TILE_PACKAGE に設定されている場合は、デフォルトでこの設定が有効になります。
  • DO_NOT_UPLOADタイルは直接、サーバのキャッシュ ディレクトリにインポートされます。ArcGIS Server アカウントには、ソース キャッシュに対する読み取りアクセス権が必要です。
Boolean
scales
[scales,...]
(オプション)

タイルがインポートされる縮尺レベルのリスト。

Double
num_of_caching_service_instances
(オプション)

このツールの実行に専用で使用する、システム/CachingTools サービスのインスタンス数の合計。ArcGIS Server への管理者接続を通して使用できる [サービス エディタ] ウィンドウで、システム/CachingTools サービスの [コンピュータごとのインスタンスの最大数] の値を大きく変更することができます。選択したインスタンス数を、サーバ コンピュータでサポートできることを確認してください。

Long
import_extent
(オプション)

キャッシュにインポートするタイルを定義する矩形の範囲。デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。このツールのオプション パラメータの [対象地域] を使用すると、不規則な形状を使用してインポート対象のタイルを空間的に制限できます。両方のパラメータを指定した場合は、[対象地域] パラメータが [インポート範囲] よりも優先されます。

Extent
area_of_interest
(オプション)

タイルをキャッシュにインポートする範囲を空間的に制限する対象エリアのポリゴン。フィーチャクラスを指定するか、ArcMap で対話的に定義するフィーチャを指定できます。このパラメータは、不規則な形状のエリアにタイルをインポートする場合に便利です。ツールはピクセル解像度でポリゴンと交差するキャッシュ データセットをクリップし、その結果をサービス キャッシュ ディレクトリにインポートします。

このパラメータに値を指定しない場合は、[インポート範囲] パラメータの値が使用されます。デフォルトでは、マップの全範囲が使用されます。

Feature Set
overwrite
(オプション)
  • OVERWRITEインポートにより、対象エリアのすべてのピクセルが置き換えられます。インポート先のキャッシュ内にあるタイルを、作成されたキャッシュのタイルで完全に上書きします。
  • MERGE(マージする)タイルのインポート時に、作成されたキャッシュ内の透明なピクセルはデフォルトで無視されます。この結果、エクスポート先のキャッシュはマージまたはブレンドされます。これはデフォルト設定です。
Boolean

コードのサンプル

例 1

デフォルトの縮尺数で CACHE_DATASET をキャッシュされたサービスにインポートします。インポート先のキャッシュ内にあるタイルは、インポートされるタイルによって上書きされます。

# Name: ImportMapServerCache.py
# Description: The following stand-alone script demonstrates how to import map
#               server cache from a source directory with CACHE_DATASET and  
#               OVERWRITE existing cache on the service for the number 
#               of scales specified without Uploading data to 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
sourceCacheType     = "CACHE_DATASET"
sourceCacheDataset  = "C:/data/destination_folder/Layers"
sourceTilePackage   = ""
uploadDataToServer  = "DO_NOT_UPLOAD"
scales              = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest      = ""
importExtents       = ""
overwriteTiles      = "OVERWRITE"

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 "scales[0]","scales[-1]","scales[0:3]"

try:
    starttime = time.clock()
    result = arcpy.ImportMapServerCache_server(inputService, sourceCacheType,
                                               sourceCacheDataset,
                                               sourceTilePackage,
                                               uploadDataToServer, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, importExtents,
                                               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 "Imported Map server Cache Tiles successfully for" + serviceName
    " from" + sourceCacheDataset + "\n in " + str(elapsedtime)+ "sec 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 "Imported Map server Cache Tiles "

report.close()

例 2

対象エリアのキャッシュ タイルを TILE_PACKAGE からキャッシュ サービスにインポートします。

# Name: ImportMapServerCache.py
# Description: The following stand-alone script demonstrates how to import map
#               server cache from a source directory with Tile Package to an existing service for 
#               the default number of scales specified using an AOI by uploading data to remote server
# To Import cache tiles for the scales specified for given feature class

# Requirements: os, sys, time and traceback modules
# Author: ESRI

# 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
sourceCacheType = "TILE_PACKAGE"
sourceCacheDataset = ""
sourceTilePackage = "C:\\data\\destination_folder\\TPK\\Rainfall.tpk"
uploadDataToServer = "UPLOAD_DATA"
scales = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
cacheDir = "c:\\arcgisserver\\arcgiscache"
areaOfInterest = "C:/data/101/Portland/Portland_Metro.shp"
importExtents = ""
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 "scales[0]","scales[-1]","scales[0:3]"

try:
    starttime = time.clock()
    result = arcpy.ImportMapServerCache_server(inputService, sourceCacheType,
                                               sourceCacheDataset,
                                               sourceTilePackage,
                                               uploadDataToServer, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, importExtents,
					       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 "Imported Map server Cache Tiles successfully for " + serviceName
    " from " + sourceTilePackage + " to " + cacheDir + "\n using "+ areaOfInterest
    " 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 2 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()

print "Imported Map server Cache Tiles for the given feature class"

環境

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

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
5/25/2014