OData 接続マネージャー
適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム
OData 接続マネージャーを使用して、OData データ ソースに接続します。 OData ソース コンポーネントは OData 接続マネージャーを使用して OData データ ソースに接続し、サービスから取得したデータを使用します。 詳細については、「 OData Source」を参照してください。
SSIS パッケージへの OData 接続マネージャーの追加
次の 3 とおりの方法で、SSIS パッケージに新しい OData 接続マネージャーを追加できます。
[OData ソース エディター] の [新規] ボタンをクリックします。
ソリューション エクスプローラー で [接続マネージャー]を右クリックし、 [新しい接続マネージャー]をクリックします。 [接続マネージャーの種類] の [ODATA]をクリックします。
パッケージ デザイナーの下部にある [接続マネージャー] ペインを右クリックし、[新しい接続] を選択します。 [接続マネージャーの種類] の [ODATA]をクリックします。
注意
Visual Studio および SQL Server Data Tools (SSDT) の国際対応の設定の言語が、SSIS パッケージがデプロイされているターゲット SQL Server インスタンスの既定の言語と合っていることを確認します。
接続マネージャーの認証
OData 接続マネージャーでは、5 つの認証モードがサポートされています。
Windows 認証
基本認証 (ユーザー名とパスワードを使用)
Microsoft Dynamics AX Online (ユーザー名とパスワードを使用)
Microsoft Dynamics CRM Online (ユーザー名とパスワードを使用)
Microsoft Online Services (ユーザー名とパスワードを使用)
匿名アクセスを使用するには、[Windows 認証] オプションを選択します。
Microsoft Dynamics AX Online または Microsoft Dynamics CRM Online に接続する場合、[Microsoft Online Services] 認証オプションを使用することはできません。 また、多要素認証に構成されているオプションを使用することもできません。 現時点では、先進認証はサポートされていません。
資格情報の指定とセキュリティ保護
OData サービスで基本認証が必要とされる場合は、 OData Connection Manager Editorでユーザー名とパスワードを指定できます。 エディターに入力した値は、パッケージ内に保存されます。 パスワードの値は、パッケージの保護レベルに応じて暗号化されます。
ユーザー名とパスワードの値をパラメーター化またはパッケージ外に保存する方法はいくつかあります。 たとえば、パラメーターを使用するか、SQL Server Management Studio からパッケージを実行するときに接続マネージャーのプロパティを直接設定できます。
OData 接続マネージャーのプロパティ
次の一覧で、OData 接続マネージャーのプロパティについて説明します。
プロパティ | 既定値 | 説明 |
---|---|---|
キープ アライブ | False | Web 要求を送信するときの "Keep-Alive" ヘッダーの値。 |
最大受信メッセージ サイズ | 4TB | Web 要求を送信するときの最大受信メッセージ サイズ (バイト単位)。 |
再試行の回数 | 5 | Web 要求を送信するときの再試行回数。 |
再試行のスリープ | 100 | Web 要求を送信するときの再試行のためのスリープ時間 (ミリ秒単位)。 |
タイムアウト | 600 | Web 要求を送信するときのタイムアウト (秒単位)。 |
url | サービス ドキュメントに対応する URL。 | |
UserName | 認証に使用するユーザー名 (必要な場合)。 | |
パスワード | 認証に使用するパスワード (必要な場合)。 | |
ConnectionString | 接続マネージャーの他のプロパティが含まれます。 |
[OData 接続マネージャー エディター]
[OData 接続マネージャー エディター] ダイアログ ボックスを使用して、OData データ ソースへの接続を追加するか、既存の接続を編集します。
オプション
接続マネージャー名
接続マネージャーの名前です。
サービス ドキュメントの場所
OData サービスに対応する URL。 たとえば、 https://services.odata.org/V3/Northwind/Northwind.svc/と指定します。
認証
以下のオプションの 1 つを選択します。
- Windows 認証 匿名アクセスの場合は、このオプションを選択します。
- 基本認証
- Microsoft Dynamics AX Online (Dynamics AX Online の場合)
- Microsoft Dynamics CRM Online (Dynamics CRM Online の場合)
- Microsoft Online Services (Microsoft Online Services の場合)
Windows 認証以外のオプションを選択する場合は、ユーザー名とパスワードを入力します。
Microsoft Dynamics AX Online または Microsoft Dynamics CRM Online に接続する場合、[Microsoft Online Services] 認証オプションを使用することはできません。 また、多要素認証に構成されているオプションを使用することもできません。
[接続テスト]
OData ソースへの接続をテストするには、このボタンをクリックします。