Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # JSON\_EXTRACT\_PATH\_TEXT 函數 **注意** JSON\_PARSE 及其相關聯的函式會將 JSON 值剖析為 SUPER，Amazon Redshift 會剖析這類值的效率比剖析 VARCHAR 更高。 建議您使用 [JSON\_PARSE 函數](JSON_PARSE.md) 剖析 JSON 字串來取得 SUPER 值，而不要使用 JSON\_EXTRACT\_PATH\_TEXT。然後使用 `value.attribute` 語法查詢您要的元素。如需在 SUPER 值中查詢陣列元素的詳細資訊，請前往 [查詢半結構化資料](query-super.md)。 JSON\_EXTRACT\_PATH\_TEXT 函數傳回 JSON 字串中由一連串路徑元素所參考的鍵-值對的值。JSON 路徑巢狀最深可達五層。路徑元素區分大小寫。如果 JSON 字串中沒有路徑元素，JSON\_EXTRACT\_PATH\_TEXT 會傳回 `NULL`。 如果 *null\_if\_invalid* 引數設為 `TRUE`，且 JSON 字串無效，此函數會傳回 `NULL`，而非傳回錯誤。 JSON\_EXTRACT\_PATH\_TEXT 的資料大小上限為 16MB。因此，如果任何 JSON 記錄大於 16MB，則使用 JSON\_EXTRACT\_PATH\_TEXT 處理它會導致錯誤。 如需有關其他 JSON 函數的資訊，請參閱[JSON 函數](json-functions.md)。如需使用 JSON 的相關資訊，請參閱[從 JSON 格式 COPY](copy-usage_notes-copy-from-json.md)。 ## 語法 ``` JSON_EXTRACT_PATH_TEXT('json_string', 'path_elem' [,'path_elem'[, …] ] [, null_if_invalid ] ) ``` ## 引數 *json\_string* 格式正確的 JSON 字串。 *path\_elem* JSON 字串中的路徑元素。需要一個路徑元素。可指定其他路徑元素，最深可達五層。 *null\_if\_invalid* (選用) `BOOLEAN` 值，指定輸入 JSON 字串無效時是否傳回 `NULL`，而非傳回錯誤。若要在 JSON 無效時傳回 `NULL`，請指定 `TRUE` (`t`)。若要在 JSON 無效時傳回錯誤，請指定 `FALSE` (`f`)。預設值為 `FALSE`。 在 JSON 字串中，Amazon Redshift 將 `\n` 視為新行字元，將 `\t` 視為 Tab 字元。若要載入反斜線，請加上反斜線 ( `\\` ) 來逸出。如需詳細資訊，請參閱[JSON 中的逸出字元](copy-usage_notes-copy-from-json.md#copy-usage-json-escape-characters)。 ## 傳回類型 `VARCHAR` `VARCHAR` 字串，代表路徑元素所參考的 JSON 值。 ## 範例 若要傳回路徑 `'f4', 'f6'` 的值，請使用下列範例。 ``` SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}}','f4', 'f6'); +------------------------+ | json_extract_path_text | +------------------------+ | star | +------------------------+ ``` 若要因 JSON 無效而傳回錯誤，請使用下列範例。 ``` SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}','f4', 'f6'); ERROR: invalid json object {"f2":{"f3":1},"f4":{"f5":99,"f6":"star"} ``` 若要將 *null\_if\_invalid* 設為 *TRUE*，讓陳述式在 JSON 無效時傳回 `NULL` 而非傳回錯誤，請使用下列範例。 ``` SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}','f4', 'f6',true); +------------------------+ | json_extract_path_text | +------------------------+ | NULL | +------------------------+ ``` 請參考下列選取路徑 `'farm', 'barn', 'color'` 之值的範例，其中擷取的值位於第三層。此範例使用 JSON lint 工具進行格式，以便於閱讀。 ``` SELECT JSON_EXTRACT_PATH_TEXT('{ "farm": { "barn": { "color": "red", "feed stocked": true } } }', 'farm', 'barn', 'color'); +------------------------+ | json_extract_path_text | +------------------------+ | red | +------------------------+ ``` 若要在遺失 `'color'` 元素時傳回 `NULL`，請使用下列範例。此範例使用 JSON lint 工具進行格式化。 ``` SELECT JSON_EXTRACT_PATH_TEXT('{ "farm": { "barn": {} } }', 'farm', 'barn', 'color'); +------------------------+ | json_extract_path_text | +------------------------+ | NULL | +------------------------+ ``` 如果 JSON 有效，嘗試提取缺少的元素會傳回 `NULL`。 若要傳回路徑 `'house', 'appliances', 'washing machine', 'brand'` 的值，請使用下列範例。 ``` SELECT JSON_EXTRACT_PATH_TEXT('{ "house": { "address": { "street": "123 Any St.", "city": "Any Town", "state": "FL", "zip": "32830" }, "bathroom": { "color": "green", "shower": true }, "appliances": { "washing machine": { "brand": "Any Brand", "color": "beige" }, "dryer": { "brand": "Any Brand", "color": "white" } } } }', 'house', 'appliances', 'washing machine', 'brand'); +------------------------+ | json_extract_path_text | +------------------------+ | Any Brand | +------------------------+ ``` 下列範例會建立範例資料表，並填入 SUPER 值，然後針對這兩列路徑 `'f2'` 的值。 ``` CREATE TABLE json_example(id INT, json_text SUPER); INSERT INTO json_example VALUES (1, JSON_PARSE('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}}')), (2, JSON_PARSE('{ "farm": { "barn": { "color": "red", "feed stocked": true } } }')); SELECT * FROM json_example; id | json_text ------------+-------------------------------------------- 1 | {"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}} 2 | {"farm":{"barn":{"color":"red","feed stocked":true}}} SELECT id, JSON_EXTRACT_PATH_TEXT(JSON_SERIALIZE(json_text), 'f2') FROM json_example; id | json_text ------------+-------------------------------------------- 1 | {"f3":1} 2 | ``` 請參考下列範例陳述式。提供的 *path\_elem* 為 NULL，因此無論任何其他參數的值為何，JSON\_EXTRACT\_PATH\_TEXT 都會傳回 NULL。 ``` --Statement where path_elem is NULL and json_string is valid JSON. SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}}',NULL); json_extract_path_text ------------------------ NULL --Statement where only one path_elem is NULL. SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}}','f4',NULL); json_extract_path_text ------------------------ NULL --Statement where path_elem is NULL and json_string is invalid JSON. SELECT json_extract_path_text('invalid_json', NULL); json_extract_path_text ------------------------ NULL --Statement where path_elem is NULL and null_if_invalid is FALSE. SELECT json_extract_path_text(NULL, 0, FALSE); json_extract_path_text ------------------------ NULL ``` 請參考下列範例陳述式。當 *null\_if\_invalid* 為 TRUE 時，JSON\_EXTRACT\_PATH\_TEXT 會在 *json\_string* 為無效 JSON 的情況下傳回 NULL。如果 *null\_if\_invalid* 為 FALSE 或未設定，則函式會在 *json\_string* 無效時傳回錯誤。 ``` --Statement with invalid JSON where null_if_invalid is TRUE. SELECT json_extract_path_text('invalid_json', 0, TRUE); json_extract_path_text ------------------------ NULL --Statement with invalid JSON where null_if_invalid is FALSE. SELECT json_extract_path_text('invalid_json', 0, FALSE); ERROR: JSON parsing error ``` 請參考下列範例，其中 *json\_string* 是有效的 JSON，而 *path\_elem* 參考 JSON `null` 值。在此情況下，JSON\_EXTRACT\_PATH\_TEXT 會傳回 NULL。同樣地，當 *path\_elem* 參考不存在的值時，無論 *null\_if\_invalid* 的值為何，JSON\_EXTRACT\_PATH\_TEXT 都會傳回 NULL。 ``` --Statement selecting a null value. SELECT json_extract_path_text('[null]', 0); json_extract_path_text ------------------------- NULL --Statement selecting a non-existing value. SELECT json_extract_path_text('{}', 'a'); json_extract_path_text ------------------------- NULL ```