mirror of
https://github.com/lancedb/lancedb.git
synced 2025-12-27 07:09:57 +00:00
48f46d4751
`indexStats` still referenced UUID even though in https://github.com/lancedb/lancedb/pull/1702 we changed it to take name instead.
323 lines
6.9 KiB
Markdown
323 lines
6.9 KiB
Markdown
[vectordb](../README.md) / [Exports](../modules.md) / LocalConnection
|
||
|
||
# Class: LocalConnection
|
||
|
||
A connection to a LanceDB database.
|
||
|
||
## Implements
|
||
|
||
- [`Connection`](../interfaces/Connection.md)
|
||
|
||
## Table of contents
|
||
|
||
### Constructors
|
||
|
||
- [constructor](LocalConnection.md#constructor)
|
||
|
||
### Properties
|
||
|
||
- [\_db](LocalConnection.md#_db)
|
||
- [\_options](LocalConnection.md#_options)
|
||
|
||
### Accessors
|
||
|
||
- [uri](LocalConnection.md#uri)
|
||
|
||
### Methods
|
||
|
||
- [createTable](LocalConnection.md#createtable)
|
||
- [createTableImpl](LocalConnection.md#createtableimpl)
|
||
- [dropTable](LocalConnection.md#droptable)
|
||
- [openTable](LocalConnection.md#opentable)
|
||
- [tableNames](LocalConnection.md#tablenames)
|
||
- [withMiddleware](LocalConnection.md#withmiddleware)
|
||
|
||
## Constructors
|
||
|
||
### constructor
|
||
|
||
• **new LocalConnection**(`db`, `options`)
|
||
|
||
#### Parameters
|
||
|
||
| Name | Type |
|
||
| :------ | :------ |
|
||
| `db` | `any` |
|
||
| `options` | [`ConnectionOptions`](../interfaces/ConnectionOptions.md) |
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:739](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L739)
|
||
|
||
## Properties
|
||
|
||
### \_db
|
||
|
||
• `Private` `Readonly` **\_db**: `any`
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:737](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L737)
|
||
|
||
___
|
||
|
||
### \_options
|
||
|
||
• `Private` `Readonly` **\_options**: () => [`ConnectionOptions`](../interfaces/ConnectionOptions.md)
|
||
|
||
#### Type declaration
|
||
|
||
▸ (): [`ConnectionOptions`](../interfaces/ConnectionOptions.md)
|
||
|
||
##### Returns
|
||
|
||
[`ConnectionOptions`](../interfaces/ConnectionOptions.md)
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:736](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L736)
|
||
|
||
## Accessors
|
||
|
||
### uri
|
||
|
||
• `get` **uri**(): `string`
|
||
|
||
#### Returns
|
||
|
||
`string`
|
||
|
||
#### Implementation of
|
||
|
||
[Connection](../interfaces/Connection.md).[uri](../interfaces/Connection.md#uri)
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:744](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L744)
|
||
|
||
## Methods
|
||
|
||
### createTable
|
||
|
||
▸ **createTable**\<`T`\>(`name`, `data?`, `optsOrEmbedding?`, `opt?`): `Promise`\<[`Table`](../interfaces/Table.md)\<`T`\>\>
|
||
|
||
Creates a new Table, optionally initializing it with new data.
|
||
|
||
#### Type parameters
|
||
|
||
| Name |
|
||
| :------ |
|
||
| `T` |
|
||
|
||
#### Parameters
|
||
|
||
| Name | Type |
|
||
| :------ | :------ |
|
||
| `name` | `string` \| [`CreateTableOptions`](../interfaces/CreateTableOptions.md)\<`T`\> |
|
||
| `data?` | `Table`\<`any`\> \| `Record`\<`string`, `unknown`\>[] |
|
||
| `optsOrEmbedding?` | [`WriteOptions`](../interfaces/WriteOptions.md) \| [`EmbeddingFunction`](../interfaces/EmbeddingFunction.md)\<`T`\> |
|
||
| `opt?` | [`WriteOptions`](../interfaces/WriteOptions.md) |
|
||
|
||
#### Returns
|
||
|
||
`Promise`\<[`Table`](../interfaces/Table.md)\<`T`\>\>
|
||
|
||
#### Implementation of
|
||
|
||
[Connection](../interfaces/Connection.md).[createTable](../interfaces/Connection.md#createtable)
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:788](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L788)
|
||
|
||
___
|
||
|
||
### createTableImpl
|
||
|
||
▸ `Private` **createTableImpl**\<`T`\>(`«destructured»`): `Promise`\<[`Table`](../interfaces/Table.md)\<`T`\>\>
|
||
|
||
#### Type parameters
|
||
|
||
| Name |
|
||
| :------ |
|
||
| `T` |
|
||
|
||
#### Parameters
|
||
|
||
| Name | Type |
|
||
| :------ | :------ |
|
||
| `«destructured»` | `Object` |
|
||
| › `data?` | `Table`\<`any`\> \| `Record`\<`string`, `unknown`\>[] |
|
||
| › `embeddingFunction?` | [`EmbeddingFunction`](../interfaces/EmbeddingFunction.md)\<`T`\> |
|
||
| › `name` | `string` |
|
||
| › `schema?` | `Schema`\<`any`\> |
|
||
| › `writeOptions?` | [`WriteOptions`](../interfaces/WriteOptions.md) |
|
||
|
||
#### Returns
|
||
|
||
`Promise`\<[`Table`](../interfaces/Table.md)\<`T`\>\>
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:822](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L822)
|
||
|
||
___
|
||
|
||
### dropTable
|
||
|
||
▸ **dropTable**(`name`): `Promise`\<`void`\>
|
||
|
||
Drop an existing table.
|
||
|
||
#### Parameters
|
||
|
||
| Name | Type | Description |
|
||
| :------ | :------ | :------ |
|
||
| `name` | `string` | The name of the table to drop. |
|
||
|
||
#### Returns
|
||
|
||
`Promise`\<`void`\>
|
||
|
||
#### Implementation of
|
||
|
||
[Connection](../interfaces/Connection.md).[dropTable](../interfaces/Connection.md#droptable)
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:876](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L876)
|
||
|
||
___
|
||
|
||
### openTable
|
||
|
||
▸ **openTable**(`name`): `Promise`\<[`Table`](../interfaces/Table.md)\<`number`[]\>\>
|
||
|
||
Open a table in the database.
|
||
|
||
#### Parameters
|
||
|
||
| Name | Type | Description |
|
||
| :------ | :------ | :------ |
|
||
| `name` | `string` | The name of the table. |
|
||
|
||
#### Returns
|
||
|
||
`Promise`\<[`Table`](../interfaces/Table.md)\<`number`[]\>\>
|
||
|
||
#### Implementation of
|
||
|
||
[Connection](../interfaces/Connection.md).[openTable](../interfaces/Connection.md#opentable)
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:760](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L760)
|
||
|
||
▸ **openTable**\<`T`\>(`name`, `embeddings`): `Promise`\<[`Table`](../interfaces/Table.md)\<`T`\>\>
|
||
|
||
Open a table in the database.
|
||
|
||
#### Type parameters
|
||
|
||
| Name |
|
||
| :------ |
|
||
| `T` |
|
||
|
||
#### Parameters
|
||
|
||
| Name | Type | Description |
|
||
| :------ | :------ | :------ |
|
||
| `name` | `string` | The name of the table. |
|
||
| `embeddings` | [`EmbeddingFunction`](../interfaces/EmbeddingFunction.md)\<`T`\> | An embedding function to use on this Table |
|
||
|
||
#### Returns
|
||
|
||
`Promise`\<[`Table`](../interfaces/Table.md)\<`T`\>\>
|
||
|
||
#### Implementation of
|
||
|
||
Connection.openTable
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:768](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L768)
|
||
|
||
▸ **openTable**\<`T`\>(`name`, `embeddings?`): `Promise`\<[`Table`](../interfaces/Table.md)\<`T`\>\>
|
||
|
||
#### Type parameters
|
||
|
||
| Name |
|
||
| :------ |
|
||
| `T` |
|
||
|
||
#### Parameters
|
||
|
||
| Name | Type |
|
||
| :------ | :------ |
|
||
| `name` | `string` |
|
||
| `embeddings?` | [`EmbeddingFunction`](../interfaces/EmbeddingFunction.md)\<`T`\> |
|
||
|
||
#### Returns
|
||
|
||
`Promise`\<[`Table`](../interfaces/Table.md)\<`T`\>\>
|
||
|
||
#### Implementation of
|
||
|
||
Connection.openTable
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:772](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L772)
|
||
|
||
___
|
||
|
||
### tableNames
|
||
|
||
▸ **tableNames**(): `Promise`\<`string`[]\>
|
||
|
||
Get the names of all tables in the database.
|
||
|
||
#### Returns
|
||
|
||
`Promise`\<`string`[]\>
|
||
|
||
#### Implementation of
|
||
|
||
[Connection](../interfaces/Connection.md).[tableNames](../interfaces/Connection.md#tablenames)
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:751](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L751)
|
||
|
||
___
|
||
|
||
### withMiddleware
|
||
|
||
▸ **withMiddleware**(`middleware`): [`Connection`](../interfaces/Connection.md)
|
||
|
||
Instrument the behavior of this Connection with middleware.
|
||
|
||
The middleware will be called in the order they are added.
|
||
|
||
Currently this functionality is only supported for remote Connections.
|
||
|
||
#### Parameters
|
||
|
||
| Name | Type |
|
||
| :------ | :------ |
|
||
| `middleware` | `HttpMiddleware` |
|
||
|
||
#### Returns
|
||
|
||
[`Connection`](../interfaces/Connection.md)
|
||
|
||
- this Connection instrumented by the passed middleware
|
||
|
||
#### Implementation of
|
||
|
||
[Connection](../interfaces/Connection.md).[withMiddleware](../interfaces/Connection.md#withmiddleware)
|
||
|
||
#### Defined in
|
||
|
||
[index.ts:880](https://github.com/lancedb/lancedb/blob/92179835/node/src/index.ts#L880)
|