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 の要素 (0 から始まる配列インデックスの 3 番目の要素) が返されます。

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_invalid を true に設定しているため、ステートメントは、無効な JSON のエラーを返す代わりに NULL を返します。

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