メニュー
Amazon Redshift
データベース開発者ガイド (API Version 2012年12月1日)

JSON_EXTRACT_ARRAY_ELEMENT_TEXT 関数

JSON_EXTRACT_ARRAY_ELEMENT_TEXT は、JSON 文字列の最外部の配列内の JSON 配列要素 (0 から始まるインデックスを使用) を返します。配列内の最初の要素の位置は 0 です。インデックスが負または範囲外である場合、JSON_EXTRACT_ARRAY_ELEMENT_TEXT は空の文字列を返します。null_if_invalid の引数が true に設定され、JSON 文字列が無効になっている場合、関数はエラーを返す代わりに NULL を返します。

詳細については、「JSON 関数」を参照してください。

構文

json_extract_array_element_text('json string', pos [, null_if_invalid ] )

引数

json_string

正しくフォーマットされた JSON 文字列。

pos

返される配列要素のインデックスを表す整数 (0 から始まる配列インデックスを使用)。

null_if_invalid

エラーを返す代わりに入力 JSON 文字列が無効である場合に NULL を返すかどうかを指定するブール値。JSON が無効な場合に NULL を返すには、true (t) を指定します。JSON が無効な場合にエラーを返すには、false (f) を指定します。デフォルト: false

戻り型

pos によって参照される JSON 配列要素を表す VARCHAR 文字列。

次の例は、位置 2 にある配列要素を返します。

select json_extract_array_element_text('[111,112,113]', 2); json_extract_array_element_text ------------------------------- 113

次の例では、JSON が無効であるため、エラーが返されます。

select json_extract_array_element_text('["a",["b",1,["c",2,3,null,]]]',1); An error occurred when executing the SQL command: select json_extract_array_element_text('["a",["b",1,["c",2,3,null,]]]',1)

次の例では、null_if_invalidtrue に設定しているため、ステートメントは、無効な JSON のエラーを返す代わりに NULL を返します。

select json_extract_array_element_text('["a",["b",1,["c",2,3,null,]]]',1,true); json_extract_array_element_text -------------------------------

このページの内容: