Connect to your database
|
The DataStax Astra DB Serverless (Vector) documentation site is currently in Public Preview and is provided on an “AS IS” basis, without warranty or indemnity of any kind. For more, see the DataStax Preview Terms. |
Connect to your vector database with a client library or API.
Prerequisites
-
Active Astra account
-
Astra application token with Database Administrator permissions
Find connection information
Astra database connection information is available in the Astra Portal.
-
Create an application token with Database Administrator permissions (e.g. AstraCS:WSnyFUhRxsrg…).
-
Locate your Database API endpoint (e.g. https://<ASTRA_DB_ID>-<ASTRA_DB_REGION>.apps.astra.datastax.com).
For more on tokens, see Manage application tokens^. For more on permissions, see Manage database roles and permissions^.
-
Assign your token and API endpoint to environment variables in your terminal:
export ASTRA_DB_APPLICATION_TOKEN="AstraCS:..." export ASTRA_DB_API_ENDPOINT="<Astra DB API endpoint>" -
Test the connection by creating a new collection called
test.import os from astrapy.db import AstraDB ASTRA_DB_APPLICATION_TOKEN = os.environ.get("ASTRA_DB_APPLICATION_TOKEN") ASTRA_DB_API_ENDPOINT = os.environ.get("ASTRA_DB_API_ENDPOINT") # Initialization db = AstraDB( token=ASTRA_DB_APPLICATION_TOKEN, api_endpoint=ASTRA_DB_API_ENDPOINT, ) # Create collection col = db.create_collection("test", dimension=5)
See Python client reference for more details.