> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bijection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Class: VirtualTableHandle<Row>

> A reference to one execution, never authority to read it.

[browser](/api/modules/browser).VirtualTableHandle

A reference to one execution, never authority to read it.

## Type parameters

| Name | Type |
| :- | :- |
| `Row` | `Record`\<`string`, [`Value`](/api/modules/values#value)> |

## Hierarchy

* **`VirtualTableHandle`**

  ↳ [`PreparedVirtualTable`](/api/classes/browser.PreparedVirtualTable)

## Constructors

### constructor

• **new VirtualTableHandle**\<`Row`>(`transport`, `executionId`, `initial?`)

#### Type parameters

| Name | Type |
| :- | :- |
| `Row` | `Record`\<`string`, [`Value`](/api/modules/values#value)> |

#### Parameters

| Name | Type |
| :- | :- |
| `transport` | [`VirtualTableTransport`](/api/interfaces/browser.VirtualTableTransport) |
| `executionId` | [`VirtualTableExecutionId`](/api/modules/server#virtualtableexecutionid)\<`Row`> |
| `initial?` | [`VirtualTableExecution`](/api/modules/server#virtualtableexecution)\<`Row`> |

## Properties

### transport

• `Protected` `Readonly` **transport**: [`VirtualTableTransport`](/api/interfaces/browser.VirtualTableTransport)

***

### executionId

• `Readonly` **executionId**: [`VirtualTableExecutionId`](/api/modules/server#virtualtableexecutionid)\<`Row`>

## Methods

### snapshot

▸ `Readonly` **snapshot**(): [`VirtualTableSnapshot`](/api/modules/browser#virtualtablesnapshot)\<`Row`>

#### Returns

[`VirtualTableSnapshot`](/api/modules/browser#virtualtablesnapshot)\<`Row`>

***

### subscribe

▸ `Readonly` **subscribe**(`listener`): () => `void`

#### Parameters

| Name | Type |
| :- | :- |
| `listener` | () => `void` |

#### Returns

`fn`

▸ (): `void`

##### Returns

`void`

***

### update

▸ `Protected` **update**(`change`): `void`

#### Parameters

| Name | Type |
| :- | :- |
| `change` | `Partial`\<[`VirtualTableSnapshot`](/api/modules/browser#virtualtablesnapshot)\<`Row`>> |

#### Returns

`void`

***

### get

▸ **get**(): `Promise`\<[`VirtualTableExecution`](/api/modules/server#virtualtableexecution)\<`Row`>>

#### Returns

`Promise`\<[`VirtualTableExecution`](/api/modules/server#virtualtableexecution)\<`Row`>>

***

### wait

▸ **wait**(`options?`): `Promise`\<\{ `executionId`: [`VirtualTableExecutionId`](/api/modules/server#virtualtableexecutionid)\<`Row`> ; `deadline`: `string` ; `expiresAt`: `string`  } & \{ `state`: `"ready"` ; `plan`: [`VirtualTablePlan`](/api/interfaces/server.VirtualTablePlan) ; `basis`: \{ `kind`: `"statement"` ; `provider`: `"snowflake"` | `"databricks"`  } | \{ `kind`: `"federated"` ; `localRevision?`: `string` ; `remote`: \{ `kind`: `"statement"` ; `provider`: `"snowflake"` | `"databricks"` ; `tables`: `string`\[]  }\[]  } ; `rowCount`: `number`  }>

#### Parameters

| Name | Type |
| :- | :- |
| `options` | `Object` |
| `options.signal?` | `AbortSignal` |

#### Returns

`Promise`\<\{ `executionId`: [`VirtualTableExecutionId`](/api/modules/server#virtualtableexecutionid)\<`Row`> ; `deadline`: `string` ; `expiresAt`: `string`  } & \{ `state`: `"ready"` ; `plan`: [`VirtualTablePlan`](/api/interfaces/server.VirtualTablePlan) ; `basis`: \{ `kind`: `"statement"` ; `provider`: `"snowflake"` | `"databricks"`  } | \{ `kind`: `"federated"` ; `localRevision?`: `string` ; `remote`: \{ `kind`: `"statement"` ; `provider`: `"snowflake"` | `"databricks"` ; `tables`: `string`\[]  }\[]  } ; `rowCount`: `number`  }>

***

### pages

▸ **pages**(`options?`): `AsyncGenerator`\<[`VirtualTablePage`](/api/modules/server#virtualtablepage)\<`Row`>, `any`, `unknown`>

#### Parameters

| Name | Type |
| :- | :- |
| `options` | `Object` |
| `options.cursor?` | `string` |
| `options.limit?` | `number` |
| `options.signal?` | `AbortSignal` |

#### Returns

`AsyncGenerator`\<[`VirtualTablePage`](/api/modules/server#virtualtablepage)\<`Row`>, `any`, `unknown`>

***

### cancel

▸ **cancel**(): `Promise`\<[`VirtualTableControl`](/api/interfaces/server.VirtualTableControl)\<`Row`>>

#### Returns

`Promise`\<[`VirtualTableControl`](/api/interfaces/server.VirtualTableControl)\<`Row`>>

***

### release

▸ **release**(): `Promise`\<[`VirtualTableControl`](/api/interfaces/server.VirtualTableControl)\<`Row`>>

#### Returns

`Promise`\<[`VirtualTableControl`](/api/interfaces/server.VirtualTableControl)\<`Row`>>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.