マップ サービス キャッシュの格納形式を変換 (Convert Map Server Cache Storage Format) (サーバー)

サマリー

マップ イメージ レイヤー、またはマップかイメージ サービスのキャッシュの格納形式をエクスプロード形式と compactV2 形式の間で変換します。

注意:

このツールでは使用中の形式が変換されるため、キャッシュの既存の形式のコピーは作成されません。 代わりに、同じキャッシュ フォルダーにキャッシュの新しい形式が作成され、古い形式が削除されます。 必要に応じて古い形式に戻せるように、このツールを実行する前にキャッシュのバックアップを取っておいてください。

使用法

  • ArcGIS Enterprise では、[入力サービス] パラメーターはサービスの REST エンドポイントを含む文字列です。 ArcGIS Enterprise ポータルがアクティブなポータルであることを確認してください。

    スタンドアロンの ArcGIS Server 配置では、[入力サービス] パラメーターはサーバーとサービスの両方の情報を含む文字列です。 文字列を構築するには、公開者か管理者の資格情報を使用して ArcGIS Server 接続ファイル (.ags) へのフル パスをスタンドアロン サーバーのサービス名に追加します (例: "C:\path_to_the connection_file_of_standAloneServer\arcgis on MyServer.com_6443.ags\ServiceName.MapServer")。 詳細については、「GIS サーバーへの接続」をご参照ください。

  • 入力サービスの現在の格納形式が検出され、対象の形式を逆の形式に設定するのに使用されます。 [キャッシュ サービスのインスタンス数] パラメーターを使用することで、キャッシュの変換に専用で使用するサービス インスタンスの数を指定できます。 デフォルト値である -1 では、ArcGIS Enterprise 設定のすべてのキャッシュ ツール インスタンスが使用されます。 使用するキャッシュ ツール インスタンスの数を減らすには値を小さくします。 ArcGIS Server への管理者接続を通して使用できる [サービス エディター] ウィンドウで、System/CachingTools サービスの [コンピューターごとのインスタンスの最大数] 設定の値を大きく変更することができます。 選択したインスタンス数を、サーバー コンピューターでサポートできることを確認してください。 スタンドアロン サーバーに接続する際は、インスタンスのデフォルトの数字とキャッシュ ツール サービスの [インスタンスの最大数] 設定の値が等しくなるようにします。

パラメーター

ラベル説明データ タイプ
入力サービス

キャッシュ形式を変換するマップまたはイメージ サービス。 ArcGIS Enterprise では、これはマップ イメージ レイヤーの REST エンドポイントを含む文字列です。 スタンドアロンの ArcGIS Server 配置では、これはサーバーとサービスの両方の情報を含む文字列です。

Image Service; Map Server
キャッシュ サービスのインスタンス数
(オプション)

このツールの実行に専用で使用する、System/CachingTools サービスのインスタンス数の合計。 デフォルト値である -1 を使用した場合、ArcGIS Enterprise 設定のすべてのキャッシュ ツール インスタンスが使用されます。 使用するキャッシュ ツール インスタンスの数を減らすには値を小さくします。

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

スタンドアロン サーバーに接続する際は、インスタンスのデフォルトの数字とキャッシュ ツール サービスの [インスタンスの最大数] 設定の値が等しくなるようにします。

Long

派生した出力

ラベル説明データ タイプ
出力マップ サービス URL

出力 URL。

String

arcpy.management.ConvertMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})
名前説明データ タイプ
input_service

キャッシュ形式を変換するマップまたはイメージ サービス。 ArcGIS Enterprise では、これはマップ イメージ レイヤーの REST エンドポイントを含む文字列です。 スタンドアロンの ArcGIS Server 配置では、これはサーバーとサービスの両方の情報を含む文字列です。

Image Service; Map Server
num_of_caching_service_instances
(オプション)

このツールの実行に専用で使用する、System/CachingTools サービスのインスタンス数の合計。 デフォルト値である -1 を使用した場合、ArcGIS Enterprise 設定のすべてのキャッシュ ツール インスタンスが使用されます。 使用するキャッシュ ツール インスタンスの数を減らすには値を小さくします。

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

スタンドアロン サーバーに接続する際は、インスタンスのデフォルトの数字とキャッシュ ツール サービスの [インスタンスの最大数] 設定の値が等しくなるようにします。

Long

派生した出力

名前説明データ タイプ
out_job_url

出力 URL。

String

コードのサンプル

ConvertMapServerCacheStorageFormat の例

マップ サーバーのキャッシュ格納形式を別の格納形式に変換します。

# Name: ConvertMapServerCacheStorageFormat.py
# Description: The following stand-alone script demonstrates how to convert map
#               server cache storage format to the alteranate storage format for
#               a weblayers/map or image service based on
#               ArcGIS Enterprise or a stand alone ArcGIS Server

import arcpy
import os

# Sign in to portal
myPortal= "https://www.myArcGISEnterprise.com/webadaptor"
arcpy.SignInToPortal(myPortal, "MyUserName", "MyPassword")
serviceName= "MyCounty"
serviceType= "MapServer"
myPortalServiceURL = (myPortal + "/" + "rest/services" +"/" + serviceName + "/" + serviceType)


# Stand alone ArcGIS Server
target_server_connection = r"C:\Project\gisserver.ags.esri.com (publisher).ags"
serviceName= "MyCounty"
serviceType= "MapServer"
myServerServiceURL= target_server_connection + "/" + serviceName + "." + serviceType

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

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

try:
    #result = arcpy.server.ConvertMapServerCacheStorageFormat(myPortalServiceURL, -1)
    result = arcpy.server.ConvertMapServerCacheStorageFormat(myServerServiceURL, -1)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))
    
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(e.message)
report.close()

print ("Converted Map Server Cache Storage format for " + serviceName)

環境

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