From fb5715c3f0f05edb7c8d82d196b98000da403ba7 Mon Sep 17 00:00:00 2001 From: April M <36110273+aimurphy@users.noreply.github.com> Date: Mon, 13 Jul 2026 18:50:20 -0700 Subject: [PATCH] non-published changes for deployment types and pcu --- antora.yml | 1 + in-progress/dsbulk.adoc | 2 +- in-progress/managing.adoc | 18 +++++++++++------- in-progress/quickstart-databases.adoc | 4 +--- 4 files changed, 14 insertions(+), 11 deletions(-) diff --git a/antora.yml b/antora.yml index f37cc82..079c92f 100644 --- a/antora.yml +++ b/antora.yml @@ -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' diff --git a/in-progress/dsbulk.adoc b/in-progress/dsbulk.adoc index b4bed78..f0b6f57 100644 --- a/in-progress/dsbulk.adoc +++ b/in-progress/dsbulk.adoc @@ -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] ---- diff --git a/in-progress/managing.adoc b/in-progress/managing.adoc index 4a0462a..b8b3797 100644 --- a/in-progress/managing.adoc +++ b/in-progress/managing.adoc @@ -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 <> 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: @@ -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 @@ -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 @@ -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"] ---- @@ -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** @@ -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"] ---- @@ -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"] @@ -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"] ---- diff --git a/in-progress/quickstart-databases.adoc b/in-progress/quickstart-databases.adoc index fc7429f..3ce2538 100644 --- a/in-progress/quickstart-databases.adoc +++ b/in-progress/quickstart-databases.adoc @@ -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: