ログイン転送タスク
適用対象: 
SQL Server Azure Data Factory の SSIS 統合ランタイム
ログイン転送タスクは、 SQL Serverのインスタンス間で 1 つ以上のログインを転送します。
SQL Server のインスタンス間でのログインの転送
ログイン転送タスクでは、転送元または転送先として、 SQL Server をサポートします。
events
ログイン転送タスクでは、転送されたログインの数を報告する情報イベントと、ログインが上書きされた場合の警告イベントが発生します。
ログインの転送の進捗状況は報告されません。0% または 100% 完了した場合のみ報告されます。
実行値
タスクの ExecutionValue プロパティで定義する実行値は、転送されたログインの数を返します。 ログイン転送タスクの ExecValueVariable プロパティにユーザー定義変数を割り当てると、パッケージの他のオブジェクトからログインの転送に関する情報を使用できるようになります。 詳細については、「Integration Services (SSIS) Variables」(Integration Services (SSIS) の変数) と「Use Variables in Packages」(パッケージで変数を使用する) を参照してください。
ログ エントリ
ログイン転送タスクには、次のようなカスタム ログ エントリがあります。
TransferLoginsTaskStarTransferringObjects 転送が開始されたことを報告するログ エントリです。 ログ エントリには、開始時刻が含まれます。
TransferLoginsTaskFinishedTransferringObjects 転送が完了したことを報告するログ エントリです。 ログ エントリには、終了時刻が含まれます。
また、 OnInformation イベントのログ エントリは転送されたログインの数を報告し、 OnWarning イベントのログ エントリは転送先でログインが上書きされると書き込まれます。
セキュリティとアクセス許可
転送元サーバーのログインを参照し、転送先サーバーにログインを作成するユーザーは、両方のサーバーのサーバー ロール sysadmin のメンバーでなければなりません。
ログイン転送タスクの構成
ログイン転送タスクは、すべてのログイン、指定したログインのみ、または指定したデータベースにアクセスしたすべてのログインを転送するように構成できます。 sa ログインは転送できません。 sa ログインの名前は変更できますが、名前を変更した sa ログインを転送することはできません。
また、ログインに関連付けられているセキュリティ識別子 (SID) をコピーするかどうかも指定できます。 ログイン転送タスクをデータベース転送タスクと共に使用する場合、SID を転送先にコピーする必要があります。コピーしない場合、転送したログインが転送先データベースで認識されません。
転送先では、転送されたログインは無効にされ、ランダムなパスワードが割り当てられます。 ログインを使用する前に、転送先サーバーの sysadmin ロールのメンバーがパスワードを変更して、ログインを有効にする必要があります。
転送するログインが既に転送先に存在している場合もあります。 ログイン転送タスクでは、既存のログインの処理を次のように構成できます。
既存のログインを上書きします。
重複するログインが存在する場合、タスクを失敗とします。
重複するログインをスキップします。
ログイン転送タスクは実行時に、2 つの SMO 接続マネージャーを使用して、転送元および転送先サーバーに接続します。 SMO 接続マネージャーの構成はログイン転送タスクとは別に行い、ログイン転送タスクは SMO 接続マネージャーを参照します。 SMO 接続マネージャーは、サーバーと、サーバーに接続する際に使用する認証モードを指定します。 詳細については、「 SMO 接続マネージャー」をご覧ください。
プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。
SSIS デザイナーで設定できるプロパティの詳細については、次のトピックを参照してください。
SSIS デザイナーでこれらのプロパティを設定する方法については、次のトピックを参照してください。
プログラムによるログイン転送タスクの構成
プログラムによってこれらのプロパティを設定する方法の詳細については、次のトピックを参照してください。
[ログイン転送タスク エディター] ([全般] ページ)
[ログイン転送タスク エディター] ダイアログ ボックスの [全般] ページを使用すると、ログイン転送タスクの名前と説明を入力します。
オプション
Name
ログイン転送タスクの一意の名前を入力します。 この名前は、タスク アイコンのラベルとして使用されます。
Note
タスク名はパッケージ内で一意である必要があります。
説明
ログイン転送タスクの説明を入力します。
[ログイン転送タスク エディター] ([ログイン] ページ)
[ログイン転送タスク エディター] ダイアログ ボックスの [ログイン] ページを使用すると、 SQL Server のインスタンスから別のインスタンスへと SQL Server ログインをコピーする際のプロパティを指定できます。
重要
ログイン転送タスクを実行すると、転送先のサーバー上でランダムなパスワードを使用してログインが作成され、パスワードが無効になります。 このログインを使用するには、 sysadmin 固定サーバー ロールのメンバーでパスワードを変更し、そのパスワードを有効にする必要があります。 sa ログインは転送できません。
オプション
SourceConnection
SMO 接続マネージャーを一覧から選択するか、<[新しい接続]> をクリックしてコピー元のサーバーへの新しい接続を作成します。
DestinationConnection
SMO 接続マネージャーを一覧から選択するか、<[新しい接続]> をクリックしてコピー先のサーバーへの新しい接続を作成します。
[LoginsToTransfer]
転送元サーバーから転送先サーバーにコピーされる SQL Server ログインを選択します。 このプロパティには、次の表に示すオプションがあります。
| 値 | 説明 |
|---|---|
| [AllLogins] | 転送元サーバーのすべての SQL Server ログインが転送先サーバーにコピーされます。 |
| [SelectedLogins] | [LoginsList] に指定されているログインのみが転送先サーバーにコピーされます。 |
| [AllLoginsFromSelectedDatabases] | [DatabasesList] で指定されているデータベース内のすべてのログインが転送先サーバーにコピーされます。 |
[LoginsList]
転送先サーバーにコピーする、転送元サーバーのログインを選択します。 このオプションは、 [LoginsToTransfer] を [SelectedLogins] に設定した場合のみ使用できます。
[DatabasesList]
転送先サーバーにコピーするログインが含まれる、転送元サーバー上のデータベースを選択します。 このオプションは、 [LoginsToTransfer] を [AllLoginsFromSelectedDatabases] に設定した場合のみ使用できます。
[IfObjectExists]
転送先サーバーに同じ名前のログインが既に存在していた場合の処理方法を選択します。
このプロパティには、次の表に示すオプションがあります。
| 値 | 説明 |
|---|---|
| [FailTask] | 転送先サーバーに同じ名前のログインが既に存在していた場合、タスクが失敗します。 |
| Overwrite | 転送先サーバーにある同じ名前のログインは上書きされます。 |
| Skip | 転送先サーバーにある同じ名前のログインはスキップされます。 |
[CopySids]
ログインに関連付けられたセキュリティ識別子を転送先サーバーにコピーするかどうかを選択します。 ログイン転送タスクをデータベース転送タスクと同時に使用する場合、 [CopySids] を [True] に設定する必要があります。 そのように設定しなかった場合、コピーされたログインは転送されたデータベースで認識されなくなります。