Cassandra 查詢語言 (CQL) v3.4.3

有效的表格名稱與有效的 鍵空間名稱 相同 (長度最多 32 個字元的字母數字識別碼)。如果僅提供表格名稱，表格會在目前鍵空間中建立 (請參閱 USE)，但如果它是由現有鍵空間名稱為前綴 (請參閱 <tablename> 語法)，它會在指定的鍵空間中建立 (但不會變更目前鍵空間)。

CREATE TABLE 陳述定義表格列可以擁有的列。欄位由其名稱（識別碼）和類型定義（有關允許類型及其屬性的更多詳細資料，請參閱 資料類型 區段）。

在表格中，列會由其 PRIMARY KEY（或更簡單地說，就是金鑰）唯一識別，因此所有表格定義必須定義 PRIMARY KEY（且只有一個）。PRIMARY KEY 由表格中定義的一個或多個欄位組成。如果 PRIMARY KEY 僅有一個欄位，則可以在欄位定義後直接指定。否則，必須在 PRIMARY KEY 後面加上括號中由逗號分隔的組成金鑰的欄位名稱清單來指定。請注意

bc(sample).
CREATE TABLE t (
k int PRIMARY KEY,
other text
)

等於

bc(sample).
CREATE TABLE t (
k int,
other text,
PRIMARY KEY (k)
)

在 CQL 中，為 PRIMARY KEY 定義欄位的順序很重要。金鑰的第一個欄位稱為分區金鑰。它具有以下屬性：所有共用相同分區金鑰的列（事實上甚至跨表格）都儲存在同一個實體節點上。此外，針對共用特定表格的相同分區金鑰的列進行的插入/更新/刪除會以原子和隔離方式執行。請注意，可以擁有複合分區金鑰，也就是使用一組額外的括號來定義哪些欄位組成分區金鑰，以形成由多個欄位組成的分區金鑰。

PRIMARY KEY 定義的其餘欄位（如果有）稱為__叢集欄位。在特定實體節點上，特定分區金鑰的列會按照叢集欄位產生的順序儲存，讓以該叢集順序擷取列特別有效率（請參閱 SELECT）。

在表格定義中，有些欄位可以宣告為 STATIC。靜態欄位將會由屬於相同分區（擁有相同分區金鑰）的所有列``共用''。例如，在

bc(sample).
CREATE TABLE test (
pk int,
t int,
v text,
s text static,
PRIMARY KEY (pk, t)
);
INSERT INTO test(pk, t, v, s) VALUES (0, 0, `val0', `static0');
INSERT INTO test(pk, t, v, s) VALUES (0, 1, `val1', `static1');
SELECT * FROM test WHERE pk=0 AND t=0;

最後的查詢會傳回 `'static1'` 作為 `s` 的值，因為 `s` 是靜態的，因此第二次插入修改了這個 `'shared'` 值。不過請注意，靜態欄位只在給定的分割區內是靜態的，如果在上面的範例中兩列來自不同的分割區（也就是說，如果它們有不同的 `pk` 值），第二次插入就不會修改第一列的 `s` 值。

允許靜態欄位時會套用一些限制

CREATE TABLE 陳述式支援許多選項，用於控制新表格的組態。這些選項可以在 WITH 關鍵字之後指定。

這些選項的第一個是 COMPACT STORAGE。此選項主要針對在 CQL3 之前建立的定義的向後相容性（有關更多詳細資料，請參閱 www.datastax.com/dev/blog/thrift-to-cql3）。此選項也提供稍微更精簡的資料磁碟配置，但代價是降低表格的彈性和可擴充性。最值得注意的是，COMPACT STORAGE 表格不能有集合或靜態欄位，而且有至少一個叢集欄位的 COMPACT STORAGE 表格支援的欄位正好是一個（表示不是 0 或大於 1）不屬於 PRIMARY KEY 定義的欄位（特別表示您不能在建立後新增或移除欄位）。由於這些原因，除了上述的向後相容性原因之外，不建議使用 COMPACT STORAGE。

另一個選項是 CLUSTERING ORDER。它允許定義磁碟上列的順序。它會取得叢集欄位名稱的清單，以及每個欄位的磁碟順序（遞增或遞減）。請注意，此選項會影響 在 SELECT 期間允許哪些 ORDER BY。

表格建立支援以下其他 <property>

compaction 屬性至少必須定義 'class' 子選項，該子選項定義要使用的壓縮策略類別。預設支援的類別為 'SizeTieredCompactionStrategy'、'LeveledCompactionStrategy' 和 'TimeWindowCompactionStrategy'。可以透過指定完整類別名稱作為字串常數來提供自訂策略。其餘子選項取決於所選的類別。預設類別支援的子選項為

語法

bc(syntax)..
::= ALTER (TABLE | COLUMNFAMILY) (IF EXISTS)?

::= ADD (IF NOT EXISTS)?
| ADD (IF NOT EXISTS)? ( ( , )* )
| DROP (IF EXISTS)?
| DROP (IF EXISTS)? ( ( , )* )
| RENAME (IF EXISTS)? TO (AND TO)*
| WITH ( AND )*
p.
範例

bc(sample)..
ALTER TABLE addamsFamily

ALTER TABLE addamsFamily
ADD gravesite varchar;

ALTER TABLE addamsFamily
WITH comment = 最優秀且有用的欄位家族';
p.
`ALTER` 陳述式用於控制資料表定義。它允許新增新欄位、刪除現有欄位或更新資料表選項。與資料表建立一樣，`ALTER COLUMNFAMILY` 被允許作為 `ALTER TABLE` 的別名。如果資料表不存在，則陳述式會傳回錯誤，除非使用 `IF EXISTS`，這種情況下作業為空操作。

::=
| (' (,' )* )'
| IN `(' ( ( `,' )* )? `)'
| IN
| `(' (,' )* `)' IN `(' ( ( `,' )* )? `)'
| `(' (,' )* `)' IN

::= `=' | `<' | `>' | `⇐' | `>='
::= ( | `(' ( ( `,' )* )? `)')

::= ( | `!=')
| CONTAINS (KEY)?
| IN
| `[' `]' ( | `!=')
| `[' `]' IN
| `.' ( | `!=')
| `.' IN

範例

bc(sample)..
DELETE FROM NerdMovies USING TIMESTAMP 1240003134 WHERE movie = `Serenity';

DELETE phone FROM Users WHERE userid IN (C73DE1D3-AF08-40F3-B124-3FF3E5109F22, B70DE1D0-9908-4AE3-BE34-5573E5B09F14);
p.
DELETE 敘述會刪除欄位和列。如果在 DELETE 關鍵字後直接提供欄位名稱，則僅會從 <where-clause> 指出的列中刪除這些欄位。<selection> 中的 id[value] 語法適用於非凍結的集合（請參閱 集合區段 以取得更多詳細資料）。id.field 語法適用於刪除非凍結的使用者定義類型。否則，會移除整列。<where-clause> 指定要刪除哪些列。可以使用 IN 子句使用一個敘述刪除多列。可以使用不等於運算子（例如 >=）刪除一連串列。

DELETE 支援 TIMESTAMP 選項，其語意與 UPDATE 敘述相同。

在 DELETE 敘述中，同一個分割鍵中的所有刪除動作會以原子方式和獨立方式套用。

DELETE 作業可以使用 IF 子句進行條件設定，類似於 UPDATE 和 INSERT 敘述。不過，與 INSERT 和 UPDATE 敘述一樣，這會產生不可忽略的效能成本（在內部，會使用 Paxos），因此應謹慎使用。

語法

bc(syntax)..
::= BEGIN ( UNLOGGED | COUNTER ) BATCH
( USING ( AND )* )?
( `;' )*
APPLY BATCH

::=
|
|

::= TIMESTAMP
p.
範例

bc(sample).
BEGIN BATCH
INSERT INTO users (userid, password, name) VALUES (`user2', `ch@ngem3b', `second user');
UPDATE users SET password = `ps22dhds' WHERE userid = `user3';
INSERT INTO users (userid, password) VALUES (`user4', `ch@ngem3c');
DELETE name FROM users WHERE userid = `user1';
APPLY BATCH;

BATCH 敘述會將多個修改敘述（插入/更新和刪除）群組成一個單一敘述。它有幾個目的

請注意

語法

bc(syntax)..
::= SELECT ( JSON )?
FROM
( WHERE )?
( GROUP BY )?
( ORDER BY )?
( PER PARTITION LIMIT )?
( LIMIT )?
( ALLOW FILTERING )?

::= DISTINCT?

::= (AS )? ( `,' (AS )? )*
| `*'

::=
|
| WRITETIME (' `)'
| MAXWRITETIME `(' `)'
| COUNT `(' `' `)'
| TTL `(' `)'
| CAST `(' AS `)'
| `(' ( (,' ))? `)'
| `.'
| `[' `]'
| `[' ? .. ? `]'

::= ( AND )*

::=
| (' (,' )* )'
| IN `(' ( ( `,' )* )? `)'
| `(' (,' )* `)' IN `(' ( ( `,' )* )? `)'
| TOKEN `(' ( `,' )* `)'

::= =' | `<' | `>' | `⇐' | `>=' | CONTAINS | CONTAINS KEY
::= (,' )*
::= ( ,' )*
::= ( ASC | DESC )?
::= `(' (,' )* `)'
p.
範例

bc(sample)..
SELECT name, occupation FROM users WHERE userid IN (199, 200, 207);

SELECT JSON name, occupation FROM users WHERE userid = 199;

SELECT name AS user_name, occupation AS user_occupation FROM users;

SELECT time, value
FROM events
WHERE event_type = `myEvent'
AND time > `2011-02-03'
AND time ⇐ `2012-01-01'

SELECT COUNT (*) FROM users;

SELECT COUNT (*) AS user_count FROM users;

SELECT 陳述式會讀取資料表中一或多列的一或多列。它會傳回列的結果集，其中每一列都包含與查詢相符的欄位集合。如果使用了 JSON 關鍵字，每一列的結果只會包含一個名為 `json'' 的欄位。請參閱 `SELECT JSON 章節以取得更多詳細資料。

語法

bc(syntax)..
::= 建立角色 ( 如果不存在 )? ( 使用 ( 且 )* )?

::= 密碼 =
| 登入 =
| 超級使用者 =
| 選項 =
p.

範例

bc(sample).
建立角色 new_role；
建立角色 alice 使用密碼 = `password_a' 且登入 = true；
建立角色 bob，密碼為 `password_b'，並具有登入權限和超級使用者權限。
建立角色 carlos，選項為 \{ `custom_option1' : `option1_value', `custom_option2' : 99 };

預設情況下，角色不具有 LOGIN 權限或 SUPERUSER 狀態。

權限會授予角色對資料庫資源的存取權，資源類型包括鍵空間、表格、函數和角色本身。角色可以授予其他角色，以建立階層式權限結構；在這些階層中，權限和 SUPERUSER 狀態會被繼承，但 LOGIN 權限不會。

如果角色具有 LOGIN 權限，用戶端在連線時可以識別為該角色。在該連線期間，用戶端將取得授予該角色的所有角色和權限。

只有具有資料庫角色資源 CREATE 權限的用戶端可以發出 CREATE ROLE 要求（請參閱以下 相關部分），除非該用戶端是 SUPERUSER。Cassandra 中的角色管理是可插入的，自訂實作可能只支援列出的選項的一部分。

如果角色名稱包含非字母數字字元，則應加上引號。

語法

bc(syntax)..
::= ALTER ROLE (IF EXISTS)? ( WITH ( AND )* )?

::= 密碼 =
| 登入 =
| 超級使用者 =
| 選項 =
p.

範例

bc(sample).
ALTER ROLE bob，密碼為 `PASSWORD_B'，且超級使用者為 false；

如果角色不存在，該陳述式將傳回錯誤，除非使用 IF EXISTS，在這種情況下，操作為 no-op。

執行 ALTER ROLE 陳述式的條件

語法

bc(syntax)..
::= DROP ROLE ( IF EXISTS )?
p.

範例

bc(sample).
DROP ROLE alice;
DROP ROLE IF EXISTS bob;

DROP ROLE 要求用戶端對相關角色擁有 DROP 權限。此外，用戶端無法 DROP 登入時識別的角色。最後，只有擁有 SUPERUSER 狀態的用戶端才能 DROP 另一個 SUPERUSER 角色。
嘗試刪除不存在的角色會導致無效的查詢條件，除非使用 IF EXISTS 選項。如果使用該選項且角色不存在，則陳述式為 no-op。

語法

bc(syntax).
::= GRANT TO

範例

bc(sample).
GRANT report_writer TO alice;

此陳述式會將 report_writer 角色授與 alice。授與 report_writer 的任何權限也會由 alice 取得。
角色會模擬為有向非循環圖，因此不允許循環授與。下列範例會導致錯誤條件

bc(sample).
GRANT role_a TO role_b;
GRANT role_b TO role_a;

bc(sample).
GRANT role_a TO role_b;
GRANT role_b TO role_c;
GRANT role_c TO role_a;

語法

bc(syntax).
::= REVOKE FROM

範例

bc(sample).
REVOKE report_writer FROM alice;

此陳述式會從 alice 撤銷 report_writer 角色。alice 透過 report_writer 角色取得的任何權限也會被撤銷。

在 Cassandra 2.2 中導入角色之前，驗證和授權是基於 USER 概念。為了向後相容性，已保留舊語法，而以 USER 為中心的陳述式已成為以 ROLE 為基礎的等義詞。

語法

bc(syntax)..
::= CREATE USER ( IF NOT EXISTS )? ( WITH PASSWORD )? ()?

::= SUPERUSER
| NOSUPERUSER
p.

範例

bc(sample).
建立使用者 alice 密碼為 `password_a` SUPERUSER;
建立使用者 bob 密碼為 `password_b` NOSUPERUSER;

建立使用者 等同於 建立角色，其中 登入 選項為 true。因此，以下成對的陳述式等同

bc(sample)..
建立使用者 alice 密碼為 `password_a` SUPERUSER;
建立角色 alice 密碼為 `password_a` 並登入為 true 且 SUPERUSER 為 true;

建立使用者 alice 密碼為 `password_a` SUPERUSER 如果不存在;
建立角色 alice 密碼為 `password_a` 並登入為 true 且 SUPERUSER 為 true 如果不存在;

建立使用者 alice 密碼為 `password_a` NOSUPERUSER;
建立角色 alice 密碼為 `password_a` 並登入為 true 且 SUPERUSER 為 false;

建立使用者 alice 密碼為 `password_a` NOSUPERUSER;
建立角色 alice 使用密碼 = `password_a' 且登入 = true；

建立使用者 alice 密碼為 `password_a`;
建立角色 alice 使用密碼 = `password_a' 且登入 = true；
p.

語法

bc(syntax)..
::= 變更使用者 (如果存在)? (使用密碼)? ( )?

::= SUPERUSER
| NOSUPERUSER
p.

bc(sample).
變更使用者 alice 密碼為 `PASSWORD_A`;
變更使用者 bob SUPERUSER;

如果使用者不存在，陳述式將傳回錯誤，除非使用 如果存在，在這種情況下，操作為無操作。

語法

bc(syntax)..
::= 刪除使用者 (如果存在)?
p.

範例

bc(sample).
刪除使用者 alice;
刪除使用者 bob 如果存在;

語法

bc(syntax).
::= 列出使用者;

範例

bc(sample).
列出使用者;

此陳述式等同於

bc(sample).
LIST ROLES;

但只有具有 登入 權限的角色會包含在輸出中。

語法

bc(syntax)..
::= 新增身分 (如果不存在)? 至角色 ?

範例

bc(sample).
新增身分 'id1' 至角色 'role1';

只有具有新增角色權限的使用者才能新增身分

如果角色名稱和身分名稱包含非字母數字字元，則應加上引號。

語法

bc(syntax)..
::= DROP IDENTITY ( IF EXISTS )?
p.

範例

bc(sample).
刪除身分識別碼「testIdentity」。
如果身分識別碼「testIdentity」存在，請刪除。

只有擁有刪除角色權限的使用者才能移除身分識別碼

嘗試刪除不存在的身分識別碼會導致無效的查詢條件，除非使用 IF EXISTS 選項。如果使用此選項且身分識別碼不存在，則此陳述式為無作用。

資源上的權限授予角色；Cassandra 中有數種不同類型的資源，且每種類型都以階層方式建模

可以在這些階層的任何層級授予權限，且權限會向下傳遞。因此，在鏈中的較高層級資源上授予權限會自動在較低層級的所有資源上授予相同的權限。例如，在 KEYSPACE 上授予 SELECT 權限會自動在該 KEYSPACE 中的所有 TABLES 上授予 SELECT 權限。同樣地，在 ALL FUNCTIONS 上授予權限會在每個已定義的函數上授予權限，無論其作用範圍在於哪個鍵空間。也可以在特定鍵空間的作用範圍內授予所有函數權限。

現有客戶端工作階段可見權限修改；換句話說，在權限變更後不需要重新建立連線。

可用的完整權限組為

並非所有權限都適用於每種類型的資源。例如，EXECUTE 僅與函數或 mbean 相關；授予 EXECUTE 在表示表格的資源上是沒有意義的。嘗試對無法套用的資源GRANT 權限會導致錯誤回應。以下說明哪些權限可以授予哪些類型的資源，以及哪些陳述是由該權限啟用的。

語法

bc(syntax)..
::= 授予 ( 所有 ( 權限 )? | ( 權限 )? ) 給

::= 建立 | 變更 | 刪除 | 選取 | 修改 | 授權 | 描述 | 取消遮罩 | 選取遮罩執行

::= 所有鍵空間
| 鍵空間
| ( 表格 )?
| 所有角色
| 角色
| 所有函數 ( 在鍵空間中 )?
| 函數
| 所有 MBean
| ( MBean | MBean )
p.

範例

bc(sample).
授予 data_reader 所有鍵空間的 SELECT 權限；

這會讓具有 data_reader 角色的任何使用者都能對所有鍵空間中的任何表格執行 SELECT 陳述式

bc(sample).
授予 data_writer 鍵空間 keyspace1 的 MODIFY 權限；

這會讓具有 data_writer 角色的任何使用者都能對 keyspace1 鍵空間中的所有表格執行 UPDATE、INSERT、UPDATE、DELETE 和 TRUNCATE 查詢

bc(sample).
授予 schema_owner keyspace1.table1 的 DROP 權限；

這會讓具有 schema_owner 角色的任何使用者都能 DROP keyspace1.table1。

bc(sample).
授予 report_writer 函數 keyspace1.user_function( int ) 的 EXECUTE 權限；

這會讓具有 report_writer 角色的任何使用者都能執行使用函數 keyspace1.user_function( int ) 的 SELECT、INSERT 和 UPDATE 查詢

bc(sample).
授予 role_admin 所有角色的 DESCRIBE 權限；

這會讓具有 role_admin 角色的任何使用者都能使用 LIST ROLES 陳述式檢視系統中的任何和所有角色

語法

bc(syntax)..
::= 撤銷 ( 所有 ( 權限 )? | ( 權限 )? ) 給

::= 建立 | 變更 | 刪除 | 選取 | 修改 | 授權 | 描述 | 取消遮罩 | 選取遮罩執行

::= 所有鍵空間
| 鍵空間
| ( 表格 )?
| 所有角色
| 角色
| 所有函數 ( 在鍵空間中 )?
| 函數
| 所有 MBean
| ( MBean | MBean )
p.

範例

bc(sample)..
撤銷 data_reader 所有鍵空間的 SELECT 權限；
撤銷 data_writer 鍵空間 keyspace1 的 MODIFY 權限；
撤銷 schema_owner keyspace1.table1 的 DROP 權限；
撤銷 report_writer 函數 keyspace1.user_function( int ) 的 EXECUTE 權限；
撤銷 role_admin 所有角色的 DESCRIBE 權限；
p.

timestamp 類型的值編碼為 64 位元有號整數，表示自稱為「紀元」的標準基準時間（1970 年 1 月 1 日格林威治時間 00:00:00）以來的毫秒數。

時間戳記可以在 CQL 中輸入為簡單的長整數，提供自上述定義的紀元以來的毫秒數。

它們也可以輸入為下列任何 ISO 8601 格式的字串文字，每個格式都表示格林威治時間 2011 年 3 月 2 日上午 04:05:00 的時間和日期。

上面的 +0000 是 RFC 822 4 位元時間區域規格；+0000 指的是格林威治標準時間。美國太平洋標準時間是 -0800。如果需要，可以省略時間區域，日期會被解釋為協調的 Cassandra 節點所設定的時間區域。

不過，依賴預期的時間區域設定有明顯的困難，因此建議在可行的情況下，始終為時間戳指定時間區域。

如果日期是唯一重要的部分，也可以省略時間。

在這種情況下，時間會預設為 00:00:00，在指定或預設的時間區域中。

date 類型的值編碼為 32 位元無符號整數，代表以「基準時間」為範圍中心的日期數目 (2^31)。基準時間是 1970 年 1 月 1 日。

可以在 CQL 中輸入日期，格式為如上所定義的無符號整數。

也可以使用下列格式輸入字串字面值

time 類型的值編碼為 64 位元有符號整數，代表自午夜以來的奈秒數。

可以在 CQL 中輸入時間，格式為簡單的長整數，提供自午夜以來的奈秒數。

也可以使用下列任何格式輸入字串字面值

counter 類型用於定義計數器欄位。計數器欄位是一個欄位，其值為 64 位元有符號整數，並且支援 2 個運算：增量和減量 (語法請參閱 UPDATE)。請注意，無法設定計數器的值。計數器在第一次增量/減量之前不存在，而第一次增量/減量會視為先前的值為 0。支援刪除計數器欄位，但有一些限制 (更多資訊請參閱 Cassandra Wiki)。

計數器類型的使用受到下列限制

向量是特定資料類型中非 Null 值的固定大小順序。它們使用與清單相同的文字。

您可以使用下列方式定義、插入和更新向量

請注意，無法變更向量的個別值，也無法選取向量的個別元素。

cast 函式可用於將一種原生資料類型轉換為另一種原生資料類型。

下表說明 cast 函式支援的轉換。Cassandra 會自動忽略將資料類型轉換為其自身資料類型的任何轉換。

轉換嚴格依賴於 Java 的語意。例如，雙精度值 1 將轉換為文字值 `1.0'。

bc(sample).
SELECT avg(cast(count as double)) FROM myTable

token 函數允許計算給定分區金鑰的 token。token 函數的確切簽章取決於相關的表格和叢集使用的分區器。

token 的參數類型取決於分區金鑰欄的類型。回傳類型取決於使用的分區器

例如，在使用預設 Murmur3Partitioner 的叢集中，如果表格由下述定義

bc(sample).
CREATE TABLE users (
userid text PRIMARY KEY,
username text,
…
)

則 token 函數將採用單一 text 類型的參數（在這種情況下，分區金鑰為 userid（沒有叢集欄，因此分區金鑰與主金鑰相同）），且回傳類型將為 bigint。

uuid 函數不採用參數，並產生適用於 INSERT 或 SET 陳述式的隨機類型 4 uuid。

提供許多函數將 `timeuuid'' 轉換為 `timestamp 或 `date`，或 `date` 轉換為其他 `原生` 類型。

提供許多函數將原生類型轉換為二進位資料（blob）。對於 CQL3 支援的每一個 <原生類型> 類型（顯著的例外是 blob，原因很明顯），type_as_blob 函數會取得 類型 類型的參數，並將其傳回為 blob。反之，blob_as_type 函數會取得 64 位元 blob 參數，並將其轉換為 bigint 值。因此，例如，bigint_as_blob(3) 為 0x0000000000000003，而 blob_as_bigint(0x0000000000000003) 為 3。

count 函數可用於計數查詢傳回的列。範例

bc(sample).
SELECT COUNT (*) FROM plays;
SELECT COUNT (1) FROM plays;

它也可以用於計數指定欄位的非 Null 值。範例

bc(sample).
SELECT COUNT (scores) FROM plays;

max 和 min 函數可用於計算查詢傳回的指定欄位的最大值和最小值。

bc(sample).
SELECT MIN (players), MAX (players) FROM plays WHERE game = `quake';

sum 函數可用於將查詢傳回的指定欄位的全部值加總。

bc(sample).
SELECT SUM (players) FROM plays;

avg 函數可用於計算查詢傳回的指定欄位的全部值的平均值。

bc(sample).
SELECT AVG (players) FROM plays;

對於 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'' 的表，您會執行下列動作

bc(sample).
INSERT INTO mytable JSON `\{\''myKey\'': 0, ``value'': 0}'

任何從 JSON 對應中省略的欄位將預設為 NULL 值（這將導致建立墓碑）。

在可能的情況下，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 陳述式的選取子句中。