Connect with the TypeScript client
You can connect to your Serverless (Vector) databases with the astra-db-ts client.
|
For a guided experience to get started with the TypeScript client, see the Quickstart. |
Prerequisites
-
An active Astra account
-
An active Serverless (Vector) database
Install the TypeScript client
Install the TypeScript client:
-
Verify that Node is version 18 or later:
node --version -
Install astra-db-ts
with your preferred package manager:
-
npm
-
Yarn
-
pnpm
npm install @datastax/astra-db-tsyarn add @datastax/astra-db-tspnpm add @datastax/astra-db-ts -
Upgrade the TypeScript client
When a new client version is released, upgrade your client to get the latest features, improvements, and bug fixes. For information about major changes in specific client versions, see Compare Data API client versions.
Reinstall the TypeScript client at the latest version.
For the TypeScript client, DataStax recommends reinstallation instead of upgrade and update commands, such as npm update @datastax/astra-db-ts, that install the latest version allowed by your package.json.
If your package.json pins a version that is earlier than the actual latest version, then upgrade and update won’t install the actual latest version.
# npm
npm install @datastax/astra-db-ts@latest
# Yarn
yarn add @datastax/astra-db-ts@latest
# pnpm
pnpm add @datastax/astra-db-ts@latestSet environment variables
The Data API requires an application token and your database’s API endpoint for most operations. Store these values in environment variables to simplify reuse in your scripts:
-
Generate an application token with the Database Administrator role, and then get your database’s API endpoint in the form of
https://DATABASE_ID-REGION.apps.astra.datastax.com. For more information, see Generate an application token for a database. -
Set environment variables for your token and API endpoint:
-
Linux or macOS
-
Windows
export ASTRA_DB_API_ENDPOINT=API_ENDPOINT export ASTRA_DB_APPLICATION_TOKEN=TOKENset ASTRA_DB_API_ENDPOINT=API_ENDPOINTset ASTRA_DB_APPLICATION_TOKEN=TOKEN -
Connect to a Serverless (Vector) database
When you use a Data API client, your main entry point is the DataAPIClient object.
Then, you get a database object to connect to a database.
These operations are the basis of your client scripts.
For more information, see Instantiate a client object and Connect to a database.
import { DataAPIClient, VectorDoc, UUID } from '@datastax/astra-db-ts';
const { ASTRA_DB_APPLICATION_TOKEN, ASTRA_DB_API_ENDPOINT } = process.env;
// Initialize the client and get a "Db" object
const client = new DataAPIClient(ASTRA_DB_APPLICATION_TOKEN);
const db = client.db(ASTRA_DB_API_ENDPOINT);
console.log(`* Connected to DB ${db.id}`);Next steps
After you connect to a database, you can extend your script to work with the collections and documents in it. You can also use the TypeScript client to manage databases and keyspaces.
For more information about Astra DB APIs, see Intro to Astra DB APIs and Get started with the Data API.
