Skip To Content

ArcGIS Data Store REST コマンド

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

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

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

  • リレーショナル データ ストア - [data] > [items] > [enterpriseDatabases] > [<データ ストア名>] > [machines] > [<コンピューター名>] の順にクリックします。
  • 時空間ビッグ データ ストア - [data] > [items] > [nosqlDatabases] > [AGSDataStore_bigdata_<データ ストア名>] > [machines] > [<コンピューター名>] の順にクリックします。
  • グラフ ストア - [data] > [items] > [nosqlDatabases] > [AGSDataStore_graph_<data store name>] > [machines] > [<machine name>] の順にクリックします。
  • オブジェクト ストア - [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 つに移動して、[整合チェック] をクリックし、そのデータ ストアに関連する情報を参照します。 データ ストアのステータスに関連する重要な情報として、次のようなものがあります。

  • overallhealth - 値は次のとおりです。
    • Healthy - すべてのメンバー コンピューター上のすべてのコンポーネントがアクセス可能であり、正常に機能しています。
    • [HealthyWithWarning] - この状態は、リレーショナル データ ストア、オブジェクト ストア、グラフ ストアにのみ当てはまります。 1 つ以上のコンポーネントが使用できなくなっても、データ ストアはまだ使用できます。 この値は、プライマリー コンピューターは正常であるもののスタンバイ コンピューターが利用できない場合に、リレーショナル データ ストアに返されます。 リレーショナル データ ストアは、この時点では可用性が高くありません。 クラスター モードで動作しているオブジェクト ストアまたはグラフ ストアの場合、データ ストアは可用性が高くないことがあります。
    • Unhealthy - データ ストア内のコンピューターのうちの半数以上にアクセスできない場合、そのデータ ストアは「異常」と見なされます ("datastore.overallhealth": "Unhealthy")。 コンピューターがアクセス不能である場合、そのコンピューターは Unhealthy と見なされます ("machine.overallhealth": "Unhealthy")。
  • status - リレーショナル データ ストアの場合、指定可能な値は [Started] または [Stopped] です。 停止している間、ホスト フィーチャ レイヤーやホスト シーン レイヤーを、ポータルに公開することはできません。
  • 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 Server 管理者は、パフォーマンスを向上させるために、個々のレイヤーのクエリー応答キャッシュを有効化することができます。 これらのクエリー応答はオブジェクト ストアにキャッシュされます。 キャッシュの格納期間 (キャッシュの有効期限ポリシー) や、オブジェクト ストアが実行されているコンピューターでの空きディスク容量によっては、オブジェクト ストアが一杯になって機能しなくなることがあります。

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

フィーチャ クエリー応答キャッシュとそれを使用する状況の詳細については、「応答キャッシュ」をご参照ください。

ホスト フィーチャ レイヤーのクエリー応答キャッシュを有効化する手順については、ArcGIS REST API ヘルプの「フィーチャ レイヤー」および「Update Definition」をご参照ください。