diff --git a/in-progress/managing.adoc b/in-progress/managing.adoc index b8b3797..bef6fac 100644 --- a/in-progress/managing.adoc +++ b/in-progress/managing.adoc @@ -58,7 +58,8 @@ Running `astra db create` without any options deploys the database in an availab If the database already exists but is currently xref:astra-db-serverless:databases:database-statuses.adoc[hibernated], the `astra db create` command <> the database. -include::ROOT:partial$async-option-active.adoc[] +By default, the command runs synchronously and doesn't return the command prompt until the database reaches *Terminated* or *Error* status. +To run the command _asynchronously_, add the `--async` option. === `db create` options @@ -195,7 +196,8 @@ astra db create-keyspace **DATABASE_ID** -k **KEYSPACE_NAME** The database enters *Maintenance* status while creating the keyspace. When the database returns to *Active* status, you can use the new keyspace. -include::ROOT:partial$async-option-active.adoc[] +By default, the command runs synchronously and doesn't return the command prompt until the database reaches *Terminated* or *Error* status. +To run the command _asynchronously_, add the `--async` option. [TIP] ==== @@ -257,7 +259,8 @@ Deleting a keyspace permanently deletes all collections, tables, and data in the The database enters *Maintenance* status while it deletes the keyspace along with any collections, tables, and data within the keyspace. -include::ROOT:partial$async-option-active.adoc[] +By default, the command runs synchronously and doesn't return the command prompt until the database reaches *Terminated* or *Error* status. +To run the command _asynchronously_, add the `--async` option. If you delete the default keyspace, {astra-db} automatically selects another keyspace to be the default keyspace. @@ -2239,7 +2242,8 @@ astra db resume **DATABASE_ID** Resuming the database may take a few minutes. -include::ROOT:partial$async-option-active.adoc[] +By default, the command runs synchronously and doesn't return the command prompt until the database reaches *Terminated* or *Error* status. +To run the command _asynchronously_, add the `--async` option. === `db resume` options diff --git a/in-progress/quickstart-databases.adoc b/in-progress/quickstart-databases.adoc index 3ce2538..367cd4b 100644 --- a/in-progress/quickstart-databases.adoc +++ b/in-progress/quickstart-databases.adoc @@ -22,7 +22,6 @@ Get a list of available regions for database creation. You can create {db-serverless-vector} and {db-serverless} databases. 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: @@ -40,17 +39,11 @@ Parameters: | `db_name` | `String` -a| The database name. - -Database names must follow these rules: - -include::common:ROOT:partial$database-name-rules.adoc[] +| The database name. | `region` | `String` (OPTIONAL) -a| A valid xref:databases:regions.adoc[cloud provider region], depending on your xref:administration:subscription-plans.adoc[plan] and the database type. - -include::astra-db-serverless:databases:partial$get-regions-endpoint.adoc[] +| A valid xref:databases:regions.adoc[cloud provider region], depending on your xref:administration:subscription-plans.adoc[plan] and the database type. | `cloud` | `String` (OPTIONAL) @@ -58,7 +51,7 @@ include::astra-db-serverless:databases:partial$get-regions-endpoint.adoc[] | `keyspace` | `String` (OPTIONAL) -a| The name of the database's initial keyspace. +| The name of the database's initial keyspace. If omitted, the default is `default_keyspace`. | `--if-not-exists` @@ -70,7 +63,6 @@ Check for an existing database with the same configuration. | `flag` (OPTIONAL) | By default, the operation is synchronous and waits for the database to become active. Include this option to make the operation asynchronous. - |=== [IMPORTANT] @@ -142,7 +134,6 @@ List all of your databases: astra db list ---- -.Result [source,console,subs="+quotes"] ---- +---------------------+--------------+-----------+-------+---+-----------+ @@ -151,13 +142,11 @@ astra db list | astra_db_client | *DB_ID* | us-east1 | gcp | ■ | ACTIVE | +---------------------+--------------+-----------+-------+---+-----------+ ---- -//ID truncated to prevent bad wrapping. == Drop a database -include::common:ROOT:partial$terminate-db-warn.adoc[] - -Delete a database and erase all data stored in it. +Permanently delete a database, erasing all data stored in it and all backups. +You cannot undo this action. Delete a database by ID: @@ -209,11 +198,7 @@ See xref:databases:create-database.adoc#get-db-id[Get your database ID]. | `KEYSPACE_NAME` | `String` -a| The unique name for the keyspace. - -Keyspace names must follow these rules: - -include::common:ROOT:partial$keyspace-name-rules.adoc[] +| The unique name for the keyspace. |=== == List keyspaces diff --git a/modules/ROOT/pages/install.adoc b/modules/ROOT/pages/install.adoc index 72b6932..1d8f25e 100644 --- a/modules/ROOT/pages/install.adoc +++ b/modules/ROOT/pages/install.adoc @@ -137,14 +137,14 @@ To install the {product} on Windows, you can use a scripted installation or bina . Run the following command to install the latest version of the {product} to the default location: + -[source,powershell] +[source,shell] ---- powershell -c "irm https://ibm.biz/astra-cli-win | iex" ---- + To install the {product} to a custom location, export the `ASTRA_HOME` environment variable before running the installation command, replacing `**INSTALLATION_DIRECTORY**` with the full path to your preferred installation directory: + -[source,powershell,subs="+quotes"] +[source,shell,subs="+quotes"] ---- $env:ASTRA_HOME = "**INSTALLATION_DIRECTORY**" ---- @@ -153,7 +153,7 @@ $env:ASTRA_HOME = "**INSTALLATION_DIRECTORY**" . Run the `astra` command from any directory to verify successful installation: + -[source,powershell] +[source,shell] ---- astra ---- @@ -166,7 +166,7 @@ The response includes available commands and options for the {product}. . Extract the zip file into the directory where you want to install the {product}: + -[source,powershell,subs="+quotes"] +[source,shell,subs="+quotes"] ---- powershell -C "Expand-Archive -Path astra-windows-x86_64.zip -DestinationPath **INSTALLATION_DIRECTORY** -Force" ---- @@ -180,7 +180,7 @@ For more information, see the https://learn.microsoft.com/en-us/powershell/modul . Run the `astra` command from any directory to verify successful installation: + -[source,powershell] +[source,shell] ---- astra ---- diff --git a/modules/ROOT/pages/manage-cli.adoc b/modules/ROOT/pages/manage-cli.adoc index 164cc11..ddfd2ec 100644 --- a/modules/ROOT/pages/manage-cli.adoc +++ b/modules/ROOT/pages/manage-cli.adoc @@ -63,19 +63,11 @@ For more advanced methods of creating and managing configuration profiles, see < ---- astra setup ---- + +. Press kbd:[Enter] to continue: + -.Result [source,console] ---- - _____ __ - / _ \ _______/ |_____________ - / /_\ \ / ___/\ __\_ __ \__ \ - / | \\___ \ | | | | \ //__ \_ - \____|__ /____ > |__| |__| (____ / - \/ \/ \/ - - Version: x.x.x - Welcome to the interactive Astra CLI setup! Your configuration file will be created at /Users/username/.astrarc @@ -83,38 +75,34 @@ Your configuration file will be created at /Users/username/.astrarc Press Enter to continue, or use Ctrl+C to cancel. ---- -. Press kbd:[Enter] to continue. +. When prompted, enter your application token (`AstraCS:...`), and then press kbd:[Enter]: + -.Result [source,console] ---- (Required) Enter your Astra token (it should start with AstraCS) > input hidden for security ---- -. Enter your application token (`AstraCS:...`), and then press kbd:[Enter]. +. Enter a name for your configuration profile, or press kbd:[Enter] to accept the default (your organization name): + -.Result [source,console] ---- (Optional) Enter a name for your profile (defaults to your org name) > ---- - -. Enter a name for your configuration profile, or press kbd:[Enter] to accept the default (your organization name). + -.Result +The {product} automatically sets the configuration profile as the default. +All subsequent commands use this profile unless you <>. ++ [source,console] ---- Profile 'PROFILE_NAME' successfully created. It has been set as the default profile. ---- -+ -The {product} automatically sets the configuration profile as the default. -All subsequent commands use this profile unless you <>. . Run a command to test the connection. ++ For example: + [source,shell] @@ -122,7 +110,9 @@ For example: astra db list-clouds ---- + -.Result +If the command succeeds, your connection is configured correctly. +For example, the `list-clouds` command returns a list of cloud providers: ++ [source,console] ---- ┌─────────────────┐ @@ -133,8 +123,6 @@ astra db list-clouds │ aws │ └─────────────────┘ ---- -+ -If the command succeeds, your connection is configured correctly. [#authenticate-individual-command] === Authenticate an individual command @@ -164,7 +152,8 @@ Run `astra` by itself to print general help information: astra ---- + -.Result +The output lists available commands and general help information: ++ [source,console] ---- _____ __ @@ -232,7 +221,8 @@ Append the `-h` / `--help` option to any command to get specific help informatio astra org -h ---- + -.Result +The output is based on the specified command: ++ [source,console] ---- Usage: astra org [-qV] [--no-input] [--[no-]spinner] [--dump-logs[=FILE]] @@ -293,7 +283,8 @@ Append the `-h` / `--help` option to any subcommand to get specific help informa astra db list --help ---- + -.Result +The output is based on the specified subcommand: ++ [source,console] ---- Usage: astra db list [-qvV] [--no-input] [--[no-]spinner] [--dump-logs[=FILE]] @@ -382,7 +373,9 @@ Use the `xref:commands:astra-config-list.adoc[]` command to list all of your con astra config list ---- -.Result +The output shows the list of configuration profiles. +The default configuration profile is indicated by `(in use)`. + [source,console] ---- ┌─────────────────────┐ @@ -393,12 +386,11 @@ astra config list └─────────────────────┘ ---- -The default configuration profile is indicated by `(in use)`. + Configuration profiles are stored in the following format in the `<>` file: -..astrarc -[source,ini,subs="+quotes"] +[source,plaintext,subs="+quotes"] ---- [Production] ASTRA_DB_APPLICATION_TOKEN=AstraCS:**IGXWg...** @@ -422,7 +414,8 @@ Use the `xref:commands:astra-config-create.adoc[]` command to create a new confi astra config create '**PROFILE_NAME**' --token **APPLICATION_TOKEN** ---- -.Result +The output shows the new profile name and a hint to set it as your default configuration profile: + [source,console] ---- Configuration profile 'PROFILE_NAME' successfully created. @@ -435,9 +428,10 @@ $ astra config use 'PROFILE_NAME' You can also use the `xref:commands:astra-setup.adoc[]` command again to create additional configuration profiles interactively. -.Enclose arguments in quotes when they contain spaces [TIP] ==== +Enclose arguments in quotes when they contain spaces. + When specifying arguments that contain spaces (for example, profile names like `Test 1`), you must wrap the value in single quotes (`''`). This ensures that your shell treats the entire phrase as one argument rather than splitting it into separate words. @@ -461,7 +455,8 @@ Use the `xref:commands:astra-config-use.adoc[]` command to change the default co astra config use '**PROFILE_NAME**' ---- -.Result +The output confirms that the default profile has been set: + [source,console] ---- Default profile set to 'PROFILE_NAME'. @@ -486,6 +481,12 @@ If you want to run a command using an application token directly, without having === Delete a configuration profile +[TIP] +==== +If you delete the default configuration profile, the {product} _doesn't_ automatically select a new default configuration profile. +You must use the `xref:commands:astra-config-use.adoc[]` command to set a new default configuration profile. +==== + Use the `xref:commands:astra-config-delete.adoc[]` command to delete a configuration profile: [source,shell,subs="+quotes"] @@ -493,37 +494,29 @@ Use the `xref:commands:astra-config-delete.adoc[]` command to delete a configura astra config delete '**PROFILE_NAME**' ---- -.Result +The output shows that the profile was deleted: + [source,console] ---- Profile 'PROFILE_NAME' deleted successfully. ---- -[NOTE] -==== -If you delete the default configuration profile, the {product} _doesn't_ automatically select a new default configuration profile. -You must use the `xref:commands:astra-config-use.adoc[]` command to set a new default configuration profile. -==== - [#file-locations] == {product} file locations The {product} stores installation and configuration files in the following locations: -[cols="1h,2"] +[cols=4] |=== -|File / Folder |Description +|File or Folder |Description |Default location |Contents |`.astra` -a|The {product} home folder (`ASTRA_HOME`). - -_Default location_: - +|The {product} home folder (`ASTRA_HOME`) +a| * macOS and Linux: `~/.astra` * Windows: `%USERPROFILE%\.astra` * All platforms: If the `XDG_DATA_HOME` environment variable is set, then the default location is `$XDG_DATA_HOME/astra`. - -The {product} home folder contains the following items: +a|The {product} home folder contains the following items: * The `astra` executable (scripted installations only) * Accessory executables that are downloaded by certain commands, such as `xref:commands:astra-db-cqlsh.adoc[]` and `xref:commands:astra-db-dsbulk.adoc[]` @@ -531,22 +524,17 @@ The {product} home folder contains the following items: * Cache files for <> * Logs -For more information about `ASTRA_HOME`, see the https://github.com/datastax/astra-cli?tab=readme-ov-file#home-folder-location[{product} README]. - |`.astrarc` -a|The {product} configuration file. - -_Default location_: - +|The {product} configuration file. +a| * macOS and Linux: `~/.astrarc` * Windows: `%USERPROFILE%\.astrarc` * All platforms: If the `XDG_CONFIG_HOME` environment variable is set, then the default location is `$XDG_CONFIG_HOME/astra/.astrarc`. - -The {product} uses this file to store your <> and their associated application tokens. - -For more information about the {product} configuration file, see the https://github.com/datastax/astra-cli?tab=readme-ov-file#astrarc-location[{product} README]. +|The {product} uses this file to store your <> and their associated application tokens. |=== +For more information, see the https://github.com/datastax/astra-cli?tab=readme-ov-file#astrarc-location[{product} README]. + === Override the default home folder location You can override the default location of the {product} home folder (`.astra`) by setting the `ASTRA_HOME` environment variable: @@ -617,7 +605,6 @@ Structured JSON format, suitable for programmatic parsing. + Every command that supports JSON output always returns a response using exactly this schema: + -.JSON output schema [source,json] ---- { @@ -635,9 +622,8 @@ Every command that supports JSON output always returns a response using exactly } ---- + -All field names in the JSON output are in camel case (`fieldName`). +All field names in the JSON output are in camel case (`fieldName`): + -.JSON output fields [cols="1,1,2"] |=== |Name |Type |Summary @@ -681,8 +667,7 @@ Comma-separated output format, ideal for data export and analysis. + Every command that supports CSV output always returns an RFC-4180-compliant response using exactly this schema: + -.CSV output schema -[source,csv] +[source,plaintext] ---- code,message,data_field_1,data_field_2,... ---- @@ -695,7 +680,6 @@ Each subsequent row represents one data record from the command. The `code` and `message` fields can repeat for each row of data to keep the CSV schema consistent. Values can contain commas or newlines, and they can be wrapped in quotes to ensure RFC-4180-compliant CSV output. + -.CSV output fields [cols="1,1,2"] |=== |Name |Type |Summary @@ -729,7 +713,7 @@ Fields can be empty if there is nothing to report. Column order is consistent per command. |=== -[NOTE] +[TIP] ==== -For commands that issue GET requests, the `json` response generally contains the raw response from the server, whereas the `human` and `csv` formats contain a simplified version of the data. +For commands that issue `GET` requests, the `json` response generally contains the raw response from the server, whereas the `human` and `csv` formats contain a simplified version of the data. ==== \ No newline at end of file diff --git a/modules/ROOT/pages/uninstall.adoc b/modules/ROOT/pages/uninstall.adoc index 9e70c5d..abd9448 100644 --- a/modules/ROOT/pages/uninstall.adoc +++ b/modules/ROOT/pages/uninstall.adoc @@ -17,19 +17,11 @@ To uninstall the {product} on macOS and Linux, you can use either `astra nuke` o ---- astra nuke ---- + +. When prompted `Are you sure you want to entirely delete Astra CLI from your system?`, select kbd:[yes], and then press kbd:[Enter]: + -.Result [source,console] ---- - _____ __ - / _ \ _______/ |_____________ - / /_\ \ / ___/\ __\_ __ \__ \ - / | \\___ \ | | | | \ //__ \_ - \____|__ /____ > |__| |__| (____ / - \/ \/ \/ - - Version: x.x.x - Are you sure you want to entirely delete Astra CLI from your system? This action is irreversible and will delete all Astra CLI files from your system. @@ -39,9 +31,10 @@ This action is irreversible and will delete all Astra CLI files from your system ↑↓ to navigate, Enter to select, type to filter ---- -. When prompted to continue, select kbd:[yes], and then press kbd:[Enter]. +. When prompted, select whether to delete the `xref:ROOT:manage-cli.adoc#file-locations[.astrarc]` file. ++ +Only select kbd:[yes] if you _don't_ want to preserve your xref:ROOT:manage-cli.adoc#manage-configuration-profiles[configuration profiles]. + -.Result [source,console] ---- Do you also want to delete the .astrarc file located at /Users/username/.astrarc? @@ -53,11 +46,11 @@ Your credentials may be lost if you do. A backup is recommended. > no (default) ---- -. Select whether to delete the `xref:ROOT:manage-cli.adoc#file-locations[.astrarc]` file, and then press kbd:[Enter] to continue. +. Press kbd:[Enter] to proceed with the `astra nuke` operation. + -Only select kbd:[yes] if you don't want to preserve your xref:ROOT:manage-cli.adoc#manage-configuration-profiles[configuration profiles]. +Progress is reported in the terminal. +If you chose to keep the `.astrarc` file, the output shows that the file was skipped. + -.Result [source,console] ---- Astra CLI Nuke Summary @@ -110,7 +103,7 @@ Only use this method if you installed the {product} using the xref:ROOT:install. . Optional: If you don't want to preserve your xref:ROOT:manage-cli.adoc#manage-configuration-profiles[configuration profiles], delete the `xref:ROOT:manage-cli.adoc#file-locations[.astrarc]` file: + -[source,powershell] +[source,shell] ---- rm -f $(astra config path -p) ---- @@ -122,23 +115,15 @@ For specific instructions, see https://support.microsoft.com/en-us/windows/unins . Run the `xref:commands:astra-nuke.adoc[]` command: + -[source,powershell] +[source,shell] ---- astra nuke ---- + +. When prompted `Are you sure you want to entirely delete Astra CLI from your system?`, select kbd:[yes], and then press kbd:[Enter]: + -.Result [source,console] ---- - _____ __ - / _ \ _______/ |_____________ - / /_\ \ / ___/\ __\_ __ \__ \ - / | \\___ \ | | | | \ //__ \_ - \____|__ /____ > |__| |__| (____ / - \/ \/ \/ - - Version: x.x.x - Are you sure you want to entirely delete Astra CLI from your system? This action is irreversible and will delete all Astra CLI files from your system. @@ -148,9 +133,10 @@ This action is irreversible and will delete all Astra CLI files from your system ↑↓ to navigate, Enter to select, type to filter ---- -. When prompted to continue, select kbd:[yes] and press kbd:[Enter]. +. When prompted, select whether to delete the `xref:ROOT:manage-cli.adoc#file-locations[.astrarc]` file. ++ +Only select kbd:[yes] if you _don't_ want to preserve your xref:ROOT:manage-cli.adoc#manage-configuration-profiles[configuration profiles]. + -.Result [source,console] ---- Do you also want to delete the .astrarc file located at ? @@ -162,11 +148,11 @@ Your credentials may be lost if you do. A backup is recommended. > no (default) ---- -. Select whether to delete the `xref:ROOT:manage-cli.adoc#file-locations[.astrarc]` file, and then press kbd:[Enter] to continue. +. Press kbd:[Enter] to proceed with the `astra nuke` operation. + -Only select kbd:[yes] if you don't want to preserve your xref:ROOT:manage-cli.adoc#manage-configuration-profiles[configuration profiles]. +Progress is reported in the terminal. +If you chose to keep the `.astrarc` file, the output shows that the file was skipped. + -.Result [source,console] ---- Astra CLI Nuke Summary @@ -182,27 +168,28 @@ Files skipped: ---- . Optional: Manually remove `astra` from your system `PATH`. ++ For more information, see the https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables[Microsoft PowerShell documentation]. === Manual removal on Windows . Optional: If you don't want to preserve your xref:ROOT:manage-cli.adoc#manage-configuration-profiles[configuration profiles], delete the `xref:ROOT:manage-cli.adoc#file-locations[.astrarc]` file: + -[source,powershell] +[source,shell] ---- rm -f $(astra config path -p) ---- . Delete the xref:ROOT:manage-cli.adoc#file-locations[{product} home folder]: + -[source,powershell] +[source,shell] ---- rm -r -f $(astra config home path -p) ---- . Delete the `astra` binary if it still exists: + -[source,powershell] +[source,shell] ---- rm -f (Get-Command astra).Source ---- @@ -223,18 +210,10 @@ Only use this method if you installed the {product} with Homebrew. astra nuke ---- + -.Result +.. When prompted `Are you sure you want to entirely delete Astra CLI from your system?`, select kbd:[yes], and then press kbd:[Enter]: ++ [source,console] ---- - _____ __ - / _ \ _______/ |_____________ - / /_\ \ / ___/\ __\_ __ \__ \ - / | \\___ \ | | | | \ //__ \_ - \____|__ /____ > |__| |__| (____ / - \/ \/ \/ - - Version: x.x.x - Are you sure you want to entirely delete Astra CLI from your system? This action is irreversible and will delete all Astra CLI files from your system. @@ -244,9 +223,10 @@ This action is irreversible and will delete all Astra CLI files from your system ↑↓ to navigate, Enter to select, type to filter ---- + -.. When prompted to continue, select kbd:[yes] and press kbd:[Enter]. +.. When prompted, select whether to delete the `xref:ROOT:manage-cli.adoc#file-locations[.astrarc]` file. ++ +Only select kbd:[yes] if you _don't_ want to preserve your xref:ROOT:manage-cli.adoc#manage-configuration-profiles[configuration profiles]. + -.Result [source,console] ---- Do you also want to delete the .astrarc file located at /Users/username/.astrarc? @@ -258,13 +238,11 @@ Your credentials may be lost if you do. A backup is recommended. > no (default) ---- + -.. Select whether to delete the `xref:ROOT:manage-cli.adoc#file-locations[.astrarc]` file. -+ -Only select kbd:[yes] if you don't want to preserve your xref:ROOT:manage-cli.adoc#manage-configuration-profiles[configuration profiles]. +.. Press kbd:[Enter] to proceed with the `astra nuke` operation. + -Press kbd:[Enter] to continue. +Progress is reported in the terminal. +If you chose to keep the `.astrarc` file, the output shows that the file was skipped. + -.Result [source,console] ---- Astra CLI Nuke Summary diff --git a/modules/quickstarts/pages/cqlsh.adoc b/modules/quickstarts/pages/cqlsh.adoc index b29dcb4..771f759 100644 --- a/modules/quickstarts/pages/cqlsh.adoc +++ b/modules/quickstarts/pages/cqlsh.adoc @@ -54,7 +54,8 @@ Use the `xref:commands:astra-db-cqlsh-start.adoc[]` command to start `cqlsh` in astra db cqlsh start **DB_ID** ---- -.Result +A successful connection shows the connection details and the `cqlsh` prompt: + [source,console] ---- [INFO] Patched cqlsh script to try known supported Python versions first @@ -68,14 +69,17 @@ To exit `cqlsh`, type `exit` or `quit;` and then press kbd:[Enter]. == Issue a CQL statement directly -Use the `xref:commands:astra-db-cqlsh-exec.adoc[]` command to issue a CQL statement directly from your terminal without starting an interactive `cqlsh` session: +Use the `xref:commands:astra-db-cqlsh-exec.adoc[]` command to issue a CQL statement directly from your terminal without starting an interactive `cqlsh` session. + +For example, run `DESCRIBE KEYSPACES`: [source,shell,subs="+quotes"] ---- astra db cqlsh exec **DB_ID** "describe keyspaces;" ---- -.Result +The result of `DESCRIBE KEYSPACES` is printed to the terminal: + [source,console] ---- system_auth data_endpoint_auth default_keyspace system_views @@ -94,7 +98,8 @@ Use the `-f` / `--file` option with the `xref:commands:astra-db-cqlsh-exec.adoc[ astra db cqlsh exec **DB_ID** -f sample.cql ---- -.Example CQL file (sample.cql) +For example, using the following `sample.cql` file: + [source,cql] ---- -- Use a specific keyspace @@ -115,7 +120,8 @@ INSERT INTO users (id, name, email) VALUES (uuid(), 'Bob', 'bob@example.com'); SELECT * FROM users; ---- -.Result +The result is printed to the terminal: + [source,console] ---- id | email | name @@ -137,7 +143,8 @@ Use the `-k` / `--keyspace` option to connect directly to a specific keyspace: astra db cqlsh start **DB_ID** -k **KEYSPACE_NAME** ---- + -.Result +The `cqlsh` prompt shows the selected keyspace: ++ [source,console] ---- Connected to cndb at 127.0.0.1:9042. @@ -153,7 +160,8 @@ token@cqlsh:my_keyspace> astra db cqlsh exec **DB_ID** -k **KEYSPACE_NAME** "DESC TABLES" ---- + -.Result +The result of the `DESC TABLES` command is printed to the terminal: ++ [source,console] ---- repairs view_builds_in_progress paxos transferred_ranges