Skip to content

Interface: ProvisionOptions

Options for SearchClient.provision - a one-call “make this index real and searchable” used at boot or in a seed script. It ensures the endpoint, ensures the index, and (optionally) seeds documents when the index is empty.

optional columnsToSync?: string[]

Extra columns to sync alongside the embedding source (Delta Sync).

CreateIndexOptions.columnsToSync


optional embeddingDimension?: number

For a direct-access index: the embedding vector dimension (self-managed vectors, no source table).

CreateIndexOptions.embeddingDimension


optional embeddingModel?: string

Embedding model endpoint. A loose name is fuzzy-matched; when omitted the best embedding endpoint in the workspace is chosen (resolveEmbeddingModel).

CreateIndexOptions.embeddingModel


optional embeddingSourceColumn?: string

The text column embeddings are computed from (Delta Sync). Defaults to the first of text / content / body present, else the caller must set it.

CreateIndexOptions.embeddingSourceColumn


optional embeddingVectorColumn?: string

For a direct-access index: the column the vector is stored in. Defaults to embedding.

CreateIndexOptions.embeddingVectorColumn


optional endpoint?: string

Vector Search endpoint to host the index on. Defaults to the plugin’s endpoint.

CreateIndexOptions.endpoint


optional pipelineType?: "TRIGGERED" | "CONTINUOUS"

Sync mode for a Delta Sync index. TRIGGERED (default) syncs on demand; CONTINUOUS keeps fresh.

CreateIndexOptions.pipelineType


optional primaryKey?: string

Primary-key column. Defaults to id.

CreateIndexOptions.primaryKey


optional schema?: Record<string, string>

The column-name -> type map used to build a direct-access index’s schema_json (types: string, int, long, float, double, boolean, date, timestamp). Must include the primary key and any columns you upsert. Defaults to { id: "string", text: "string" }. The embedding vector column is added automatically.

CreateIndexOptions.schema


optional seed?: Record<string, unknown>[]

Documents to seed when the index has no rows yet. Skipped if it already has data.


optional signal?: AbortSignal

External cancellation.

CreateIndexOptions.signal


optional sourceTable?: string

Source Delta table (catalog.schema.table) for a Delta Sync index. Provide this for the common case: Databricks computes and syncs embeddings from it. Omit it (and pass embeddingDimension) to create a direct-access index you write vectors to yourself.

CreateIndexOptions.sourceTable


optional timeoutMs?: number

How long to wait for readiness before giving up. Defaults to 20 minutes.


optional wait?: boolean

Wait for the endpoint AND index to come online before returning (needed before seeding). Defaults to true. Endpoint creation can take many minutes.