Skip to main content

ArcGIS Data Store REST コマンド

ArcGIS Data Store を構成する際には、ホスティング サーバーに関連付けます。 データ ストアのステータスを変更または確認する操作は、ホスティング サーバーの ArcGIS Server Administrator Directory から ArcGIS Server 管理者として実行します。 (URL の形式は https://gisserver.example.com:6443/arcgis/admin です)。プライマリー/スタンバイ モードで実行されているリレーショナル ストアからスタンバイ コンピューターを削除し、ArcGIS Server Administrator Directory 内の GIS サーバー サイトからスタンバイ コンピューターを削除することもできます。 次の各セクションには、それぞれの操作の概要と ArcGIS REST API ドキュメントへのリンクが記載されています。

ホスティング サーバーの ArcGIS Server 管理者でない場合は、管理者と連携してここで説明した作業を実行します。

以下に示すのは ArcGIS Server Administrator Directory のパスです。各タイプの ArcGIS Data Store に対する操作には、これに従ってアクセスする必要があります:

  • リレーショナル ストア - data > items > enterpriseDatabases > <データ ストア名> > machines > <コンピューター名> の順にクリックします。

  • 時空間ビッグ データ ストア - data > items > nosqlDatabases > AGSDataStore_bigdata_<データ ストア名> > machines > <コンピューター名> の順にクリックします。

  • グラフ ストア - data > items > nosqlDatabases > AGSDataStore_graph_<データ ストア名> > machines > <コンピューター名> の順にクリックします。

  • オブジェクト ストア - data > items > cloudStores > <データ ストア名> > machines > <コンピューター名> の順にクリックします。

データ ストア コンピューターのステータスの変更

データ ストア内の各コンピューターを一度停止してから再起動できます。 また、スタンバイ リレーショナル ストア コンピューターをプライマリー コンピューターに昇格させることもできます。

プライマリー データ ストア コンピューターを停止しても、オンプレミスの配置でデータ ストアのフェイルオーバーは行われません。これは、データ ストアを一時的にオフラインにするなどのメンテナンス タスクを実行する場合は、フェイルオーバーを行う必要がないからです。

たとえば、次のアップグレード シナリオの中でデータ ストア コンピューターのステータスを変更します。

  • スタンバイ コンピューターを停止する。

  • スタンバイ コンピューターをアップグレードする。

  • スタンバイ コンピューターを起動する。

  • makePrimary コマンドを使用して、スタンバイをプライマリーに昇格させる。

  • 元のプライマリー コンピューターを停止する。

  • 元のプライマリー コンピューターをアップグレードする。

  • 元のプライマリー コンピューターを起動する。

  • 元のプライマリー コンピューターをスタンバイ コンピューターとしてデータ ストアにもう一度追加する。

ホスティング サーバーの ArcGIS Server Administrator Directory に ArcGIS Server サイト管理者としてサイン インした後、特定のコンピューターにアクセスし、次のいずれかのコマンドを使用して、データ ストア コンピューターのステータスを変更します:

  • stop

  • start

  • makePrimary (リレーショナル ストアのスタンバイ コンピューター)

データ ストアの検証

validate ArcGIS Server REST コマンドを使用すると、データ ストア内の各コンピューターのステータスを確認できます。

ArcGIS Server サイト管理者として ArcGIS Server Administrator Directory にサイン インし、確認したい特定のデータ ストア タイプ内のコンピューターのうちの 1 つに移動して、validate をクリックし、そのデータ ストアに関連する情報を参照します。 データ ストアのステータスに関連する重要な情報として、次のようなものがあります。

  • overallhealth - 値は次のとおりです:

    • Healthy - すべてのメンバー コンピューター上のすべてのコンポーネントがアクセス可能であり、正常に機能しています。

    • HealthyWithWarning - この状態は、リレーショナル ストア、オブジェクト ストア、グラフ ストアにのみ当てはまります。 1 つ以上のコンポーネントが使用できなくなっても、データ ストアはまだ使用できます。 この値は、プライマリー コンピューターは正常であるもののスタンバイ コンピューターが利用できない場合に、リレーショナル ストアに返されます。 リレーショナル ストアは、この時点では可用性が高くありません。 クラスター モードで動作しているオブジェクト ストアまたはグラフ ストアの場合、データ ストアは可用性が高くないことがあります。

    • Unhealthy - データ ストア内のコンピューターのうちの半数以上にアクセスできない場合、そのデータ ストアは「異常」と見なされます ("datastore.overallhealth": "Unhealthy")。 コンピューターがアクセス不能である場合、そのコンピューターは Unhealthy と見なされます ("machine.overallhealth": "Unhealthy")。

  • status - リレーショナル ストアの場合、値は Started または Stopped です。 停止している間、ホスト フィーチャ レイヤーやホスト 3D レイヤーをポータルに公開することはできません。

  • clusterStatus - 時空間ビッグ データ ストアの場合、ステータスは次のいずれかです。

    • green — データはすべて揃っています。

    • yellow — データは揃っていますが、レプリカ コピーの一部または全部が存在しないため、時空間ビッグ データ ストアは高可用性構成になっていません。 単一コンピューターで時空間ビッグ データ ストアを構成した場合は、常にこの状態になります。 データのバランス調整中や、時空間ビッグ データ ストアを構成するコンピューターの一部にアクセスできない場合にも、この状態になることがあります。 複数コンピューターによる時空間ビッグ データ ストアでこの状態になった場合は、コンピューターがすべて動作しているかどうか確認してください。 すべて動作している場合は、数時間待ってもう一度確認します。 それでも status が yellow のままであれば、ArcGIS Server ログにエラー情報がないか調べてください。

    • red — データの一部または全部にアクセスできません。 ログを調べて対処してください。

  • role - リレーショナル ストアのコンピューターの場合、primary (プライマリー) か standby (スタンバイ) かを表します。 オブジェクト ストアとグラフ ストアの場合、role は単一のインスタンスでは primary になり、クラスター モードでデプロイされている場合には cluster_member になります。

  • messages - データ ストアのステータスに関連する警告メッセージおよびエラー メッセージがここに表示されます。

以下について整合チェックを行うことができます。

  • データ ストア コンピューターが停止しているか、始動しているかを確認します。

  • makePrimary コマンドにより、スタンバイ コンピューターがプライマリー コンピューターに昇格したことを確認します。

  • ホスト レイヤーを公開できない場合、またはこれらにアクセスできない場合、ナレッジ グラフを作成できない場合、もしくはこれにアクセスできない場合に最初に行うべきトラブルシューティングのステップです。

スタンバイ コンピューターの削除

remove ArcGIS Server REST コマンドを使用すると、リレーショナル ストアからスタンバイ コンピューターを削除できます。 たとえば、別のコンピューターをスタンバイ コンピューターとして使用する場合は、元のスタンバイ コンピューターをデータ ストアから削除した後、ArcGIS Data Store を新しいコンピューターにインストールし、新しいコンピューターをスタンバイとして構成します。

ホスティング サーバーの ArcGIS Server Administrator Directory に ArcGIS Server サイト管理者としてサイン インして、remove コマンドを使用します。

クエリー応答キャッシュの管理

組織管理者およびフィーチャ レイヤーとマップ イメージ レイヤーの所有者は、個々のレイヤーのクエリー応答キャッシュを有効にして、クエリーのパフォーマンスを向上させることができます。 これらのクエリー応答はオブジェクト ストアにキャッシュされます。 キャッシュの格納期間 (キャッシュの有効期限ポリシー) や、オブジェクト ストアが実行されているコンピューターでの空きディスク容量によっては、オブジェクト ストアが一杯になって機能しなくなることがあります。

ArcGIS Enterprise デプロイメントで ArcGIS Data Store オブジェクト ストアが使用されている場合、ArcGIS Data Store 管理者は次の操作を行う必要があります:

  • これらのキャッシュおよびオブジェクト ストアに保存されているその他のデータを格納するのに十分なディスク容量があるコンピューター上にオブジェクト ストアを構成します。

  • ArcGIS Data Store のログを監視して、オブジェクト ストアの容量に近づいたことを検知します。 オブジェクト ストアを検証して、オブジェクト ストア コンピューターで使用されているディスク容量の割合を確認することができます。 必要に応じて、ArcGIS Server 管理者と連携して、キャッシュの有効期限ポリシーを変更するか、それらのフィーチャ レイヤーの応答キャッシュを無効化して、大きなレイヤー キャッシュを削除してください。

  • 定期的に maintaindatastore ユーティリティーを実行して、オブジェクト ストアから期限切れのキャッシュをクリアします。

クエリー応答キャッシュ、それを使用するタイミング、有効化する方法については、「応答キャッシュの有効化」をご参照ください。

有効期限ポリシーを変更する手順については、ArcGIS REST API ヘルプの「Update Definition」をご参照ください。