次の方法で共有


Oracle 接続マネージャー

適用対象:SQL Server Azure Data Factory の SSIS Integration Runtime

重要

Microsoft Connector for Oracle は非推奨になりました。 詳細は アナウンスを参照してください。

Oracle 接続マネージャーを使用して、Oracle データベースからのデータの抽出と Oracle データベースへのデータの読み込みを行うパッケージを有効にできます。

Oracle 接続マネージャーの ConnectionManagerType プロパティには、ORACLE が設定されます。

SSIS 実行ログでは、このコネクタは "Oracle 接続マネージャー" と呼ばれます。

Oracle 接続マネージャーの構成

Oracle 接続マネージャーの構成の変更は、実行時に Integration Services によって解決されます。 [Oracle 接続マネージャー] ダイアログ ボックスを使用して、Oracle データ ソースへの接続を追加します。

接続マネージャー

オプション

接続マネージャー情報

Oracle 接続に関する情報を入力します。

名前

Oracle 接続の名前を入力します。 既定の名前は、[Oracle 接続マネージャー] です。

説明

接続の説明を入力します。 この入力は省略可能です。

TNS サービス名

作業する Oracle データベースの名前を入力します。 次のような TNS サービス名を使用できます。

  • tnsnames.ora ファイルで定義されている接続名

  • EzConnect 形式: [//]host[:port][/service_name]

tnsnames.ora ファイルを使用するには、SSIS パッケージを実行しているマシンにシステム環境変数を追加する必要がある場合があります。 TNS_Admin 環境変数では、tnsnames.ora ファイルがあるフォルダーの場所を指定します。 これは、Oracle クライアントをインストールしていない場合に必要です。 Windows 10、Windows 11、または Windows Server 2022 で環境変数を追加するには、次の手順に従います。

  1. [スタート] アイコンを右クリックし、[システム] を選択します。
  2. [設定] ウィンドウで、[システムの詳細設定] を選択します。
  3. [システムのプロパティ] ウィンドウの [詳細設定] タブで、[環境変数] を選択します。
  4. [環境変数] ウィンドウの [システム] で、[新規] を選択します。
  5. [新しいシステム変数] ウィンドウで、[変数名] に「TNS_Admin」と入力し、変数の値として、tnsnames.ora ファイルがあるフォルダーへの正しいパスを入力します。
  6. [新しいシステム変数]、[環境変数]、[システム プロパティ] ウィンドウで、[OK] を選択します。

詳細については Oracle のマニュアルを参照してください。

接続マネージャーのログ記録

次のいずれかのオプションを選択します。

  • Windows 認証を使用する:Windows 認証を使用するには、これを選択します。

  • Oracle 認証を使用する:Oracle データベース認証を使用するには、これを選択します。 この認証を使用する場合は、Oracle 資格情報を次のように入力します。
    ユーザー名:Oracle データベースに接続するために使用するユーザー名を入力します。
    パスワード:[ユーザー名] フィールドに入力したユーザーの Oracle データベース パスワードを入力します。

注意

Oracle Server 18c では、Windows 認証はサポートされていません。

[接続テスト]

[接続テスト] をクリックして、指定した情報が正しいかどうかを確認します。 入力された情報が Oracle データベースに接続できる場合は、テスト接続に成功した メッセージが表示されます。

注意

ConnectionString 直接指定するには、Oracle 認証のサンプルを次に示します。

SERVER=\<YourOracleServerName or EzConnect format>;USERNAME=\<YourUserName>;PWD=\<YourPassword>;WINAUTH=0

カスタム プロパティ

Oracle 接続マネージャーには、次のカスタム接続マネージャー プロパティがあります。

  • EnableDetailedTracing:使用されません。

  • OracleHome:コネクタによって使用される 32 ビットの Oracle ホーム名またはフォルダーを指定します。 (省略可能)

  • OracleHome64:64 ビット モードで実行する場合にコネクタによって使用される 64 ビットの Oracle ホーム名またはフォルダーを指定します。 (省略可能)

カスタム プロパティは、Oracle 接続マネージャー エディターには表示されません。 OracleHome プロパティと OracleHome64 プロパティを設定するには:

  1. [接続マネージャー] 領域で、使用している Oracle 接続マネージャーを右クリックし、[プロパティ]選択します。

  2. [プロパティ] ウィンドウで、OracleHome プロパティまたは OracleHome64 プロパティに Oracle ホーム ディレクトリへの完全なパスを設定します。

次のステップ