Berenguer Blasi

<p>JSON is a popular format. This post provides information on easy ways to use JSON with DSE Search.</p>

<p>Some approaches to using JSON with DSE Search use FIT (Field Input Transformers) and other complex methods. These methods are valid, but there are easier ways of doing things which cover most cases. This demo uses DSE 5.0.3. Let’s see an example:</p>

<h2>Set-up for the demo</h2>

<p>&nbsp;</p>

<p>1. Start by creating a CQL table:</p>

<table border="0" cellpadding="0" cellspacing="0">
	<tbody>
		<tr>
			<td>
			<p><code>CREATE</code> <code>KEYSPACE jsondemo </code><code>WITH</code> <code>REPLICATION = { </code><code>'class'</code> <code>: </code><code>'SimpleStrategy'</code><code>, </code><code>'replication_factor'</code> <code>: 1 };</code></p>

			<p>&nbsp;</p>

			<p><code>USE jsondemo;</code></p>

			<p>&nbsp;</p>

			<p><code>create</code> <code>type jsondemo.trip (</code></p>

			<p><code>origin text,</code></p>

			<p><code>dest text,</code></p>

			<p><code>);</code></p>

			<p>&nbsp;</p>

			<p><code>create</code> <code>table</code> <code>jsondemo.holidays (</code></p>

			<p><code>&nbsp;&nbsp;</code><code>"id"</code> <code>VARCHAR</code> <code>PRIMARY</code> <code>KEY</code><code>,</code></p>

			<p><code>&nbsp;&nbsp;</code><code>"title"</code> <code>TEXT,</code></p>

			<p><code>&nbsp;&nbsp;</code><code>"season"</code> <code>TEXT,</code></p>

			<p><code>&nbsp;&nbsp;</code><code>"date"</code> <code>date</code><code>,</code></p>

			<p><code>&nbsp;&nbsp;</code><code>"trips"</code> <code>list&lt;frozen&lt;trip&gt;&gt;);</code></p>
			</td>
		</tr>
	</tbody>
</table>

<p>&nbsp;</p>

<p>&nbsp;</p>

<p>2. Now create a DSE Search core against that table</p>

<table border="0" cellpadding="0" cellspacing="0">
	<tbody>
		<tr>
			<td>
			<p><code>dsetool create_core jsondemo.holidays generateResources=true</code></p>
			</td>
		</tr>
	</tbody>
</table>

<p>&nbsp;</p>

<p>&nbsp;</p>

<h2>Inserting JSON</h2>

<p>A. Simple JSON String: Notice how we can feed our JSON directly to Apache Cassandra™ and DSE picks it up and indexes it. No need to do any preprocessing or exploding of the JSON string</p>

<table border="0" cellpadding="0" cellspacing="0">
	<tbody>
		<tr>
			<td>
			<p><code>cqlsh&gt; </code><code>insert</code> <code>into</code> <code>jsondemo.holidays JSON </code><code>'{"id":"1", "title":"First holiday ever", "season": "Xmas"}'</code><code>;</code></p>

			<p><code>cqlsh&gt; </code><code>select</code> <code>* </code><code>from</code> <code>jsondemo.holidays </code><code>where</code> <code>solr_query=</code><code>'*:*'</code><code>;</code></p>

			<p>&nbsp;</p>

			<p><code>&nbsp;</code><code>id | </code><code>date</code> <code>| season | solr_query | title&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | trips</code></p>

			<p><code>----+------+--------+------------+--------------------+-------</code></p>

			<p><code>&nbsp;&nbsp;</code><code>1 | </code><code>null</code> <code>|&nbsp;&nbsp; Xmas |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </code><code>null</code> <code>| </code><code>First</code> <code>holiday ever |&nbsp; </code><code>null</code></p>

			<p>&nbsp;</p>

			<p><code>(1 </code><code>rows</code><code>)</code></p>
			</td>
		</tr>
	</tbody>
</table>

<p>&nbsp;</p>

<p>&nbsp;</p>

<p>B. Tuple JSON-like approach: When working with a Tuple or a UDT you can insert them with a JSON-like approach and keep the rest of the fields like in standard CQL statements. This approach is useful when the rest of the row fields, besides Tuple/UDTs, are not available in JSON.</p>

<table border="0" cellpadding="0" cellspacing="0">
	<tbody>
		<tr>
			<td>
			<p><code>cqlsh&gt; </code><code>insert</code> <code>into</code> <code>jsondemo.holidays (id, title, season, trips) </code><code>values</code> <code>(</code><code>'2'</code><code>, </code><code>'Week in Barcelona'</code><code>, </code><code>'Easter'</code><code>, [{origin: </code><code>'London'</code><code>, dest:</code><code>'Barcelona'</code><code>}, {origin: </code><code>'Barcelona'</code><code>, dest:</code><code>'London'</code><code>}]);</code></p>

			<p><code>cqlsh&gt; </code><code>select</code> <code>* </code><code>from</code> <code>jsondemo.holidays </code><code>where</code> <code>solr_query=</code><code>'*:*'</code><code>;</code></p>

			<p>&nbsp;</p>

			<p><code>&nbsp;</code><code>id | </code><code>date</code> <code>| season | solr_query | title&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | trips</code></p>

			<p><code>----+------+--------+------------+--------------------+--------------------------------------------------------------------------------</code></p>

			<p><code>&nbsp;&nbsp;</code><code>1 | </code><code>null</code> <code>|&nbsp;&nbsp; Xmas |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </code><code>null</code> <code>| </code><code>First</code> <code>holiday ever |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </code><code>null</code></p>

			<p><code>&nbsp;&nbsp;</code><code>2 | </code><code>null</code> <code>| Easter |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </code><code>null</code> <code>|&nbsp; Week </code><code>in</code> <code>Barcelona | [{origin: </code><code>'London'</code><code>, dest: </code><code>'Barcelona'</code><code>}, {origin: </code><code>'Barcelona'</code><code>, dest: </code><code>'London'</code><code>}]</code></p>

			<p>&nbsp;</p>

			<p><code>(2 </code><code>rows</code><code>)</code></p>
			</td>
		</tr>
	</tbody>
</table>

<p>&nbsp;</p>

<p>&nbsp;</p>

<p>C. Full JSON: Tuple/UDTS can be inserted if all your fields are available as JSON.</p>

<table border="0" cellpadding="0" cellspacing="0">
	<tbody>
		<tr>
			<td>
			<p><code>cqlsh&gt; </code><code>insert</code> <code>into</code> <code>jsondemo.holidays JSON </code><code>'{"id":"3", "title":"Week in Miami", "season": "Summer holidays", "trips": [{"origin": "Barcelona", "dest": "Miami"}, {"origin": "Miami", "dest": "Barcelona"}]}'</code><code>;</code></p>

			<p><code>cqlsh&gt; </code><code>select</code> <code>* </code><code>from</code> <code>jsondemo.holidays </code><code>where</code> <code>solr_query=</code><code>'*:*'</code><code>;</code></p>

			<p>&nbsp;</p>

			<p><code>&nbsp;</code><code>id | </code><code>date</code> <code>| season&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | solr_query | title&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | trips</code></p>

			<p><code>----+------+-----------------+------------+--------------------+--------------------------------------------------------------------------------</code></p>

			<p><code>&nbsp;&nbsp;</code><code>1 | </code><code>null</code> <code>|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Xmas |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </code><code>null</code> <code>| </code><code>First</code> <code>holiday ever |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </code><code>null</code></p>

			<p><code>&nbsp;&nbsp;</code><code>2 | </code><code>null</code> <code>|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Easter |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </code><code>null</code> <code>|&nbsp; Week </code><code>in</code> <code>Barcelona | [{origin: </code><code>'London'</code><code>, dest: </code><code>'Barcelona'</code><code>}, {origin: </code><code>'Barcelona'</code><code>, dest: </code><code>'London'</code><code>}]</code></p>

			<p><code>&nbsp;&nbsp;</code><code>3 | </code><code>null</code> <code>| Summer holidays |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </code><code>null</code> <code>|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Week </code><code>in</code> <code>Miami |&nbsp;&nbsp; [{origin: </code><code>'Barcelona'</code><code>, dest: </code><code>'Miami'</code><code>}, {origin: </code><code>'Miami'</code><code>, dest: </code><code>'Barcelona'</code><code>}]</code></p>

			<p>&nbsp;</p>

			<p><code>(3 </code><code>rows</code><code>)</code></p>
			</td>
		</tr>
	</tbody>
</table>

<p>&nbsp;</p>

<p>&nbsp;</p>

<h2>Querying for JSON</h2>

<p>It is equally easy to get your results back as JSON.</p>

<table border="0" cellpadding="0" cellspacing="0">
	<tbody>
		<tr>
			<td>
			<p><code>cqlsh&gt; </code><code>select</code> <code>json * </code><code>from</code> <code>jsondemo.holidays </code><code>where</code> <code>solr_query=</code><code>'*:*'</code><code>;</code></p>

			<p>&nbsp;</p>

			<p><code>&nbsp;</code><code>[json]</code></p>

			<p><code>-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------</code></p>

			<p><code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{</code><code>"id"</code><code>: </code><code>"1"</code><code>, </code><code>"date"</code><code>: </code><code>null</code><code>, </code><code>"season"</code><code>: </code><code>"Xmas"</code><code>, </code><code>"solr_query"</code><code>: </code><code>null</code><code>, </code><code>"title"</code><code>: </code><code>"First holiday ever"</code><code>, </code><code>"trips"</code><code>: </code><code>null</code><code>}</code></p>

			<p><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>{</code><code>"id"</code><code>: </code><code>"2"</code><code>, </code><code>"date"</code><code>: </code><code>null</code><code>, </code><code>"season"</code><code>: </code><code>"Easter"</code><code>, </code><code>"solr_query"</code><code>: </code><code>null</code><code>, </code><code>"title"</code><code>: </code><code>"Week in Barcelona"</code><code>, </code><code>"trips"</code><code>: [{</code><code>"origin"</code><code>: </code><code>"London"</code><code>, </code><code>"dest"</code><code>: </code><code>"Barcelona"</code><code>}, {</code><code>"origin"</code><code>: </code><code>"Barcelona"</code><code>, </code><code>"dest"</code><code>: </code><code>"London"</code><code>}]}</code></p>

			<p><code>&nbsp;</code><code>{</code><code>"id"</code><code>: </code><code>"3"</code><code>, </code><code>"date"</code><code>: </code><code>null</code><code>, </code><code>"season"</code><code>: </code><code>"Summer holidays"</code><code>, </code><code>"solr_query"</code><code>: </code><code>null</code><code>, </code><code>"title"</code><code>: </code><code>"Week in Miami"</code><code>, </code><code>"trips"</code><code>: [{</code><code>"origin"</code><code>: </code><code>"Barcelona"</code><code>, </code><code>"dest"</code><code>: </code><code>"Miami"</code><code>}, {</code><code>"origin"</code><code>: </code><code>"Miami"</code><code>, </code><code>"dest"</code><code>: </code><code>"Barcelona"</code><code>}]}</code></p>

			<p>&nbsp;</p>

			<p><code>(3 </code><code>rows</code><code>)</code></p>
			</td>
		</tr>
	</tbody>
</table>

<p>&nbsp;</p>

<p>&nbsp;</p>

<h2>Conclusions</h2>

<p>There is no need to use FIT and other elaborate techniques to use JSON in DSE. Complex approaches like having a field holding the full JSON string, to be later exploded into individual fields so they are each indexed etc are not necessary. DSE provides out of the box functionality that supports JSON in most cases.</p>


Temporal Supercharges Developer Agility

Temporal powers high growth apps like Netflix and Instacart.

Learn about NoSQL Databases

Learn about NoSQL databases with Apache Cassandra and Astra DB.

2022 Recap: A Year for Customers, Community, and Real-Time Data

Highlights from 2022 and a glimpse into the year ahead.

ViewingCompany

JSON and DSE Search

Sign up for our Developer Newsletter