Releases: awslabs/amazon-qldb-shell
v2.0.0-alpha9
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
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
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
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
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
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
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
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
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 theclear
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
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
- 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) >
- 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
- 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
- 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.
- Any casing of quit or exit command and the keys
CTRL+D
will now quit the shell. - We now have multi-line support for the shell:
- You can now copy paste inputs with multiple lines.
- Besides, to start a new line,
META
Key +Enter
needs to be used.- For a Mac, as an example, the option key can be used as a meta key by following instructions as mentioned here.
- For Windows, by default, the Escape key will be considered the meta key.
- Use the Tab key on a partial word to autocomplete and autosuggest QLDB reserved words and active tables.
- We also display the ledger name on the right side of the shell.
CTRL+C
cancels the current command.