接続の確立
コネクタ内で利用可能なオブジェクトは、"cdata.oracleoci" モジュールからアクセスできます。モジュールのオブジェクトを直接使用するには:
- モジュールを以下のようにインポートします。
import cdata.oracleoci as mod
- 接続を確立するには、以下のような適切な接続文字列を使用してコネクタオブジェクトからconnect() メソッドを呼び出します。
mod.connect("User=scott;Password=tiger;Server=127.0.0.1;Port=1521;")
Oracle OCI への接続
Oracle OCI は、以下の接続タイプをサポートしています。- Oracle Server
- OracleTNS
- LDAP
Oracle Server
適切なライブラリをPATH に追加(接続の前に で説明)したのち、次のプロパティを設定します。- User:Oracle データベースへの認証のためのユーザーId。
- Password:Oracle データベースへの認証のためのパスワード。
- Port:Oracle データベースをホスティングしているサーバーに接続する際のポート。
- ServiceName:Oracle データベースのサービス名。この値はOracle SQL*PLUS コマンドラインを使ってglobal_name をクエリ(select * from global_name)することで取得できます。
- Server:Oracle データベースをホスティングしているサーバーのホスト名またはIP アドレス。
OracleTNS
OracleTNS を介して認証するには、次のプロパティを設定します。- User:Oracle データベースへの認証のためのユーザーId。
- Password:Oracle データベースへの認証のためのパスワード。
- DataSource:Oracle ネット・サービス名、接続記述子(TNS 接続文字列とも呼ばれます)、または接続先のデータベースを識別する接続名。これらの値は、tnsnames.ora ファイルにあります。
次に例を示します。
DataSource='(DESCRIPTION=(ADDRESS=(protocol_address_information))(CONNECT_DATA= (SERVICE_NAME=service_name)))'
LDAP
LDAP サーバーを介して認証するには、次のプロパティを設定します。- User:Oracle データベースへの認証のためのユーザーId。
- Password:Oracle データベースへの認証のためのパスワード。
- LDAPUri:LDAP サーバーへの接続に使用されるLDAP URI。
- LDAPUser:LDAP サーバーのユーザーアカウント。
- LDAPPassword:LDAP ユーザーのパスワード。
接続文字列は以下のようになります。
LDAPUri=ldap://myldap.com:389/SERVICE_EXMPL,cn=OracleContext,dc=example,dc=com; User=ORACLEUSER; Password=OracleUserPassword;この接続タイプは、Oracle とLDAP の両方のユーザー名とパスワードが必要であることに注意してください。 システム管理者が匿名でのLDAP ログインを許可している場合は、LDAP のユーザー名とパスワードは必要ありません。