Skip to content

Releases: awslabs/amazon-qldb-shell

v2.0.0-alpha9

07 May 16:04
Compare
Choose a tag to compare
v2.0.0-alpha9 Pre-release
Pre-release

The QLDB Shell is undergoing a complete rewrite in Rust to make it faster and lower latency with zero external dependencies. This is an early alpha release which is not intended for use in production systems. For the time being the Python-based shell on the master branch continues to be the production-ready release. Please contact us if you experiment with this early alpha release and have feedback you'd like to share with us.

v2.0.0-alpha8

07 May 03:01
Compare
Choose a tag to compare
v2.0.0-alpha8 Pre-release
Pre-release

The QLDB Shell is undergoing a complete rewrite in Rust to make it faster and lower latency with zero external dependencies. This is an early alpha release which is not intended for use in production systems. For the time being the Python-based shell on the master branch continues to be the production-ready release. Please contact us if you experiment with this early alpha release and have feedback you'd like to share with us.

v2.0.0-alpha6

29 Apr 00:59
Compare
Choose a tag to compare
v2.0.0-alpha6 Pre-release
Pre-release

The QLDB Shell is undergoing a complete rewrite in Rust to make it faster and lower latency with zero external dependencies. This is an early alpha release which is not intended for use in production systems. For the time being the Python-based shell on the master branch continues to be the production-ready release. Please contact us if you experiment with this early alpha release and have feedback you'd like to share with us.

v2.0.0-alpha5

23 Apr 23:06
Compare
Choose a tag to compare
v2.0.0-alpha5 Pre-release
Pre-release

The QLDB Shell is undergoing a complete rewrite in Rust to make it faster and lower latency with zero external dependencies. This is an early alpha release which is not intended for use in production systems. For the time being the Python-based shell on the master branch continues to be the production-ready release. Please contact us if you experiment with this early alpha release and have feedback you'd like to share with us.

v2.0.0-alpha4

23 Apr 21:55
Compare
Choose a tag to compare
v2.0.0-alpha4 Pre-release
Pre-release

The QLDB Shell is undergoing a complete rewrite in Rust to make it faster and lower latency with zero external dependencies. This is an early alpha release which is not intended for use in production systems. For the time being the Python-based shell on the master branch continues to be the production-ready release. Please contact us if you experiment with this early alpha release and have feedback you'd like to share with us.

v2.0.0-alpha3

21 Apr 22:01
Compare
Choose a tag to compare
v2.0.0-alpha3 Pre-release
Pre-release

The QLDB Shell is undergoing a complete rewrite in Rust to make it faster and lower latency with zero external dependencies. This is an early alpha release which is not intended for use in production systems. For the time being the Python-based shell on the master branch continues to be the production-ready release. Please contact us if you experiment with this early alpha release and have feedback you'd like to share with us.

(non-production) Release v2.0.0-alpha2 of the QLDB Shell

08 Apr 16:18
40503ab
Compare
Choose a tag to compare

The QLDB Shell is undergoing a complete rewrite in Rust to make it faster and lower latency with zero external dependencies. This is an early alpha release which is not intended for use in production systems. For the time being the Python-based shell on the master branch continues to be the production-ready release. Please contact us if you experiment with this early alpha release and have feedback you'd like to share with us.

(non-production) Release v2.0.0-alpha1 of the QLDB Shell

16 Mar 23:18
Compare
Choose a tag to compare

The QLDB Shell is undergoing a complete rewrite in Rust to make it faster and lower latency with zero external dependencies. This is an early alpha release which is not intended for use in production systems. For the time being the Python-based shell on the master branch continues to be the production-ready release. Please contact us if you experiment with this early alpha release and have feedback you'd like to share with us.

Release v1.2.0 of the Amazon QLDB Shell

17 Nov 05:00
Compare
Choose a tag to compare

Release qldbshell-v1.2.0

The Amazon QLDB team is pleased to announce the release of version v1.2.0 of Amazon QLDB Shell. This release is aimed at enhancing the developer experience when interacting with Amazon QLDB.

Enhancements:

  • Add ability to clear the screen by using the clear command. Command behaves similar to the clear command in Linux which moves the previous outputs up in the terminal and focuses on the current prompt.

Release v1.1.0 of the Amazon QLDB Shell

27 Oct 02:09
Compare
Choose a tag to compare

Release qldbshell-v1.1.0

The Amazon QLDB team is pleased to announce the release of version v1.1.0 of Amazon QLDB Shell. This release is aimed at enhancing the developer experience when interacting with the Amazon QLDB.

New Features

Interact with Transactions

Interactive transactions

  1. To begin a transaction, enter the start command.
qldbshell > start

After you start a transaction, the command prompt displays the current system-assigned transaction ID. For example, if your transaction ID is FMoVdWuPxJg3k466Iz4i75, the shell displays the following command prompt.

qldbshell (tx:FMoVdWuPxJg3k466Iz4i75) >
  1. Then, each statement that you enter runs in the same transaction.
  • For example, you can run a single statement as follows:
qldbshell (tx:FMoVdWuPxJg3k466Iz4i75) > SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151'

After you press Enter, the shell displays the results of the statement

  • You can also enter multiple statements or commands separated by a semicolon as follows.
qldbshell (tx:FMoVdWuPxJg3k466Iz4i75) > SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151'; commit
  1. To end the transaction, enter one of the following commands.
qldbshell (tx:FMoVdWuPxJg3k466Iz4i75) > commit
Transaction with transaction ID FMoVdWuPxJg3k466Iz4i75 committed

Enter the abort command to cancel your transaction.

qldbshell (tx:FMoVdWuPxJg3k466Iz4i75) > abort
Transaction with transaction ID FMoVdWuPxJg3k466Iz4i75 aborted

Transaction timeout
An interactive transaction adheres to QLDB’s transaction timeout limit which is currently set at 30s.

Ending a transaction
commit/abort will either commit the transaction or abort it

qldbshell (tx:txID) > abort
Transaction with transaction ID txID aborted

On Transaction Expiry
On Transaction expiry, the result of the statement entered will not be displayed.
A message, “Transaction with ID expired. Aborting transaction.” will be displayed and the flow will return back into the normal shell mode.

Non-interactive transactions
You can run a complete transaction with multiple statements by batching commands and statements sequentially as follows

qldbshell > start; SELECT * FROM Vehicle AS v WHERE v.VIN = '1N4AL11D75C109151'; SELECT * FROM Person AS p, DriversLicense as l WHERE p.GovId = l.LicenseNumber; commit

You must separate each command and statement with a semicolon (;). If any statement in the transaction is not valid, the shell automatically aborts the transaction . The shell does not proceed with any subsequent statements that you entered.

You can also set up multiple transactions.

qldbshell > start; statement1; commit; start; statement2; statement3; commit

If you don't end a transaction, the shell switches to interactive mode and prompts you for the next command or statement.

qldbshell > start; statement1; commit; start
qldbshell (tx:FMoVdWuPxJg3k466Iz4i75) > 

Enhancements

  1. In previous versions of the shell, a carriage return(pressing enter) on an empty line repeated the last command. Now, pressing enter will do nothing.
  2. Any casing of quit or exit command and the keys CTRL+D will now quit the shell.
  3. We now have multi-line support for the shell:
    1. You can now copy paste inputs with multiple lines.
    2. Besides, to start a new line, META Key + Enter needs to be used.
      1. For a Mac, as an example, the option key can be used as a meta key by following instructions as mentioned here.
      2. For Windows, by default, the Escape key will be considered the meta key.
  4. Use the Tab key on a partial word to autocomplete and autosuggest QLDB reserved words and active tables.
  5. We also display the ledger name on the right side of the shell.
  6. CTRL+C cancels the current command.