QLDBAmazon-Treiber für. NET - Amazon Quantum Ledger-Datenbank (AmazonQLDB)
Ressourcen für FahrerVoraussetzungenInstallation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

QLDBAmazon-Treiber für. NET

Wichtig

Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter Migrieren eines Amazon QLDB Ledgers zu Amazon Aurora SQL Postgre.

Um mit Daten in Ihrem Ledger zu arbeiten, können Sie QLDB von Ihrem Microsoft aus eine Verbindung zu Amazon herstellen. NETAnwendung mithilfe eines AWS bereitgestellten Treibers. Die Treiberziele. NETStandard 2.0. Genauer gesagt unterstützt es. NETCore (LTS) 2.1+ und. NETFramework 4.5.2+. Informationen zur Kompatibilität finden Sie unter. NETStandard auf der Microsoft Docs-Website.

Wir empfehlen dringend, den Ion Object Mapper zu verwenden, um die manuelle Konvertierung zwischen Amazon Ion-Typen und nativen C#-Typen vollständig zu umgehen.

In den folgenden Themen werden die ersten Schritte mit dem QLDB Treiber für beschrieben. NET.

Themen

Ressourcen für Fahrer

Weitere Informationen zu den Funktionen, die von der unterstützt werden. NETTreiber finden Sie in den folgenden Ressourcen:

Voraussetzungen

Bevor Sie mit dem QLDB Treiber für beginnen. NET, müssen Sie Folgendes tun:

  1. Folgen Sie den Anweisungen zur AWS Einrichtung unterZugriff auf Amazon QLDB. Diese umfasst die folgenden Funktionen:

    1. Melde dich an für AWS.

    2. Erstellen Sie einen Benutzer mit den entsprechenden QLDB Berechtigungen.

    3. Gewähren Sie programmatischen Zugriff für die Entwicklung.

  2. Laden Sie das herunter und installieren Sie es. NETSDKCore-Version 2.1 oder höher von Microsoft. NETDownload-Seite.

  3. (Optional) Installieren Sie eine integrierte Entwicklungsumgebung (IDE) Ihrer Wahl, z. B. Visual Studio, Visual Studio für Mac oder Visual Studio Code. Sie können diese von der Microsoft Visual Studio-Website herunterladen.

  4. Konfigurieren Sie die Entwicklungsumgebung für das AWS SDK for .NET:

    1. Richten Sie Ihre AWS Anmeldeinformationen ein. Wir empfehlen, eine gemeinsame Anmeldeinformationsdatei zu erstellen.

      Anweisungen finden Sie unter Konfiguration von AWS Anmeldeinformationen mithilfe einer Anmeldeinformationsdatei im AWS SDK for .NET Entwicklerhandbuch.

    2. Stellen Sie Ihre Standardeinstellung ein AWS-Region. Wie das geht, erfahren Sie unter AWS-Region Auswahl.

      Eine vollständige Liste der verfügbaren Regionen finden Sie unter QLDBAmazon-Endpunkte und Kontingente in der Allgemeine AWS-Referenz.

Als Nächstes können Sie eine einfache Beispielanwendung einrichten und kurze Codebeispiele ausführen — oder Sie können den Treiber in einer vorhandenen Anwendung installieren. NETProjekt.

  • Um den QLDB Treiber und den AWS SDK for .NET in einem vorhandenen Projekt zu installieren, fahren Sie mit fortInstallation.

  • Informationen zum Einrichten eines Projekts und zum Ausführen von kurzen Codebeispielen, die grundlegende Datentransaktionen in einem Ledger veranschaulichen, finden Sie unter. Schnellstart-Tutorial

Installation

Verwenden Sie den NuGet Paketmanager, um den QLDB Treiber für zu installieren. NET. Wir empfehlen, Visual Studio oder ein Programm IDE Ihrer Wahl zu verwenden, um Projektabhängigkeiten hinzuzufügen. Der Name des Treiberpakets ist Amazon. QLDB.Treiber.

Öffnen Sie beispielsweise in Visual Studio die NuGet Package Manager Console im Menü Tools. Geben Sie anschließend den folgenden Befehl an der PM>-Eingabeaufforderung ein:

PM> Install-Package Amazon.QLDB.Driver

Durch die Installation des Treibers werden auch seine Abhängigkeiten installiert, einschließlich der Pakete AWS SDK for .NET und Amazon Ion.

Installieren Sie den Ion Object Mapper

Version 1.3.0 des QLDB Treibers für. NETbietet Unterstützung für das Akzeptieren und Zurückgeben nativer C#-Datentypen, ohne dass Sie mit Amazon Ion arbeiten müssen. Um diese Funktion zu verwenden, fügen Sie Ihrem Projekt das folgende Paket hinzu.

  • Amazon. QLDB.Driver.Serialization — Eine Bibliothek, die Ion-Werte einfachen alten CLR C#-Objekten (POCO) zuordnen kann und umgekehrt. Mit diesem Ion-Objektmapper kann Ihre Anwendung direkt mit systemeigenen C#-Datentypen interagieren, ohne dass Sie mit Ion arbeiten müssen. Eine kurze Anleitung zur Verwendung dieser Bibliothek finden Sie in der SERIALIZATION.md-Datei im Repository. GitHub awslabs/amazon-qldb-driver-dotnet

Geben Sie den folgenden Befehl ein, um dieses Paket zu installieren.

PM> Install-Package Amazon.QLDB.Driver.Serialization

Kurze Codebeispiele für die Ausführung von Basisdatentransaktionen in einem Ledger finden Sie unterReferenz zum Kochbuch.