JSON_EXTRACT_PATH_TEXT 函數

注意

JSON_PARSE 及其相關聯的函數會將值剖析為 SUPER，Amazon Redshift 會比 更有效率地剖析這些JSON值VARCHAR。

建議您使用 剖析JSON字串JSON_PARSE 函數以取得SUPER值TEXT，而不是使用 JSONEXTRACT__PATH_。然後，使用value.attribute語法查詢您想要的元素。如需查詢SUPER值中陣列元素的詳細資訊，請前往 查詢半結構化資料。

JSON_EXTRACT_PATH_TEXT 函數會傳回JSON字串中一系列路徑元素所參考之鍵值對的值。JSON 路徑最多可巢狀至五個層級深。路徑元素區分大小寫。如果JSON字串中不存在路徑元素，JSON_EXTRACT_PATH_TEXT 會傳回 NULL。

如果 null_if_invalid 引數設定為 true且JSON字串無效，則函數會傳回 NULL，而不是傳回錯誤。

JSON_EXTRACT_PATH_TEXT 的資料大小上限為 64KB。因此，如果任何JSON記錄大於 64KB ，使用 JSON_EXTRACT_PATH_TEXT 處理它會導致錯誤。

如需其他JSON函數的資訊，請參閱 JSON 函數。如需使用 的詳細資訊JSON，請參閱 COPY 從JSON格式。

語法

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標籤字元。若要載入反斜線，請加上反斜線 ( \\ ) 來逸出。如需詳細資訊，請參閱中的逸出字元 JSON。

傳回類型

VARCHAR

表示路徑元素參考JSON值的VARCHAR字串。

範例

若要傳回路徑 '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 ，因此陳述式會傳回NULL無效，JSON而不是傳回錯誤，請使用下列範例。

SELECT JSON_EXTRACT_PATH_TEXT('{"f2":{"f3":1},"f4":{"f5":99,"f6":"star"}','f4', 'f6',true);

+------------------------+
| json_extract_path_text |
+------------------------+
| NULL                   |
+------------------------+

若要傳回路徑 'farm', 'barn', 'color' 的值，其中擷取的值位於第三層，請使用下列範例。此範例使用 lint JSON 工具格式化，以便於讀取。

SELECT JSON_EXTRACT_PATH_TEXT('{
    "farm": {
        "barn": {
            "color": "red",
            "feed stocked": true
        }
    }
}', 'farm', 'barn', 'color');
+------------------------+
| json_extract_path_text |
+------------------------+
| red                    |
+------------------------+

若要在遺失 'color' 元素時傳回 NULL，請使用下列範例。此範例使用 lint JSON 工具格式化。

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           |