[](https://twitter.com/intent/tweet?text=%23RethinkDB %23reql driver for C%23 and .NET:&url=https%3A%2F%2Fgithub.com%2Fbchavez%2FRethinkDb.Driver)

RethinkDb.Driver

Project Description

A RethinkDB database driver written in C# with 100% ReQL API compatibility and completeness.

This driver is based on the official Java Driver. The basic mechanics and architecture of both drivers are the same. Except this C# driver is a bit more cool, stylish and kick-ass. 😎

Standout Features

• 1,200+ Unit Tests - This driver passes the same ReQL test harness as the official drivers.
• Awesome documentation.
• ReGrid Support - Distributed Large Binary Storage

Getting Help

Commercial Support

Independent commercial support and consulting are available for this community driver. To ensure best practices in .NET, proper driver usage, training, and critical bug fixes for the C# community driver contact Brian Chavez (twitter, email) for more information.

Community Support

Slack (http://slack.rethinkdb.com) is the primary means of getting help for free. If you don't receive the invite, check your spam folder. The #general channel has many RethinkDB users willing to help. If your C# related question can't be answered by anyone tag @bchavez in your question.

Download & Install

NuGet Package RethinkDb.Driver

Install-Package RethinkDb.Driver

Supported Runtimes

<th><img src='https://github.com/Turbo87/Font-Awesome/raw/platform-icons/svg/windows.png'/> Windows</th>

<th><img src='https://github.com/Turbo87/Font-Awesome/raw/platform-icons/svg/linux.png'> Linux</th>

<th><img src='https://github.com/Turbo87/Font-Awesome/raw/platform-icons/svg/apple.png'/> Mac OS X</th>

.NET Framework	v4.5	n/a	n/a
.NET Standard	All platforms supporting .NET Standard 1.3 or higher. Eg: .NET Core 1.0.
Mono	All platforms 4.0.2 SR2 or higher
RethinkDB server 2.3.0 or higher

Documentation

• Home
• Query Examples
• Logging
• Connections & Pooling
  • Single Connection
  • Round Robin Pooling
  • Epsilon Greedy Pooling
• Extra C# Features
  • Optional Arguments
  • Bracket
  • DLR Integration
  • Cursor[T]
  • Run Helpers
    • .RunAtom
    • .RunCursor
    • .RunResult
    • .RunChanges
    • .RunGrouping
  • Async/Await Support
  • POCO Support
  • DAO Support
  • JObject Support
  • Anon Type Insert
  • Anon Type Projection
  • Consuming Changefeeds
  • Reactive Extensions
  • Implicit Operators
  • Serializing Expressions
• GOTCHA Goblins!
• LINQ to ReQL Provider
• Differences
• Java ReQL API Documentation

ReGrid File Storage

• What is ReGrid?
• Getting Started
• Buckets
• Files
  • Revision Numbers
  • Upload
  • Download
  • Seekable Streams
  • Delete

Driver Development

• Contributing
• Getting Started
• Unit Tests
• Protocol Debugging
• Threading Architecture
• Connection Pooling Architecture

Quick Examples

public static RethinkDB R = RethinkDB.R;

[Test]
public void can_connect()
{
    var c = R.Connection()
             .Hostname("192.168.0.11")
             .Port(RethinkDBConstants.DefaultPort)
             .Timeout(60)
             .Connect();

    int result = R.Random(1, 9).Add(R.Random(1, 9)).Run<int>(c);
    Console.WriteLine(result);
    result.Should().BeGreaterOrEqualTo(2).And.BeLessThan(18);
}
// Output: 8

[Test]
public void insert_poco_without_id()
{
    var obj = new Foo { Bar = 1, Baz = 2};
    var result = R.Db("mydb").Table("mytable").Insert(obj).Run(conn);
    result.Dump();
}
/*
    //JObject: Insert Response
	{
	  "deleted": 0,
	  "errors": 0,
	  "generated_keys": [
	    "6931c97f-de3d-46d2-b0f9-956af9517a57"
	  ],
	  "inserted": 1,
	  "replaced": 0,
	  "skipped": 0,
	  "unchanged": 0
	}
*/

[Test]
public void insert_an_array_of_pocos()
{
    var list = new[]
        {
            new Foo {id = "a", Baz = 1, Bar = 1},
            new Foo {id = "b", Baz = 2, Bar = 2},
            new Foo {id = "c", Baz = 3, Bar = 3}
        };
    var result = R.Db("mydb").Table("mytable").Insert(list).Run(conn);
    result.Dump();
}
/*
    //JObject Insert Response
    {
      "deleted": 0,
      "errors": 0,
      "inserted": 3,
      "replaced": 0,
      "skipped": 0,
      "unchanged": 0
    }
*/


[Test]
public void get_a_poco()
{
    Foo foo = R.Db("mydb").Table("mytable").Get("abc").Run<Foo>(conn);
    foo.Dump();
}
//Foo Object
/*
    {
      "id": "abc",
      "Bar": 1,
      "Baz": 2
    }
*/

Contributing

If you'd like to contribute, please consider reading some helpful tips before making changes.

Contributors

Created by Brian Chavez (twitter). Originally ported from the Java Driver by Josh Kuhn. Special thanks to the rest of the RethinkDB team (Josh, AtnNn, danielmewes, neumino, VeXocide) for answering ReQL protocol questions. Also, special thanks to Annie Ruygt for the wonderful GitHub banner!

A big thanks to GitHub and all contributors:

• jrote1 (Jake Rote) ~ LINQ Provider
• fiLLLip (Filip Andre Larsen Tomren)
• cadabloom

Music Wall

🎼 A small collection of videos that helped in the creation of this driver. =)

    <tr>
        <td>
            <a href="http://www.youtube.com/watch?feature=player_embedded&v=nXri9t8yrr4" target="_blank">
                <img src="http://img.youtube.com/vi/nXri9t8yrr4/0.jpg" alt="Kuffdam & Plant" width="240" height="180" border="10" />
            </a>
        </td>
        <td>
            <a href=
            "http://www.youtube.com/watch?feature=player_embedded&v=FyASdjZE0R0"
            target="_blank"><img alt="NIN" border="10" height="180" src=
            "http://img.youtube.com/vi/FyASdjZE0R0/0.jpg" width="240"></a>
        </td>
        <td>
            <a href=
            "http://www.youtube.com/watch?feature=player_embedded&v=dd00Qh9yZUg"
            target="_blank"><img alt="Glitch Mob" border="10" height="180" src=
            "http://img.youtube.com/vi/dd00Qh9yZUg/0.jpg" width="240"></a>
        </td>
    </tr>