次のセクションでは、より高度な設定で Web ツールを実行する場合の注意事項について説明します。
大きなデータセットのアップロードとダウンロード
Web ツールの共有時にデータをアップロードしたり、Web ツールの実行時に出力データをダウンロードする際には、ファイル サイズの制限が課されます。 ファイルの大きさは、Web ツールをホストするフェデレーション サーバーのヒープ サイズによって異なります。 デフォルトのサーバー ヒープ サイズは 64 MB ですが、サーバー管理者が必要に応じてサイズを変更することもできます。 次のような場合は、ヒープ サイズを増加できるかどうかサーバー管理者に確認してください。
- 64 MB よりも大きいラスター データをアップロードする
- 64 MB に近い大きさ、またはそれよりも大きいフィーチャ データをアップロードする
- 64 MB に近い大きさ、またはそれよりも大きいフィーチャ データをダウンロードする
ヒープ サイズと、大きいデータセットのアップロードとダウンロードとの関係について詳しくは、「Web ツール プロパティの高度な設定」の「ヒープ サイズ」セクションをご参照ください。
大きいフィーチャ データをダウンロードする場合、サーバーから返される最大レコード数も考慮する必要があります。 デフォルトのレコード サイズは 1000 件です。 返されるレコード数が 1000 件以上の場合は、以下の操作を行ってください。
- Web ツールとして共有する場合は、Web ツール設定からレコードの最大数をリセットします。
- 共有処理の際にリセットしなかった場合は、データはダウンロードされず、ジオプロセシング履歴の Web ツール実行結果には [転送制限外のデータ] メッセージが表示されます。 その場合は、フェデレーション サーバー マネージャーにサイン インし、Web ツールをホストするジオプロセシング サービスのレコードの最大数をリセットする必要があります。
- 出力フィーチャ サービスで Web ツールを使用し、大量の出力データをダウンロードしないようにします。
Web アプリケーションからの大きなデータセットのアップロード
Web アプリケーションは、REST (Representational State Transfer) アップロード操作を使用して、ファイルをアップロードします。 この機能は、ジオプロセシング サービス プロパティ ページのアップロード機能で設定します。 デフォルトの最大アップロード サイズは 2 GB です。 最大アップロード サイズを 2 GB 未満に変更するには、「Web ツール プロパティの高度な設定」の「アップロード サイズ」セクションで説明されている手順に従います。 最大アップロード サイズを 2 GB より大きいサイズに変更することはできません。
入力データが、.txt、.zip、.jpg などのファイルである場合、アップロード リソース操作を使用してこれらのファイル タイプをアップロードできます。 アップロード ファイル タイプの設定については、「Web ツール プロパティの高度な設定」の「アップロード タイプ」セクションをご参照ください。
ArcMap の Web ツール
サーバー コネクションファイルを使用して Web ツールを使用できます。 Web ツールが任意のクライアントから ArcGIS Enterprise 10.9.1 以前のバージョンに公開されている場合は、任意のコネクション タイプおよび共有権限でツールを使用できます。 ArcMap から ArcGIS Enterprise 11 への公開はサポートされていません。 ただし、ArcGIS Pro から ArcGIS Enterprise 11 に、次の要件で公開された Web ツールは使用できます。
- サーバー コネクションでユーザー コネクション タイプを使用している。
- Web ツールがすべてのユーザーと共有されている。
- ArcGIS Pro 3.0 のように出力フィーチャ サービス オプションを上書きすることはありませんが、出力フィーチャ サービスのパラメーターを使用してツールを実行することはできます。
- Web ツールに、値テーブルまたはフィールド データ タイプのパラメーターがある場合は、既存の値で使用することのみできます。 既存の値の変更または ArcMap からの値の入力はサポートされていません。
フィーチャまたはイメージ サービスとしての入力
ラスター データ タイプのフィーチャおよびイメージ サービスのフィーチャ サービスから入力を指定するには、サービス URL を入力するか、目次からサービス レイヤーを選択するか、ArcGIS Pro の [ポータル] ウィンドウからサービスを選択します。
フィーチャ サービスとしての出力
Web ツールを使用する場合、出力は出力フィーチャクラスまたはテーブルとして、または [出力フィーチャ サービス名] パラメーターを使用して出力フィーチャ サービスとして生成できます。 このオプションにより、出力フィーチャのサイズが大きい場合の消費プロセスを円滑に進めることができます。 また、自分のデータを Web クライアント、デスクトップ アプリ、フィールド アプリなど、さまざまなクライアントで恒久的に使用可能にすることもできます。 出力をフィーチャ サービスとして保存する詳細については、「出力フィーチャ サービスでの Web ツールの使用」をご参照ください。
カスタム地理座標系変換の使用
共有する Web ツールに対し、カスタム地理座標系変換ファイル (.gtf) を使用することもあります。 その場合は、Web ツールをホストしているフェデレーション サーバーに .gtf ファイルがあることを確認してください。 ArcGIS Pro に保存された .gtf ファイルのパスは、ArcGIS Desktop のものとよく似ています。 .gtf パスの Desktop10.x 部分を ArcGISPro に変更するだけです。
環境変数の使用
ArcGIS Pro から Web ツールを使用する際、ツールの [環境] タブを使用し、ツールの実行に関する環境設定を行うことができます。 出力座標系およびマスクなど、一部の環境では、ドロップダウン リストからの選択に加えて、フィーチャ サービスまたはマップ サービス URL への入力を受け入れます。 スナップ対象ラスターおよびセル サイズなど、一部の環境では、ドロップダウン リストからの選択に加えて、イメージ サービス URL への入力を受け入れます。 ArcGIS Pro のローカル ジオプロセシングで使用される、[解析] タブで指定された [環境] 設定は、Web ツールが使用されるときは処理されません。 サポートされている環境の一覧を次に示します。
- 出力座標- 出力座標系、地理座標変換
- 処理範囲 - 範囲
- 並列処理 - 並列処理ファクター
- ラスター解析 - セル サイズ、セル サイズ投影法、マスク、スナップ対象ラスター
- ジオデータベース - 自動コミット
- M 値 - 出力に M 値がある
- Z 値 - デフォルトの出力 Z 値、出力に Z 値がある
- 乱数 - 乱数ジェネレーター
- ラスター格納 - NoData
- プロセッサー タイプ - プロセッサー タイプ、GPU ID
パラメーター フィルター
ツールを作成する際、[ツール プロパティ] ダイアログ ボックスの [パラメーター] タブでフィルターを設定できます。 ArcGIS Server 10.7 以降、フィルターを含むツールを公開すると、フィルター情報も公開されるようになりました。 日付フィルターのほかには、サポートされている入力データ タイプによるフィルターのみがサポートされています。
例
以下のツールでは、double パラメーターに [最小] が 213、[最大] が 123132.123 の [範囲フィルター] が設定されています。
ツールが公開され、ArcGIS Pro で Web ツールとして使用されている場合、フィルター範囲外の値を入力すると、値が範囲外である旨のエラーが表示されます。
Web ツールが使用する Python 環境
ArcGIS Pro と同様に、ArcGIS Enterprise では ArcGIS Server の Python 環境を使用します。
デフォルトでは、ArcGIS Pro から公開された Web ツールはデフォルトの Python 環境を使用します。この環境はサーバー コンピューターの ArcGIS Server インストール ディレクトリにあります。 ArcGIS Server がデフォルトのインストール場所にある場合、Python 環境は C:\Program Files\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3 にあります。
解析を作成する際にサードパーティの Python パッケージを含む、カスタマイズされた Python 環境を使用する場合、これらの Python パッケージは公開プロセス中に ArcGIS Server に自動的にアップロードされません。 パッケージをアップロードする方法については、「ArcGIS Server へのカスタム Python パッケージの配置」をご参照ください。 パッケージをアップロードしない場合、Web ツールは Python エラーで失敗します。
さまざまな ArcGIS Enterprise デプロイメント タイプの考慮事項
デプロイメント シナリオは数多くあります。 デプロイメントによっては、特定の状況で注意が必要な場合があります。
ArcGIS Enterprise における高可用性
NFS ファイル共有を使用して可用性の高い ArcGIS Enterprise のデプロイメントに Web ツールを公開する場合は、NFS ファイル共有の NOLOCK オプションを設定しないようにしてください。 ファイルのロックを使用することにより、非同期ジオプロセシング サービスを使用して Web ツールのジョブ ステータスを記録する基本ファイルが適切なロック メカニズムを確実に持つことができます。 NFS ファイル共有で NOLOCK オプションが設定されている場合、複数のコンピューターが同じリクエストを処理する可能性があるため、重複結果が生じます。 このデプロイメントと NAS デバイスの詳細については、「ArcGIS Enterprise の高可用性」および「ArcGIS Server 用の NAS デバイスの選択」をご参照ください。
複数台のコンピューターにデプロイされた ArcGIS Server サイト
複数台のコンピューターにデプロイされた ArcGIS Server サイトがサード パーティ製ロード バランサーを使用している場合、ロード バランサーが固定的なセッションをサポートしていることを確認してください。 これにより、非同期ジオプロセシング サービスを使用しているクライアントはジョブを送信して、同じコンピューターからジョブ ステータス、進捗、入力、および出力を取得できます。 それ以外の場合、ロード バランサーがジョブを実行しているコンピューター以外のコンピューターにリクエストをルーティングすると、クライアントはジョブ ステータスを取得できなくなります。