REPLACE (SSIS)
式に含まれている文字列を別の文字列または空の文字列で置き換えた文字式を返します。
注意 |
---|
REPLACE 関数では長い文字列が使用される場合が多いため、式の長さに対する 4,000 文字の制限が発生する可能性が高くなります。式の評価結果が Integration Services データ型の DT_WSTR または DT_STR である場合、式は 4,000 文字に切り捨てられます。サブ式の結果のデータ型が DT_STR または DT_WSTR である場合、式全体の結果のデータ型に関係なく、そのサブ式も同様に 4,000 文字に切り捨てられます。切り捨ての結果を効率よく処理できる場合もあれば、結果により警告またはエラーが発生する場合もあります。詳細については、「構文 (SSIS)」を参照してください。 |
構文
REPLACE(character_expression,searchstring,replacementstring)
引数
character_expression
検索対象となる有効な文字式です。searchstring
関数により検索される有効な文字式です。replacementstring
置換後の式となる有効な文字式です。
戻り値の型
DT_WSTR
説明
searchstring の長さは 0 にできません。
replacementstring の長さは 0 にできます。
searchstring および replacementstring 引数には、変数および列を使用できます。
REPLACE は、DT_WSTR データ型でのみ機能します。character_expression1, character_expression2, および character_expression3 引数が DT_STR データ型の文字列リテラルまたはデータ列である場合は、REPLACE による演算の実行前に、暗黙的に DT_WSTR データ型にキャストされます。その他のデータ型は、明示的に DT_WSTR データ型にキャストされる必要があります。詳細については、「キャスト (SSIS)」を参照してください。
いずれかの引数が NULL の場合、REPLACE は NULL を返します。
例
この例では、文字列リテラルを使用します。返される結果は "All Terrain Bike" です。
REPLACE("Mountain Bike", "Mountain","All Terrain")
この例では、Product 列から文字列 "Bike" を削除します。
REPLACE(Product, "Bike","")
この例では、DaysToManufacture 列の値を置換します。DaysToManufacture 列は整数データ型で、式の内部で DT_WSTR データ型にキャストされます。
REPLACE((DT_WSTR,8)DaysToManufacture,"6","5")