Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions antora.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ asciidoc:
product: 'Astra CLI'
product-short: 'Astra'
product-version: '1.0'
db-serverless-short: 'Serverless'
db-serverless: 'Serverless (non-vector)'
db-serverless-vector: 'Serverless (vector)'
db-classic: 'Astra Managed Clusters'
Expand Down
2 changes: 1 addition & 1 deletion in-progress/dsbulk.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,7 @@ To resume the current operation, re-run it with the same settings, and add the f

The following end-to-end example shows how to use the {product}'s built-in {dsbulk-short} support to load data into a database, get information about the data, and unload the data into CSV files:

. Create an {astra-db} {db-serverless} database:
. Create an {product} database:
+
[source,shell]
----
Expand Down
18 changes: 11 additions & 7 deletions in-progress/managing.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,11 @@ You can use `**DATABASE_NAME**` instead of `**DATABASE_ID**` in all `astra db` c

== Create a database

The {product} can create {db-serverless} and {db-serverless-vector} databases with on-demand (non-PCU) capacity only.
The {product} can create {db-serverless} and {db-serverless-vector} databases.

It cannot deploy {db-classic} (Classic) databases; however, you can use the {product} to <<get-database-details,get information>> about your existing {db-classic} databases.

If your organization requires that new databases to belong to a xref:astra-db-serverless:administration:provisioned-capacity-units.adoc[PCU group], you must xref:astra-db-serverless:databases:create-database.adoc[use the {astra-ui} or {devops-api} to create databases] because the {product} doesn't support PCU group assignment with database creation.
If your organization uses xref:astra-db-serverless:administration:provisioned-capacity-units.adoc[PCU groups], you can specify a PCU group when creating a {db-serverless} or {db-serverless-vector} database with the {product}.

Use the `astra db create` command to create a new {db-serverless} database:

Expand Down Expand Up @@ -412,7 +413,7 @@ OPTIONS
[#manage-collections]
== Manage collections

xref:astra-db-serverless:databases:manage-collections.adoc[Collections] store semi-structured data, in the form of documents, in {db-serverless-vector} databases.
xref:astra-db-serverless:databases:manage-collections.adoc[Collections] store semi-structured data, in the form of documents, in {astra-db} {db-serverless-short} databases.

=== Create a collection

Expand All @@ -425,7 +426,7 @@ You can bring your own embeddings and xref:astra-db-serverless:databases:embeddi
**You must decide which options you need when you create the collection.**
====

Use the `astra db create-collection` command to create a new collection in a {db-serverless-vector} database.
Use the `astra db create-collection` command to create a new collection in an {astra-db} {db-serverless-short} database.
The options to use depend on your desired collection settings.

==== Bring my own embeddings
Expand Down Expand Up @@ -1336,7 +1337,7 @@ OPTIONS

== Manage embedding providers

Use the `astra db list-embedding-providers` command to get a list of the embedding provider integrations that are available for a {db-serverless-vector} database:
Use the `astra db list-embedding-providers` command to get a list of the embedding provider integrations that are available for an {astra-db} {db-serverless-short} database:

[source,bash,subs="+quotes"]
----
Expand Down Expand Up @@ -2381,6 +2382,7 @@ OPTIONS

Use the `get-endpoint-swagger` command to get the Swagger UI endpoint for a database:

//If this is for the Stargate REST API, then it is deprecated.
[source,bash,subs="+quotes"]
----
astra db get-endpoint-swagger **DATABASE_ID**
Expand All @@ -2392,7 +2394,8 @@ astra db get-endpoint-swagger **DATABASE_ID**
https://26054aa9-eb37-4d88-b343-7c934cd1d7bc-us-east-1.apps.astra.datastax.com/api/rest/swagger-ui/
----

Use the `get-endpoint-api` command to get the JSON API endpoint for a {db-serverless-vector} database:
//This is the Data API.
Use the `get-endpoint-api` command to get the JSON API endpoint for an {astra-db} {db-serverless-short} database:

[source,bash,subs="+quotes"]
----
Expand All @@ -2405,6 +2408,7 @@ astra db get-endpoint-api **DATABASE_ID**
https://26054aa9-eb37-4d88-b343-7c934cd1d7bc-us-east-1.apps.astra.datastax.com/api/rest
----

//I think this was for stargate and no longer works.
Use the `get-endpoint-playground` command to get the GraphQL playground endpoint for a non-vector database:

[source,bash,subs="+quotes"]
Expand Down Expand Up @@ -3419,7 +3423,7 @@ For more information, see https://www.ibm.com/docs/en/astra-streaming?topic=astr

CDC for {astra-db} automatically captures changes in real time, de-duplicates the changes, and then streams the clean set of changed data into xref:astra-streaming:ROOT:index.adoc[{astra-stream}] where it can be processed by client applications or sent to downstream systems.

Use the `astra db create-cdc` command to create a CDC connection for a table in a {db-serverless} database:
Use the `astra db create-cdc` command to create a CDC connection for a table in an {astra-db} {db-serverless-short} database:

[source,bash,subs="+quotes"]
----
Expand Down
4 changes: 1 addition & 3 deletions in-progress/quickstart-databases.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,7 @@ Get a list of available regions for database creation.

You can create {db-serverless-vector} and {db-serverless} databases.

[NOTE]
====
If your organization requires that new databases belong to a xref:astra-db-serverless:administration:provisioned-capacity-units.adoc[PCU group], you cannot use the {product} to create databases because it doesn't support PCU group assignment with database creation.
If your organization uses xref:astra-db-serverless:administration:provisioned-capacity-units.adoc[PCU groups], you assign the database to a PCU group when creating the database.
====

Create a database:
Expand Down