Skip to main content

changedbproperties

この ArcGIS Data Store ユーティリティーは、リレーショナル ストア、オブジェクト ストア、および時空間ビッグ データ ストアで使用されます。

changedbproperties ユーティリティーでは、実行対象のデータ ストアのタイプに応じて、さまざまなプロパティを変更できます。

構文

changedbproperties --store {relational | spatiotemporal | object} [configuration options]

--store オプションと少なくとも 1 つの構成オプションを指定する必要があります。 次の表には、サポートされている構成オプションとその説明が記載されています。また、各オプションを使用できるデータ ストア タイプも示されています。

構成オプション

説明

サポートされているデータ ストア タイプ

--disk-threshold-readonly

このオプションは、ディスク容量の不足によるデータの損失を防ぐために、リレーショナル ストアを読み取り専用モードに設定するタイミングを制御します。

サイズを MB 単位で指定します。 ディスク容量のデフォルト値は 1024 MB です。

リレーショナル ストアのみ

--max-connections

このパラメーターは、リレーショナル ストアに許可される接続の最大数を指定します。

リレーショナル ストアは、デフォルトでは最大 150 の接続を受け入れます。 --max-connections プロパティを使用すると、許可される接続数を変更できます。

ArcGIS Data Store の内部プロセスで取得できる接続の数は最大で 5 つであることを考慮に入れてください。 また、ArcGIS Data Store コンピューターが受け入れ可能であり、高いパフォーマンスを維持できる同時接続の数も考慮に入れる必要があります。 ArcGIS Data Store を実行するコンピューターのメモリー容量が少ない場合は、許可される接続数を減らす必要があります。

10 未満の数を指定することはできません。

許可される最大接続数を変更すると、プライマリーとスタンバイの両方のデータ ストア コンピューターに対してその数が変更されます。

リレーショナル ストアのみ

--pitr

このオプションは、ArcGIS Data Store がリレーショナル ストアの増分バックアップを作成することで、リレーショナル ストアを特定の時点まで復元できるようにするかどうかを示します。

このオプションで指定できる引数は enable または disable です。

リレーショナル ストアのみ

デフォルト設定は --pitr disable です。

注意:

特定時点への復元は、完全な自動バックアップが存在していることが前提となります。 --pitr オプションを enable に設定する場合、自動バックアップは無効にしないでください。

Portal for ArcGIS とともにインストールされている webgisdr ユーティリティーを使用して ArcGIS Enterprise デプロイメントの増分バックアップを作成する場合は、--pitr オプションを enable に設定する必要があります。

--enablessl

このオプションは、リレーショナル ストアとホスティング サーバーの間で通信する際のトランスポート レイヤー セキュリティー (TLS) プロトコルの使用を制御します。

--enablessl パラメーターでサポートされている引数は次のとおりです:

  • true - これがデフォルトの設定です。 --store relational を指定した場合、リレーショナル ストアとホスティング サーバーの間で通信する際には、トランスポート レイヤー セキュリティー プロトコルが使用されます。

  • false - ホスティング サーバーとリレーショナル ストアの間で HTTP 通信を使用するには、false および --store relational を指定します。

リレーショナル ストアのみ

--heap-size

このパラメーターは、時空間ビッグ データ ストアまたはオブジェクト ストアで使用するヒープ メモリーのサイズ (MB) を変更するために使用します。

デフォルトでは、時空間ビッグ データ ストアは、起動時に合計 RAM の半分または使用可能な RAM の 70% (いずれか小さい方) を使用します。 ヒープ サイズを 512 ～ 32,000 MB の容量に変更できますが、指定した容量がコンピューター上で使用可能な RAM の容量を超えないようにしてください。 時空間ビッグ データ ストアに複数のコンピューターが含まれている場合は、各コンピューター上で changedbproperties ユーティリティーを実行してヒープ サイズを大きくします。

オブジェクト ストアで使用するデフォルトのヒープ メモリーのサイズは、コンピューター上で使用可能な RAM の量に基づいて決まります。

  • ほとんどの場合、オブジェクト ストアでは合計 RAM の半分または使用可能な RAM の 70% (いずれか小さい方) を使用します。

  • RAM が 20 GB 以上あるコンピューターの場合、オブジェクト ストアでは起動時に RAM の 40% を使用しますが、これは使用可能な RAM の量が合計 RAM の 40% から 70% の間である場合に限ります。

オブジェクト ストアのヒープ サイズは、1024 MB (最小) から 124,000 MB (最大) までの値に変更できます。 ただし、次の点に注意してください。

  • コンピューター上の使用可能な RAM が 16 GB から 32 GB までの間である場合、オブジェクト ストアの最小実用ヒープ サイズは 6 GB です。

  • ヒープ サイズを指定する場合は、コンピューター上で使用可能な RAM の量を超えないようにしてください。

オブジェクト ストアに複数のコンピューターが含まれている場合、クラスター内のすべてのコンピューターが更新され、オブジェクト ストアがクラスター内のすべてのコンピューター上で再起動されます。

時空間ビッグ データ ストアとオブジェクト ストアのみ

--rebalance

デフォルトで、このオプションは true に設定され、どれか 1 台のコンピューターが使用不可になった場合に時空間ビッグ データ ストアから他のコンピューターにデータが配布されます。

アップグレードする場合など、1 台の時空間ビッグ データ ストア コンピューターのメンテナンスを実行する必要がある場合は、--rebalance false を指定して、一時的にバランス調整を無効にすることができます。 バランス調整オプションは、--max-rebalance-off パラメーターで設定された分数だけ中断されます。

時空間ビッグ データ ストアのみ

--max-rebalance-off

このオプションを --rebalance オプションと組み合わせて使用すると、バランス調整を中断する時間を指定できます。

デフォルトでは、--max-rebalance-off は 60 分に設定されます。 つまり、バランス調整を一時的に無効にした場合、60 分後に再開されます。 バランス調整を中断してメンテナンス タスクを実行するために必要な時間がこれよりも長いまたは短い場合は、--max-rebalance-off で時間設定を変更します。

時空間ビッグ データ ストアのみ

--prompt

このユーティリティーを実行するときに、指定したアクションを確認するプロンプトが表示されます。 このユーティリティーの使用を自動化する場合は、--prompt no を指定します。自動化しない場合は、プロンプトに答えるまでスクリプトが実行されません。

このユーティリティーによってサポートされているすべてのデータ ストア

例

以下の各セクションに、changedbproperties ユーティリティーで使用できるオプションの使用例を示します。

リレーショナル ストアの読み取り専用閾値の変更

デフォルトでは、空きディスク容量が 1,024 MB 以下になると、リレーショナル ストアが読み取り専用モードに設定されます。 次の例では、他のアプリがコンピューターに書き込みを行っているため、管理者は、コンピューター上の空きディスク容量が 4,000 MB 以下になると直ちに読み取り専用モードに設定されるようにリレーショナル ストアを構成します:

./changedbproperties.sh --store relational --disk-threshold-readonly 4000

changedbproperties --store relational --disk-threshold-readonly 4000

You are changing the following database properties:
      ...disk space threshold to change relational store into READONLY mode to 4000MB)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

リレーショナル ストアに許可される接続数の変更

この例では、リレーショナル ストアに許可される最大接続数が 100 に設定されます:

./changedbproperties.sh --store relational --max-connections 100

changedbproperties --store relational --max-connections 100

You are changing the following database properties:
      ...max number of connections to 100 (on all relational store machines)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

リレーショナル ストアの特定時点への復元の有効化

デフォルトでは、特定時点への復元は無効化されています。 この例では、リレーショナル ストアの特定時点への復元が有効化されます:

./changedbproperties.sh --store relational --pitr enable

changedbproperties --store relational --pitr enable

You are changing the following database properties:
      ...enable point-in-time recovery for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

SSL の無効化

デフォルトでは、リレーショナル ストアは HTTPS を介してホスティング サーバーと通信します。 この例では、--enablessl パラメーターを使用して、HTTP を介してホスティング サーバーと通信するように、リレーショナル ストアを構成します。

./changedbproperties.sh --store relational --enablessl false

changedbproperties --store relational --enablessl false

You are changing the following database properties:
      ...disable ssl for relational store
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

時空間ビッグ データ ストアまたはオブジェクト ストアのヒープ サイズの変更

時空間ビッグ データ ストアまたはオブジェクト ストアで起動時に使用される RAM の量を変更できます。 ヒープ サイズ値の単位は MB です。

注意:

ヒープ サイズを減らすと、データ ストアが起動できなくなる場合があります。 ヒープ サイズを増やす場合は、コンピューター上で使用可能な RAM の量を超える数値を指定しないでください。

この例では、時空間ビッグ データ ストアのコンピューターのヒープ サイズは 1,600 MB に設定されます。

./changedbproperties.sh --store spatiotemporal --heap-size 1600

changedbproperties --store spatiotemporal --heap-size 1600

You are changing the following database properties:
      ...heap size for spatiotemporal store to 1600MB (on current machine)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

この例では、オブジェクト ストアのコンピューターのヒープ サイズは 2,400 MB に設定されます。

./changedbproperties.sh --store object --heap-size 2400

changedbproperties --store object --heap-size 2400

You are changing the following database properties:
      ...heap size to 2400MB for the object store installed on this machine
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes

時空間ビッグ データ ストアのバランス調整の一時停止

この例では、管理者は時空間ビッグ データ ストア内の 1 台のコンピューター上で簡潔なメンテナンス手順を実行する必要がありますが、データ ストアをバランス調整しません。 これを行うには、--rebalance オプションと --max-rebalance-off オプションを使用して、バランス調整を 30 分間中断します。 30 分後、時空間ビッグ データ ストアは自動的に rebalance を true に変更します。

これは定期的に行われる必要があるため、管理者は次のステートメントをスクリプト内に保持して、プロンプト オプションを no に設定します。

./changedbproperties.sh --store spatiotemporal --rebalance false --prompt no

./changedbproperties.sh --store spatiotemporal --max-rebalance-off 30 --prompt no

changedbproperties --store spatiotemporal --rebalance false --prompt no

changedbproperties --store spatiotemporal --max-rebalance-off 30 --prompt no