动态字段介绍及使用

Size: px

Start display at page:

Download "动态字段介绍及使用"

鲸卢
5 years ago
Views:

1 DBMaker Author: DBMaster Support Team Production Team Publish Date: 5 11, 2017

2 目錄 1. JSONCOLS 類型介紹 JSONCOLS 類型定義 JSON 運算式使用 JSONCOLS 類型的原則 JSONCOLS 類型執行許可權及特點操作 JSONCOLS 類型使用動態欄位 ALTER TABLE ADD DYNAMIC COLUMN 命令 ALTER TABLE MODIFY DYNAMIC COLUMN 命令 ALTER TABLE DROP DYNAMIC COLUMN 命令動態欄位上創建索引動態欄位上創建視圖動態欄位在應用程式中使用... 5 Copyright CASEMaker Inc. 1

3 1. JSONCOLS 類型介紹 DBMaker 支援動態欄位動態欄位不在表定義中出現, 他是從 JSON 字串派生的 KEY, 只能在表將一個欄位聲明為 JSONCOLS 欄位時使用表中有很多欄位且大部分欄位的值為 NULL, 且分別操作很麻煩時就需要考慮使用 JSONCOLS 類型使用 JSONCOLS 類型來存儲動態欄位, 在 DBMaker 中,JSONCOLS 類型表示為 JSONCOLS 欄位 Dynamic column col1,col2, JSONCOLS data type: BLOB checkmdiaformat(value, JSN )=1 DBMaker Engineer 圖 6-1:JSONCOLS 和動態欄位 1.1 JSONCOLS 類型 DBMaker 5.4 開始支持新的資料類型 JSONCOLS,JSONCOLS 類型是一個 JSON 運算式, 可以將表中的所有動態欄位轉化為結構化的輸出 JSONCOLS 類型用於存儲表中的所有動態欄位, 可以結合動態欄位使用 JSONCOLS 類型可以通過 CREATE TABLE 或 ALTER TABLE 語法的 <JSONCOLS_type_name> JSONCOLS 關鍵字來定義 CREATE TABLE table-name(jsoncols-column-name JSONCOLS, common-column-name data-type, ) ALTER TABLE table-name ADD DYNAMIC [COLUMN] column-name datatype; 定義了 JSONCOLS 欄位之後即可將其作為普通欄位使用此外, 由於 JSONCOLS 欄位 Copyright CASEMaker Inc. 1

4 是從 LONG VARBINARY 派生的, 且在 DBMaker 中使用者不能在大物件上創建索引, 因此也不能在已定義的 JSONCOLS 欄位元元上創建索引, 但是可以創建全文索引 *JSON(JavaScript Object Natation) 類型的資料格式基於純文字相對而言更容易讀和寫並且方便軟體的解析和生成 1.2 定義 JSON 運算式您可以通過如下格式來定義 JSONCOLS 類型的 JSON 運算式 : {col1_name:col1_value,col2_name:col2_value,col3_name:col3_value...} 例 [6-1]:JSONCOLS 類型的示例 {"ID":1001,"NAME": Wang","PHONE": "} 注意 : 在 JSONCOLS 類型的 JSON 運算式中, 可以省略含 NULL 值的動態欄位例 [6-1] 中, 學生對象包含的鍵值 Key-Value : ID:1001 NAME: Wang PHONE: JSON 運算式 : {"ID":1001,"NAME": Wang","PHONE": "} 資料庫存儲格式 : Create table student (c1 jsoncols); Insert into student values('{"id":"1001","name":"wang","phone":" "} '); select c1 from student; //result: {"NAME":"Wang","ID":"1001","PHONE":" "} 1.3 使用 JSONCOLS 類型的原則使用 JSONCOLS 類型時, 您需要考慮以下幾點原則 : 不能更改 JSONCOLS 類型如果要更改, 則需要刪除和重建 JSONCOLS 類型一個表中只允許一個 JSONCOLS 類型存在不能在 JSONCOLS 類型中定義約束或預設值 1.4 JSONCOLS 類型執行許可權及特點 JSONCOLS 類型的安全模組類似于普通欄位, 在 JSONCOLS 欄位上執行 DML 語句時, 要求您具備和 JSONCOLS 欄位相應的許可權當對 JSONCOLS 欄位的資料執行操作時, 需要使用單個動態欄位的名稱, 或者參照 JSONCOLS 類型的名稱以及使用 JSONCOLS 類型的 JSON 運算式來指定 JSONCOLS 類型的值動態欄位能夠以任何順序顯示在 JSONCOLS 欄位中因為 DBMaker 是以內部方式來存儲 JSONCOLS 欄位的資料, 因此在查詢時, 動態欄位的顯示順序可能與其插入順序不同 Copyright CASEMaker Inc. 2

5 1.5 操作 JSONCOLS 類型例 [6-2]: 創建一個帶有 JSONCOLS 類型的表 dmsql> CREATE TABLE student(name CHAR(30), info JSONCOLS); 或 dmsql> CREATE TABLE student(name CHAR(30)); dmsql> ALTER TABLE student ADD COLUMN info JSONCOLS; 例 [6-3]: 使用 JSONCOLS 類型的名稱將資料插入表 student dmsql> Insert into student values('wang','{"id":"1001","phone":" "} '); 注意 : 當您使用參數將資料插入動態欄位或更新動態欄位的資料時,DBMaker 僅支援插入 VARCHAR 類型的資料, 此時, 您可以使用隱式資料轉換功能, 插入其他類型的資料例 [6-4]: 使用 SELECT * 命令查詢表 student dmsql> set blobwidth 100; dmsql> SELECT * FROM student; 或 dmsql> SELECT name, info FROM student; NAME INFO ============= ====== =========== =========== Wang {"ID":"1001","PHONE":" "} 例 [6-5]: 使用 JSONCOLS 類型的名稱更新表 student 的資料 dmsql> UPDATE student SET info = '{"ID":1002, "PHONE":" "}' WHERE name='wang'; 1 rows updated 例 [6-6]: 使用 JSONCOLS 類型的名稱刪除表 student 的資料 dmsql> DELETE FROM student WHERE ID = 1002 ; 1 rows deleted 2. 使用動態欄位動態欄位用於存儲半結構化的資料記錄的屬性有數千種或資料類型經常更改的資料, 可以結合 JSONCOLS 類型使用動態欄位的安全模組類似于普通欄位, 其特徵如下所示 : 可以在動態欄位元元上創建索引動態欄位僅支援更改資料類型動態欄位支援如下資料類型 : SMALLINT INT FLOAT DOUBLE DATE TIME TIMESTAMP CHAR VARCHAR NCHAR NVARCHAR 動態欄位必須為可空的值動態欄位不能有預設值動態欄位不能有欄位約束動態欄位不能用於存儲命令 Copyright CASEMaker Inc. 3

6 動態欄位不能用於存儲過程動態欄位不能用於觸發器動態欄位創建後無需定義即可直接使用動態欄位的預設資料類型是 varchar(256) 2.1 ALTER TABLE ADD DYNAMIC COLUMN 命令該命令用來將動態欄位更改為其他資料類型此外, 當該動態欄位被插入到表時, 也可以使用該命令聲明動態欄位的資料類型例 [6-7]: 將名為 ID 的欄位的資料類型更改為 INT 類型 dmsql> ALTER TABLE student ADD DYNAMIC COLUMN ID INT; 注意 : 如果在插入資料時未執行 ALTER TABLE ADD DYNAMIC COLUMN 命令, 但是卻使用該命令聲明瞭動態欄位的資料類型, 之後又無法將之前插入的資料轉換為已聲明的資料類型時, 在查詢時該資料會表示為 NULL, 此時也不會報錯 2.2 ALTER TABLE MODIFY DYNAMIC COLUMN 命令該命令用來將將已聲明的資料類型更改為另一種資料類型例 [6-8]: 修改動態欄位 ID 的資料類型 dmsql> ALTER TABLE student MODIFY DYNAMIC COLUMN ID TYPE TO CHAR(100); 2.3 ALTER TABLE DROP DYNAMIC COLUMN 命令該命令用來刪除動態欄位的描述資訊例 [6-9]: 刪除動態欄位 ID 的描述資訊 dmsql> ALTER TABLE student DROP DYNAMIC COLUMN ID; 2.4 動態欄位上創建索引例 [6-10]: 在 JSONCOLS 類型欄位 ID 上創建索引 dmsql>create INDEX idx1 ON student(id); 例 [6-11]: 在 JSONCOLS 類型欄位 info 上創建文本索引 dmsql> CREATE TEXT INDEX idx_stu ON student(info); 2.5 動態欄位上創建視圖例 [6-12]: 刪除動態欄位 ID 的描述資訊 dmsql> CREATE VIEW v1 AS SELECT info FROM student; Copyright CASEMaker Inc. 4

7 2.6 動態欄位在應用程式中使用在應用程式中 JSON 運算式 {"ID":"1001","PHONE":" "} 應該將展開 info 列名展開, 類似普通 TYPE 的用法來使用例如創建 student 表,name,JSONCOLS info, 並插入一條資料 dmsql> CREATE TABLE student(name CHAR(30), info JSONCOLS); dmsql> Insert into student(name,info) values('wang','{"id":"1001","phone":" "} '); 當在應用程式中使用時, 需要將 info 列展開的方式來寫 dmsql> Insert into student (name,id,phone) values('wang',1001, ); or dmsql> Insert into student (name,id,phone) values('wang',?,?); dmsql/val>1001, ; dmsql/val>end; Copyright CASEMaker Inc. 5

动态字段介绍及使用

动态字段介绍及使用 DBMaker JSONCOLS Type Columns Author: DBMaster Support Team Production Team Publish Date: 5 16, 2017 目錄 JSONCOLS Type Columns 1. JSON 介紹... 1 1.1 優點... 1 1.2 為什麼 DBMaker 要支持 JSON... 1 2. JSONCOLS 類型和動態欄位的介紹...