0.6

Release Notes 0.6

New Commands

• Support for Data API Embedding Providers

astra db list-embeddings-providers
astra db describe-embeddings-provider

• Support for Data API Collection

astra db list-collections ...
astra db create-collection...
astra db delete-collection...
astra db describe-collection
astra db truncate-collection...

• Support for Data API Tables

astra db list-tables ...
astra db delete-table...
astra db describe-table
astra db truncate-table...

Bug Fixes

• #209 get-endpoints-* Invalid output
• #198 [BUG] create-region returned error even though it's still possible to add region via Astra UI
• #177 [Feature] - List the embedding providers available for a DB
• #174 [BUG] - Invalid message when providing invalid configuration
• #173 [BUG] (nit) wording wrong in "create db" command with incompatible region/cloud
• #171 [Feature] - Add new option to collection creation
• #165 [BUG] Some Astra CLI command can work with DB ids, but NOT with DB names.
• #162 [Feature]- Add more functions at collection level
• #160 [BUG] HttpRequest: HttpEntity error if the token doesn't have enough permissions
• #146 [BUG] Error when executing cqlsh via astra-cli

Improvements

• #197 Improve documentation
• #139 [BUG] Cannot "setup" due to linking issue in 0.5

0.5

New Features

• #130 [vector] List collections for vector database

A new command list-collections is available but will be processed only if target database is vector enabled.

Sample command

astra db list-collections test_astra_cli_vector

Expected output

+------------------------+-----------+-----------+
| Name                   | Dimension | Metric    |
+------------------------+-----------+-----------+
| test_collection_simple |           |           |
| test_collection_vector | 1536      | cosine    |
| demo_vector            | 5         | cosine    |
+------------------------+-----------+-----------+

• #129 [vector] Display endpoint for the json API

Displaying endpoints for different apis:

Sample command

astra db get-endpoint-api my-db
astra db get-endpoint-swagger my-db
astra db get-endpoint-playground my-db

Expected output

astra db get-endpoint-api my-db
https://93783a2d-2450-422a-8b4e-5dec1b4384fa-westus3.apps.astra.datastax.com/api/json

Note: The command astra db create-dotenv to add the key ASTRA_DB_API_ENDPOINT accordingly

• #128 [vector] Create a new collection from the CLI

For Vector Databases, you can now create or delete collections

Sample Create

astra db create-collection my-db --collection col1 --dimension 1536 --metric cosine

Sample delete

astra db delete-collection my-db --collection col1 

• #127 [vector] List vector databases

When listing databases a flag is added for only the vector databases

Sample Create

astra db list --vector

Sample output

+-----------------------+--------------------------------------+-----------+-------+---+-----------+
| Name                  | id                                   | Regions   | Cloud | V | Status    |
+-----------------------+--------------------------------------+-----------+-------+---+-----------+
| test_astra_cli_vector | db7d003e-b9d3-433d-be12-d252b2ed30da | us-east1  | gcp   | ■ | ACTIVE    |
| db_vector             | 93783a2d-2450-422a-8b4e-5dec1b4384fa | westus3   | azure | ■ | ACTIVE    |
+-----------------------+--------------------------------------+-----------+-------+---+-----------+

You want to separate region for astra serverless and regions for vector

List serverless regions

astra db list-regions-serverless

List vector regions

astra db list-regions-vector

BUG Fixes

• #123 Astra CLI doesn't recognize databases above 25 to be queried via cqlsh
• #111 Database description in native mode
• #104 Update to new output from devops api streaming
• #103 Support of dev and test environments
• #98 In native token create return an error in the output marshalling
• #97 In native user invite return a 504
• #94 Create Tenant failling in native mode

Improvements

• #117 Support Vector Regions managements with vector
• #96 setup command does not override the default section is already exists
• #95 Allow Creation of DB for different tiers (astra Classic)

Maintenance

• Update all required maven plugins and CVE.

Upgrading

With HomeBrew (Mac Intel Only)

brew upgrade datastax/astra-cli/astra-cli

Manually

curl -Ls "https://dtsx.io/get-astra-cli" | bash

0.4

New Features

• #90 - Support Non Production Environments

astra config create <env_name> --token --env DEV

config list updated:

+------+-----------------------------------------+
| env  | configuration                           |
+------+-----------------------------------------+
| DEV  | sample-dev                              |
| TEST | sample-test                             |
| PROD | datastaxDevs     (in use)               |
| PROD | gcp_integrations                        |
+------+-----------------------------------------+

• #86 - Support for Vector databases

astra db create <db_name> --vector

db list updated:

+---------------------------+--------------------------------------+-----------+-------+---+-----------+
| Name                      | id                                   | Regions   | Cloud | V | Status    |
+---------------------------+--------------------------------------+-----------+-------+---+-----------+
| astra_cli_test            | c4e77247-575a-4853-857e-692f49dab7b6 | us-east1  | gcp   |   | ACTIVE    |
| astra_cli_vector_test     | 35f29a92-fb58-4bbc-84a0-a98615052cad | us-east1  | gcp   | ■ | ACTIVE    |
+---------------------------+--------------------------------------+-----------+-------+---+-----------+

Improvements

• #88 - Support for an astra login command
• #65 - Show free tier in the region list
• #72 - Update to cqlsh-astra 20230710-vectortype with Python 11 support
• Update to DS Bulk 1.11 with Vector Search and JDK17 supports
• Update to Pulsar Shell 2.10.4.9

Bug Fixing

• #66 - Quotes support for token input
• #67 - .env will be created in the current folder

Maintenance

• Update all required maven plugins and CVE.
• Update all required dependencies and especially astra-sdk-java0.6.7

Upgrading.

• With HomeBrew (Mac Only)

brew upgrade datastax/astra-cli/astra-cli

• Manually

curl -Ls "https://dtsx.io/get-astra-cli" | bash

0.3

New Features

• #4 Support CDC endpoints
• #63 Delete a keyspace

Improvements

• #62 - Display token in console with astra token
• #61 Output of swagger and playground should give you url
• #60 Provide options to increase CQLSH Timeouts
• #53 Specify cloud provider during DB creation
• #47 Use Astra UI color scheme in CLI output

Bug Fixing

• #46 The flag no-color was ignored on tables bug Something isn't working
• #43 Resuming-database message does not name the database bug

Maintenance

• Update jacoco-maven-plugin
• Update maven-resources-plugin
• Update commons-compress
• Update slf4j-nop,
• Update maven-surefire-plugin
• Update maven-compiler-plugin
• Update maven-assembly-plugin
• Update maven-surefire-plugin
• Moved exceptions to SDK Java
• Implementation of fluent API in SDK Java

How to update

• With Brew

brew upgrade datastax/astra-cli/astra-cli

• Manually

curl -Ls "https://dtsx.io/get-astra-cli" | bash

First execution of DSBulk, Pulsar-shell and CqlShell will be slow as the component will install latest version

0.2.1

This release will fix some open issues and improve quality overall:

Fixes

• Fix #32 - Misleading error message when downloading SCB for name-colliding databases
• Fix #33 - download-scb help message: mention possibility of DB ID and fix description
• Fix #38 - streaming get return ERROR You provided unknown or not well formatted argument.
• Fix #39 - When unload param URL should not be mandatory
• Fix #41 - Compiled in native list token command is failing

Maintenance

• Dependencies have been refreshed: junit, http-client
• License Document has been refreshed (2023)
• Quality from 240 to 110 code smells

Evolutions

• #26 = Adding alias to describe entities and not only get

0.2

V0.2 Release Note

• Drop dependency to stargate, stick to astra-sdk-devops only
• Fixing created-dotenv for native images
• create-dotenv now keep existing keys in place
• New Create a region for a database
• New Delete a region for a database
• New List regions for a database
• New Region listing move from org to db

Fixing Bug Create dotenv

To create the file .env the system assumed it was always on default region. This version fixed this behaviour.

0.1

• Moving from versions alpha to a first release
• Full documentation available on Awesome Astra

Details of different Assets for this release:

Asset	Description
astra-cli-0.1-linux.zip	Native image for Linux environments, install with manual script
astra-cli-0.1-mac.zip	Native image for Mac environments, install with manual script
astra-cli-0.1-mac.tar.gz	Native image for Mac environments, install with homebrew
astra-cli-0.1-java.tar.gz	Fat jar, jdk17 required and manual installation
astra-cli-0.1-java.zip	Fat jar, jdk17 required and manual installation