Repository files navigation

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

This driver is based on theofficialJava Driver. The basic mechanics and architecture of both drivers are the same. Except thisC# driver is a bit morecool,stylish andkick-ass. 😎

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

This open-source driver is dual-licensed. Please read below about SSL/TLS restrictions.

A commercial license is required if any part of this driver is used to communicate with aRethinkDB (server or proxy) using SSL/TLS encryption. A commercial license is also required if any part of this driver is used to interact withCompose.IO. Commercial licenses are sold byBit Armory Inc and are available forpurchase here. More information about commercial licensing can befound here.

As long as SSL/TLS is not used when communicating with aRethinkDB (server or proxy), the driver is free to use forcommercial andnon-commercial applications and is covered under amodified Apache License 2.0.

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

Slack andDiscord are the primary means of getting help for free. If yourC# related question can't be answered by anyone tag@bchavez in your question.

NuGet PackageRethinkDb.Driver

Install-Package RethinkDb.Driver

Supported Runtimes

	Windows	Linux	Mac OS X
.NET Framework	v4.5	n/a	n/a
.NET Standard	All platforms supporting.NET Standard 2.0 or higher. Eg:.NET Core 2.0.
Mono	All platforms4.0.2 SR2 or higher
RethinkDB server2.3.0 or higher

• Home
• Query Examples
• Logging
• Connections & Pooling
  • Single Connection
  • Round Robin Pooling
  • Epsilon Greedy Pooling
  • Using SSL / TLS Encryption
    • Connecting to Compose.IO
• Extra C# Features
  • Optional Arguments
  • Bracket
  • DLR Integration
  • Cursor[T]
  • Run Helpers
    • .RunAtom
    • .RunWrite
    • .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

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

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

RethinkDB Discord HelpRethinkDB Gitter Help

publicstaticRethinkDBR=RethinkDB.R;[Test]publicvoidcan_connect(){varc=R.Connection().Hostname("192.168.0.11").Port(RethinkDBConstants.DefaultPort).Timeout(60).Connect();intresult=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]publicvoidinsert_poco_without_id(){varobj=newFoo{Bar=1,Baz=2};varresult=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]publicvoidinsert_an_array_of_pocos(){varlist=new[]{newFoo{id="a",Baz=1,Bar=1},newFoo{id="b",Baz=2,Bar=2},newFoo{id="c",Baz=3,Bar=3}};varresult=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]publicvoidget_a_poco(){Foofoo=R.Db("mydb").Table("mytable").Get("abc").Run<Foo>(conn);foo.Dump();}//Foo Object/*    {      "id": "abc",      "Bar": 1,      "Baz": 2    }*/

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

Created byBrian Chavez (twitter). Originally ported from the Java Driver byJosh Kuhn. Special thanks to the rest of the RethinkDB team (Josh,AtnNn,danielmewes,neumino,VeXocide) for answering ReQL protocol questions. Also, special thanks toAnnie 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

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