Interface CreateCollectionOptions<Schema>

Options for creating a new collection (via Db.createCollection).

See Db.createCollection & Collection for more information.

Field

vector - The vector configuration for the collections.

Field

indexing - The indexing configuration for the collections.

Field

defaultId - The default ID for the collections.

Field

keyspace - Overrides the keyspace for the collections.

Field

timeout - The timeout override for this method

See

Db.createCollection

interface CreateCollectionOptions<Schema> {
    defaultId?: CollectionDefaultIdOptions;
    embeddingApiKey?: null | string | EmbeddingHeadersProvider;
    indexing?: CollectionIndexingOptions<Schema>;
    keyspace?: string;
    logging?: DataAPILoggingConfig;
    serdes?: CollectionSerDesConfig;
    timeout?: number | Pick<Partial<TimeoutDescriptor>, "collectionAdminTimeoutMs">;
    timeoutDefaults?: Partial<TimeoutDescriptor>;
    vector?: CollectionVectorOptions;
}

Type Parameters

Hierarchy (view full)

Properties

Options related to the default ID.

embeddingApiKey?: null | string | EmbeddingHeadersProvider

The API key for the embedding service to use, or the EmbeddingHeadersProvider if using a provider that requires it (e.g. AWS bedrock).

Options related to indexing.

keyspace?: string

The keyspace to use for the operation.

The configuration for logging events emitted by the DataAPIClient.

This can be set at any level of the major class hierarchy, and will be inherited by all child classes.

See DataAPILoggingConfig for much more information on configuration, outputs, and inheritance.

Advanced & currently somewhat unstable features related to customizing the collection's ser/des behavior at a lower level.

Use with caution. See official DataStax documentation for more info.

timeout?: number | Pick<Partial<TimeoutDescriptor>, "collectionAdminTimeoutMs">
timeoutDefaults?: Partial<TimeoutDescriptor>
Overview

The default timeout options for any operation performed on this Collection instance.

See TimeoutDescriptor for much more information about timeouts.

Example

// The request timeout for all operations is set to 1000ms.
const client = new DataAPIClient('...', {
  timeoutDefaults: { requestTimeoutMs: 1000 },
});

// The request timeout for all operations borne from this Db is set to 2000ms.
const db = client.db('...', {
  timeoutDefaults: { requestTimeoutMs: 2000 },
});
Inheritance

The timeout options are inherited by all child classes, and can be overridden at any level, including the individual method level.

Individual-method-level overrides can vary in behavior depending on the method; again, see TimeoutDescriptor.

Defaults

The default timeout options are as follows:

  • requestTimeoutMs: 10000
  • generalMethodTimeoutMs: 30000
  • collectionAdminTimeoutMs: 60000
  • tableAdminTimeoutMs: 30000
  • databaseAdminTimeoutMs: 600000
  • keyspaceAdminTimeoutMs: 30000

See

TimeoutDescriptor

Options related to vector search.