Bill Bucher

The C# driver allows .Net developers to write applications that utilize Cassandra. The driver works exclusively with CQL3. The driver separates functionality between lower level API calls, such as connecting to a data store and executing queries and a LINQ2CQL layer, which is a&nbsp;<a href="http://msdn.microsoft.com/en-us/library/bb397926.aspx" title="LINQ">LINQ</a>&nbsp;driver.

Getting Started

Creating a new project that utilizes the drivers is simple. Add a project like normal, and add a reference to the driver. The packages are available through NuGet, making adding the package references even easier
<img alt="getting started" data-align="center" data-entity-type="file" data-entity-uuid="a7ffcc2b-e60f-4a11-8a5d-c03c89b93bd3" height="392" src="https://www.datastax.com/sites/default/files/inline-images/nuget_pkg_mgr_scn_ds-700x437.jpg" width="628" /><img alt="getting started" data-align="center" data-entity-type="file" data-entity-uuid="0b5562be-a90d-4c8f-88da-0ac9a5128266" src="https://www.datastax.com/sites/default/files/inline-images/vs_refs_with_ds_pkgs.jpg" />
One of the first things you will want to do in your project is connect to the Cassandra cluster. This is straightforward. You simply create a cluster object, and call it's Conntect() method:
<img alt="session object" data-align="center" data-entity-type="file" data-entity-uuid="852dcc2a-66bc-4f30-b90c-807a17a39d72" height="363" src="https://www.datastax.com/sites/default/files/inline-images/ex_connect_and_simple_execute-700x612.jpg" width="415" />
A Session object is returned from Connect(). This Session instance will be used to perform all operations against the Cassandra cluster. For example, let's say you want to add a Keyspace and a ColumnFamily. This would look something like this:
<img alt="add keyspace" data-align="center" data-entity-type="file" data-entity-uuid="d53add31-4b80-4823-a089-6fa6c45effb9" src="https://www.datastax.com/sites/default/files/inline-images/ex_create_ks_and_cf_1.jpg" />
The replication Dictionary in the above example contains all of the keyspace settings you want to specify at the time of creation. Leaving this off sets up a keyspace with default settings.
<img alt="keyspace" data-align="center" data-entity-type="file" data-entity-uuid="7d810af5-4ac6-4f39-b4a8-b95023aa398d" src="https://www.datastax.com/sites/default/files/inline-images/replication_dict_for_ks_create-1.jpg" />
Querying and Inserting Data

There are many ways to work with data using the C# driver. I'll briefly cover a few of them here. The most basic way to work with data is using inline CQL statements, and passing them to the to the Session's Execute() method, similar to the following:
<img alt="simple insert" data-align="center" data-entity-type="file" data-entity-uuid="28a4231f-bcfd-458d-883c-577156d8fb15" src="https://www.datastax.com/sites/default/files/inline-images/ex_simple_insert-700x75.jpg" /><img alt="simple query method" data-align="center" data-entity-type="file" data-entity-uuid="75604782-0523-40cf-bcbc-1d2724a25160" src="https://www.datastax.com/sites/default/files/inline-images/ex_simple_query_method.jpg" />
In a similar fashion, you could craft a CQL SELECT statement to get data out of Cassandra.

Prepared Statements are another option for working with data. As you will see in the next example, values are not specified at the time of Statement creation, but rather, at the time of execution.
<img alt="ex prepared statement" data-align="center" data-entity-type="file" data-entity-uuid="8cc414c0-dd72-4177-8073-7547704d8df5" src="https://www.datastax.com/sites/default/files/inline-images/ex_prepared_statement1-700x48.jpg" />
The C# driver also exposes a batch job class for inserting many columns of data at a time. The following is an example of a running a batch job in single threaded mode:
<img alt="ex batch insert" data-align="center" data-entity-type="file" data-entity-uuid="ae0fa089-5ae4-4724-88e9-9d260c54e6ed" src="https://www.datastax.com/sites/default/files/inline-images/ex_batch_insert1-700x185.jpg" />
The LINQ2CQL Driver

The LINQ driver can be found in the Cassandra.Data.Linq namespace. It's rather extensive, and deserves a dedicated blog post to fully describe it's capabilities. In the meantime, see the following for an example application that uses the LINQ driver. The following is a simple example to help you get up and running with LINQ2CQL:
<img alt="blog post context" data-align="center" data-entity-type="file" data-entity-uuid="7fa738ba-5856-480a-adca-2c96cb344974" src="https://www.datastax.com/sites/default/files/inline-images/blog_post_context.jpg" /><img alt="ex LINQ" data-align="center" data-entity-type="file" data-entity-uuid="84cb1082-a8d2-4b15-8ab3-bba396bf8c57" src="https://www.datastax.com/sites/default/files/inline-images/ex_LINQ_1-700x127.jpg" />
 
 
 
&nbsp;

<hr />

Build and scale cloud native apps

Discover the benefits of DBaaS and why your apps deserve an upgrade.

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.

ViewingTechnical How To’s

An Introduction to the C# Driver for Cassandra

Sign up for our Developer Newsletter