ArcGIS Data Store REST コマンド—Portal for ArcGIS | ArcGIS Enterprise のドキュメント

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

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

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

リレーショナルデータストア - [data] > [items] > [enterpriseDatabases] > [<データストア名>] > [machines] > [<コンピューター名>] の順にクリックします。
時空間ビッグデータストア - [data] > [items] > [nosqlDatabases] > [AGSDataStore_bigdata_<データストア名>] > [machines] > [<コンピューター名>] の順にクリックします。
タイルキャッシュデータストア - [data] > [items] > [nosqlDatabases] > [AGSDataStore_nosql_<データストア名>] > [machines] > [<コンピューター名>] の順にクリックします。
グラフストア - [data] > [items] > [nosqlDatabases] > [AGSDataStore_graph_<data store name>] > [machines] > [<machine name>] の順にクリックします。
オブジェクトストア - [data] > [items] > [objectStores] > [<データストア名>] > [machines] > [<コンピューター名>] の順にクリックします。

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

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

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

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

スタンバイコンピューターを停止する。
スタンバイコンピューターをアップグレードする。
スタンバイコンピューターを起動する。
makePrimary コマンドを使用して、スタンバイをプライマリに昇格させる。
元のプライマリコンピューターを停止する。
元のプライマリコンピューターをアップグレードする。
元のプライマリコンピューターを起動する。
元のプライマリコンピューターをスタンバイコンピューターとしてデータストアにもう一度追加する。

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

停止
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 - データストアのステータスに関連する警告メッセージおよびエラーメッセージがここに表示されます。たとえば、複数コンピューターのタイルキャッシュデータストアを整合チェックする場合、シーンのキャッシュデータが現在高可用性でなければ (言い換えると、1 つ以上のシーンのキャッシュの 1 つのコピーのみが存在する場合)、メッセージを受信します。

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

データストアコンピューターが停止しているか、始動しているかを確認します。
makePrimary コマンドにより、スタンバイコンピューターがプライマリコンピューターに昇格したことを確認します。
タイルキャッシュデータストアの可用性が高いかを確認します。
ホストフィーチャレイヤーまたはホストシーンレイヤーを公開できない場合、またはこれらにアクセスできない場合、ナレッジグラフを作成できない場合、またはこれにアクセスできない場合、もしくは GeoAnalytics Tools　を実行できない場合に最初に行うべきトラブルシューティングのステップです。

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

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

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

ホストフィーチャレイヤーのクエリ応答キャッシュの管理

頻繁にクエリされるホストフィーチャレイヤーの場合、ホスティングサーバーの ArcGIS Server 管理者は、パフォーマンスを向上させるために、個々のレイヤーのクエリ応答キャッシュを有効化することができます。有効にすると、フィーチャサービスが一意のクエリを受信するごとに、フィーチャと範囲がオブジェクトストアにキャッシュされます。キャッシュの格納期間 (キャッシュの有効期限ポリシー) や、オブジェクトストアが実行されているコンピューターでの空きディスク容量によっては、オブジェクトストアが一杯になって機能しなくなることがあります。

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

フィーチャレイヤーのクエリ応答キャッシュの有効化

ホストフィーチャレイヤー (フィーチャサービス) 内の 1 つまたは複数のレイヤーに対してキャッシュを有効にするには、ホスティングサーバーサイトの ArcGIS Server 管理者がホスティングサーバーの ArcGIS Server Administrator Directory にサインインし、[定義の更新] REST 操作で次のリクエストを送信する必要があります。

{
    "layerCache": {
        "enabled": true
    }
}

データが頻繁に更新される場合は、キャッシュを有効にしないでください。レイヤーが更新されるたびにキャッシュを再構築する必要があるため、頻繁に編集されるフィーチャレイヤーでキャッシュされたクエリを使用してもパフォーマンスは向上しません。

キャッシュの有効期限ポリシーの設定または変更

キャッシュは一意のクエリごとに作成されます。オブジェクトストアコンピューターに十分なディスク容量があり、そのレイヤーが多くのクライアントからアクセスされている場合は、キャッシュの有効期限が切れないように設定します。前のセクションで示したリクエストの例では、有効期限なしでキャッシュを有効化します。

継続的にアクセスされていないレイヤーの場合や、ディスク容量が心配な場合は、レイヤーのクエリ応答キャッシュの保持日数を設定します。

{
    "layerCache": {
        "enabled": true, 
        "expiration": <duration_in_days>
    }
}

キャッシュの有効期限は UTC 時間の午前零時に切れることに注意してください。有効期限ポリシーを 1 に設定すると、キャッシュが作成されたタイミングによっては、最大で約 2 日間キャッシュが保持されます。

たとえば、クライアントが 4:00 UTC にフィーチャレイヤーにアクセスした場合、そのキャッシュは翌日の 24:00 UTC まで保持されます。

レイヤーのキャッシュの削除

オブジェクトストアのディスク容量が不足している場合は、ArcGIS Data Store ログに警告が表示され、validate REST コマンドでディスク容量の使用量を表示できます。既存のオブジェクトストアにディスク容量やコンピューターを追加することはできないため、キャッシュを一掃してディスク容量を解放する必要がある場合があります。これには、ホスティングサーバーの ArcGIS Server 管理者がそのレイヤーのキャッシュを無効にする必要があります。

{
    "layerCache": {
        "enabled": false
    }
}

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

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

データ ストアの整合チェック

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

ホスト フィーチャ レイヤーのクエリ応答キャッシュの管理

フィーチャ レイヤーのクエリ応答キャッシュの有効化