TRANSLATE (Azure Stream Analytics)

2 番目の引数で指定された一部の文字が 3 番目の引数で指定された対象の文字セットに変換された後に、最初の引数として指定された文字列を返します。

関数の動作は、複数REPLACEのTRANSLATE関数の使用に似ています。

構文

TRANSLATE ( expression, replaced_characters, translations)

Note

TRANSLATE 関数のインデックス/位置は 1 から始まります。

引数

式 (expression)

型 nvarchar(max) の文字式または列です。

replaced_characters

型 nvarchar(max) の文字式または列です。 置き換える文字の一覧が含まれています。

translations

replaced_charactersと同じ長さの文字式または nvarchar(max) 型の列です。 置換文字が含まれています。

戻り値の型

nvarchar(max)

解説

characters 式と translations 式の長さが異なる場合、TRANSLATE はエラーを返します。 TRANSLATE は、いずれかの引数が NULL の場合は NULL を返します。

TRANSLATE 関数の動作は、複数の REPLACE 関数を使用した場合と似ています。 TRANSLATE ただし、inputString 内の個々の文字を複数回置き換えるわけではありません。 characters パラメーターの 1 つの値は、expression 内の複数の文字を置き換えることができます。 これは、複数の REPLACE 関数の動作とは異なります。関数を呼び出すごとに、前回の入れ子になった REPLACE 関数呼び出しによって置き換えられている場合であっても、関連するすべての文字が置き換えられるためです。

例

角かっこと中かっこを通常のかっこで置き換える

SELECT
    x,
    TRANSLATE(x, '[]{}', '()()') AS translatedX
FROM Input

x	translatedX
2*[3+4]/{7-2}	2*(3+4)/(7-2)

GeoJSON ポイントを WKT に変換する

SELECT
    xPoint,
    TRANSLATE(xPoint, '[,]', '( )') xPoint2Coordinates,
    xCoordinates,
    TRANSLATE(xPoint, '[,]', '( )') xCoordinates2Point
FROM Input

xPoint	xPoint2Coordinates	xCoordinates	xCoordinates2Point
(137.4 72.3)	[137.4,72.3]	[137.4,72.3]	(137.4 72.3)

参照

• REPLACE (Azure Stream Analytics)