変換先のカスタム プロパティ
更新 : 2006 年 4 月 14 日
Microsoft SQL Server 2005 Integration Services のオブジェクト モデルでは、データ フロー オブジェクトのコンポーネント、入力、出力、入力列、および出力列の各レベルに、共通プロパティとカスタム プロパティがあります。カスタム プロパティにアクセスできるのは実行時のみで、このプロパティに関する説明は、『Integration Services マネージ プログラミング リファレンス マニュアル』には記載されていません。
ここでは、データ フローの変換先のカスタム プロパティを一覧で示し、それぞれについて説明します。
- データ マイニング モデル トレーニング変換先
- DataReader 変換先
- ディメンション処理変換先
- フラット ファイル変換先
- OLE DB 変換先
- パーティション処理変換先
- 生ファイル変換先
- レコードセット変換先
- SQL Server Compact Edition 変換先
- SQL Server 変換先
データ フロー オブジェクトの大部分との共通プロパティについては、「共通プロパティ」を参照してください。
変換先のプロパティの一部は、このトピックで示すとおり、プロパティ式を使用して設定できます。詳細については、「プロパティ式を使用したデータ フロー オブジェクトのプロパティ値の指定」を参照してください。
データ マイニング モデル トレーニング変換先のカスタム プロパティ
データ マイニング モデル トレーニング変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、データ マイニング モデル トレーニング変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| プロパティ | データ型 | 説明 |
|---|---|---|
ASConnectionId |
String |
接続マネージャの一意識別子。 |
ASConnectionString |
String |
Analysis Services のインスタンスまたは Analysis Services プロジェクトへの接続文字列。 |
ObjectRef |
String |
この変換が使用するデータ マイニング構造を指定する XML タグ。 |
データ マイニング モデル トレーニング変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「データ マイニング モデル トレーニング変換先」を参照してください。
DataReader 変換先のカスタム プロパティ
DataReader 変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、DataReader 変換先のカスタム プロパティを示しています。DataReader を除き、すべてのプロパティは読み取り/書き込み可能です。
| プロパティ名 | データ型 | 説明 |
|---|---|---|
DataReader |
String |
DataReader 変換先のクラス名。 |
FailOnTimeout |
Boolean |
ReadTimeout が発生したときに失敗するかどうかを示します。このプロパティの既定値は False です。 |
ReadTimeout |
Integer |
タイムアウトが発生するまでの時間 (ミリ秒単位)。このプロパティの既定値は 30000 (30 秒) です。 |
DataReader 変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「DataReader 変換先」を参照してください。
ディメンション処理変換先のカスタム プロパティ
ディメンション処理変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、ディメンション処理変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| プロパティ | データ型 | 説明 |
|---|---|---|
ASConnectionString |
String |
Analysis Services のインスタンスまたは Analysis Services プロジェクトへの接続文字列。 |
KeyDuplicate |
Integer (列挙) |
UseDefaultConfiguration が False の場合、重複キー エラーの処理方法を示す値。値には、IgnoreError、ReportAndContinue、および ReportAndStop を使用できます。このプロパティの既定値は IgnoreError です。 |
KeyErrorAction |
Integer (列挙) |
UseDefaultConfiguration が False の場合、キー エラーの処理方法を示す値。値には、ConvertToUnknown および DiscardRecord を使用できます。このプロパティの既定値は ConvertToUnknown です。 |
KeyErrorLimit |
Integer |
UseDefaultConfiguration が False の場合、許可されるキー エラーの上限。 |
KeyErrorLimitAction |
Integer (列挙) |
UseDefaultConfiguration が False の場合、KeyErrorLimit に達したときに行われるアクションを示す値。値には、StopLogging および StopProcessing を使用できます。このプロパティの既定値は StopProcessing です。 |
KeyErrorLogFile |
String |
UseDefaultConfiguration が False の場合の、エラー ログ ファイルのパスおよびファイル名。 |
KeyNotFound |
Integer (列挙) |
UseDefaultConfiguration が False の場合、存在しないキーのエラーの処理方法を示す値。値には、IgnoreError、ReportAndContinue、および ReportAndStop を使用できます。このプロパティの既定値は IgnoreError です。 |
NullKeyConvertedToUnknown |
Integer (列挙) |
UseDefaultConfiguration が False の場合、不明な値に変換された NULL キーの処理方法を示す値。値には、IgnoreError、ReportAndContinue、および ReportAndStop を使用できます。このプロパティの既定値は IgnoreError です。 |
NullKeyNotAllowed |
Integer (列挙) |
UseDefaultConfiguration が False の場合、許容されない NULL の処理方法を示す値。値には、IgnoreError、ReportAndContinue、および ReportAndStop を使用できます。このプロパティの既定値は IgnoreError です。 |
ProcessType |
Integer (列挙) |
変換が使用するディメンション処理の種類。値は、ProcessAdd (増分)、ProcessFull、および ProcessUpdate です。 |
UseDefaultConfiguration |
Boolean |
変換が既定のエラー構成を使用するかどうかを指定する値。このプロパティが False の場合、変換にはエラー処理に関する情報が含まれます。 |
ディメンション処理変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「ディメンション処理変換先」を参照してください。
Excel 変換先のカスタム プロパティ
Excel 変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、Excel 変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
プロパティ名
データ型
説明
AccessMode
Integer (列挙)
変換先が変換先となるデータベースにアクセスする方法を指定する値。使用できるオプションは、OpenRowset、OpenRowset from Variable、OpenRowset Using Fastload、OpenRowset Using Fastload from Variable、および SQL Command です。OpenRowset および OpenRowset Using Fastload には、テーブルまたはビューの名前を指定します。OpenRowset from Variable および OpenRowset Using Fastload from Variable には、テーブルまたはビューの名前が含まれる変数の名前を指定します。SQL Command には SQL ステートメントを指定します。
CommandTimeout
Integer
SQL コマンドがタイムアウトになるまでの最大秒数。この値に 0 を指定すると、時間は無制限になります。このプロパティの既定値は 0 です。
.gif "ms135971.note(ja-jp,SQL.90).gif")
メモ :
このプロパティは、[Excel 変換先エディタ] では使用できませんが、[詳細エディタ] を使用して設定できます。
FastLoadKeepIdentity
Boolean
データが読み込まれるときに ID 値をコピーするかどうかを指定する値。このプロパティは、高速読み取りオプションのいずれかを使用した場合のみ使用できます。このプロパティの既定値は False です。
FastLoadKeepNulls
Boolean
データが読み込まれるときに NULL 値をコピーするかどうかを指定する値。このプロパティは、高速読み取りオプションのいずれかを使用した場合のみ使用できます。このプロパティの既定値は False です。
FastLoadMaxInsertCommitSize
Integer
高速読み込み操作の実行中に、Excel 変換先でコミットを試行するバッチ サイズを指定する値。既定値の 0 は、すべての行が処理された後で、コミット操作が 1 回行われることを示します。
FastLoadOptions
String
高速読み込みオプションのコレクション。高速読み込みオプションには、テーブルのロックおよび制約のチェックが含まれています。どちらか 1 つまたは両方を指定することも、どちらも指定しないこともできます。
メモ :
このプロパティの一部のオプションは、[Excel 変換先エディタ] では使用できませんが、[詳細エディタ] を使用して設定できます。
OpenRowset
String
AccessMode が OpenRowset の場合、Excel 変換先がアクセスするテーブルまたはビューの名前。
OpenRowsetVariable
String
AccessMode が OpenRowset from Variable の場合、Excel 変換先がアクセスするテーブルまたはビューの名前が含まれる変数名。
SqlCommand
String
AccessMode が SQL Command の場合、Excel 変換先がデータの変換先列を指定するときに使用する、Transact-SQL ステートメント。
Excel 変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「Excel 変換先」を参照してください。
フラット ファイル変換先のカスタム プロパティ
フラット ファイル変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、フラット ファイル変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| プロパティ名 | データ型 | 説明 |
|---|---|---|
Header |
String |
データが書き込まれる前にファイルに挿入される、テキストのブロック。 このプロパティの値は、プロパティ式を使用して指定できます。 |
Overwrite |
Boolean |
同じ名前の既存の変換先ファイルに対して、上書きまたは追加のどちらを実行するかを指定する値。このプロパティの既定値は True です。 |
フラット ファイル変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「フラット ファイル変換先」を参照してください。
OLE DB 変換先のカスタム プロパティ
OLE DB 変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、OLE DB 変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| メモ : |
|---|
| ここに一覧で示されている FastLoad オプション (FastLoadKeepIdentity、FastLoadKeepNulls、および FastLoadOptions) は、Microsoft OLE DB Provider for SQL Server (SQLOLEDB) が実装する IRowsetFastLoad インターフェイスによって公開され、同様の名前が付けられたプロパティに対応します。詳細については、MSDN ライブラリで、IRowsetFastLoad を検索してください。 |
プロパティ名
データ型
説明
AccessMode
Integer (列挙)
変換先が変換先となるデータベースにアクセスする方法を指定する値。使用できるオプションは、OpenRowset、OpenRowset from Variable、OpenRowset Using Fastload、OpenRowset Using Fastload from Variable、および SQL Command です。OpenRowset および OpenRowset Using Fastload には、テーブルまたはビューの名前を指定します。OpenRowset from Variable および OpenRowset Using Fastload from Variable には、テーブルまたはビューの名前が含まれる変数の名前を指定します。SQL Command には SQL ステートメントを指定します。
AlwaysUseDefaultCodePage
Boolean
DefaultCodePage プロパティの値を各列に使用するか、または各列のロケールからコードページを派生するかを示す値。このプロパティの既定値は False です。
CommandTimeout
Integer
SQL コマンドがタイムアウトになるまでの最大秒数。この値に 0 を指定すると、時間は無制限になります。このプロパティの既定値は 0 です。
メモ :
このプロパティは、[OLE DB 変換先エディタ] では使用できませんが、[詳細エディタ] を使用して設定できます。
DefaultCodePage
Integer
OLE DB 変換先に関連付けられた既定のコード ページ。
FastLoadKeepIdentity
Boolean
データが読み込まれるときに ID 値をコピーするかどうかを指定する値。このプロパティは、高速読み取りオプションのいずれかを使用した場合のみ使用できます。このプロパティの既定値は False です。このプロパティは、OLE DB IRowsetFastLoad (OLE DB) のプロパティ、SSPROP_FASTLOADKEEPIDENTITY に対応しています。
FastLoadKeepNulls
Boolean
データが読み込まれるときに NULL 値をコピーするかどうかを指定する値。このプロパティは、高速読み取りオプションのいずれかを使用した場合のみ使用できます。このプロパティの既定値は False です。このプロパティは、OLE DB IRowsetFastLoad (OLE DB) のプロパティ、SSPROP_FASTLOADKEEPNULLS に対応しています。
FastLoadMaxInsertCommitSize
Integer
高速読み込み操作の実行中に OLE DB 変換先でコミットを試行するバッチ サイズを指定する値。既定値の 0 は、すべての行が処理された後で、コミット操作が 1 回行われることを示します。
FastLoadOptions
String
高速読み込みオプションのコレクション。高速読み込みオプションには、テーブルのロックおよび制約のチェックが含まれています。どちらか 1 つまたは両方を指定することも、どちらも指定しないこともできます。このプロパティは、OLE DB IRowsetFastLoad のプロパティ、SSPROP_FASTLOADOPTIONS に対応し、CHECK_CONSTRAINTS や TABLOCK などの文字列オプションを指定します。
メモ :
このプロパティの一部のオプションは、[Excel 変換先エディタ] では使用できませんが、[詳細エディタ] を使用して設定できます。
OpenRowset
String
AccessMode が OpenRowset の場合、OLE DB 変換先がアクセスするテーブルまたはビューの名前。
OpenRowsetVariable
String
AccessMode が OpenRowset from Variable の場合、OLE DB 変換先がアクセスするテーブルまたはビューの名前が含まれる変数名。
SqlCommand
String
AccessMode が SQL Command の場合、OLE DB 変換先がデータの変換先列を指定するときに使用する、Transact-SQL ステートメント。
OLE DB 変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「OLE DB 変換先」を参照してください。
パーティション処理変換先のカスタム プロパティ
パーティション処理変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、パーティション処理変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| プロパティ | データ型 | 説明 |
|---|---|---|
ASConnectionString |
String |
Analysis Services プロジェクトまたは Analysis Services インスタンスへの接続文字列 |
KeyDuplicate |
Integer (列挙) |
UseDefaultConfiguration が False の場合、重複キー エラーの処理方法を示す値。値には、IgnoreError、ReportAndContinue、および ReportAndStop を使用できます。このプロパティの既定値は IgnoreError です。 |
KeyErrorAction |
Integer (列挙) |
UseDefaultConfiguration が False の場合、キー エラーの処理方法を示す値。値には、ConvertToUnknown および DiscardRecord を使用できます。このプロパティの既定値は ConvertToUnknown です。 |
KeyErrorLimit |
Integer |
UseDefaultConfiguration が False の場合、許可されるキー エラーの上限。 |
KeyErrorLimitAction |
Integer (列挙) |
UseDefaultConfiguration が False の場合、KeyErrorLimit に達したときに行われるアクションを示す値。値には、StopLogging および StopProcessing を使用できます。このプロパティの既定値は StopProcessing です。 |
KeyErrorLogFile |
String |
UseDefaultConfiguration が False の場合の、エラー ログ ファイルのパスおよびファイル名。 |
KeyNotFound |
Integer (列挙) |
UseDefaultConfiguration が False の場合、存在しないキーのエラーの処理方法を示す値。値には、IgnoreError、ReportAndContinue、および ReportAndStop を使用できます。このプロパティの既定値は ReportAndContinue です。 |
NullKeyConvertedToUnknown |
Integer (列挙) |
UseDefaultConfiguration が False の場合、不明な値に変換された NULL キーの処理方法を示す値。値には、IgnoreError、ReportAndContinue、および ReportAndStop を使用できます。このプロパティの既定値は IgnoreError です。 |
NullKeyNotAllowed |
Integer (列挙) |
UseDefaultConfiguration が False の場合、許容されない NULL の処理方法を示す値。値には、IgnoreError、ReportAndContinue、および ReportAndStop を使用できます。このプロパティの既定値は ReportAndContinue です。 |
ProcessType |
Integer (列挙) |
変換が使用するパーティション処理の種類。値には、ProcessAdd (増分)、ProcessFull、および ProcessUpdate を使用できます。 |
UseDefaultConfiguration |
Boolean |
変換が既定のエラー構成を使用するかどうかを指定する値。このプロパティが False の場合、変換は、この表の一覧で示されている、KeyDuplicate や KeyErrorAction などのエラー処理のカスタム プロパティの値を使用します。 |
パーティション処理変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「パーティション処理変換先」を参照してください。
生ファイル変換先のカスタム プロパティ
生ファイル変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、生ファイル変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| プロパティ名 | データ型 | 説明 |
|---|---|---|
AccessMode |
Integer (列挙) |
FileName プロパティにファイル名を含めるか、またはファイル名が含まれる変数名を含めるかを指定する値。使用できるオプションは、File name および File name from variable です。 |
FileName |
String |
生ファイル変換先が書き込むファイルの名前。 |
WriteOption |
Integer (列挙) |
生ファイル変換先が、同じ名前の既存のファイルを削除するかどうかを指定する値。使用できるオプションは、Create Always、Create Once、Truncate and Append、および Append です。このプロパティの既定値は Create Always です。 |
| メモ : |
|---|
| 追加操作では、追加するデータのメタデータが、ファイル内の既存データのメタデータと一致している必要があります。 |
生ファイル変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「生ファイル変換先」を参照してください。
レコードセット変換先のカスタム プロパティ
レコードセット変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、レコードセット変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| プロパティ名 | データ型 | 説明 |
|---|---|---|
VariableName |
String |
ADO レコードセットが保持する変数の名前。 |
レコードセット変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「レコードセット変換先」を参照してください。
SQL Server Compact Edition 変換先のカスタム プロパティ
SQL Server 2005 Compact Edition 変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、SQL Server 2005 Compact Edition 変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| プロパティ名 | データ型 | 説明 |
|---|---|---|
TableName |
String |
SQL Server 2005 Compact Edition データベース内の変換先テーブルの名前。 このプロパティの値は、プロパティ式を使用して指定できます。 |
SQL Server 2005 Compact Edition 変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「SQL Server Compact Edition 変換先」を参照してください。
SQL Server 変換先のカスタム プロパティ
SQL Server 変換先には、カスタム プロパティと、すべてのデータ フロー コンポーネントとの共通プロパティの両方があります。
次の表は、SQL Server 変換先のカスタム プロパティを示しています。すべてのプロパティは読み取り/書き込み可能です。
| プロパティ名 | データ型 | 説明 |
|---|---|---|
AlwaysUseDefaultCodePage |
Boolean |
DefaultCodePage プロパティ値を強制的に使用します。このプロパティの既定値は False です。 |
BulkInsertCheckConstraints |
Boolean |
一括挿入で制約をチェックするかどうかを指定する値。このプロパティの既定値は True です。 |
BulkInsertFireTriggers |
Boolean |
一括挿入でテーブル上のトリガを起動するかどうかを指定する値。このプロパティの既定値は False です。 |
BulkInsertFirstRow |
Integer |
挿入する最初の行を指定する値。このプロパティの既定値は、-1 です。これは、割り当てられた値がないことを示します。 |
BulkInsertKeepIdentity |
Boolean |
ID 列に値を挿入できるかどうかを指定する値。このプロパティの既定値は False です。 |
BulkInsertKeepNulls |
Boolean |
一括挿入で NULL 値を保持するかどうかを指定する値。このプロパティの既定値は False です。 |
BulkInsertLastRow |
Integer |
挿入する最後の行を指定する値。このプロパティの既定値は、-1 です。これは、割り当てられた値がないことを示します。 |
BulkInsertMaxErrors |
Integer |
一括挿入を停止する前に許容するエラー数を指定する値。このプロパティの既定値は、-1 です。これは、割り当てられた値がないことを示します。 |
BulkInsertOrder |
String |
並べ替え列の名前。各列は、昇順または降順で並べ替えることができます。並べ替え列を複数使用する場合、列の名前はコンマで区切ります。 |
BulkInsertTableName |
String |
データのコピー先となる、データベース内の SQL Server テーブルまたはビュー。 |
BulkInsertTablock |
Boolean |
一括挿入中にテーブルをロックするかどうかを指定する値。このプロパティの既定値は True です。 |
DefaultCodePage |
Integer |
コード ページに関する情報をデータ ソースから取得できない場合に使用するコード ページ。 |
MaxInsertCommitSize |
Integer |
バッチに挿入する行の最大数を示す値。値がゼロのときは、単一のバッチにすべての行が挿入されます。 |
Timeout |
Integer |
挿入できるデータがない場合、終了前に SQL Server 変換先が待機する秒数を指定する値。値を 0 に設定すると、SQL Server 変換先はタイムアウトしません。このプロパティの既定値は 30 です。 |
SQL Server 変換先の入力および入力列には、カスタム プロパティはありません。
詳細については、「SQL Server 変換先」を参照してください。
参照
関連項目
共通プロパティ
変換元のカスタム プロパティ
変換のカスタム プロパティ
パスのプロパティ
概念
プロパティ式を使用したデータ フロー オブジェクトのプロパティ値の指定
その他の技術情報
ヘルプおよび情報
変更履歴
| リリース | 履歴 |
|---|---|
2006 年 4 月 14 日 |
|
2005 年 12 月 5 日 |
|