mirror of
https://github.com/lancedb/lancedb.git
synced 2026-05-19 04:50:40 +00:00
25dfe2cfd4
Adds manifest_enabled for local/native connections so directory namespace manifests can be the source of truth, including migration from directory listing and Azure credential vending feature wiring. Also exposes the option through Rust, Python, and Node bindings with focused validation.
116 lines
2.3 KiB
Markdown
116 lines
2.3 KiB
Markdown
[**@lancedb/lancedb**](../README.md) • **Docs**
|
|
|
|
***
|
|
|
|
[@lancedb/lancedb](../globals.md) / ConnectionOptions
|
|
|
|
# Interface: ConnectionOptions
|
|
|
|
## Properties
|
|
|
|
### apiKey?
|
|
|
|
```ts
|
|
optional apiKey: string;
|
|
```
|
|
|
|
(For LanceDB cloud only): the API key to use with LanceDB Cloud.
|
|
|
|
Can also be set via the environment variable `LANCEDB_API_KEY`.
|
|
|
|
***
|
|
|
|
### clientConfig?
|
|
|
|
```ts
|
|
optional clientConfig: ClientConfig;
|
|
```
|
|
|
|
(For LanceDB cloud only): configuration for the remote HTTP client.
|
|
|
|
***
|
|
|
|
### hostOverride?
|
|
|
|
```ts
|
|
optional hostOverride: string;
|
|
```
|
|
|
|
(For LanceDB cloud only): the host to use for LanceDB cloud. Used
|
|
for testing purposes.
|
|
|
|
***
|
|
|
|
### manifestEnabled?
|
|
|
|
```ts
|
|
optional manifestEnabled: boolean;
|
|
```
|
|
|
|
(For LanceDB OSS only): use directory namespace manifests as the source
|
|
of truth for table metadata. Existing directory-listed root tables are
|
|
migrated into the manifest on access.
|
|
|
|
***
|
|
|
|
### namespaceClientProperties?
|
|
|
|
```ts
|
|
optional namespaceClientProperties: Record<string, string>;
|
|
```
|
|
|
|
(For LanceDB OSS only): extra properties for the backing namespace
|
|
client used by manifest-enabled native connections.
|
|
|
|
***
|
|
|
|
### readConsistencyInterval?
|
|
|
|
```ts
|
|
optional readConsistencyInterval: number;
|
|
```
|
|
|
|
(For LanceDB OSS only): The interval, in seconds, at which to check for
|
|
updates to the table from other processes. If None, then consistency is not
|
|
checked. For performance reasons, this is the default. For strong
|
|
consistency, set this to zero seconds. Then every read will check for
|
|
updates from other processes. As a compromise, you can set this to a
|
|
non-zero value for eventual consistency. If more than that interval
|
|
has passed since the last check, then the table will be checked for updates.
|
|
Note: this consistency only applies to read operations. Write operations are
|
|
always consistent.
|
|
|
|
***
|
|
|
|
### region?
|
|
|
|
```ts
|
|
optional region: string;
|
|
```
|
|
|
|
(For LanceDB cloud only): the region to use for LanceDB cloud.
|
|
Defaults to 'us-east-1'.
|
|
|
|
***
|
|
|
|
### session?
|
|
|
|
```ts
|
|
optional session: Session;
|
|
```
|
|
|
|
(For LanceDB OSS only): the session to use for this connection. Holds
|
|
shared caches and other session-specific state.
|
|
|
|
***
|
|
|
|
### storageOptions?
|
|
|
|
```ts
|
|
optional storageOptions: Record<string, string>;
|
|
```
|
|
|
|
(For LanceDB OSS only): configuration for object storage.
|
|
|
|
The available options are described at https://docs.lancedb.com/storage/
|