- カテゴリ:
半構造化データ関数と構造化データ関数 (抽出)
JSON_EXTRACT_PATH_TEXT¶
最初の引数を JSON 文字列として解析し、2番目の引数のパスが指す要素の値を返します。これは、 TO_VARCHAR(GET_PATH(PARSE_JSON(JSON), PATH)) と同等です
構文¶
引数¶
column_identifier抽出するデータを含む列の名前。
path_name抽出する要素へのパスを含む文字列。
戻り値¶
戻り値のデータ型はVARCHARです。
使用上の注意¶
この関数は、パス名がどの要素にも対応しない場合に NULL を返します。
パス名の構文は標準の JavaScript 表記です。これは、ピリオド(例:
.)とインデックス演算子(例:[<インデックス>])が前に付いたフィールド名(識別子)の連結で構成されます。最初のフィールド名には、先行ピリオドを指定する必要はありません。
インデックス演算子のインデックス値は、負でない整数(配列の場合)または一重引用符または二重引用符で囲まれた文字列リテラル(オブジェクトフィールドの場合)です。
詳細については、 半構造化データのクエリ をご参照ください。
構文の一貫性を維持するために、パス表記は SQL スタイルの二重引用符で囲まれた識別子もサポートし、パス区切り文字として
:を使用します。
例¶
テーブルを作成して値を挿入します。
JSON_EXTRACT_PATH_TEXT を使用して、単純な1レベルの文字列から値を抽出します。
2レベルのパスを使用して2レベルの文字列から値を抽出するには、 JSON_EXTRACT_PATH_TEXT を使用します。
この例には配列が含まれています。