QLDBÜber die QLDB Shell auf Amazon zugreifen (APInur Daten)

Amazon QLDB bietet eine Befehlszeilen-Shell für die Interaktion mit den Transaktionsdaten. API Mit der QLDB Shell können Sie PartiQL-Anweisungen für Ledger-Daten ausführen.

Die neueste Version dieser Shell ist in Rust geschrieben und als Open Source im GitHub Repository amazon-qldb-shellawslabs/ im Standardzweig verfügbar. main Die Python-Version (v1) ist auch weiterhin für die Verwendung im selben Repository in der master Filiale verfügbar.

Dieses Tool ist nicht dafür vorgesehen, in eine Anwendung integriert oder für Produktionszwecke verwendet zu werden. Das Ziel dieses Tools ist es, Ihnen das schnelle Experimentieren mit QLDB und PartiQL zu ermöglichen.

In den folgenden Abschnitten wird beschrieben, wie Sie mit der QLDB Shell beginnen.

Voraussetzungen

Bevor Sie mit der QLDB Shell beginnen, müssen Sie Folgendes tun:

Installation der Shell

Informationen zur Installation der neuesten Version der QLDB Shell finden Sie in der README.md-Datei unter GitHub. QLDBstellt im Bereich Releases des GitHub Repositorys vorgefertigte Binärdateien für Linux, macOS und Windows bereit.

Für macOS ist die Shell in den aws/tap Homebrew-Tap integriert. Führen Sie die folgenden Befehle aus, um die Shell unter macOS mit Homebrew zu installieren.

$ xcode-select --install # Required to use Homebrew
$ brew tap aws/tap # Add AWS as a Homebrew tap
$ brew install qldbshell

Konfiguration

Nach der Installation lädt die Shell die Standardkonfigurationsdatei, die sich $XDG_CONFIG_HOME/qldbshell/config.ion bei der Initialisierung unter befindet. Unter Linux und macOS befindet sich diese Datei normalerweise unter~/.config/qldbshell/config.ion. Wenn eine solche Datei nicht existiert, läuft die Shell mit den Standardeinstellungen.

Sie können eine config.ion Datei nach der Installation manuell erstellen. Diese Konfigurationsdatei verwendet das Amazon Ion-Datenformat. Das Folgende ist ein Beispiel für eine config.ion Minimaldatei.

{
  default_ledger: "my-example-ledger"
}

Wenn in Ihrer Konfigurationsdatei default_ledger nicht festgelegt ist, ist der --ledger Parameter erforderlich, wenn Sie die Shell aufrufen. Eine vollständige Liste der Konfigurationsoptionen finden Sie in der README.md-Datei unter. GitHub

Die Shell aufrufen

Um die QLDB Shell auf Ihrem Befehlszeilenterminal für ein bestimmtes Ledger aufzurufen, führen Sie den folgenden Befehl aus. Ersetzen my-example-ledger mit Ihrem Ledger-Namen.

$ qldb --ledger my-example-ledger

Dieser Befehl stellt eine Verbindung zu Ihrem AWS-Region Standardbefehl her. Um die Region explizit anzugeben, können Sie den Befehl mit dem --qldb-session-endpoint Parameter --region oder ausführen, wie im folgenden Abschnitt beschrieben.

Nach dem Aufrufen einer qldb Shell-Sitzung können Sie die folgenden Eingabetypen eingeben:

Shell-Parameter

Eine vollständige Liste der verfügbaren Flags und Optionen zum Aufrufen einer Shell erhalten Sie, wenn Sie den qldb Befehl mit dem --help Flag wie folgt ausführen.

$ qldb --help

Im Folgenden sind einige wichtige Flags und Optionen für den qldb Befehl aufgeführt. Sie können diese optionalen Parameter hinzufügen, um die Konfigurationsoptionen Profil AWS-Region, Endpunkt, Ergebnisformat und andere Konfigurationsoptionen zu überschreiben.

Usage

$ qldb [FLAGS] [OPTIONS]

Befehlsreferenz

Nachdem Sie eine qldb Sitzung aufgerufen haben, unterstützt die Shell die folgenden Schlüssel und Datenbankbefehle:

Einzelne Anweisungen ausführen

Mit Ausnahme der in README.md aufgeführten Datenbankbefehle und Shell-Metabefehlen interpretiert die Shell jeden Befehl, den Sie eingeben, als separate PartiQL-Anweisung. Standardmäßig aktiviert die Shell den Modus. auto-commit Dieser Modus ist konfigurierbar.

In diesem auto-commit Modus führt die Shell implizit jede Anweisung in ihrer eigenen Transaktion aus und schreibt die Transaktion automatisch fest, wenn keine Fehler gefunden werden. Das bedeutet, dass Sie nicht jedes Mal, wenn Sie eine Anweisung ausführen, commit manuell start transaction (oderbegin) ausführen müssen.

Verwalten von Transaktionen

Alternativ können Sie mit der QLDB Shell Transaktionen manuell steuern. Sie können mehrere Anweisungen innerhalb einer Transaktion interaktiv oder nicht interaktiv ausführen, indem Sie Befehle und Anweisungen nacheinander stapeln.

Interaktive Transaktionen

Gehen Sie wie folgt vor, um eine interaktive Transaktion auszuführen.

Timeout-Limit für Transaktionen

Bei einer interaktiven Transaktion wird das QLDB Transaktions-Timeout-Limit eingehalten. Wenn Sie eine Transaktion nicht innerhalb von 30 Sekunden nach dem Start festschreiben, läuft die Transaktion QLDB automatisch ab und alle während der Transaktion vorgenommenen Änderungen werden zurückgewiesen.

Anstatt die Ergebnisse der Anweisung anzuzeigen, zeigt die Shell dann eine Ablauffehlermeldung an und kehrt zur normalen Eingabeaufforderung zurück. Um es erneut zu versuchen, müssen Sie den begin Befehl erneut eingeben, um eine neue Transaktion zu starten.

transaction failed after 1 attempts, last error: communication failure: Transaction 2UMpiJ5hh7WLjVgEiMLOoO has expired

Nicht interaktive Transaktionen

Sie können eine vollständige Transaktion mit mehreren Anweisungen ausführen, indem Sie Befehle und Anweisungen nacheinander wie folgt stapeln.

qldb> begin; SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151'; SELECT * FROM Person p, DriversLicense l WHERE p.GovId = l.LicenseNumber; commit

Sie müssen jeden Befehl und jede Anweisung durch ein Semikolon () trennen. ; Wenn eine Anweisung in der Transaktion nicht gültig ist, lehnt die Shell die Transaktion automatisch ab. Die Shell fährt mit den nachfolgenden Anweisungen, die Sie eingegeben haben, nicht fort.

Sie können auch mehrere Transaktionen einrichten.

qldb> begin; statement1; commit; begin; statement2; statement3; commit

Ähnlich wie im vorherigen Beispiel: Wenn eine Transaktion fehlschlägt, fährt die Shell nicht mit den nachfolgenden Transaktionen oder Anweisungen fort, die Sie eingegeben haben.

Wenn Sie eine Transaktion nicht beenden, wechselt die Shell in den interaktiven Modus und fordert Sie auf, den nächsten Befehl oder die nächste Anweisung einzugeben.

qldb> begin; statement1; commit; begin
qldb *>  

Die Shell wird beendet

Um die aktuelle qldb Shell-Sitzung zu beenden, geben Sie den quit Befehl exit oder ein oder verwenden Sie die Tastenkombination Ctrl +, D wenn sich die Shell nicht in einer Transaktion befindet.

qldb> exit
$ 

qldb> quit
$ 

Beispiel

Informationen zum Schreiben von PartiQL-Anweisungen in QLDB finden Sie unterAmazon QLDB PartiQL-Referenz.

$ qldb --ledger test-ledger --region us-east-1

qldb> CREATE TABLE TestTable
qldb> INSERT INTO TestTable `{"Name": "John Doe"}`
qldb> SELECT * FROM TestTable
qldb> DROP TABLE TestTable
qldb> exit