JSON 支援

在 SELECT 陳述式中，JSON 關鍵字用於將每一列傳回為單一 JSON 編碼的對應。其餘 SELECT 陳述式行為相同。

結果對應鍵與一般結果集中的欄位名稱相符。例如，類似 SELECT JSON a, ttl(b) FROM …​ 的陳述式會產生一個包含鍵 "a" 和 "ttl(b)" 的對應。不過，有一個值得注意的例外：為了與 INSERT JSON 行為對稱，包含大寫字母的大小寫敏感欄位名稱會加上雙引號。例如，SELECT JSON myColumn FROM …​ 會產生一個包含轉義引號的對應鍵 "\"myColumn\""。

對應值會是結果集值的 JSON 編碼表示（如下所述）。

在 INSERT 陳述式中，新的 JSON 關鍵字可用於啟用將 JSON 編碼的對應插入為單一列。JSON 對應的格式通常應與在同一表格上執行 SELECT JSON 陳述式所傳回的格式相符。特別是，大小寫敏感欄位名稱應加上雙引號。例如，要插入到兩個欄位名稱為「myKey」和「value」的表格中，您可以執行下列動作

預設情況下（或如果明確使用 DEFAULT NULL），從 JSON 對應中省略的欄位會設為 NULL，表示會移除該欄位的任何預先存在的數值（導致產生墓碑）。或者，如果在數值後使用 DEFAULT UNSET 指令，省略的欄位值會保持未設定，表示會保留這些欄位的預先存在數值。

Cassandra 會在可能的情況下以其原生 JSON 呈現方式呈現和接受資料類型。Cassandra 也會接受與 CQL 文字格式相符的字串呈現方式，適用於所有單一欄位類型。例如，浮點數、整數、UUID 和日期可以用 CQL 文字字串呈現。不過，複合類型（例如集合、組和使用者定義類型）必須以原生 JSON 集合（對應和清單）或集合的 JSON 編碼字串呈現方式呈現。

下表說明 Cassandra 會在 INSERT JSON 值（和 from_json() 參數）中接受的編碼，以及 Cassandra 在傳回 SELECT JSON 陳述式（和 from_json()）資料時會使用的格式

from_json() 函數的使用方式可能與 INSERT JSON 類似，但適用於單一欄位值。它只能用於 INSERT 陳述式的 VALUES 子句，或用於 UPDATE、DELETE 或 SELECT 陳述式中的其中一個欄位值。例如，它不能用於 SELECT 陳述式的選擇子句中。

to_json() 函數的使用方式可能與 SELECT JSON 類似，但適用於單一欄位值。它只能用於 SELECT 陳述式的選擇子句中。