Interface DbSpawnOptions

The path to the Data API, which is going to be api/json/v1 for all Astra instances. However, it may vary if you're using a different Data API-compatible endpoint.

Defaults to 'api/json/v1' if never provided. However, if it was provided when creating the DataAPIClient, it will default to that value instead.

Default Value

'api/json/v1'
Copy

Whether to monitor commands for Db-level & Collection-level events through an event emitter.

Defaults to false if never provided. However, if it was provided when creating the DataAPIClient, it will default to that value instead.

Example

const client = new DataAPIClient('*TOKEN*', {
  dbOptions: {
    monitorCommands: true,
  },
});

client.on('commandStarted', (event) => {
  console.log(`Running command ${event.commandName}`);
});

client.on('commandSucceeded', (event) => {
  console.log(`Command ${event.commandName} succeeded in ${event.duration}ms`);
});

client.on('commandFailed', (event) => {
  console.error(`Command ${event.commandName} failed w/ error ${event.error}`);
});

const db = client.db('https://<db_id>-<region>.apps.astra.datastax.com');
const coll = db.collection('my_collection');

// Logs:
// - Running command insertOne
// - Command insertOne succeeded in <time>ms
await coll.insertOne({ name: 'Lordi' });
Copy

Default Value

false
Copy

See

DataAPICommandEvents

The namespace (aka keyspace) to use for the database.

Defaults to 'default_keyspace'. if never provided. However, if it was provided when creating the DataAPIClient, it will default to that value instead.

Every db method will use this namespace as the default namespace, but they all allow you to override it in their options.

Example

const client = new DataAPIClient('AstraCS:...');

// Using 'default_keyspace' as the namespace
const db1 = client.db('https://<db_id>-<region>.apps.astra.datastax.com');

// Using 'my_namespace' as the namespace
const db2 = client.db('https://<db_id>-<region>.apps.astra.datastax.com', {
  namespace: 'my_keyspace',
});

// Finds 'my_collection' in 'default_keyspace'
const coll1 = db1.collection('my_collection');

// Finds 'my_collection' in 'my_namespace'
const coll2 = db1.collection('my_collection');

// Finds 'my_collection' in 'other_keyspace'
const coll3 = db1.collection('my_collection', { namespace: 'other_keyspace' });
Copy

Default Value

'default_keyspace'
Copy

The access token for the Data API, typically of the format 'AstraCS:...'.

If never provided, this will default to the token provided when creating the DataAPIClient.

Example

const client = new DataAPIClient('strong-token');

// Using 'strong-token' as the token
const db1 = client.db('https://<db_id>-<region>.apps.astra.datastax.com');

// Using 'weaker-token' instead of 'strong-token'
const db2 = client.db('https://<db_id>-<region>.apps.astra.datastax.com', {
  token: 'weaker-token',
});
Copy