IoT Platform:文字列関数

構文

STRING CHR(BIGINT ascii)

説明

指定された ASCII コードを対応する文字に変換します。

パラメーター

ascii: BIGINT 型の値で、ASCII コードを示します。有効値の範囲：0 ～ 255。入力値がこの範囲外の場合、例外が返されます。入力値が STRING、DOUBLE、または DECIMAL 型の場合、計算前に暗黙的に BIGINT 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

構文

STRING CONCAT(STRING a, STRING b...)

説明

指定されたすべての文字列を連結し、最終的な文字列を返します。

パラメーター

すべてのパラメーターの値は STRING 型です。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

戻り値の型

STRING 型の値が返されます。入力パラメーターがない場合、または入力パラメーターが NULL の場合、NULL が返されます。

例

CONCAT('ab','c') = 'abc'
CONCAT() = NULL
CONCAT('a', null, 'b') = NULL

構文

STRING GET_JSON_OBJECT(STRING json,STRING path)

説明

path に基づいて、標準 JSON 文字列から指定された文字列を抽出します。この関数が呼び出されるたびに元のデータが読み取られます。そのため、繰り返し呼び出すとシステムリソースが浪費され、コストが増加する可能性があります。繰り返し呼び出しを防ぐには、ユーザー定義のテーブル値関数（UDTF）と共に GET_JSON_OBJECT 関数を呼び出して、JSON ログデータを変換します。

パラメーター

• json: 標準 JSON 形式の文字列。

• path: ドル記号（$）で始まる文字列で、JSON 文字列内の JSON オブジェクトのパスを記述します。path の詳細については、LanguageManual UDF を参照してください。

  • $: ルートノードを示します。

  • .: 子ノードを示します。

  • []: [number] は配列の添字を示します。配列は key[sub1][sub2][sub3]…… の形式で表されます。

  • *: [] のワイルドカードを示します。この文字が path パラメーターで使用されている場合、配列全体が返されます。アスタリスク（*）はエスケープできません。

戻り値

• json が空または無効な場合、NULL を返します。

• json が有効で、指定された path が存在する場合、対応する文字列を返します。

• オブジェクト内に重複キーは表示できません。たとえば、{a:1, a:0} はサポートされていません。サポートされていない場合、文字列の解析に失敗する可能性があります。

• 絵文字はサポートされていません。

例

• 例 1：

  -- JSON data. 
  {"store":
  {"fruit":[{"weight":8,"type":"apple"},{"weight":9,"type":"pear"}],
  "bicycle":{"price":19.95,"color":"red"}
  },
  "email":"amy@only_for_json_udf_test.net",
  "owner":"amy"
  }

  上記の JSON 文字列からデータを抽出するには、次のステートメントを実行します。

  -- 戻り値は amy です。
      GET_JSON_OBJECT(json, '$.owner');
  
  -- 戻り値は {"weight":8,"type":"apple"} です。
      GET_JSON_OBJECT(json, '$.store.fruit\[0]');
  
  -- 戻り値は null です。
      GET_JSON_OBJECT(json, '$.non_exist_key');

• 例 2：

  GET_JSON_OBJECT('{"array":[["aaaa",1111],["bbbb",2222],["cccc",3333]]}','$.array[1][1]')= "2222"
  
  GET_JSON_OBJECT('{"aaa":"bbb","ccc":{"ddd":"eee","fff":"ggg","hhh":["h0","h1","h2"]},"iii":"jjj"}','$.ccc.hhh[*]') = "["h0","h1","h2"]"
  
  GET_JSON_OBJECT('{"aaa":"bbb","ccc":{"ddd":"eee","fff":"ggg","hhh":["h0","h1","h2"]},"iii":"jjj"}','$.ccc.hhh[1]') = "h1"

構文

BIGINT INSTR(STRING str1, STRING str2[, BIGINT start_position[, BIGINT nth_appearance]])

説明

文字列 str1 内の部分文字列 str2 の位置を返します。

パラメーター

• : STRING 型の値。部分文字列を検索する文字列を示します。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

• : STRING 型の値。検索する部分文字列を示します。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

• : BIGINT 型の値。他のデータ型の場合、例外が返されます。 str1 内のどの文字から検索を開始するかを示します。デフォルトの開始位置は最初の文字で、1 とマークされます。

• : BIGINT 型の値。0 より大きい値である必要があります。文字列内に部分文字列が出現する n 回目を示します。n は nth_appearance で指定されます。nth_appearance の値が他のデータ型の場合、または 0 以下の場合、例外が返されます。

戻り値

• BIGINT 型の値が返されます。

• str1 が str2 内に見つからない場合、0 が返されます。

• 入力パラメーターが NULL に設定されている場合、NULL が返されます。

• str2 が空の場合、常に一致が成功します。たとえば、instr(‘abc’, ") の場合は 1 が返されます。

例

INSTR('Tech on the net', 'e') = 2
INSTR('Tech on the net', 'e', 1, 1) = 2
INSTR('Tech on the net', 'e', 1, 2) = 11
INSTR('Tech on the net', 'e', 1, 3) = 14

構文

base64_decode(STRING str)

説明

Base64 エンコードされた文字列をデコードします。

パラメーター

str: STRING 型の値。分割する文字列を示します。入力値が BIGINT、DOUBLE、DECIMAL、TIMESTAMP、または DATE 型の場合、計算前に値が暗黙的に STRING 型に変換されます。入力値が Base64 エンコードされた文字列でない場合、元の文字列が返されます。

戻り値

STRING 型の値が返されます。

構文

BIGINT LENGTH(STRING str)

説明

文字列 str の長さを返します。

パラメーター

• : STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

• BIGINT 型の値が返されます。入力パラメーターが NULL の場合、NULL が返されます。入力パラメーターが UTF-8 でエンコードされていない場合、-1 が返されます。

例

LENGTH('hi! China') = 6

構文

BIGINT LENGTHB(STRING str)

説明

文字列 str の長さをバイト単位で返します。

パラメーター

• : STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

• BIGINT 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

LENGTHB('hi! China') = 10

構文

STRING MD5(STRING value)

説明

入力文字列 value の MD5 値を返します。

パラメーター

: STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

構文

STRING REGEXP_REPLACE(STRING source, STRING pattern, STRING replace_string[, BIGINT occurrence])

説明

replace_STRING で指定された文字列を使用して、ソース文字列内の occurrence で指定された n 番目の出現箇所にある、指定された pattern に一致する部分文字列を置き換え、結果を返します。

パラメーター

• source: 置き換えられる文字列。

• pattern: STRING 型の定数。一致させるパターンを示します。pattern が空の文字列の場合、例外が返されます。

• replace_string: STRING 型の値。指定された pattern に一致する部分文字列に置き換えられる文字列です。

• occurrence: BIGINT 型の定数。0 以上である必要があります。 replace_string が n 番目の出現箇所にある一致する部分文字列に置き換えられることを示します。値 0 は、一致するすべての部分文字列が置き換えられることを示します。値が他の型の場合、または 0 未満の場合、例外が返されます。デフォルト値：0。

戻り値

• STRING 型の値が返されます。参照されるグループが存在しない場合、部分文字列は置き換えられません。

• 入力パラメーターが NULL に設定されている場合、NULL が返されます。

• replace_string が null に設定されていて、部分文字列が指定された pattern に一致する場合、NULL が返されます。

• replace_string が null に設定されているが、部分文字列が指定された pattern に一致しない場合、元の文字列が返されます。

例

regexp_replace("123.456.7890", "([[:digit:]]{3})\\.([[:digit:]]{3})\\.([[:digit:]]{4})",
"(\\1)\\2-\\3", 0) = "(123)456-7890"
regexp_replace("abcd", "(.)", "\\1 ", 0) = "a b c d "
regexp_replace("abcd", "(.)", "\\1 ", 1) = "a bcd"
regexp_replace("abcd", "(.)", "\\2", 1) = "abcd"
-- パターンには 1 つのグループのみが定義されており、参照するグループは存在しません。
-- この関数はこの方法で使用しないことをお勧めします。存在しないグループを参照した結果は定義されていません。
regexp_replace("abcd", "(.*)(.)$", "\\2", 0) = "d"
regexp_replace("abcd", "a", "\\1", 0) = "bcd"
-- pattern に文字クラスは定義されていません。\1 は存在しない文字クラスを参照しています。
-- この関数はこの方法で使用しないことをお勧めします。存在しないグループを参照した結果は定義されていません。

構文

STRING SPLIT_PART(STRING str, STRING separator, BIGINT start[, BIGINT end])

説明

str で指定された文字列を、separator で指定されたデリミタで分割し、start で指定された位置から end で指定された別の位置まで始まる部分文字列を返します。

パラメーター

• : STRING 型の値。分割する文字列を示します。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

• separator: STRING 型の定数。分割に使用されるデリミタです。文字または文字列を指定できます。他のデータ型の場合、例外が返されます。

• : BIGINT 型の定数。0 より大きい値である必要があります。値が定数でない場合、または他のデータ型の場合、例外が返されます。このパラメーターは、返される部分文字列の開始位置を指定します。位置は 1 から始まります。end が設定されていない場合、start で指定された位置にある部分文字列が返されます。

• end: BIGINT 型の定数。start の値以上である必要があります。このパラメーターは、返されるセグメントの終了位置を指定します。値が定数でない場合、または他のデータ型の場合、例外が返されます。end が設定されていない場合、最後の部分文字列が返されます。

戻り値

• STRING 型の値が返されます。

• start をセグメント数より大きい値に設定すると、空の文字列が返されます。たとえば、文字列に 6 つのセグメントがあるが、start を 6 より大きい値に設定すると、空の文字列が返されます。

• separator の値が str で指定された文字列に存在せず、start を 1 に設定すると、str で指定された文字列が返されます。str の値が空の文字列の場合、空の文字列が返されます。

• separator の値が空の文字列の場合、str で指定された文字列が返されます。

• end をセグメント数より大きい値に設定すると、すべてのセグメントが返されます。

• 入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

SPLIT_PART('a,b,c,d', ',', 1) = 'a'
SPLIT_PART('a,b,c,d', ',', 1, 2) = 'a,b'
SPLIT_PART('a,b,c,d', ',', 10) = ''

構文

STRING SUBSTR(STRING str, BIGINT start_position[, BIGINT length])

説明

str 内の start_position で指定された位置から始まり、length で指定された長さの部分文字列を返します。

パラメーター

• str: STRING 型の値。入力値が BIGINT、DECIMAL、DOUBLE、または DATETIME 型の場合、計算前に暗黙的に STRING 型に変換されます。入力値が他のデータ型の場合、例外が返されます。

• start_position: BIGINT 型の値。デフォルト値：1。start_position を 0 に設定すると、空の文字列が返されます。start_position を負の値に設定すると、開始位置は文字列の最後の文字から逆算されます。たとえば、-1 は最後の文字、-2 は最後から 2 番目の文字、-3 は最後から 3 番目の文字を示します。値が他のデータ型の場合、例外が返されます。

• : BIGINT 型の値。部分文字列の長さを示します。値は 0 より大きくなります。値が他のデータ型の場合、または 0 以下の場合、例外が返されます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

SUBSTR("abc", 2) = "bc"
SUBSTR("abc", 2, 1) = "b"
SUBSTR("abc",-2,2) = "bc"
SUBSTR("abc",-3) = "abc"

構文

STRING TOLOWER(STRING source)

説明

文字列 source を小文字の文字列に変換します。

パラメーター

: STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

tolower("aBcd") = "abcd"
tolower("HAHACd") = "hahacd"

構文

STRING TOUPPER(STRING source)

説明

source で指定された文字列を大文字の文字列に変換します。

パラメーター

: STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外が返されます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

toupper("aBcd") = "ABCD"
toupper("HahaCd") = "HAHACD"

構文

STRING TO_CHAR(BOOLEAN value)
STRING TO_CHAR(BIGINT value)
STRING TO_CHAR(DOUBLE value)
STRING TO_CHAR(DECIMAL value)

説明

BOOLEAN、BIGINT、DECIMAL、または DOUBLE 型のデータを STRING 型に変換します。

パラメーター

: 入力値は、BOOLEAN、BIGINT、DECIMAL、または DOUBLE 型のいずれかになります。値が他のデータ型の場合、例外が返されます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

TO_CHAR(123) = '123'
TO_CHAR(true) = 'TRUE'
TO_CHAR(1.23) = '1.23'
TO_CHAR(null) = NULL

構文

STRING TRIM(STRING str)

説明

str で指定された文字列の左右両側のスペースを削除します。

パラメーター

: STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外がスローされます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

LTRIM(' abc ')="abc"; 

構文

STRING LTRIM(STRING str)

説明

str で指定された文字列の左側のスペースを削除します。

パラメーター

: STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外がスローされます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

LTRIM(' abc ')="abc "; 

構文

STRING RTRIM(STRING str)

説明

str で指定された文字列の右側のスペースを削除します。

パラメーター

: STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外がスローされます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

RTRIM('a abc ')="a abc"; 

構文

STRING REVERSE(STRING str)

説明

逆順の文字列を返します。

パラメーター

: STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外がスローされます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

REVERSE('abcedfg')="gfdecba"

構文

BIGINT ASCII(STRING str)

説明

str で指定された文字列の最初の文字の ASCII コードを返します。

パラメーター

: STRING 型の値。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外がスローされます。

戻り値

BIGINT 型の値が返されます。

例

-- 戻り値は 97 です。
ASCII('abcde')

構文

STRING LPAD(STRING a, INT len, STRING b)

説明

a で指定された文字列の左側に、新しい埋め込み文字列の文字数が len で指定された値に達するまで、b で指定された文字列を埋め込みます。

パラメーター

• : INT 型の値。

• a および b: STRING 型の値。

戻り値

STRING 型の値が返されます。len の値が a で指定された文字列の文字数より小さい場合、len で指定された長さの部分文字列が文字列の左側から切り捨てられ、返されます。len を 0 に設定すると、NULL が返されます。

例

lpad('abcdefgh',10,'12')='12abcdefgh'
lpad('abcdefgh',5,'12')='abcde'
lpad('abcdefgh',0,'12') -- NULL を返します。

構文

STRING RPAD(STRING a, INT len, STRING b)

説明

文字列 a の右側に、新しい埋め込み文字列の文字数が len で指定された値に達するまで、文字列 b を埋め込みます。

パラメーター

• : INT 型の値。

• a および b などのパラメーター: STRING 型の値。

戻り値

STRING 型の値が返されます。len の値が a で指定された文字列の文字数より小さい場合、len で指定された長さの部分文字列が文字列の左側から切り捨てられ、返されます。len。len の値が 0 の場合、NULL が返されます。

例

rpad('abcdefgh',10,'12')='abcdefgh12'
rpad('abcdefgh',5,'12')='abcde'
rpad('abcdefgh',0,'12') -- NULL を返します。

構文

STRING REPLACE(STRING a, STRING OLD, STRING NEW)

説明

目的: 文字列 a の文字列 OLD と完全に同じ部分を文字列 NEW に置き換え、文字列 a を返します。

パラメーター

すべてのパラメーターの値は STRING 型です。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

REPLACE('ababab','abab','12')='12ab'
REPLACE('ababab','cdf','123')='ababab'
REPLACE('123abab456ab',null,'abab')=null

構文

STRING URL_ENCODE(STRING input[, STRING encoding])

説明

パラメーター

• : デコードする文字列。

• : エンコード形式。有効な値は GBK と UTF-8 です。このパラメーターを設定しない場合、デフォルト値の UTF-8 が使用されます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

URL_ENCODE('Example for URL_ENCODE:// (fdsf)') = "%E7%A4%BA%E4%BE%8Bfor+URL_ENCODE%3A%2F%2F+%28fdsf%29"
URL_ENCODE('Example for URL_ENCODE:// dsf(fasfs)', 'GBK') = "Example+for+URL_ENCODE+%3A%2F%2F+dsf%28fasfs%29"

構文

STRING URL_DECODE(STRING input[, STRING encoding])

説明

パラメーター

• : デコードする文字列。

• : エンコード形式。有効な値は GBK と UTF-8 です。このパラメーターを指定しない場合、デフォルト値の UTF-8 が使用されます。

戻り値

STRING 型の値が返されます。入力パラメーターが NULL に設定されている場合、NULL が返されます。

例

URL_DECODE('%E7%A4%BA%E4%BE%8Bfor+URL_DECODE%3A%2F%2F+%28fdsf%29')= "Example for URL_DECODE:// (fdsf)"
URL_DECODE('Example+for+URL_DECODE+%3A%2F%2F+dsf%28fasfs%29', 'GBK') = "Example for URL_DECODE:// dsf(fasfs)"

構文

BOOLEAN ENDSWITH(STRING input, STRING suffix)

説明

入力文字列が で指定された文字列で終わるかどうかを確認します。

パラメーター

すべてのパラメーターの値は STRING 型です。入力値が BIGINT、DOUBLE、DECIMAL、または DATETIME 型の場合、計算前に暗黙的に STRING 型の値に変換されます。入力値が他のデータ型の場合、例外がスローされます。

戻り値

BOOLEAN 型の値が返されます。

構文

TO_BASE64(BINARY bin)

説明

バイナリデータを Base64 エンコードされた文字列に変換します。

パラメーター

入力パラメーターの値は BINARY 型です。

戻り値

Base64 エンコードされた文字列。