データ フロー コンポーネントのプロパティを設定する
適用対象: 
SQL Server Azure Data Factory の SSIS Integration Runtime
変換元、変換先、変換などを含むデータ フロー コンポーネントのプロパティを設定するには、次の機能のいずれかを使用します。
Integration Services が提供するコンポーネント エディター。 これらのエディターには、各データ フロー コンポーネントのカスタム プロパティのみ含まれます。
[プロパティ] ウィンドウでは、各要素のコンポーネントレベルのカスタム プロパティ、およびすべてのデータ フロー要素との共通プロパティの一覧が表示されます。
[詳細エディター] ダイアログ ボックスでは、各コンポーネントのカスタム プロパティにアクセスできます。 また、 [詳細エディター] ダイアログ ボックスを使用すると、すべてのデータ フロー コンポーネントの共通プロパティである、入力、出力、エラー出力、列、および外部列のプロパティにもアクセスできます。
コンポーネント エディターを使用してデータ フロー コンポーネントのプロパティを設定する
SQL Server Data Tools (SSDT)で、目的のパッケージが含まれている Integration Services プロジェクトを開きます。
ソリューション エクスプローラーで、パッケージをダブルクリックして開きます。
[制御フロー] タブをクリックし、プロパティを表示して変更するコンポーネントのあるデータ フローが含まれる、データ フロー タスクをダブルクリックします。
データ フロー コンポーネントをダブルクリックします。
コンポーネント エディターで、プロパティ値を表示または変更し、エディターを閉じます。
更新されたパッケージを保存するには、 [ファイル] メニューの [選択されたファイルを上書き保存] をクリックします。
[プロパティ] ウィンドウでデータ フロー コンポーネントのプロパティを設定する
SQL Server Data Tools (SSDT)で、目的のパッケージが含まれている Integration Services プロジェクトを開きます。
ソリューション エクスプローラーで、パッケージをダブルクリックして開きます。
[制御フロー] タブをクリックし、プロパティを表示して変更するコンポーネントが含まれているデータ フロー タスクをダブルクリックします。
データ フロー コンポーネントを右クリックし、 [プロパティ]をクリックします。
プロパティ値を表示または変更し、 [プロパティ] ウィンドウを閉じます。
注意
プロパティの多くは読み取り専用であり、変更できません。
更新されたパッケージを保存するには、 [ファイル] メニューの [選択されたファイルを上書き保存] をクリックします。
詳細エディターを使用してデータ フロー コンポーネントのプロパティを設定する
SQL Server Data Tools (SSDT)で、目的のパッケージが含まれている Integration Services プロジェクトを開きます。
ソリューション エクスプローラーで、パッケージをダブルクリックして開きます。
[制御フロー] タブをクリックし、表示または変更するコンポーネントが含まれているデータ フロー タスクをダブルクリックします。
データ フロー デザイナーで、データ フロー コンポーネントを右クリックし、 [詳細エディターの表示]をクリックします。
注意
SQL Serverでは、複数の入力をサポートするデータ フロー コンポーネントで [詳細エディター]を使用できません。
[詳細エディター] ダイアログ ボックスで、次のいずれかの手順を実行します。
コンポーネントで使用する接続を表示および指定するには、 [接続マネージャー] タブをクリックします。
注意
[接続マネージャー] タブは、接続マネージャーを使用してファイルやデータベースなどのデータ ソースに接続するデータ フロー コンポーネントのみで使用できます。
コンポーネント レベルのプロパティを表示および変更するには、 [コンポーネントのプロパティ] タブをクリックします。
外部列と使用できる出力との間のマッピングを表示および変更するには、 [列マッピング] タブをクリックします。
注意
[列マッピング] タブは、変換元または変換先を表示または編集するときにのみ使用できます。
使用できる入力列の一覧を表示して、出力列の名前を更新するには、 [入力列] タブをクリックします。
注意
[入力列] タブは、変換または変換先を使用した作業でのみ使用できます。 詳しくは、「 Integration Services の変換」をご覧ください。
入力、出力、およびエラー出力のプロパティや、列自体のプロパティを表示および変更するには、 [入力プロパティと出力プロパティ] タブをクリックします。
注意
変換元には入力はありません。 変換先には出力はありません。ただし、オプションのエラー出力がある場合があります。
プロパティ値を表示または変更します。
[OK] をクリックします。
更新されたパッケージを保存するには、 [ファイル] メニューの [選択されたファイルを上書き保存] をクリックします。
データ フロー コンポーネントの共通プロパティ
Microsoft SQL Server Integration Services のオブジェクト モデルでは、データ フロー オブジェクトのコンポーネント、入力、出力、入力列、および出力列の各レベルに、共通プロパティとカスタム プロパティがあります。 多くのプロパティの値は読み取り専用で、実行時にデータ フロー エンジンによって割り当てられます。
ここでは、データ フロー オブジェクトの共通プロパティを一覧で示し、それぞれについて説明します。
Component properties
Integration Services のオブジェクト モデルでは、データ フロー内のコンポーネントに IDTSComponentMetaData100 インターフェイスを実装します。
次の表は、データ フロー内のコンポーネントのプロパティを示しています。 一部のプロパティの値は読み取り専用で、実行時にデータ フロー エンジンによって割り当てられます。
| プロパティ | データ型 | 説明 |
|---|---|---|
| ComponentClassID | String | コンポーネントの CLSID。 |
| ContactInfo | String | コンポーネント開発者の連絡先情報。 |
| 説明 | String | データ フロー コンポーネントの説明。 このプロパティの既定値は、データ フロー コンポーネントの名前です。 |
| id | Integer | コンポーネントのこのインスタンスを一意に識別する値。 |
| [IdentificationString] | String | コンポーネントを識別します。 |
| IsDefaultLocale | ブール型 | コンポーネントが、それ自体が属するデータ フロー タスクのロケールを使用するかどうかを示します。 |
| LocaleID | Integer | パッケージを実行する際、データ フロー コンポーネントが使用するロケール。 データ フロー コンポーネントでは、すべての Windows ロケールが使用できます。 |
| 名前 | String | データ フロー コンポーネントの名前。 |
| PipelineVersion | Integer | コンポーネントを実行するように設計されたデータ フロー タスクのバージョン。 |
| UsesDispositions | ブール型 | コンポーネントにエラー出力があるかどうかを示します。 |
| [ValidateExternalMetadata] | Boolean | 外部列のメタデータを検証するかどうかを示します。 このプロパティの既定値は Trueです。 |
| Version | Integer | コンポーネントのバージョン。 |
入力プロパティ
Integration Services のオブジェクト モデルでは、変換および変換先には入力があります。 データ フロー内のコンポーネントの入力は、IDTSInput100 インターフェイスを実装します。
次の表は、データ フロー内のコンポーネントの入力のプロパティを示しています。 一部のプロパティの値は読み取り専用で、実行時にデータ フロー エンジンによって割り当てられます。
| プロパティ | データ型 | 説明 |
|---|---|---|
| 説明 | String | 入力の説明。 |
| ErrorOrTruncationOperation | String | 行の処理中にエラーや切り捨てが発生する可能性がある場合、その種類を指定するオプションの文字列。 |
| ErrorRowDisposition | DTSRowDisposition | エラーの処理方法を指定する値。 値は Fail component、 Ignore failure、 Redirect row |
| HasSideEffects | ブール型 | コンポーネントが下流コンポーネントにアタッチされていない場合や、 RunInOptimizedMode が trueの場合に、データ フローの実行プランからコンポーネントを削除できるかどうかを示します。 |
| id | Integer | 入力を一意に識別する値。 |
| [IdentificationString] | String | 入力を識別する文字列。 |
| IsSorted | ブール型 | 入力のデータを並べ替えるかどうかを示します。 |
| 名前 | String | 入力の名前。 |
| SourceLocale | Integer | 入力データのロケール ID (LCID)。 |
| TruncationRowDisposition | DTSRowDisposition | 行の処理中に発生した切り捨てを処理する方法を指定する値。 。 値は Fail component、 Ignore failure、 Redirect row |
変換先および一部の変換では、エラー出力がサポートされず、これらのコンポーネントの ErrorRowDisposition プロパティおよび TruncationRowDisposition プロパティは読み取り専用です。
入力列プロパティ
Integration Services のオブジェクト モデルでは、入力には入力列のコレクションが含まれています。 データ フロー内のコンポーネントの入力列は、IDTSInputColumn100 インターフェイスを実装します。
次の表は、データ フロー内のコンポーネントの入力列のプロパティを示しています。 一部のプロパティの値は読み取り専用で、実行時にデータ フロー エンジンによって割り当てられます。
| プロパティ | データ型 | 説明 |
|---|---|---|
| ComparisonFlags | Integer | 文字データ型を持つ列の比較を示すフラグの組。 詳しくは、「 Comparing String Data」をご覧ください。 |
| 説明 | String | 入力列を説明します。 |
| ErrorOrTruncationOperation | String | 行の処理中にエラーや切り捨てが発生する可能性がある場合、その種類を指定するオプションの文字列。 |
| ErrorRowDisposition | DTSRowDisposition | エラーの処理方法を指定する値。 値は Fail component、 Ignore failure、 Redirect row |
| ExternalMetadataColumnID | IDTSExternalMetadataColumn100 | 出力列に割り当てられた外部メタデータ列の ID。 |
| id | Integer | 入力列を一意に識別する値。 |
| [IdentificationString] | String | 入力列を識別する文字列。 |
| LineageID | Integer | 上流列の ID。 |
| LineageIdentificationString | String | 上流列の名前を含む識別文字列。 |
| 名前 | String | 入力列の名前。 |
| SortKeyPosition | Integer | 列を並べ替えるかどうか、並べ替える場合はその並べ替え順、および複数の列の並べ替えの順序を示す値。 値 0 は、その列が並べ替えられないことを示します。 詳細については、「 マージ変換およびマージ結合変換用にデータを並べ替える」を参照してください。 |
| TruncationRowDisposition | DTSRowDisposition | 行の処理中に発生した切り捨てを処理する方法を指定する値。 値は Fail component、 Ignore failure、 Redirect row |
| UpstreamComponentName | String | 上流コンポーネントの名前。 |
| UsageType | DTSUsageType | コンポーネントが入力列を使用する方法を指定する値。 |
入力列には、後の「データ型プロパティ」で説明するデータ型プロパティもあります。
出力プロパティ
Integration Services のオブジェクト モデルでは、変換元および変換には出力があります。 データ フロー内のコンポーネントの出力は、IDTSOutput100 インターフェイスを実装します。
次の表は、データ フロー内のコンポーネントの出力のプロパティを示しています。 一部のプロパティの値は読み取り専用で、実行時にデータ フロー エンジンによって割り当てられます。
| プロパティ | データ型 | 説明 |
|---|---|---|
| DeleteOutputOnPathDetached | ブール型 | 出力がパスに接続されていない場合に、データ フロー エンジンが出力を削除するかどうかを指定する値。 |
| 説明 | String | 出力を説明します。 |
| ErrorOrTruncationOperation | String | 行の処理中にエラーや切り捨てが発生する可能性がある場合、その種類を指定するオプションの文字列。 |
| ErrorRowDisposition | DTSRowDisposition | エラーの処理方法を指定する値。 値は Fail component、 Ignore failure、 Redirect row |
| ExclusionGroup | Integer | 相互排他的な出力のグループを識別する値。 |
| HasSideEffects | ブール型 | コンポーネントが上流コンポーネントにアタッチされていない場合や、 RunInOptimizedMode が trueの場合に、データ フローの実行プランからコンポーネントを削除できるかどうかを示します。 |
| id | Integer | 出力を一意に識別する値。 |
| [IdentificationString] | String | 出力を識別する文字列。 |
| IsErrorOut | ブール型 | 出力がエラー出力かどうかを示します。 |
| IsSorted | ブール型 | 出力を並べ替えるかどうかを示します。 既定値は Falseです。 ** 重要 **IsSorted プロパティの値を True に設定しても、データは並べ替えられません。 このプロパティでは、データが既に並べ替えられている下流コンポーネントにヒントのみを提供します。 詳細については、「 マージ変換およびマージ結合変換用にデータを並べ替える」を参照してください。 |
| 名前 | String | 出力の名前。 |
| SynchronousInputID | Integer | 出力に同期する入力の ID。 |
| TruncationRowDisposition | DTSRowDisposition | 行の処理中に発生した切り捨てを処理する方法を指定する値。 値は Fail component、 Ignore failure、 Redirect row |
出力列プロパティ
Integration Services のオブジェクト モデルでは、出力に出力列のコレクションが含まれています。 データ フロー内のコンポーネントの出力列は、IDTSOutputColumn100 インターフェイスを実装します。
次の表は、データ フロー内のコンポーネントの出力列のプロパティを示しています。 一部のプロパティの値は読み取り専用で、実行時にデータ フロー エンジンによって割り当てられます。
| プロパティ | データ型 | 説明 |
|---|---|---|
| ComparisonFlags | Integer | 文字データ型を持つ列の比較を示すフラグの組。 詳しくは、「 Comparing String Data」をご覧ください。 |
| 説明 | String | 出力列を説明します。 |
| ErrorOrTruncationOperation | String | 行の処理中にエラーや切り捨てが発生する可能性がある場合、その種類を指定するオプションの文字列。 |
| ErrorRowDisposition | DTSRowDisposition | エラーの処理方法を指定する値。 値は Fail component、 Ignore failure、 Redirect row 既定値は Fail componentです。 |
| ExternalMetadataColumnID | Integer | 出力列に割り当てられた外部メタデータ列の ID。 |
| id | Integer | 出力列を一意に識別する値。 |
| [IdentificationString] | String | 出力列を識別する文字列。 |
| LineageID | Integer | 出力列の ID。 下流コンポーネントは、この値を使用して列を参照します。 |
| LineageIdentificationString | String | 列の名前を含む識別文字列。 |
| 名前 | String | 出力列の名前。 |
| SortKeyPosition | Integer | 列を並べ替えるかどうか、並べ替える場合はその並べ替え順、および複数の列の並べ替えの順序を示す値。 値 0 は、その列が並べ替えられないことを示します。 詳細については、「 マージ変換およびマージ結合変換用にデータを並べ替える」を参照してください。 |
| SpecialFlags | Integer | 出力列の特殊なフラグを含む値。 |
| TruncationRowDisposition | DTSRowDisposition | 行の処理中に発生した切り捨てを処理する方法を指定する値。 値は Fail component、 Ignore failure、 Redirect row 既定値は Fail componentです。 |
出力列には、データ型プロパティの組も含まれています。
外部メタデータ列のプロパティ
Integration Services のオブジェクト モデルでは、入力および出力に外部メタデータ列のコレクションを含めることができます。 データ フロー内のコンポーネントの外部メタデータ列は、IDTSExternalMetadataColumn100 インターフェイスを実装します。
次の表は、データ フロー内のコンポーネントの外部メタデータ列のプロパティを示しています。 一部のプロパティの値は読み取り専用で、実行時にデータ フロー エンジンによって割り当てられます。
| プロパティ | データ型 | 説明 |
|---|---|---|
| 説明 | String | 外部列を説明します。 |
| id | Integer | 列を一意に識別する値。 |
| [IdentificationString] | String | 列を識別する文字列。 |
| 名前 | String | 外部列の名前。 |
外部メタデータ列には、データ型プロパティの組も含まれています。
データ型プロパティ
出力列および外部メタデータ列には、データ型プロパティの組が含まれています。 列のデータ型に応じて、プロパティは読み取り/書き込み可能または読み取り専用の場合があります。
次の表は、出力列および外部メタデータ列のデータ型プロパティを示しています。
| プロパティ | データ型 | 説明 |
|---|---|---|
| CodePage | Integer | Unicode でない文字列データのコード ページを指定します。 |
| DataType | Integer (列挙) | 列の Integration Services データ型。 詳細については、「 Integration Services Data Types」を参照してください。 |
| 長さ | Integer | 列の長さ (文字数単位)。 |
| 有効桁数 | Integer | 数値列の有効桁数。 |
| スケール | Integer | 数値列の小数点以下桁数。 |
データ フロー コンポーネントのカスタム プロパティ
カスタム プロパティの詳細については、次のトピックを参照してください。
OLE DB のカスタム プロパティ OLE DB のカスタム プロパティ
データ フロー コンポーネントで式を使用する
この手順では、条件分割変換または派生列変換に式を追加する方法について説明します。 条件分割変換では、式を使用して、変換出力にデータ行を出力する条件を定義します。また、派生列変換では、式を使用して、列に割り当てる値を定義します。
変換に式を実装するには、あらかじめパッケージに少なくとも 1 つのデータ フロー タスクとソースが含まれている必要があります。
SQL Server Data Tools (SSDT)で、目的のパッケージが含まれている Integration Services プロジェクトを開きます。
ソリューション エクスプローラーで、パッケージをダブルクリックして開きます。
SSIS デザイナーの [制御フロー] タブをクリックし、式を実装するデータ フローを含むデータ フロー タスクをクリックします。
[データ フロー] タブをクリックし、 [ツールボックス] からデザイン画面に条件分割変換または派生列変換のいずれかをドラッグします。
緑色のコネクタをソースまたは変換から条件分割変換または派生列変換にドラッグします。
変換をダブルクリックして、変換のダイアログ ボックスを開きます。
左側のペインで [変数] を展開し、システム変数およびユーザー定義変数を表示します。また、 [列] を展開して、変換の入力列を表示します。
右側のペインで [数学関数]、 [文字列関数]、 [日付/時刻関数]、 [NULL 関数]、 [型キャスト]、および [演算子] を展開して、式の文法で用意されている関数、キャスト、および演算子にアクセスします。
変換に応じて、次のいずれかの操作を実行し、式を作成します。
[条件分割変換エディター] ダイアログ ボックスで、変数、列、関数、演算子、およびキャストを [条件] 列にドラッグします。 ドラッグする代わりに、 [条件] 列に式を直接入力することもできます。
[派生列変換エディター] ダイアログ ボックスで、変数、列、関数、演算子、およびキャストを [式] 列にドラッグします。 ドラッグする代わりに、 [式] 列に式を直接入力することもできます。
注意
[条件] 列または [式] 列からフォーカスを外したときに、式テキストが強調表示された場合、式の文法が間違っていることを示します。
[OK] をクリックして、ダイアログ ボックスを終了します。
注意
式が有効でない場合、式に文法エラーがあることを示す警告が表示されます。
式で設定できるデータ フロー プロパティ
データ フロー タスク コンテナーで使用できるプロパティ式を使用して、データ フロー オブジェクトの特定のプロパティの値を指定できます。
プロパティ式の使用の詳細については、「 パッケージでプロパティ式を使用する」を参照してください。
プロパティ式を使用して、パッケージを配置するインスタンスごとに構成をカスタマイズできます。 また、コマンド プロンプト ユーティリティ dtexec に /set オプションを付けて使用すると、プロパティ式を使用してパッケージの実行時制約を指定することもできます。 たとえば、並べ替え変換で使用される MaximumThreads 、または、あいまいグループ化変換およびあいまい参照変換の MaxMemoryUsage を制約できます。 制約を行わないと、これらの変換により大容量のデータがメモリ内にキャッシュされる場合があります。
このトピックに示すデータ フロー オブジェクトのプロパティの 1 つに対するプロパティ式を指定するには、デザイナーの [制御フロー] 画面でデータ フロー タスクを選択するか、コンポーネントやパスを個別に選択せずにデザイナーの [データ フロー] タブを選択して、データ フロー タスクの [プロパティ] ウィンドウを表示します。 [式] プロパティを選択し、省略記号 (...) をクリックして、 [プロパティ式エディター] ダイアログ ボックスを表示します。 [プロパティ] の一覧からプロパティを選択し、 [式] テキスト ボックスに式を入力するか、省略記号 (...) をクリックして [式ビルダー] ダイアログ ボックスを表示します。
[プロパティ] の一覧には、現在、デザイナーの [データ フロー] 画面に配置されているデータ フロー オブジェクトで使用できるプロパティのみが表示されます。 したがって、 [プロパティ] の一覧では、プロパティ式をサポートするデータ フロー オブジェクトのすべてのプロパティを表示することはできません。 たとえば、デザイナー画面に ADO NET ソースを配置した場合、 [プロパティ] の一覧には [ADO NET Source].[SqlCommand] プロパティのエントリが表示されます。 この一覧には、データ フロー タスク自体の多数のプロパティも表示されます。
次の一覧にあるプロパティの値は、プロパティ式を使用して指定できます。
データ フローの変換元
| データ フロー オブジェクト | プロパティ |
|---|---|
| ADO NET ソース | TableOrViewName プロパティ SqlCommand プロパティ |
| XML ソース | XMLData プロパティ XMLSchemaDefinition プロパティ |
データ フローの変換
これらのカスタム プロパティの詳細については、「 変換のカスタム プロパティ」を参照してください。
| データ フロー オブジェクト | プロパティ |
|---|---|
| 条件分割変換 | FriendlyExpression プロパティ |
| 派生列変換 | FriendlyExpression プロパティ |
| あいまいグループ化変換 | MaxMemoryUsage プロパティ |
| あいまい参照変換 | MaxMemoryUsage プロパティ |
| 参照変換 | SqlCommand プロパティ SqlCommandParam プロパティ |
| OLE DB コマンド変換 | SqlCommand プロパティ |
| 比率サンプリング変換 | SamplingValue プロパティ |
| ピボット変換 | PivotKeyValue プロパティ |
| 行サンプリング変換 | SamplingValue プロパティ |
| 並べ替え変換 | MaximumThreads プロパティ |
| ピボット解除変換 | PivotKeyValue プロパティ |
データ フローの変換先
| データ フロー オブジェクト | プロパティ |
|---|---|
| ADO NET 変換先 | TableOrViewName プロパティ BatchSize プロパティ CommandTimeOut プロパティ |
| フラット ファイル変換先 | Header プロパティ |
| SQL Server Compact 変換先 | TableName プロパティ |
| SQL Server 変換先 | BulkInsertTableName プロパティ BulkInsertFirstRow プロパティ BulkInsertLastRow プロパティ BulkInsertOrder プロパティ Timeout プロパティ |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示