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」という2つの列を持つテーブルに挿入するには、次の操作を行います。

デフォルト（または DEFAULT NULL が明示的に使用されている場合）、JSON マップから省略された列は NULL に設定されます。つまり、その列の既存の値は削除されます（墓石が作成されます）。または、値の後に DEFAULT UNSET ディレクティブを使用すると、省略された列の値は設定されません。つまり、それらの列の既存の値は保持されます。

可能な限り、Cassandra はネイティブ JSON 表現でデータ型を表し、受け入れます。Cassandra は、すべての単一フィールド型の CQL リテラル形式と一致する文字列表現も受け入れます。たとえば、浮動小数点数、整数、UUID、日付は、CQL リテラル文字列で表すことができます。ただし、コレクション、タプル、ユーザー定義型などの複合型は、ネイティブ JSON コレクション（マップとリスト）またはコレクションの JSON エンコードされた文字列表現で表す必要があります。

次の表は、Cassandra が INSERT JSON 値（および from_json() 引数）で受け入れるエンコーディングと、SELECT JSON ステートメント（および from_json()）のデータの返却時に Cassandra が使用する形式について説明しています。

from_json() 関数は、INSERT JSON と同様に使用できますが、単一の列値に対して使用します。INSERT ステートメントの VALUES 節、または UPDATE、DELETE、SELECT ステートメントの列値のいずれかとしてのみ使用できます。たとえば、SELECT ステートメントの選択句では使用できません。

to_json() 関数は、SELECT JSON と同様に使用できますが、単一の列値に対して使用します。SELECT ステートメントの選択句でのみ使用できます。