SQL を使用してジオデータベースにアクセスするための Oracle リスナーの構成
Oracle の ST_Geometry と ST_Raster という SQL 関数が使用する共有ライブラリには、Oracle の外部プロシージャ エージェント(extproc)を経由してアクセスします。ST_Geometry または ST_Raster を含む SQL を使用したり、GDB_ITEMS_VW および GDB_ITEMRELATIONSHIPS_VW ビュー内の ArcSDE XML 列にアクセスするには、Oracle がこれらの共有ライブラリにアクセスできるようにする必要があります。したがって、これらのライブラリが Oracle サーバに存在し、Oracle の外部プロシージャ フレームワークを通してこれらのライブラリ内の関数を呼び出すように Oracle リスナーを構成する必要があります。
Oracle リスナーを設定せずに ArcGIS で ST_Geometry と ST_Raster を使用することは可能です。ただし、ArcSDE クライアントの一部の機能と、SQL クライアントの機能すべて(SQL*Plus など)が使用できなくなります。たとえば、Oracle リスナーが構成されていない場合、ArcMap のクエリ レイヤの ST_Geometry 列で SQL 関数を使用したり、ST_Raster 列を含むバージョン テーブルを使用したり、ST_Raster 列を含む行を削除したり、SQL クライアントから SQL 関数を実行することはできません。
ST_Raster のインストールは任意です。詳細については、「Oracle での ST_Raster タイプのインストール」をご参照ください。
Oracle リスナーは高度な構成が可能です。たとえば、データベースに複数のリスナーを関連付けて、各リスナーで複数タイプのサービス リクエストを管理することもできます。こうした複雑な構成については多数のバリエーションがあり、このドキュメントで取り上げることはできません。リスナーの構成方法については、『Oracle Database Net Services 管理者ガイド』をご参照いただくことが重要です。
リスナーの構成において最も重要な部分は、共有ライブラリの場所を extproc に指示することです。共有ライブラリの場所を指定するためにリスナー構成を変更し、構成の変更が反映されるように Oracle リスナー プロセスを再起動する必要があります。
2 つの標準の Oracle リスナー 構成ファイル(tnsnames.ora および listener.ora)が必要です。これらのファイルは通常、ORACLE_HOME/network/admin にあります。このドキュメントでは必要とされる構成設定を提示します。
設定を管理するための方法はいくつかあります。テキスト エディタでテキスト ファイルを編集するか、Oracle Net Manager を使用するか、Oracle Net Configuration Assistant を使用することができます。Oracle からは、リスナーの構成方法に関するドキュメントが提供されています。詳細については、『Oracle Database Net Services 管理者ガイド』をご参照ください。
tnsnames.ora ファイルには、既知のデータベース サービスのディレクトリが含まれています。このファイルによって、ローカル データベースまたはリモート サーバ上のサービスを定義できます。ここには、プロセス間通信(IPC)を使用して関数の呼び出しを extproc に送信するために、ローカル データベース サーバによって使用される、固有のエントリが 1 つ含まれています。このエントリには EXTPROC_CONNECTION_DATA というラベルが付いています。このエントリの Key 値と SID 値はユーザが変更できます。
これらのアイテムは、listener.ora ファイル内の対応する情報にこのエントリをリンクするために使用されます。キーには任意のショート ネームを付けることができますが、listener.ora ファイル内と tnsnames.ora ファイル内で同じ名前にする必要があります。これらの値では大文字と小文字が区別されます。これらを使用するのはリスナー プロセスのみで、ユーザやアプリケーションが使用することはありません。
listener.ora ファイルには、リスナーがリクエストを処理するサービスの一部(すべてである必要はない)が記述されます。
このファイル内で変更可能な値には、次のようなものがあります。
- SID_LIST_LISTENER
このラベルは、LISTENER(デフォルト リスナー名)という名前のリスナーで処理される SID のリストの最初に存在します。
- SID_LIST および SID_DESC
見出しの SID_LIST の下にある SID_DESC エントリは、サービスを定義します。リストの 1 番目は extproc リクエストを処理し、2 番目はクライアント セッションを処理します。
- SID_NAME
この値は、tnsnames.ora ファイル内で extproc に対して指定されている SID と一致させる必要があります。
- ORACLE_HOME
このサービスの Oracle ホームの場所を定義します。extproc プログラム ファイルはこの場所の下のフォルダから読み込みます。
- PROGRAM
extproc 実行可能ファイルのファイル名を指定します。この名前は大文字と小文字が区別され、オペレーティング システムのタイプによって extproc または extproc.exe になります。このファイルは ORACLE_HOME/bin に配置されています。
- ENVS
extproc が実行時に使用する環境変数のリストです。このリストはコロン区切りです。このリストには、環境変数 EXTPROC_DLLS と、extproc が実行時に使用するその他の環境変数を含む必要があります。UNIX および Linux システムでは LD_LIBRARY_PATH、SHLIB_PATH、または LIBPATH、Windows サーバでは PATH などがよく含まれます。PATH 変数には、多くの場合、ジオメトリと投影エンジン ライブラリの場所が含まれています。
- EXTPROC_DLLS
この環境変数は、extproc が読み込んで、関数を直接呼び出すことのできるライブラリのリストを定義します。ここでは、ST_SHAPELIB ライブラリ(ST_Geometry タイプにアクセスしたり、SQL を使用して GDB_ITEMS_VW および GDB_ITEMRELATIONSHIPS_VW ビューにアクセスするために必要)と、LIBST_RASTER ライブラリ(SQL を使用して ST_Raster タイプにアクセスするために必要)を含むファイルへのパスを指定する必要があります。
UNIX にインストールされた Oracle サーバではリストはコロン区切りで、Windows にインストールされた Oracle サーバではセミコロン区切りです。パスはすべて、絶対パスでローカル ディレクトリを指しているか、Oracle システム ユーザのアクセスできる UNC パスでなければなりません。つまり、Oracle 以外のサーバに ArcSDE をインストールした場合、シェープおよびラスタ ライブラリを Oracle サーバにコピーする必要があるということです。詳細については、「異なるサーバへの Oracle と ArcSDE のインストール」をご参照ください。
環境変数の代替は存在しません。
オプションのキーワードである ANY および ONLY を使用することで、extproc によるライブラリ ファイルの使用を緩和または制約することができます。パスの先頭に ANY を付けると、Oracle は指定したパスからすべてのライブラリを読み込みことができます。ライブラリ名を指定する必要はありません。パスの先頭に ONLY を付けると、Oracle はパス内に指定された特定のライブラリのみを使用します。
- KEY
このエントリの値セットによって、当該リスナーが tnsnames.ora ファイル内の対応するサービス エントリとリンクします。このキーによって、同じデータベース サーバ上に他の IPC リスナーが存在していても、当該リスナーを識別することができます。キーには任意のショート ネームを付けることができますが、listener.ora ファイル内と tnsnames.ora ファイル内で同じ名前にする必要があります。キーでは、小文字と大文字が区別されます。
- 変更を行う前に、tnsnames.ora ファイルと listener.ora ファイルのバックアップ コピーを作成します。
- Oracle サーバで tnsnames.ora ファイルを開きます。
-
tnsnames.ora ファイルの EXTPROC_CONNECTION_DATA で Key と SID の値を変更します。
EXTPROC_CONNECTION_DATA = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = IPC)(Key = EXTPROC1)) ) (CONNECT_DATA = (SID = PLSExtProc) (PRESENTATION = RO) ) )
この項目のラベルは必ず EXTPROC_CONNECTION_DATA でなければなりません。この項目は、データベース サーバがプロセス間通信を使用して extproc に関数呼び出しを送信するときに使用されます。
- Oracle サーバで listener.ora ファイルを開きます。
-
必要な項目を変更して、リスナーがリクエストを受け付けるサービスを設定します。
最初の例は、ArcSDE と Oracle の両方がインストールされた Windows オペレーティング システムの場合です。
LISTENER = (DESCRIPTION_LIST = (DESCRIPTION = (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1)) (ADDRESS = (PROTOCOL = TCP)(HOST = svr1.dmn1.com)(PORT = 1521)) ) ) SID_LIST_LISTENER = (SID_LIST = (SID_DESC = (SID_NAME = PLSExtProc) (ORACLE_HOME = C:\oracle\product\10.2.0\db_1) (PROGRAM = extproc) (ENVS="EXTPROC_DLLS=C:\ArcSDE\sdeexe\bin\st_shapelib.dll;c:\ArcSDE\sdeexe\bin\libst_raster_ora.dll") ) )
以下の例は、ArcSDE と Oracle の両方がインストールされた Linux または UNIX(IBM AIX を除く)の場合を示しています。
LISTENER = (DESCRIPTION_LIST = (DESCRIPTION = (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1)) (ADDRESS = (PROTOCOL = TCP)(HOST = svr1.dmn1.com)(PORT = 1521)) ) ) ) SID_LIST_LISTENER = (SID_LIST = (SID_DESC = (SID_NAME = PLSExtProc) (ORACLE_HOME = /servit/oracle/product/10.2.0/db_1) (PROGRAM = extproc) (ENVS="EXTPROC_DLLS=/servit/ArcSDE/sdeexe/lib/libst_shapelib.so:/servit/ArcSDE/sdeexe/lib/libst_raster_ora.so") ) )
以下の例は、IBM AIX の ArcSDE for Oracle の場合を示しています。
LISTENER = (DESCRIPTION_LIST = (DESCRIPTION = (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1)) (ADDRESS = (PROTOCOL = TCP)(HOST = svr1.dmn1.com)(PORT = 1521)) ) ) ) SID_LIST_LISTENER = (SID_LIST = (SID_DESC = (SID_NAME = PLSExtProc) (ORACLE_HOME = /servit/oracle/product/10.2.0/db_1) (PROGRAM = extproc) (ENVS="EXTPROC_DLLS=/servit/ArcSDE/sdeexe/lib/libst_shapelib_64.so:/servit/ArcSDE/sdeexe/lib/libst_raster_ora_64.so") ) )
- listener.ora ファイルを変更後、Oracle リスナーを再起動します。