MySQL :: MySQL 8.4 參考手冊 :: 14.17.1 JSON 函數參考

版本 8.4

8.0 日文

MySQL 8.4 參考手冊 / ... / JSON 函數參考

14.17.1 JSON 函數參考

表 14.22 JSON 函數

名稱	說明	已棄用
`->`	評估路徑後從 JSON 資料行傳回值；相當於 JSON_EXTRACT()。
`->>`	評估路徑後從 JSON 資料行傳回值，並取消引號結果；相當於 JSON_UNQUOTE(JSON_EXTRACT())。
`JSON_ARRAY()`	建立 JSON 陣列
`JSON_ARRAY_APPEND()`	將資料附加到 JSON 文件
`JSON_ARRAY_INSERT()`	插入 JSON 陣列
`JSON_CONTAINS()`	JSON 文件是否在路徑中包含特定物件
`JSON_CONTAINS_PATH()`	JSON 文件是否在路徑中包含任何資料
`JSON_DEPTH()`	JSON 文件的最大深度
`JSON_EXTRACT()`	從 JSON 文件傳回資料
`JSON_INSERT()`	將資料插入 JSON 文件
`JSON_KEYS()`	來自 JSON 文件的索引鍵陣列
`JSON_LENGTH()`	JSON 文件中的元素數量
`JSON_MERGE()`	合併 JSON 文件，保留重複的索引鍵。JSON_MERGE_PRESERVE() 的已棄用同義詞	是
`JSON_MERGE_PATCH()`	合併 JSON 文件，取代重複索引鍵的值
`JSON_MERGE_PRESERVE()`	合併 JSON 文件，保留重複的索引鍵
`JSON_OBJECT()`	建立 JSON 物件
`JSON_OVERLAPS()`	比較兩個 JSON 文件，如果這些文件有任何共通的索引鍵值對或陣列元素，則傳回 TRUE (1)，否則傳回 FALSE (0)
`JSON_PRETTY()`	以人類可讀的格式列印 JSON 文件
`JSON_QUOTE()`	為 JSON 文件加上引號
`JSON_REMOVE()`	從 JSON 文件移除資料
`JSON_REPLACE()`	取代 JSON 文件中的值
`JSON_SCHEMA_VALID()`	針對 JSON 綱要驗證 JSON 文件；如果文件根據綱要進行驗證，則傳回 TRUE/1，否則傳回 FALSE/0
`JSON_SCHEMA_VALIDATION_REPORT()`	針對 JSON 綱要驗證 JSON 文件；以 JSON 格式傳回關於驗證結果的報告，包括成功或失敗以及失敗原因
`JSON_SEARCH()`	JSON 文件內值的路徑
`JSON_SET()`	將資料插入 JSON 文件
`JSON_STORAGE_FREE()`	在部分更新後，JSON 資料行值的二進位表示法中的釋放空間
`JSON_STORAGE_SIZE()`	用於儲存 JSON 文件二進位表示法的空間
`JSON_TABLE()`	將來自 JSON 表達式的資料以關聯式表格形式傳回
`JSON_TYPE()`	JSON 值的類型
`JSON_UNQUOTE()`	取消 JSON 值的引號
`JSON_VALID()`	JSON 值是否有效
`JSON_VALUE()`	從路徑所指向的位置的 JSON 文件中擷取值；將此值以 VARCHAR(512) 或指定類型傳回
`MEMBER OF()`	如果第一個運算元符合作為第二個運算元傳遞的 JSON 陣列的任何元素，則傳回 true (1)，否則傳回 false (0)

MySQL 支援兩個聚合 JSON 函數 JSON_ARRAYAGG() 和 JSON_OBJECTAGG()。如需這些函數的說明，請參閱第 14.19 節「聚合函數」。

MySQL 也支援使用 JSON_PRETTY() 函數以易於閱讀的格式「美觀列印」 JSON 值。您可以使用 JSON_STORAGE_SIZE() 和 JSON_STORAGE_FREE() 分別查看給定 JSON 值佔用多少儲存空間，以及剩餘多少空間用於額外儲存。如需這些函數的完整說明，請參閱第 14.17.8 節「JSON 公用程式函數」。