トップへ戻る

PostgreSQL でのジオデータベースのアップグレード

このトピックの内容

  1. アップグレードする前に
  2. ジオデータベースのアップグレード

Standard または Advancedのライセンスで利用可能。

エンタープライズ ジオデータベースをアップグレードする目的は、新機能と修正された不具合を利用するために、ジオデータベースのシステム テーブル、ストアド プロシージャ、タイプ、および機能を更新することです。 使用しているデータベース バージョンが使用する ArcGIS クライアントでサポートされなくなった場合、データベースもアップグレードする必要があります。

ArcGIS AllSource または ArcGIS Server の最新バージョンをインストールするか、サービス パック、パッチ、またはホット フィックスを既存のインストールに適用し、ジオデータベースをアップグレードします。

注意:

ジオデータベースをアップグレードしなかった場合でも、使用しているデータベース バージョンが最新のリリースの ArcGIS ソフトウェアでサポートされなくなることがあります。 そのデータベース バージョンがサポートされなくなった場合、ジオデータベースをアップグレードする必要があります。 アップグレードの間隔が長くなるほど、アップグレード プロセスが複雑になります。

ArcGIS AllSource 3.5 を使用してジオデータベースをアップグレードする場合、アップグレードされたジオデータベースのバージョンは 11.5.0.x になります。

アップグレードの前に必要な以下の手順を完了してから、ジオデータベースのアップグレード (Upgrade Geodatabase) ジオプロセシング ツールまたは Python スクリプトを使用してジオデータベースをアップグレードします。

アップグレードする前に

ジオデータベースを含め、エンタープライズ システムをアップグレードする前に、まず計画を立てます。 開発サーバーまたはテスト サーバーで新しいバージョンをテストして、すべてのクライアント アプリケーションで動作することを確認します。

新しいシステムが想定したとおりに機能することが確認できたら、アップグレードのスケジュールを設定します。アップグレードに必要な人員を確保し、各担当者が割り当てられたタスクを実行するために必要な権限を持っていることを確認します。

次の点に注意してください。

  • ベータまたはプレリリース バージョンのソフトウェアからのアップグレードはサポートされません。
  • PostgreSQL データベースのリリースが ArcGIS の最新リリースでサポートされている場合は、10.9.x または 11.x のジオデータベースから直接アップグレードできます。

    PostgreSQL データベースが最新のリリースのジオデータベースでサポートされていない場合、ジオデータベースを最新のリリースにアップグレードするには、データベースとジオデータベースを複数回アップグレードする必要があります。 ジオデータベースをアップグレードする間隔が長くなるほど、最新リリースのジオデータベースにするために必要なアップグレードの回数が増えます。

    たとえば、次のシナリオでは、データベースとジオデータベースをそれぞれ 2 回アップグレードする必要があります。

    かなり古いバージョンのジオデータベースからアップグレードする場合は、複数ステップの手順を実行してデータベースとジオデータベースをアップグレードする必要があります。

    ジオデータベースの中間アップグレードでは、そのジオデータベース バージョンのアップグレード手順に従い、バージョンを移行するたびにジオデータベースをテストします。 同様に、データベース ベンダーから提供されている各データベース バージョンのアップグレード手順に従い、バージョンを移行するたびにテストします。

  • ジオデータベースを以前のバージョンにダウングレードするための正式なメカニズムはありません。 新しいバージョンにアップグレードした後でジオデータベースをダウングレードする場合は、古いジオデータベース バージョンを含むバックアップ ファイルからデータベースを復元することができます。
  • ST_Geometry 空間タイプを使用する 11.2.0 のジオデータベースからアップグレードする場合、アップグレード プロセスを実行すると、ST_Geometry 列で定義済みの空間インデックスが削除されてから再作成されます。

以下は、ジオデータベースをアップグレードする前に実行する手順のチェックリストです。

  1. 使用する PostgreSQL と ArcGIS バージョンの組み合わせが Esri でサポートされているかどうかを確認するには、「PostgreSQL に関する ArcGIS の要件」をご参照ください。

    PostgreSQL データベースをアップグレードする必要がある場合は、PostgreSQL のドキュメントで、データベース管理システムの新機能とアップグレード方法を確認してください。 アップグレードしたデータベースの名前と所有者は、必ずアップグレード前と同じでなければなりません。 また、データベースの search_path 変数を "$user"、public、および sde に設定します。

  2. ArcGIS クライアント リリースを混在して使用することの効果について理解し、特定のデータセット タイプを個別にアップグレードする必要があるかどうかを判断するには、「クライアントとジオデータベースの互換性」をご参照ください。
  3. sde ユーザーとして認証するデータベース接続を作成します。
  4. ジオデータベースをアップグレードできるかどうかを確認します。

    これには、移行先の ArcGIS クライアント バージョンを 1 台のコンピューターにインストールします。 ArcGIS AllSource をインストールした場合、前のステップで作成した接続を使用してジオデータベースに接続し、[データベース プロパティ] ダイアログ ボックスを開いて、ジオデータベースをアップグレードできるかどうかを確認します。 ArcGIS Server (エンタープライズ エディション) をインストールした場合、前のステップで作成した接続ファイルと ArcPy の Describe 関数を使用して、次の例に示すようにジオデータベースをアップグレードできるかどうかを確認できます。

    # Open Python.
cd /arcgis/server/tools
./python

# Import ArcPy.
import arcpy

# Create a connection to the geodatabase.
arcpy.CreateDatabaseConnection_management("/tmp/",
                                          "egdb_connection.sde",
                                          "POSTGRESQL",
                                          "mypgdbcluster",
                                          "DATABASE_AUTH",
                                          "sde",
                                          "mysdepassword",
                                          "SAVE_USERNAME",
                                          "mypgdb")

# Check the geodatabase release.
isCurrent = arcpy.Describe('/tmp/egdb_connection.sde').currentRelease

print(isCurrent)

    False が返された場合、ジオデータベースをアップグレードできます。 True が返された場合、ジオデータベースをアップグレードする必要はありません。 以降の手順を省略してください。

  5. データベースのバックアップを作成します。
  6. ArcGIS の外部で、ArcGIS ジオデータベース システム テーブルに追加したカスタム機能 (トリガーや追加のインデックスなど) をすべて削除します。

    アップグレード手順は、ユーザーがシステム テーブルに加えたカスタマイズに対応できません。 このようなカスタマイズによってシステム テーブルのスキーマ変更が妨げられた場合、アップグレードが失敗します。

  7. データベース管理者は、ジオデータベースのアップグレードに必要な権限を sde ユーザーに付与する必要があります。

    必要な権限については、「PostgreSQL でのジオデータベースの権限」をご参照ください。

  8. アップグレード対象のジオデータベースへの接続がないことを確認します。

    ジオデータベースに現在接続しているユーザーのリストを確認するには、ArcGIS AllSource の [ジオデータベース管理] ダイアログ ボックスを開きます。

  9. ジオデータベースで ST_Geometry タイプが使用されている場合は、次の手順を実行します。 使用されていない場合は、ジオデータベースのアップグレードに進むことができます。

    ジオデータベースで ST_Geometry タイプが使用されているかどうかがわからない場合は、SQL クライアントから sde ユーザーまたはスーパーユーザーとしてデータベースに接続し、sde ユーザーのスキーマに ST_Geometry 関数が存在するかどうかを確認します。

  10. My Esri から st_geometry ファイルをダウンロードして、そのファイルを %PostgreSQL%\lib サーバーの Microsoft Windows ディレクトリ (PostgreSQL の場合) または lib Linux ディレクトリ (PostgreSQL の場合) に配置します。

    lib で PostgreSQL をインストールするための Linux ディレクトリの正確な場所を確認するには、postgres ユーザーとして pg_config ユーティリティを実行します。 lib の場所は PGPKGLIBDIR パラメーターで示されます。

    PostgreSQL のバージョンおよびサーバーのオペレーティング システムに対応するライブラリを使用します。 各フォルダーには、PostgreSQL ライブラリのバージョンのラベルが付けられています。

    • PostgreSQL サーバーで Linux が動作している場合は、root ユーザーとしてサーバーにサイン インし、FTP を使用して st_geometry.so ファイルを PostgreSQL の lib ディレクトリに転送します。
    • PostgreSQL サーバーで Windows が動作している場合は、st_geometry.dll ファイルを PostgreSQL インストール ディレクトリの lib フォルダーにコピーします。

これで、ジオデータベースをアップグレードできるようになりました。

ジオデータベースのアップグレード

ArcGIS AllSource の [ジオデータベースのアップグレード (Upgrade Geodatabase)] ツール、または ArcGIS AllSource または ArcGIS Server コンピューターで実行する Python スクリプトを使用して、ジオデータベースをアップグレードできます。

注意:

ジオデータベースにブランチ バージョン対応データが含まれている場合は、追加のアップグレード後の手順が必要になる場合があります。 手順については、「ジオデータベースのアップグレード (Upgrade Geodatabase) の詳細」をご参照ください。

[ジオデータベースのアップグレード (Upgrade Geodatabase)] ツールの使用

[ジオデータベースのアップグレード (Upgrade Geodatabase)] ジオプロセシング ツールは、次のいずれかから開きます。

  • データ管理ツールボックス内のジオデータベース管理ツールセット
  • ArcGIS AllSource 内の [データベース プロパティ] ダイアログ ボックスの [一般] タブにある [アップグレードの実行] ボタン

[データベース プロパティ] からツールを開いた場合、[入力ジオデータベース] テキスト ボックスにジオデータベース接続情報が事前に入力されています。

Esri では、[前提条件を確認] および [ジオデータベースをアップグレード] オプションをオンのままにすることをお勧めします。 これにより、ジオデータベースのアップグレードを続ける前に、アップグレードを行うための前提条件を満たしているかどうかが確認されます。

前提条件のチェックでは、ジオデータベースへの他のアクティブな接続が検出され、接続しているユーザーにジオデータベースをアップグレードするための十分な権限があるかどうか、データベースが XML 列に対応しているかどうか、すべてのデータセットを開くことができるかどうか、データベースとライブラリのリリースが同じかどうかが確認されます。 前提条件のいずれかが満たされていない場合、ツールは終了します。 アップグレードの手順を再度実行する前に、問題を修正する必要があります。

確認の結果は、ジオプロセシング ツールのダイアログ ボックスで報告されます。 チェックで不合格になった場合は、c:\Users\<user name>\AppData\Local\ESRI\<ArcGIS product> フォルダーにある GDBUpgrade.log ファイルにも結果が書き込まれます。

すべてのチェックに合格した場合、ツールはアップグレードに進みます。 前提条件チェックとアップグレードの状態は、ジオプロセシング ツールの進行状況を示すダイアログ ボックスに表示されます。 アップグレードが失敗すると、情報が GDBUpgrade.log ファイルに書き込まれます。 ユーザーの TEMP ディレクトリにある sde_setup.log ファイルに追加情報が書き込まれます。 ユーザーが一時ディレクトリを構成していない場合は、システムの TEMP ディレクトリが使用されます。

スクリプトの実行

Python スクリプトを使用してジオデータベースをアップグレードするには、次のサンプル スクリプトのいずれかをコピーしてテキスト エディターに貼り付け、サイトに固有の情報に使用するように変更し、そのファイルを保存して閉じて、実行します。

ヒント:

ArcGIS Server コンピューターからの Python の実行については、「ArcGIS Server および ArcPy」をご参照ください。

例では、SDE ユーザーとして接続する既存のデータベース接続ファイル (.sde) があることを前提としています。 接続ファイルが存在しない場合は、アップグレードする前にファイルを作成します。

# Name: upgradesdegdb_example.py
# Description: Uses existing database connection file
# on a Windows computer to run prerequisite check
# and upgrade an enterprise geodatabase.

# Import arcpy module
import arcpy
 
# Local variables:
Output_Workspace = "C:\\ArcGIS\connection_files\<Connection file>"
Default_gdb = "C:\\ArcGIS\connection_files\<Connection file>"

# Process: Upgrade Geodatabase
arcpy.UpgradeGDB_management(Default_gdb, "PREREQUISITE_CHECK", "UPGRADE")
# Name: upgradesdegdb_example.py
# Description: Uses existing database connection file
# on a Linux computer to run prerequisite check
# and upgrade an enterprise geodatabase.

# Import arcpy module
import arcpy
 
# Local variables:
Output_Workspace = "<user>/connections/<Connection_file>"
Default_gdb = "<user>/connections/<Connection_file>"

# Process: Upgrade Geodatabase
arcpy.UpgradeGDB_management(Default_gdb, "PREREQUISITE_CHECK", "UPGRADE")

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

このトピックの内容
  1. アップグレードする前に
  2. ジオデータベースのアップグレード