Amazon QLDB Driver for .NET - Amazon Quantum Ledger Database (Amazon QLDB)

Amazon QLDB Driver for .NET

To work with data in your ledger, you can connect to Amazon QLDB from your Microsoft .NET application by using an AWS-provided driver. The driver targets .NET Standard 2.0. More specifically, it supports .NET Core 2.1 and .NET Framework 4.x. For information on compatibility, see .NET Standard on the Microsoft Docs site.

The following sections describe how to get started with the QLDB Driver for .NET.

Driver Resources

For more information about the functionality supported by the .NET driver, see the following resources:

Prerequisites

Before you get started with the QLDB Driver for .NET, you must do the following:

  1. Follow the AWS setup instructions in Accessing Amazon QLDB. This includes signing up for AWS and getting an AWS access key for development.

  2. Download and install the .NET Core SDK version 2.1 or later from the Microsoft .NET downloads site.

  3. (Optional) Install an integrated development environment (IDE) of your choice, such as Visual Studio, Visual Studio for Mac, or Visual Studio Code. You can download these from the Microsoft Visual Studio site.

  4. Configure your development environment for the AWS SDK for .NET:

Next, you can set up a basic sample application and run short code examples—or you can install the driver in an existing .NET project.

  • To install the QLDB Driver and the AWS SDK for .NET in an existing project, proceed to Installation.

  • To run short code examples that execute basic data transactions on a ledger, see the Quick start guide.

Installation

Use the NuGet package manager to install the QLDB Driver for .NET. We recommended that you use Visual Studio or an IDE of your choice to add project dependencies. The driver package name is Amazon.QLDB.Driver.

For example in Visual Studio, open the NuGet Package Manager Console on the Tools menu. Then, enter the following command at the PM> prompt.

PM> Install-Package Amazon.QLDB.Driver

Installing the driver also installs its dependencies, including the AWS SDK for .NET and Amazon Ion packages.

For short code examples of how to run basic data transactions on a ledger, see the Cookbook reference.