キャッシュ利用の構成—ArcGIS Server | ArcGIS Enterprise のドキュメント

マップサービスにタイルスキーマを定義すると、そのサービスは即座にキャッシュを使用します。マップサービスまたはイメージサービスを表示できる ArcGIS アプリケーションはすべてキャッシュを使用しますが、タイルを取得して使用する方法はアプリケーションによって異なります。

Web アプリ

キャッシュされたマップサービスまたはイメージサービスを、ベースマップまたは操作レイヤーとして Web マップで使用するために追加できます。

キャッシュされたマップサービスを Web マップに接続するには、ArcGIS タイルマップサービスレイヤーオブジェクトを使用できます。

キャッシュされたイメージサービスを Web マップに接続するには、ArcGIS タイルイメージサービスレイヤーオブジェクトを使用できます。

タイルは、 https://<map service URL>/tile/<level>/<row>/<column> マップタイルリクエストを使用し、マップサービスへの REST コールによってキャッシュディレクトリから取得されます。

Web アプリのトラブルシューティング

マップのパフォーマンスが予想よりも遅い場合、マップイメージの URL を調べて、アプリがキャッシュされたタイルを取得していることを確認できます。

アプリがキャッシュされたタイルを取得していることを確認するには、次の手順を実行します。

ブラウザーでアプリケーションの Web 開発者ツールを開きます。
コンソールで [ネットワーク] タブをクリックします。
Web マップをズームしたり画面移動したりします。

コンソールに次のような URL が表示された場合、アプリは REST リクエストからのキャッシュされたタイルを正常に使用しています。

https://gisserver.domain.com:6443/arcgis/rest/services/myService/MapServer/tile/10/1723/3495.jpg

exportMap や exportImage などの別の URL 形式が表示された場合、アプリはキャッシュを使用していません。

ArcGIS Pro

キャッシュされたマップサービスを ArcGIS Pro に追加するには、「ArcGIS Pro のマップまたはシーンへのレイヤーの追加」をご参照ください。

指定された投影法でキャッシュの縮尺レベルと一致する縮尺でタイルがリクエストされた場合、マップサービスは直接タイルを返します。ただし、リクエストがキャッシュ内の縮尺または投影法と正確に一致しないことがよくあります。このような場合、次に近い縮尺のタイルがリクエストされ、リクエストされた縮尺に合わせてリサンプリングされます。リサンプリングはタイルを動的に生成するよりも高速ですが、処理の結果、元のタイルとは見た目が異なる画像が生成されます。

注意:

リサンプリング処理の後に、キャッシュされているマップラベルを特定の縮尺で読み取ることが難しくなる場合があります。

見やすさを確認するには、キャッシュが作成された縮尺に近い縮尺でマップを表示することをお勧めします。

ArcGIS Pro は、セッション中のマップおよびイメージレイヤーのパフォーマンスを向上させるため、マップおよびイメージサービスのコンテンツをローカルにキャッシュします。 ArcGIS Pro でのキャッシュの仕組みの詳細については、「キャッシュオプションの設定」をご参照ください。

キャッシュされたデータは、ArcGIS Pro のラスターデータセットとしてもアクセスできます。ラスターとしてアクセスされるキャッシュにはクエリを実行できませんが、マップサービスに依存しないため、サーバーから切断された状態でもタイルを表示することができます。

クライアントによるローカルキャッシュの有効化

キャッシュされたマップサービスまたはイメージサービスを表示する際、ArcGIS クライアントがタイルをローカルに格納できるようにすることで、ユーザーがすでに表示したエリアを再び参照したときにタイルを再び取得せずに済むようにします。

注意:

ユーザーがキャッシュの更新内容を確認するには、ローカルキャッシュをクリアする必要がある場合があります。

キャッシュを頻繁に更新する場合、クライアントがタイルをローカルにキャッシュする機能を無効にすることができます。そうすることで、ユーザーのローカルキャッシュに格納されている古い情報ではなく、常に最新の情報をユーザーに提供できます。

ローカルキャッシュが有効になっている場合、ユーザーはタイルキャッシュをローカルに格納するかどうかを選択できます。ユーザーは、ローカルキャッシュを継続的に構築する、アプリケーションセッションごとに新しいローカルキャッシュを構築する、またはローカルキャッシュを構築しないことを選択できます。

cacheControlMaxAge プロパティの定義

クライアントが ArcGIS Server にリクエストを送信してマップサービスを表示するときに、通常はサーバーからの応答がブラウザーによって一定期間キャッシュされ、再利用されます。この動作によって、コンテンツを最高品質で表示することができます。ただし、アプリケーションでのキャッシュマップサービスまたはイメージサービスと関連データの使用方法に応じて、ブラウザーがキャッシュ内の応答を使用する期間を調整できます。

リクエストが繰り返された場合、キャッシュの最大期間の期限が切れていなければ、ブラウザーは、サーバーにリクエストを送信しないで、キャッシュされている応答を使用します。キャッシュの最大期間の期限が切れている場合、ブラウザーは、リクエストをサーバーに送信し、キャッシュ内の応答に対応する ETag 値を使用して IF-NONE-MATCH ヘッダーを設定する必要があります。 ArcGIS Server は、リクエストを評価し、ETag 値を使用して、応答が変更されているかどうかを判定します。サーバーからの応答がブラウザー上のコピーと異なる場合、サーバーは新しい応答をブラウザーに送信します。応答がブラウザー上のコピーと同一である場合、サーバーは、キャッシュ内の応答を引き続き使用するようにブラウザーに警告します。

クライアントがタイルをローカルにキャッシュすることを許可しないキャッシュされたマップサービスの場合、デフォルトは 0 です。これにより、ブラウザーは必ずリクエストを再送し、コンテンツが変更されている場合は ArcGIS Server がそのリクエストを処理して応答します。このデフォルト値は、ほとんどのアプリに適しています。

クライアントがタイルをローカルにキャッシュすることを許可するキャッシュマップサービスの場合、デフォルト値は 86,400 秒 (1 日) です。このデフォルト値の場合、リクエストが 1 日以内に繰り返された場合、ブラウザーはローカルキャッシュに格納されている応答を使用します。キャッシュマップサービスが頻繁に更新されない場合は、ネットワークトラフィックを最小限に抑えるために、cacheControlMaxAge プロパティを 30 日 (2,592,000 秒) 以上に増やすことをお勧めします。

cacheControlMaxAge プロパティをサービスに追加してデフォルト値を編集するには、以下の手順を実行します。

Web ブラウザーで ArcGIS Server Administrator Directory を開き、管理者権限でログインします。
URL の形式は http://gisserver.domain.com:6443/arcgis/admin です。
[services] をクリックして、変更するマップサービスまたはイメージサービスを [Services] リストから選択します。
サービスがリストに表示されない場合は、root フォルダーの下のディレクトリに配置されている可能性があります。
[Service - <サービス名> (<サービスタイプ>)] ページで下までスクロールし、[edit] をクリックします。
[Service Properties] ダイアログボックスで、サービス JSON の "properties" セクションを見つけます。
cacheControlMaxAge プロパティをそのセクションに追加して、そのプロパティの値 (秒単位) を指定します。
例を以下に示します。
```
"properties": {
  "cacheControlMaxAge": "300",
```
[Save Edits] をクリックします。
cacheControlMaxAge プロパティと選択した値が [プロパティ] セクションに表示されていることを確認します。

可用性の高いファイル共有の使用

オンプレミスの GIS サーバーサイトキャッシュの場合、SAN (ストレージエリアネットワーク) または高可用性 NAS (ネットワーク接続ストレージ) を使用する可用性の高いファイルサーバー上にディレクトリを指定できます。これは、通常、組織の情報技術スタッフによって構成されます。

キャッシュ用に十分な空き容量がある SAN または NAS を組織が利用している場合、これは、マップキャッシュとイメージキャッシュの可用性を高めるための最も簡単で最も信頼できるソリューションになります。

このようなファイルサーバーにアクセスできない場合は、次のセクションの説明に従って、ユーザーの環境内の各コンピューター上にキャッシュディレクトリを作成します。

高可用性システムでは、キャッシュディレクトリをクラウドストアにバックアップすることができます。マップまたはイメージサービスキャッシュのエンドユーザーは、クラウドストアからタイルを取得する際に、ローカルディスクからタイルを取得する場合と比較して、パフォーマンスが低下することがある点に注意してください。また、クラウドストアに格納されるキャッシュは、compact v2 ストレージ形式を使用していることを確認してください。

可用性の高いキャッシュの構成

サイト内のすべてのコンピューター上にマップキャッシュとイメージキャッシュの複数のコピーを保存すると、キャッシュとサービスの可用性を高めることができます。 GIS サーバーサイト内の各コンピューター上にディレクトリを作成して、それぞれのディレクトリにすべてのキャッシュをコピーします。 GIS サーバーに属しているすべてのコンピューターが、どのキャッシュディレクトリにもアクセスできる必要があります。

以下は、ローカルキャッシュディレクトリを構成する場合の注意事項です。

ローカルキャッシュディレクトリを使用してサービスが構成されている場合、オンデマンドでのマップキャッシュを使用することはできません。
既存のキャッシュを更新するジオプロセシングツールは、共通のサイトキャッシュディレクトリを出力先とします。これらのツールを実行する場合は、GIS サーバーに属している各コンピューターのローカルキャッシュディレクトリにキャッシュを移動する必要があります。

GIS サーバーサイト内のすべてのコンピューター上にキャッシュディレクトリを実装すると、管理オーバーヘッドが増加しますが、可用性の高い GIS サーバーをクラウドに実装するにはこの方法以外にありません。

このソリューションはオンプレミス環境にも実装できます。このソリューションは、可用性の高いファイルサーバーを利用できず、かつキャッシュの更新頻度が少ないかまったくない場合に推奨されます。

デフォルトでは、マップキャッシュとイメージキャッシュは単一のサイトキャッシュディレクトリに書き込まれます。 GIS サーバーサイトに属している各コンピューター上にキャッシュディレクトリを構成するには、次の手順に従います。

サーバーのキャッシュディレクトリの ArcGIS サービスエンドポイントを開きます。 URL の形式は http://gisserver.domain.com:6080/arcgis/admin/system/directories です。
サイトキャッシュを選択します。
[編集] をクリックします。
[Use Local Directory] を [TRUE] に設定します。
ローカルキャッシュディレクトリのパスを指定します。キャッシュディレクトリは、すべてのコンピューター上で同じ場所に作成する必要があります。
設定が完了すると、ArcGIS Server は、該当のコンピューターに公開されているマップサービスとイメージサービス用のキャッシュを、指定されたローカルキャッシュディレクトリに作成します。
既存のキャッシュデータをサイトキャッシュディレクトリから各ローカルキャッシュディレクトリへ手動でコピーします。
データのコピーを試行する前に、既存のキャッシュの構築が完了していることを確認してください。
キャッシュの移動には robocopy などを使用できます。
```
robocopy <location of existing cache> <local cache directory>  /s
```

このトピックへのフィードバック