View a markdown version of this page

Fungsi JSON_EXTRACT_PATH_TEXT - Amazon Redshift
SintaksisArgumenJenis pengembalianContoh

Amazon Redshift tidak akan lagi mendukung penggunaan Python UDF setelah 30 Juni 2026. Kami akan mulai menegakkannya secara bertahap. Untuk informasi lebih lanjut tentang detail opsi akhir masa pakai dan migrasi Python, lihat posting blog yang diterbitkan pada 30 Juni 2025.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Fungsi JSON_EXTRACT_PATH_TEXT

catatan

JSON_PARSE dan fungsi terkaitnya mengurai nilai JSON sebagai SUPER, yang diurai oleh Amazon Redshift lebih efisien daripada VARCHAR.

Alih-alih menggunakan JSON_EXTRACT_PATH_TEXT, kami sarankan Anda mengurai string JSON menggunakan untuk mendapatkan nilai SUPER. Fungsi JSON_PARSE Kemudian, kueri elemen yang Anda inginkan menggunakan value.attribute sintaks. Untuk informasi lebih lanjut tentang kueri elemen array dalam nilai SUPER, buka. Mengkueri data semi-terstruktur

Fungsi JSON_EXTRACT_PATH_TEXT mengembalikan nilai untuk pasangan kunci-nilai yang direferensikan oleh serangkaian elemen jalur dalam string JSON. Jalur JSON dapat bersarang hingga kedalaman lima tingkat. Elemen jalur peka huruf besar/kecil. Jika elemen jalur tidak ada dalam string JSON, JSON_EXTRACT_PATH_TEXT kembali. NULL

Jika argumen null_if_invalid disetel ke TRUE dan string JSON tidak valid, fungsi kembali alih- NULL alih mengembalikan kesalahan.

JSON_EXTRACT_PATH_TEXT memiliki ukuran data maksimum 16MB. Jadi, jika ada catatan JSON yang lebih besar dari 16MB, memprosesnya dengan JSON_EXTRACT_PATH_TEXT menghasilkan kesalahan.

Untuk informasi tentang fungsi JSON tambahan, lihatFungsi JSON. Untuk informasi selengkapnya tentang bekerja dengan JSON, lihatSALIN dari format JSON.

Sintaksis

JSON_EXTRACT_PATH_TEXT('json_string', 'path_elem' [,'path_elem'[, …] ] [, null_if_invalid ] )

Argumen

json_string

String JSON yang diformat dengan benar.

path_element

Elemen jalur dalam string JSON. Diperlukan satu elemen jalur. Elemen jalur tambahan dapat ditentukan, hingga lima tingkat kedalaman.

null_if_invalid

(Opsional) BOOLEAN Nilai yang menentukan apakah akan dikembalikan NULL jika string JSON input tidak valid alih-alih mengembalikan kesalahan. Untuk mengembalikan NULL jika JSON tidak valid, tentukan TRUE (t). Untuk mengembalikan kesalahan jika JSON tidak valid, tentukan FALSE (f). Nilai default-nya FALSE.

Dalam string JSON, Amazon Redshift mengenali \n sebagai karakter baris baru dan \t sebagai karakter tab. Untuk memuat garis miring terbalik, lepaskan dengan backslash (). \\ Untuk informasi selengkapnya, lihat Karakter melarikan diri di JSON.

Jenis pengembalian

VARCHAR

Sebuah VARCHAR string yang mewakili nilai JSON yang direferensikan oleh elemen jalur.

Contoh

Untuk mengembalikan nilai jalur'f4', 'f6', gunakan contoh berikut.

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

+------------------------+
| json_extract_path_text |
+------------------------+
| star                   |
+------------------------+

Untuk mengembalikan kesalahan karena JSON tidak valid, gunakan contoh berikut.

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"}

Untuk menyet el null_if_invalid ke TR UE, sehingga pernyataan kembali NULL untuk JSON yang tidak valid alih-alih mengembalikan kesalahan, gunakan contoh berikut.

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

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

Pertimbangkan contoh berikut, yang memilih nilai untuk jalur'farm', 'barn', 'color', di mana nilai yang diambil berada di tingkat ketiga, gunakan contoh berikut. Sampel ini diformat dengan alat lint JSON, untuk membuatnya lebih mudah dibaca.

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

Untuk kembali NULL karena 'color' elemen hilang, gunakan contoh berikut. Sampel ini diformat dengan alat lint JSON.

SELECT JSON_EXTRACT_PATH_TEXT('{
    "farm": {
        "barn": {}
    }
}', 'farm', 'barn', 'color');

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

Jika JSON valid, mencoba mengekstrak elemen yang hilang kembaliNULL.

Untuk mengembalikan nilai jalur'house', 'appliances', 'washing machine', 'brand', gunakan contoh berikut.

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              |
+------------------------+

Contoh berikut membuat tabel sampel dan mengisinya dengan nilai SUPER, lalu mengembalikan nilai untuk jalur 'f2' untuk kedua baris.

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           |

Pertimbangkan contoh pernyataan berikut. Path_elem yang disediakan adalah NULL, jadi JSON_EXTRACT_PATH_TEXT mengembalikan NULL terlepas dari nilai parameter lainnya. 

--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

Pertimbangkan contoh pernyataan berikut. Ketika null_if_invalid adalah TRUE, JSON_EXTRACT_PATH_TEXT mengembalikan NULL ketika json_string adalah JSON tidak valid. Jika null_if_invalid adalah FALSE atau tidak disetel, fungsi mengembalikan kesalahan ketika json_string tidak valid. 

--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

Pertimbangkan contoh berikut, di mana json_string adalah JSON yang valid, dan path_elem mengacu pada nilai JSON. null Dalam hal ini, JSON_EXTRACT_PATH_TEXT mengembalikan NULL. Demikian pula, ketika path_elem mengacu pada nilai yang tidak ada, JSON_EXTRACT_PATH_TEXT mengembalikan NULL, terlepas dari nilai null_if_invalid. 

--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