DataDirect ドライバーを使用する Linux および UNIX システム からのデータベースへの接続

ブローカーがデータベースに接続できるようにするためには、データベースの ODBC データ・ソース名 (DSN) を定義してください。

以下の情報は、DB2®、Informix®、Oracle、Sybase、および SQLServer データベースに限定されます。 他のすべてのサポートされているデータベースについては、WebSphere Message Broker ODBC Database Extender (IE02) を使用する Linux および UNIX システムからのデータベースへの接続を参照してください。

始める前に:
  1. install_dir/ODBC/V6.0 ディレクトリーに提供されている odbc.ini サンプル・ファイルを、任意の場所にコピーします。 例えば、WebSphere Message Broker のユーザー・ディレクトリーである /var/mqsi (このファイルのコピー先として好ましい位置) にファイルをコピーします。 したがって、システム上の各ブローカー・サービス・ユーザー ID は、独自の DSN 定義を使用できます。

    サンプル・ファイルの内容については、サンプル DataDirect odbc.ini ファイルを参照してください。

  2. odbc.ini ファイルに mqm:mqbrkrs のファイル所有権があり、提供されているサンプル・ファイルと同じ許可があることを確認します。
  3. この odbc.ini ファイルを指すように ODBCINI 環境変数を設定します。絶対パスとファイル名を指定してください。 必ずコピーを指すようにし、インストール・ディレクトリーにある odbc.ini ファイルは指さないでください。
  4. DB2 または Informix データベースに接続する場合には、使用するデータベース・マネージャーのライブラリーの場所を示すように、ライブラリー検索パス環境変数を設定します。

    ライブラリー検索パスに関する詳細は、データベース管理者 (DBA) に問い合わせるか、またはデータベース・マネージャーの資料を参照してください。

    ライブラリー検索パス環境変数は、使用しているプラットフォームによって異なります。
    • Linux platformSolaris platform Linux および Solaris の場合は、LD_LIBRARY_PATH を設定します。
    • HP-UX platform HP-UX の場合は、SHLIB_PATH を設定します。
    • AIX platform AIX® の場合は、LIBPATH を設定します。

    サポートされている他のデータベースには、ライブラリー検索パスの更新は必要ありません。

  5. AIX 上にインストールされた DB2 データベース・インスタンスを使用する場合、1 つのプロセスが共用メモリーを使用して行える DB2 データベースへの接続の数は、10 が最大です。 データベース・インスタンスに接続するには、TCP/IP モードを使用します。DB2 への接続時に DB2 エラー・メッセージ SQL1224N が出されるを参照してください。
  6. odbc.ini ファイルの最後のスタンザである [ODBC] スタンザを編集して、ODBC Driver Manager の場所を指定し、トレースを制御します。 このスタンザの細かい内容は、プラットフォームによって若干異なります。
    正しい odbc.ini ファイルを編集しているかどうかを確認するには、以下のコマンドを使用してファイルを vi テキスト・エディターで開くことができます。
    vi $ODBCINI
    1. InstallDir には、WebSphere Message Broker のインストール場所を追加して、ODBC ディレクトリーへの完全修飾パスを完成させます。 この値を正しく指定しないと、ODBC 定義は機能しません。
    2. TraceFile には、ODBC トレースを書き込むファイルの完全修飾パスとファイル名を入力します。 トレース・ファイルは大きくなる可能性があります。十分の空きディスク・スペースがあるディレクトリーを指定してください。
    3. TraceDll には、WebSphere Message Broker のインストール場所を追加して、ODBC トレース DLL への完全修飾パスを完成させます。
    4. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;##########################################
      ;###### Mandatory information stanza ######
      ;##########################################
      
      [ODBC]
      ;# To turn on ODBC trace set Trace=1
      Trace=0
      TraceOptions=3
      TraceFile=<A Directory with plenty of free space to hold trace
      output>/odbctrace.out
      TraceDll=<Your Broker install directory>/ODBC/V6.0/lib/odbctrac.so
      InstallDir=<Your Broker install directory>/ODBC/V6.0
      UseCursorLib=0
      IANAAppCodePage=4
      UNICODE=UTF-8
  7. odbc.ini ファイルの最初のスタンザである [ODBC Data Sources] スタンザを編集して、各データベースの DSN をリストします。
    例えば、AIX では以下のようにします。
    ;##########################################
    ;###### List of data sources stanza #######
    ;##########################################
    [ODBC Data Sources]
    DB2DB=IBM DB2 ODBC Driver
    ORACLEDB=DataDirect 6.0 Oracle Wire Protocol
    ORACLERACDB=DataDirect 6.0 Oracle Wire Protocol (Real Application Clusters)
    SYBASEDB=DataDirect 6.0 Sybase Wire Protocol
    SYBASEDBUTF8=DataDirect 6.0 Sybase UTF8 Wire Protocol
    SQLSERVERDB=DataDirect 6.0 SQL Server Wire Protocol
    INFORMIXDB=IBM Informix ODBC Driver
    

    データベース・マネージャーに関係なく、odbc.ini ファイルに DSN をすべてリストしてください。 Oracle および Sybase では、複数の DSN を同じデータベースに解決するように定義することができます。ただし、トランザクションのグローバル整合を使用している場合は、このオプションはデータ整合性の問題を引き起こす可能性があるため、使用しないでください。

  8. odbc.ini ファイルの [ODBC Data Sources] スタンザの後に、 [ODBC Data Sources] スタンザにリストした各データベースのスタンザを作成します。 スタンザ内のエントリーは、データベース・マネージャーによって異なります。 また、オペレーティング・システムの違いによっても、ドライバーへのファイル・パスなどの部分でいくらかの違いがあります。
    DB2 データベース・インスタンスの場合は、次のようになります。
    Linux (x86) の場合:
    1. Driver には、DB2 インストールの絶対パスを追加します。
    2. Description には、データベースについて意味のある説明を入力します。 このフィールドは情報専用で、接続には影響しません。
    3. Database には、DB2 別名を入力します。 データ・ソース名は、データベース別名と同じでなければなりません。 リモート DB2 データベースを使用している場合、この別名を正確なデータベースに解決するために、クライアント/サーバー接続をセットアップする必要があります。

      同一の DB2 データベースを参照する複数のスタンザが必要な場合は、DB2 CATALOG コマンドを使用して、DB2 でエイリアスを作成する必要があります。 これらのエイリアスは、ODBCINI ファイル内で独自のスタンザを持つことができます。

      DB2 にエイリアスを設定するために ODBCINI ファイルを使用することはできません。

      詳しくは、DB2 資料を参照してください。

      以下に例を示します。

      ;# DB2 stanza
      [DB2DB]
      Driver=<Your DB2 install directory>/lib32/libdb2.so
      Description=DB2 ODBC Database
      Database=DB2DB
    その他のプラットフォームの場合:
    1. Driver には、サンプル odbc.ini ファイルで示されている値をそのまま受け入れます。
    2. Description には、データベースについて意味のある説明を入力します。 このフィールドは情報専用で、接続には影響しません。
    3. Database には、DB2 別名を入力します。 データ・ソース名は、データベース別名と同じでなければなりません。 リモート DB2 データベースを使用している場合、この別名を正確なデータベースに解決するために、クライアント/サーバー接続をセットアップする必要があります。 詳しくは、DB2 資料を参照してください。

      同一の DB2 データベースを参照する複数のスタンザが必要な場合は、DB2 CATALOG コマンドを使用して、DB2 でエイリアスを作成する必要があります。 これらのエイリアスは、ODBCINI ファイル内で独自のスタンザを持つことができます。

      DB2 にエイリアスを設定するために ODBCINI ファイルを使用することはできません。

      例えば、AIX では以下のようにします。

      ;# DB2 stanza
      [DB2DB]
      DRIVER=<Your DB2 install directory>/lib64/db2o.o
      Description=DB2DB DB2 ODBC Database
      Database=DB2DB
    Oracle データベースの場合は、次のようになります。
    すべてのプラットフォーム:
    1. Driver には、WebSphere Message Broker のインストール場所を追加して、サンプル odbc.ini ファイルに示されているドライバーへの完全修飾パスを完成させます。
    2. Description には、データベースについて意味のある説明を入力します。 このフィールドは情報専用で、接続には影響しません。
    3. HostName には、Oracle システムをホスティングするマシンの名前または IP アドレスを入力します。
    4. PortNumber には、HostName に指定したマシン上で Oracle サーバーが listen するポートの番号を入力します。
    5. SID には、HostName に指定したシステム上で接続する Oracle サービス名を入力します。
    6. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;# Oracle stanza
      [ORACLEDB]
      Driver=<Your Broker install directory>/ODBC/V6.0/lib/UKora24.so
      Description=DataDirect 6.0 Oracle Wire Protocol
      HostName=<Your Oracle Server Machine Name>
      PortNumber=<Port on which Oracle is listening on HostName>
      SID=<Your Oracle SID>
      CatalogOptions=0
      EnableStaticCursorsForLongData=0
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      WorkArounds=536870912
      ProcedureRetResults=1
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Real Application Cluster を使用する Oracle データベースの場合は、次のようになります。
    すべてのプラットフォーム:
    1. Driver には、WebSphere Message Broker のインストール場所を追加して、サンプル odbc.ini ファイルに示されているドライバーへの完全修飾パスを完成させます。
    2. Description には、データベースについて意味のある説明を入力します。 このフィールドは情報専用で、接続には影響しません。
    3. HostName には、1 次 (推奨) Oracle インスタンスをホスティングするマシンの名前または IP アドレスを入力します。
    4. PortNumber には、HostName に指定したマシン上で Oracle サーバーが listen するポートの番号を入力します。
    5. ServiceName には、HostName に指定したインスタンス上の、接続先にする Oracle Real Application Cluster サービス名を入力します。
    6. AlternateServers には、HostName で定義された 1 次ロケーションが使用できない場合に、このサービスで使用する代わりの場所のリストを指定します。 各場所の指定は、コロンで区切られた 3 つの部分で構成します。 これらの値は、連続したストリングとして 1 行で入力します。この例のテキストは、読みやすくするために分割されています。
      HostName=<Alternative host name>
      :PortNumber=<Oracle listner port on alternative server>
      :ServiceName=<Service name on the alternative server>
      複数の AlternateServer を指定する場合は、追加の各場所の指定をコンマで区切ります。 新しいデータベース接続が必要な場合 (例えば、Oracle インスタンスのフェイルオーバーの後) には、必ず 1 次ロケーションが最初に試行されます。 ただし、1 次ロケーションが使用できない場合、ドライバーはリストに指定された代わりの場所を順番に試行します。
    7. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;# Oracle Real Application Clusters stanza
      [ORACLERACDB]
      Driver=<Your Broker install directory>/ODBC/V6.0/lib/UKora24.so
      Description=DataDirect 6.0 Oracle Wire Protocol
      HostName=<Your Oracle Server Machine Name>
      PortNumber=<Port on which Oracle is listening on HostName>
      ServiceName=<Your Oracle Real Application Cluster Service Name>
      AlternateServers=(HostName=<Your alternative host name>:PortNumber=<Port on
      which Oracle is listening on the alternative host>:ServiceName=<Your
      Oracle Real Application Cluster Service Name>)
      CatalogOptions=0
      EnableStaticCursorsForLongData=0
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      WorkArounds=536870912
      ProcedureRetResults=1
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Sybase データベースの場合は、次のようになります。
    Linux (System z® 以外のすべてのプラットフォームの場合:
    1. Driver には、WebSphere Message Broker のインストール場所を追加して、サンプル odbc.ini ファイルに示されているドライバーへの完全修飾パスを完成させます。
    2. Description には、データベースについて意味のある説明を入力します。 このフィールドは情報専用で、接続には影響しません。
    3. Database には、デフォルトで接続するデータベースの名前を入力します。 値を指定しなかった場合、各ユーザーごとにシステム管理者によって定義されたデータベースがデフォルト値となります。
    4. NetworkAddress には、使用する Sybase ASE サーバーのネットワーク・アドレスを入力します (このアドレスは、ローカルおよびリモート・データベースで必須です)。 以下のように IP アドレスまたはサーバー名を指定します。
      <Your Sybase server name or IP address>,<Your Sybase port number>

      例えば、Sybaseserver,5000 のようになります。 199.226.224.34,5000 のように IP アドレスを直接指定することもできます。 interfaces という名前の Sybase インターフェース・ファイルからポート番号を確認できます。

    5. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;# Sybase Stanza
      [SYBASEDB]
      Driver=<Your Broker install directory>/ODBC/V6.0/lib/UKase24.so
      Description=DataDirect 6.0 Sybase Wire Protocol
      Database=<Your Database Name>
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      SelectMethod=0
      NetworkAddress=<Your Sybase Server Name>,<Your Sybase Port Number>
      SelectUserName=1
      ColumnSizeAsCharacter=1
      EnableSPColumnTypes=2
      LoginTimeout=0
      TimestampTruncationBehavior=1
      XAConnOptBehaviour=3
      UNICODE UTF8 Sybase データ・ソースを使用する場合は、以下の行を Sybase スタンザの末尾に追加してください。
      Charset=UTF8
    SQL Server データベースへのリモート・アクセスの場合は、次のようになります。
    Linux (POWER®、Linux (System z、および Solaris (x86-64) 以外のすべてのプラットフォームの場合:
    1. Driver には、WebSphere Message Broker のインストール場所を追加して、サンプル odbc.ini に示されているドライバーへの完全修飾パスを完成させます。
    2. Description には、データベースについて意味のある説明を入力します。 このフィールドは情報専用で、接続には影響しません。
    3. Address には、次のいずれかを行います。
      1. 次のように、接続先の SQLServer データベースを指定する IP アドレスまたはサーバー名およびポート番号を指定します。
        <Your SQLServer machine name or IP address>,<Your SQLServer port number>
        または
      2. 次のように、接続先の SQLServer データベースを指定する IP アドレスまたはサーバー名およびインスタンス名を指定します。
        <Your SQLServer machine name or IP address>¥<Your SQLServer instance name>
        インスタンス名が空白の場合は、<Your SQLServer machine name or IP address> を指定します。
    4. Database には、デフォルトで接続するデータベースの名前を入力します。 値を指定しなかった場合、各ユーザーごとにシステム管理者によって定義されたデータベースがデフォルト値となります。
    5. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;# UNIX to SQLServer stanza
      [SQLSERVERDB]
      Driver=<Your Broker install directory>/ODBC/V6.0/lib/UKmsss24.so
      Description=DataDirect 6.0 SQL Server Wire Protocol
      Address=<Your SQLServer Machine Name>,<Your SQLServer Port Number>
      ;# Alternative way to locate server using a named instance
      ;# Address=<Your SQLServer Machine Name>¥<Your SQLServer Instance Name>
      AnsiNPW=Yes
      Database=db
      QuotedId=No
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Informix データベースの場合は、次のようになります。
    Linux (x86) の場合:
    1. Driver には、Informix クライアント・ライブラリーの絶対パスを追加します。
    2. Description には、データベースについて意味のある説明を入力します。 このフィールドは情報専用で、接続には影響しません。
    3. ServerName には、Informix IDS サーバーの名前を入力します。
    4. Database には、デフォルトで接続するデータベースの名前を入力します。 値を指定しなかった場合、各ユーザーごとにシステム管理者によって定義されたデータベースがデフォルト値となります。
      以下に例を示します。
      ;# Informix Stanza
      [INFORMIXDB]
      Driver=<Your Informix Client Directory>/lib/cli/iclit09b.so
      Description=IBM Informix ODBC Driver
      ServerName=<Your Informix Server Name>
      Database=<Your Database Name>
    その他のプラットフォームの場合:
    1. Driver には、サンプル odbc.ini ファイルで示されている値をそのまま受け入れます。
    2. Description には、データベースについて意味のある説明を入力します。 このフィールドは情報専用で、接続には影響しません。
    3. ServerName には、Informix IDS サーバーの名前を入力します。
    4. Database には、デフォルトで接続するデータベースの名前を入力します。 値を指定しなかった場合、各ユーザーごとにシステム管理者によって定義されたデータベースがデフォルト値となります。
      例えば、AIX では以下のようにします。
      ;# Informix Stanza
      [INFORMIXDB]
      Driver=libinfWrapper.so
      Description=IBM Informix ODBC Driver
      ServerName=<Your Informix Server Name>
      Database=<Your Database Name>
  9. 以下に示す odbc.ini ファイルの 3 つの部分すべてが編集済みであることを確認してください。
    • odbc.ini ファイルの先頭にある [ODBC Data Source] スタンザ。
    • 各データ・ソースのスタンザ。
    • odbc.ini ファイルの最後にある [ODBC] スタンザ。
    3 つの部分がすべて適正に構成されていないと、ODBC DSN は機能せず、ブローカーはデータベースに接続できません。
これで、Linux および UNIX 上のデータベース接続が構成されました。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        最終更新
        
        最終更新 : 2012-08-03 11:58:13


タスク・トピックタスク・トピック | バージョン 7.0.0.5 | bh26080_