Oracle Database 19c 中的 JSON_OBJECT 函式的增強功能

本文講述Oracle Database 19c 中的 JSON_OBJECT 函式的增強功能。

1、初始化

本文中的示例使用 SCOTT模式中的 DEPT表，如下：

-- DROP TABLE DEPT PURGE;
CREATE TABLE DEPT (
  DEPTNO NUMBER(2) CONSTRAINT PK_DEPT PRIMARY KEY,
  DNAME VARCHAR2(14),
  LOC VARCHAR2(13)
);
INSERT INTO DEPT VALUES (10,'ACCOUNTING','NEW YORK');
INSERT INTO DEPT VALUES (20,'RESEARCH','DALLAS');
INSERT INTO DEPT VALUES (30,'SALES','CHICAGO');
INSERT INTO DEPT VALUES (40,'OPERATIONS','BOSTON');
COMMIT;

2、萬用字元

萬用字元“*”可用作 JSON_OBJECT 函式的輸入，以在單個步驟中引用所有列。使用列名作為鍵，將每列轉換為鍵：key:value。

SELECT JSON_OBJECT(*) AS json_data
FROM   dept;
JSON_DATA
-------------------------------------------------------
{"DEPTNO":10,"DNAME":"ACCOUNTING","LOC":"NEW YORK"}
{"DEPTNO":20,"DNAME":"RESEARCH","LOC":"DALLAS"}
{"DEPTNO":30,"DNAME":"SALES","LOC":"CHICAGO"}
{"DEPTNO":40,"DNAME":"OPERATIONS","LOC":"BOSTON"}
SQL>

萬用字元也可以是表或檢視別名的字首。

SELECT JSON_OBJECT(a.*) AS json_data
FROM   dept a;
JSON_DATA
-------------------------------------------------------
{"DEPTNO":10,"DNAME":"ACCOUNTING","LOC":"NEW YORK"}
{"DEPTNO":20,"DNAME":"RESEARCH","LOC":"DALLAS"}
{"DEPTNO":30,"DNAME":"SALES","LOC":"CHICAGO"}
{"DEPTNO":40,"DNAME":"OPERATIONS","LOC":"BOSTON"}
SQL>

3、列列表

可以將逗號分隔的列列表指定為 JSON_OBJECT 函式的輸入。在查詢中使用的情況下，鍵名與列表中的列名匹配。以下查詢使用小寫的列名稱，因此輸出的鍵字是小寫的。

SELECT JSON_OBJECT(deptno, dname) AS json_data
FROM   dept;
JSON_DATA
-------------------------------------------------------
{"deptno":10,"dname":"ACCOUNTING"}
{"deptno":20,"dname":"RESEARCH"}
{"deptno":30,"dname":"SALES"}
{"deptno":40,"dname":"OPERATIONS"}
SQL>

在以下示例中，列名稱是首欄位大寫，因此鍵名稱在輸出中也是首字母大寫。

SELECT JSON_OBJECT(Deptno, Dname) AS json_data
FROM   dept;
JSON_DATA
-------------------------------------------------------
{"Deptno":10,"Dname":"ACCOUNTING"}
{"Deptno":20,"Dname":"RESEARCH"}
{"Deptno":30,"Dname":"SALES"}
{"Deptno":40,"Dname":"OPERATIONS"}
SQL>

4、鍵值（Key-Value）定義

在以前的版本中，鍵值對以兩種方式之一定義，使用KEY和VALUE關鍵字，或省略KEY關鍵字，以下所示：

SELECT JSON_OBJECT(KEY 'deptno' VALUE deptno,
                   KEY 'dname' VALUE dname) AS json_data
FROM   dept;
SELECT JSON_OBJECT('deptno' VALUE deptno,
                   'dname' VALUE dname) AS json_data

在Oracle 19c中，有一個更短的選項，用“:”代替VALUE關鍵字。

SELECT JSON_OBJECT('deptno' : deptno,
                   'dname' : dname) AS json_data
FROM   dept;
JSON_DATA
-------------------------------------------------------
{"deptno":10,"dname":"ACCOUNTING"}
{"deptno":20,"dname":"RESEARCH"}
{"deptno":30,"dname":"SALES"}
{"deptno":40,"dname":"OPERATIONS"}
SQL>

5、列別名

您不能在  JSON_OBJECT  函式呼叫本身中對列進行別名，也不需要這樣做，但可以在  WITH  子 句或內聯檢視中進行別名。

WITH converted_data AS (
  SELECT deptno AS "deptnoCol",
         dname AS "dnameCol"
  FROM   dept
)
SELECT JSON_OBJECT(a.*) AS json_data
FROM   converted_data a;
JSON_DATA
-------------------------------------------------------
{"deptnoCol":10,"dnameCol":"ACCOUNTING"}
{"deptnoCol":20,"dnameCol":"RESEARCH"}
{"deptnoCol":30,"dnameCol":"SALES"}
{"deptnoCol":40,"dnameCol":"OPERATIONS"}
SQL>SELECT JSON_OBJECT(a.*) AS json_data
FROM   (SELECT deptno AS "deptnoCol",
               dname AS "dnameCol"
        FROM   dept) a;
JSON_DATA
-------------------------------------------------------
{"deptnoCol":10,"dnameCol":"ACCOUNTING"}
{"deptnoCol":20,"dnameCol":"RESEARCH"}
{"deptnoCol":30,"dnameCol":"SALES"}
{"deptnoCol":40,"dnameCol":"OPERATIONS"}
SQL>