LinuxおよびUNIXでのDataDirect Connect ODBCドライバの使用

Oracle Business Intelligenceでは、Microsoft SQL Server、Sybase ASE、Informix、HiveおよびImpalaの各データベースへの接続性の確保のために、Linuxオペレーティング・システムおよびUNIXオペレーティング・システム用にDataDirect Connect ODBCドライバおよびドライバ・マネージャが提供されます。

Oracle Business Intelligenceをインストールすると、DataDirect Connect ODBCドライバがORACLE_HOME/bi/common/ODBC/Merant/7.1.5/libにインストールされます。

DataDirect Connect ODBCドライバを設定するために、ODBCINI環境変数を設定する必要はありません。この変数は、インストール中に自動的に設定されます。

「システム要件と動作要件」を参照してください。

注意:

Amazon Redshiftデータ・ソースもサポートされています。Amazon Webサービスから使用可能なAmazon Redshift ODBCドライバを使用する必要があります。その他のデータ・ソース用にドキュメント化されている手順を使用して、Amazon Redshiftデータ・ソースを構成します。

DataDirectを使用するためのOracle Business Intelligenceの構成

Oracle BI EEをインストールする場合、必要なDataDirect 7.1.5ドライバがインストールされ、自動的に構成されます。

obis.propertiesおよびodbc.iniファイルのデフォルト設定を定義できます。

既存のデータベース構成を変更して、DataDirectドライバを使用する必要があります。既存のデータベース構成の変更の詳細は、次の手順を参照してください。

• Microsoft SQL ServerデータベースのためのDataDirect Connect ODBCドライバの構成

• MySQLデータベースのためのDataDirect Connect ODBCドライバの構成

• Sybase ASEデータベースのためのDataDirect Connect ODBCドライバの構成

• InformixデータベースのためのDataDirect Connect ODBCドライバの構成

• Cloudera ImpalaデータベースのためのDataDirect Connect ODBCドライバの構成

• Apache HiveデータベースのためのDataDirect Connect ODBCドライバの構成

Oracle Essbaseのための追加のDataDirect構成

DataDirect構成では、EssbaseがDataDirect 7.1.5ドライバに接続できるように、essbase.cfgファイルを変更する必要があります。

1. 次の場所からessbase.cfgを開いて編集します。

   BI_DOMAIN/config/fmwconfig/biconfig/essbase

2. 構成ファイルで、BPM_ORACLE_DriverDescriptor要素を見つけて、値を"DataDirect 7.1.5 Oracle Wire Protocol"に変更します。
3. Fusion Middleware Controlを使用してEssbaseを再起動します。

Microsoft SQL ServerデータベースのためのDataDirect Connect ODBCドライバの構成

Microsoft SQL Serverデータベースに接続するDataDirect ODBCドライバ・ファイルの名前は、ARsql27.soです。

サポートされるMicrosoft SQL Serverのバージョンは、システム要件と動作要件を参照してください。

1. 次の場所にあるobis.propertiesファイルを開きます。

   BI_DOMAIN/config/fmwconfig/bienv/obis

2. LD_LIBRARY_PATH変数を見つけて、次の情報を使用します。

   • Solaris、LinuxおよびHP-UXの場合は、ライブラリ・パス変数はLD_LIBRARY_PATHです。

   • AIXの場合は、ライブラリ・パス変数はLIBPATHです。

   たとえば、Linux上のドライバにライブラリ・パス変数を設定するには、次のようにします。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE,
   $ORACLE_HOME/lib
   

3. 必要に応じ、DataDirectドライバのパスが含まれるようにLD_LIBRARY_PATH変数を更新します。

   Linuxのドライバの変数を更新するには、次の例を確認します。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib,
   $ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/bi/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE,
   $ORACLE_HOME/lib
   

4. obis.propertiesでPATH変数を検索し、必要に応じ、DataDirectドライバ・パスを含めます。
5. ファイルを保存して閉じます。
6. 次のディレクトリにあるodbcinst.iniおよびodbc.iniファイルを開きます。

   BI_DOMAIN/config/fmwconfig/bienv/core

7. データベースのエントリを作成します。

   リポジトリで定義した接続プールに指定されているデータ・ソース名と同じODBC接続名を使用します。DriverパラメータをMicrosoft SQL Server用のDataDirect Connectドライバのファイル名と場所に設定します。次の例では、DriverパラメータはDataDirect Connectドライバに設定されており、データ・ソース名はSQLSERVER_DBです。

   [SQLSERVER_DB]
   Driver=/ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib/ARsqls27.so
   Description=DataDirect 7.1 SQL Server Wire Protocol
   Address=111.111.111.111,1433
   AlternateServers=
   AnsiNPW=Yes
   ConnectionRetryCount=0
   ConnectionRetryDelay=3
   Database=dbschema_name
   LoadBalancing=0
   LogonID=
   Password=
   QuoteID=No
   ReportCodePageConversionErrors=0
   

8. odbcinst.iniおよびodbc.iniファイルを保存して閉じます。
9. OBIS1を再起動します。

MySQLデータベースのためのDataDirect Connect ODBCドライバの構成

MySQLデータベースに接続するDataDirect ODBCドライバ・ファイルの名前は、ARmysql27.soです。

MySQLデータベースに接続するDataDirect ODBCドライバ・ファイルの名前は、ARmysql27.soです。「システム要件と動作保証」を参照してください。

1. 次の場所にあるobis.propertiesファイルを開きます。

   BI_DOMAIN/config/fmwconfig/bienv/obis

2. LD_LIBRARY_PATH変数を検索します。次を使用します。

   • Solaris、LinuxおよびHP-UXの場合は、ライブラリ・パス変数はLD_LIBRARY_PATHです。

   • AIXの場合は、ライブラリ・パス変数はLIBPATHです。

   たとえば、Linux上のドライバにライブラリ・パス変数を設定するには、次のようにします。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE,
   $ORACLE_HOME/lib
   

3. 必要に応じ、DataDirectドライバのパスが含まれるようにLD_LIBRARY_PATH変数を更新します。たとえば、Linux上のドライバの変数を更新するには、次のようにします。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib,
   $ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE$:$ORACLE_HOME/lib
   

4. obis.propertiesでPATH変数を検索し、必要に応じ、DataDirectドライバ・パスを含めます。
5. ファイルを保存して閉じます。
6. odbc.iniファイルを開きます。このファイルは次の場所にあります:

   BI_DOMAIN/config/fmwconfig/bienv/core

7. データベースのエントリを作成します。

   リポジトリで定義した接続プールに指定されているデータ・ソース名と同じODBC接続名を使用します。

   DriverパラメータをMySQLデータベース用のDataDirect Connectドライバのファイル名および場所に設定します。NetworkAddressには、IPアドレスまたは完全修飾ホスト名およびポート番号を使用します。

   次の例では、DriverパラメータはDataDirect Connectドライバに設定されており、データソース名はMySQL_DBです。

   [MYSQL_DB]
   Driver=/ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib/ARmysql27.so
   Description=DataDirect 7.1.5 MySQL Wire Protocol
   ApplicationUsingThreads=1
   ConnectionRetryCount=0
   ConnectionRetryDelay=3
   Database=default
   DefaultLongDataBuffLen=1024
   EnableDescribeParam=0
   HostName=localhost
   InteractiveClient=0
   LoadBalancing=0
   LogonID=my_id
   Password=my_password
   PortNumber=1526
   ReportCodepageConversionErrors=0
   TreatBinaryAsChar=0
   

8. odbc.iniファイルを保存して閉じます。
9. OBIS1を再起動します。

Sybase ASEデータベースのためのDataDirect Connect ODBCドライバの構成

Sybase ASEデータベースに接続するDataDirect ODBCドライバのファイル名は、ARase27.soです。

サポートされるSybase ASEのバージョンの詳細は、「システム要件と動作要件」を参照してください。

1. 次の場所にあるobis.propertiesファイルを開きます。

   BI_DOMAIN/config/fmwconfig/bienv/obis

2. LD_LIBRARY_PATH変数を見つけて、次の情報を使用します。

   • Solaris、LinuxおよびHP-UXの場合は、ライブラリ・パス変数はLD_LIBRARY_PATHです。

   • AIXの場合は、ライブラリ・パス変数はLIBPATHです。

   たとえば、Linux上のドライバにライブラリ・パス変数を設定するには、次のようにします。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin, 
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE$:$ORACLE_HOME/lib
   

3. 必要に応じ、DataDirectドライバのパスが含まれるようにLD_LIBRARY_PATH変数を更新します。

   Linuxのドライバの変数を更新するには、次の例を確認します。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib,
   $ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,$ORACLE_INSTANCE$:$ORACLE_HOME/lib
   

4. PATH変数を見つけて、必要に応じてDataDirectドライバ・パスを含めます。
5. ファイルを保存して閉じます。
6. 次の場所にあるodbc.iniファイルを開きます。

   BI_DOMAIN/config/fmwconfig/bienv/core

7. データベースのエントリを作成します。

   リポジトリで定義した接続プールに指定されているデータ・ソース名と同じODBC接続名を使用します。

   DriverパラメータをSybase ASEデータベース用のDataDirect Connectドライバのファイル名および場所に設定します。NetworkAddressには、IPアドレスまたは完全修飾ホスト名およびポート番号を指定します。

   次の例は、DataDirect Connectドライバに設定されたDriverパラメータと、データ・ソース名としてSybaseASE_DBを示しています。

   [SybaseASE_DB]
   Driver=/ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib/ARase27.so
   Description=DataDirect 7.1 Sybase Wire Protocol
   AlternateServers=
   ApplicationName=
   ApplicationUsingThreads=1
   ArraySize=50
   AuthenticationMethod=0
   Charset=
   ConnectionRetryCount=0
   ConnectionRetryDelay=3
   CursorCacheSize=1
   Database=Paint
   DefaultLongDataBuffLen=1024
   EnableDescribeParam=0
   EnableQuotedIdentifiers=0
   EncryptionMethod=0
   GSSClient=native
   HostNameInCertificate=
   InitializationString=
   Language=
   LoadBalancing=0
   LogonID=my_id
   NetworkAddress=111.111.111.111,5005
   OptimizePrepare=1
   PacketSize=0
   Password=
   RaiseErrorPositionBehavior=0
   ReportCodePageConversionErrors=0
   SelectMethod=0
   ServicePrincipalName=
   TruncateTimeTypeFractions=0
   TrustStore=
   TrustStorePassword=
   ValidateServerCertificate=1
   WorkStationID=
   

8. odbc.iniファイルを保存して閉じます。
9. OBIS1を再起動します。

InformixデータベースのためのDataDirect Connect ODBCドライバの構成

Informixデータベースに接続するDataDirect ODBCドライバのファイル名は、ARifcl27.soです。

サポートされるInformixのバージョンは、「システム要件と動作要件」を参照してください。

1. 次の場所にあるobis.propertiesファイルを開きます。

   BI_DOMAIN/config/fmwconfig/bienv/obis

2. LD_LIBRARY_PATH変数を見つけて、次の情報を使用します。

   • Solaris、LinuxおよびHP-UXの場合は、ライブラリ・パス変数はLD_LIBRARY_PATHです。

   • AIXの場合は、ライブラリ・パス変数はLIBPATHです。

   たとえば、Linux上のドライバにライブラリ・パス変数を設定するには、次のようにします。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE$:$ORACLE_HOME/lib
   

3. 必要に応じ、DataDirectドライバのパスが含まれるようにLD_LIBRARY_PATH変数を更新します。

   Linuxのドライバの変数を更新するには、次の例を確認します。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib,
   $ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE$:$ORACLE_HOME/lib
   

4. obis.propertiesでPATH変数を検索し、必要に応じ、DataDirectドライバ・パスを含めます。
5. ファイルを保存して閉じます。
6. odbc.iniファイルを開きます。このファイルは次の場所にあります:

   BI_DOMAIN/config/fmwconfig/bienv/core

7. データベースのエントリを作成します。

   リポジトリで定義した接続プールに指定されているデータ・ソース名と同じODBC接続名を使用する必要があります。

   DriverパラメータをInformix用のDataDirect Connectドライバのファイル名および場所に設定します。HostNameパラメータ(完全修飾ホスト名またはIPアドレスを使用可能)とPortNumberパラメータを指定する必要があります。

   次の例では、DriverパラメータはDataDirect Connectドライバに設定されており、データソース名はInformix_DBです。

   [Informix_DB]
   Driver=/ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib/ARifcl27.so
   Description=DataDirect Informix Wire Protocol
   AlternateServers=
   ApplicationUsingThreads=1
   CancelDetectInterval=0
   ConnectionRetryCount=0
   ConnectionRetryDelay=3
   Database=
   HostName=111.111.111.111
   LoadBalancing=0
   LogonID=informix
   Password=mypassword
   PortNumber=1526
   ReportCodePageConversionErrors=0
   ServerName=
   TrimBlankFromIndexName=1
   

8. odbc.iniファイルを保存して閉じます。
9. OBIS1を再起動します。

Cloudera ImpalaデータベースのためのDataDirect Connect ODBCドライバの構成

Cloudera Impalaデータベースに接続するためのDataDirect ODBCドライバ・ファイルの名前は、ARimpala27.soです。

サポートされるCloudera Impalaのバージョンは「システム要件と動作要件」および「LIMIT句を含めるImpala 1.3.xの構成」参照してください。

1. 次の場所にあるobis.propertiesファイルを開きます。
   BI_DOMAIN/config/fmwconfig/bienv/obis
2. LD_LIBRARY_PATH変数を検索します。
   ライブラリ・パス変数は、次のようになります。

   • Solaris、Linux、およびHP-UXの場合: LD_LIBRARY_PATH

   • AIXの場合: LIBPATH

   たとえば、Linux上のドライバ用にライブラリ・パス変数を設定する場合は次のようにします。

   LD_LIBRARY_PATH=$ORACLE_HOME/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE,
   $ORACLE_HOME/lib

3. 必要に応じ、DataDirectドライバのパスが含まれるようにLD_LIBRARY_PATH変数を更新します。
   たとえば、Linux上のドライバの変数を更新するには、次のようにします。

   LD_LIBRARY_PATH=$ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib,
   $ORACLE_HOME/bi/bifoundation/server/bin,
   $ORACLE_HOME/bi/bifoundation/web/bin,
   $ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/bin,
   $ORACLE_HOME/bi/bifoundation/odbc/lib,
   $ORACLE_INSTANCE,
   $ORACLE_HOME/lib
   

4. obis.propertiesでPATH変数を検索して、必要に応じてDataDirectドライバ・パスを含めます。
5. ファイルを保存して閉じます。
6. odbc.iniファイルを開きます。このファイルは、次の場所にあります。

   BI_DOMAIN/config/fmwconfig/bienv/core

7. データベースのエントリを作成し、HostNameパラメータを指定します。

   HostNameパラメータとしての完全修飾ホスト名またはIPアドレスと、PortNumberパラメータを使用できます。

   • ODBC接続名は、リポジトリで定義した接続プールに指定されているデータ・ソース名と同じにします。

   • Driverパラメータは、Cloudera Impala用のDataDirect Connectドライバのファイル・パスに設定します。

   • HostNameパラメータは完全修飾ホスト名を使用するか、HostNameパラメータとしてのIPアドレスとPortNumberを使用します。

   次の例は、DataDirect Connectドライバに設定されたDriverパラメータと、Impala_DBデータ・ソース名を示しています。

   [Impala_DB]
   Driver=/ORACLE_HOME/bi/common/ODBC/Merant/7.1.5/lib/ARimpala27.so
   Description=Oracle 7.1 Cloudera Impala Wire Protocol
   ArraySize=16384
   Database=default
   DefaultLongDataBuffLen=1024
   DefaultOrderByLimit=-1
   EnableDescribeParam=0
   HostName=localhost
   LoginTimeout=30
   MaxVarcharSize=2000
   PortNumber=21050
   RemoveColumnQualifiers=0
   StringDescribeType=12
   TransactionMode=0
   UseCurrentSchema=0
   WireProtocolVersion=2
   

8. odbc.iniファイルを保存して閉じます。
   Impala 1.3.xを使用している場合は、LIMIT句セクションを含めた構成が必要になります。Impala 1.4 (CDH 5.1)以上を使用している場合、追加の手順を完了する必要はありません。
9. OBIS1を再起動します。

Oracle BI管理ツールに移動し、Cloudera Impalaメタデータをインポートします。「Windows ODBCを使用したCloudera Impalaメタデータのインポート」を参照してください。

LIMIT句を含めるImpala 1.3.xの構成

Impala 1.3.xでは、ORDER BY句のある問合せにLIMIT句が含まれている必要があります。

この句を構成で指定する方法は3つあります。Impalaデーモンのデフォルトの問合せオプションを変更する方法の使用をお薦めします。2番目と3番目の方法については、「Impala DefaultOrderByLimitを変更する代替方法」を参照してください。

次のいずれかの方法で制限したデフォルトの順番を指定すると、句によってORDERのある問合せに対して最大2,000,000列が戻ります。

Impalaデーモンのデフォルトの問合せオプションを変更する方法を使用してLIMIT句を指定したときに、問合せにORDER BY句が含まれていると、Impalaは最大2,000,000列を戻します。この制限を超過すると、Impalaは例外をスローします。

問合せが2,000,000列を超える場合のために、default_order_by_limit値を高く指定します。

Default Order By Limitは、Impalaサーバーのかわりにクライアント使用して指定することもできます。

先の2つの方法を使用してImpalaデーモンを変更する権限がない場合、この方法を使用してください。この方法を使用すると、Impalaにより、値が2,000,000列まで静的に切り詰められます。

1. Cloudera Managerのホーム・ページに移動し、Impalaサービスをクリックします。
2. 「Impalaサービス」ページで、「構成」をクリックして、「表示と編集」を選択します。
3. 「構成」ページで、「Impalaデーモンのデフォルトのグループ」を選択します。
4. Impala Daemon Query Options Advanced (default_query_optionsとも呼ばれます)を検索し、次のエントリを追加します。

   default_order_by_limit=2000000
   abort_on_default_limit_exceeded=true

5. 「変更の保存」をクリックします。
6. Cloudera Managerのホーム・ページで、Impalaサービスを再起動します。

Impala DefaultOrderByLimitを変更する代替方法

Cloudera Managerで管理されていないImpala環境を使用している場合は、1番目のDefaultOrderByLimitの変更オプションを使用します。2番目のDefaultOrderByLimitのオプションは、Impalaデーモンを変更するための権限がない場合に使用します。

Cloudera Managerを使用することなくImpalaデーモンのデフォルトの問合せオプションを変更する

Cloudera Managerで管理されてる環境を使用していて、必要になる権限を持っている場合は、DefaultOrderByLimitを更新する際の推奨方法を使用してください。「LIMIT句を含めるImpala 1.3xの構成」を参照してください。

Cloudera Managerで管理されていないImpala環境を使用している場合は、LIMIT句の変更に役立つImpala製品のドキュメントを使用します。この作業を完了するには、『CDH 5 Installation Guide』内の、コマンドラインを使用したImpalaスタートアップ・オプションの構成に関する項を参照してください。

この方法を使用してLIMIT句を指定し、問合せにORDER BY句が含まれている場合、Impalaは最大2,000,000列を戻します。この制限を超過すると、Impalaは例外をスローします。

• コマンドラインを使用したImpalaスタートアップ・オプションの構成に関する項の手順を使用してから、IMPALA_SERVER_ARGS内に次のエントリを追加します。

  -default_query_options 'default_order_by_limit=2000000;abort_on_default_limit_exceeded=true'
  

odbc.ini Impala DSNエントリのDefaultOrderByLimitパラメータを変更する

先の2つの方法を使用してImpalaデーモンを変更する権限がない場合、この方法を使用してください。この方法を使用すると、Impalaにより、値が2,000,000列まで静的に切り詰められます。

問合せが戻す数を2,000,000列よりも大きく指定する場合、DefaultOrderByLimitパラメータの値をそれよりも高く指定します。

Default Order By Limitは、Impalaサーバーのかわりにクライアント使用して指定することもできます。

1. BI_DOMAIN/config/fmwconfig/bienv/coreディレクトリでodbc.iniファイルを開きます。
2. Impala_DBデータベース・エントリを検索し、DefaultOrderByLimitパラメータを検索します。
3. 値を2000000に更新します(例: DefaultOrderByLimit=2000000)。
4. odbc.iniファイルを保存して閉じます。