AWS インスタンス間での PostgreSQL のジオデータベースの移行—AWS における ArcGIS Enterprise

既存の PostgreSQL のエンタープライズジオデータベースを、バックアップファイルを使用して、ローカルサーバーから ArcGIS Enterprise on Amazon Web Services インスタンスに、または ArcGIS Enterprise on Amazon Web Services インスタンス間で移行できます。

これを行うためには、pg_dump ファイルを使用したデータベースの転送に関して、ソースおよびターゲットの両方の PostgreSQL データベースクラスターに互換性がある必要があります。使用しているバージョンに互換性があるかどうかについては、PostgreSQL のドキュメントをご参照ください。

PostgreSQL バージョンに互換性がある場合、ソースジオデータベースのバックアップを作成し、バックアップファイルをターゲット ArcGIS Enterprise on Amazon Web Services インスタンスに転送します。続いて、ターゲット PostgreSQL データベースクラスターにデータベースとログインロールを作成して、データベースを復元します。

注意:

このワークフローは、Amazon Relational Database Services for PostgreSQL には適用されません。

カスタム変数設定の確認

ソースデータベースクラスターのカスタム設定を保持する場合は、これらを新しいデータベースクラスターに追加する必要があります。構成設定は postgresql.conf ファイルに格納されています。このファイルのコピーを作成し、ArcGIS Enterprise on Amazon Web Services インスタンス上のターゲットデータベースクラスターに移行します。

ArcGIS Enterprise on Amazon Web Services インスタンス上の postgresql.conf ファイルは、マウントされているドライブの /data にあります。

ソースジオデータベースのバックアップの作成

ArcGIS Enterprise on Amazon Web Services インスタンスにデータファイルを移行するデータベースのバックアップを作成できます。

PostgreSQL の pg_dump コマンドを使用して、ダンプファイルを作成します。

ソースジオデータベースが格納されているサーバーに接続します。
シェルコマンドプロンプトで pg_dump コマンドを実行して、データベースのバックアップを作成します。
```
pg_dump -U postgres -F c > /data/spdbbu11012.dump
```
pg_dump コマンドの詳細については、PostgreSQL のドキュメントをご参照ください。

移行先インスタンスへのバックアップファイルの移行

ダンプファイルをターゲットインスタンスに転送するには、いくつかの方法があります。データの移行に利用できる方法については、「Amazon Web Services へのデータの転送方法」をご参照ください。必要な場合は、postgresql.conf ファイルも同じ方法を使用して移行できます。

ダンプファイルは EBS (Elastic Block Store) ボリュームに配置してください。

ダンプファイルがターゲット ArcGIS Enterprise on Amazon Web Services インスタンスに配置されたら、PostgreSQL データベースクラスターを準備します。

ターゲット PostgreSQL データベースクラスターの準備

ダンプファイルを復元するデータベースが必要です。また、ソースデータベースでデータを所有しているログインロールが、ターゲットデータベースクラスターに存在している必要があります。

構成ファイルの配置

カスタマイズした postgresql.conf ファイルを使用している場合は、ターゲットインスタンスでデフォルトの postgresql.conf ファイルのバックアップコピーを作成し、カスタマイズしたファイルをマウントされているドライブの /data に配置します。

空のデータベースの作成

作成するデータベースの名前は、ダンプファイルを作成したソース PostgreSQL データベースクラスターのデータベースと同じにする必要があります。データベース名は、データベースクラスター内で一意である必要があります。つまり、ArcGIS Enterprise on Amazon Web Services 間でデータベースを移行する場合、次の条件のいずれかが満たされている必要があります。

ソースデータベースと、関連先データベースクラスター上のデータベースで同じ名前を使用することはできません。
もしくは
転送したバックアップファイルを復元する前に、同じ名前のデータベースを PostgreSQL データベースクラスターから削除する必要があります。

ターゲット EC2 インスタンスに root ユーザーとしてログインします。
コマンドシェルを開き、psql に sde ユーザーとしてログインします。
ダンプファイルを復元するデータベースを作成します。
次の情報に注意してください。
- ターゲットデータベースの名前、所有者、およびエンコーディングは、ソースデータベースと同じにする必要があります。
- ソースデータベースでデフォルト以外のデータベーステンプレート (PostGIS データベーステンプレートなど) を使用している場合は、ターゲットデータベースでも同じテンプレートを使用します。
- 新しいデータベースは既存の表領域に格納するか、このデータベース専用に新しい表領域を作成できます。新しい表領域を使用する場合は、データベースを作成する前に作成しておく必要があります。
```
CREATE DATABASE <dbname>
  WITH OWNER = sde
       TEMPLATE = template0
       ENCODING = '<encoding of db>'
       TABLESPACE = 
       LC_COLLATE = ''
       LC_CTYPE = ''
       CONNECTION LIMIT = -1;
```

ログインおよびグループロールの作成

ターゲットデータベースクラスターには、ソースデータベースでデータを所有している各ユーザーのログインロールが含まれている必要があります。

データベースを ArcGIS Enterprise on Amazon Web Services インスタンス間で移動している場合、デフォルトのログインロールを使用しているときは、ターゲットデータベースクラスターに新しいロールを作成する必要はありません。ただし、ソースデータベースのデータがデフォルト以外のログインロールによって所有されている場合は、ターゲット PostgreSQL データベースクラスターに同じ名前のログインロールを作成する必要があります。同様に、ターゲットデータベースでグループログインを使用する場合は、これらを作成し直してログインロールに付与する必要があります。

グループおよびログインロールの作成とグループへのログインの追加については、PostgreSQL のマニュアルをご参照ください。

データベースの復元

データベースを復元するには、PostgreSQL の pg_restore コマンドを使用します。

注意:

pg_restore コマンドは 2 回実行する必要があります。最初の実行で sde_spatial_references システムテーブルを含むパブリックスキーマを復元し、2 回目の実行で残りのデータを復元します。この手順を実行しなければ、空間データは復元されません。

(ダンプファイルを移動した) 移行先 ArcGIS Enterprise on Amazon Web Services インスタンスに接続します。
コマンドシェルを開き、psql に sde ユーザーとしてログインします。
コマンドシェルプロンプトで pg_restore コマンドを実行し、パブリックスキーマをデータベースに復元します。
pg_restore コマンドを実行するには、sde ユーザーが PostgreSQL のスーパーユーザーである必要があります。
```
pg_restore -U sde -n public -d spdb /data/spdbbu11012.dump
Password:
```
もう一度 pg_restore コマンドを実行し、データベース全体を復元します。
```
pg_restore -U sde -d spdb /data/spdbbu11012.dump
Password:
```
pg_restore コマンドの詳細については、PostgreSQL のドキュメントをご参照ください。

データベースをターゲット PostgreSQL データベースクラスターに復元した後、新しいデータベースのスキーマとテーブルが適切であることを確認します。確認するには、この情報を格納している PostgreSQL カタログビューにクエリを実行します。たとえば、pg_tables カタログビューにクエリを実行して、データベース内のすべてのテーブルと、それらが格納されているスキーマを表示できます。

データベース変数の設定

次に、収集しておいたカスタムデータベース変数の情報を使用して、新しいデータベースに変数を設定します。

次の手順では、search_path 変数を追加および設定する方法を説明しています。その他のデータベース変数にカスタム値を設定する場合も、同様の基本手順を使用します。

psql から新しいデータベースに sde ユーザーとして接続します。
psql プロンプトで、データベースの検索パスを sde スキーマを含むように設定します。
```
SET search_path TO "$user",public,sde;
```

注意:

カスタム変数設定の確認

ソース ジオデータベースのバックアップの作成

移行先インスタンスへのバックアップ ファイルの移行

ターゲット PostgreSQL データベース クラスターの準備