Class Table (4.1.0)

Version 4.1.0

• 5.0.0 (latest)
• 4.6.1
• 4.1.0
• 4.0.5
• 3.10.0
• 3.9.4
• 3.8.0
• 3.7.0
• 3.6.0
• 3.5.4

Create a Table object to interact with a Cloud Bigtable table.

Package

@google-cloud/bigtable

Example

const {Bigtable} = require('@google-cloud/bigtable');
const bigtable = new Bigtable();
const instance = bigtable.instance('my-instance');
const table = instance.table('prezzy');

Constructors

(constructor)(instance, id)

constructor(instance: Instance, id: string);

Constructs a new instance of the Table class

Parameters
Name	Description
instance	Instance
id	string

Properties

bigtable

bigtable: Bigtable;

id

id: string;

instance

instance: Instance;

maxRetries

maxRetries?: number;

metadata

metadata?: google.bigtable.admin.v2.ITable;

name

name: string;

VIEWS

static VIEWS: {
        [index: string]: number;
    };

The view to be applied to the returned table's fields. Defaults to schema if unspecified.

Methods

checkConsistency(token)

checkConsistency(token: string): Promise<CheckConsistencyResponse>;

Parameter
Name	Description
token	string

Returns
Type	Description
Promise<CheckConsistencyResponse>

checkConsistency(token, callback)

checkConsistency(token: string, callback: CheckConsistencyCallback): void;

Parameters
Name	Description
token	string
callback	CheckConsistencyCallback

Returns
Type	Description
void

create(options)

create(options?: CreateTableOptions): Promise<CreateTableResponse>;

Parameter
Name	Description
options	CreateTableOptions

Returns
Type	Description
Promise<CreateTableResponse>

create(options, callback)

create(options: CreateTableOptions, callback: CreateTableCallback): void;

Parameters
Name	Description
options	CreateTableOptions
callback	CreateTableCallback

Returns
Type	Description
void

create(callback)

create(callback: CreateTableCallback): void;

Parameter
Name	Description
callback	CreateTableCallback

Returns
Type	Description
void

createBackup(id, config)

createBackup(id: string, config: CreateBackupConfig): Promise<CreateBackupResponse>;

Parameters
Name	Description
id	string
config	CreateBackupConfig

Returns
Type	Description
Promise<CreateBackupResponse>

createBackup(id, config, callback)

createBackup(id: string, config: CreateBackupConfig, callback: CreateBackupCallback): void;

Parameters
Name	Description
id	string
config	CreateBackupConfig
callback	CreateBackupCallback

Returns
Type	Description
void

createBackup(id, config, callback)

createBackup(id: string, config: CreateBackupConfig, callback: CreateBackupCallback): void;

Parameters
Name	Description
id	string
config	CreateBackupConfig
callback	CreateBackupCallback

Returns
Type	Description
void

createFamily(id, options)

createFamily(id: string, options?: CreateFamilyOptions): Promise<CreateFamilyResponse>;

Parameters
Name	Description
id	string
options	CreateFamilyOptions

Returns
Type	Description
Promise<CreateFamilyResponse>

createFamily(id, options, callback)

createFamily(id: string, options: CreateFamilyOptions, callback: CreateFamilyCallback): void;

Parameters
Name	Description
id	string
options	CreateFamilyOptions
callback	CreateFamilyCallback

Returns
Type	Description
void

createFamily(id, callback)

createFamily(id: string, callback: CreateFamilyCallback): void;

Parameters
Name	Description
id	string
callback	CreateFamilyCallback

Returns
Type	Description
void

createPrefixRange(start)

static createPrefixRange(start: string): PrefixRange;

Creates a range based off of a key prefix.

Parameter
Name	Description
start	string The key prefix/starting bound.

Returns
Type	Description
PrefixRange	{object} range

Example

const {Bigtable} = require('@google-cloud/bigtable');
const bigtable = new Bigtable();
const instance = bigtable.instance('my-instance');
const table = instance.table('prezzy');
table.createPrefixRange('start');
// => {
//   start: 'start',
//   end: {
//     value: 'staru',
//     inclusive: false
//   }
// }

createReadStream(opts)

createReadStream(opts?: GetRowsOptions): PassThrough;

Get Row objects for the rows currently in your table as a readable object stream.

Parameter
Name	Description
opts	GetRowsOptions

Returns
Type	Description
PassThrough	{stream}

Example

    table
      .createReadStream()
      .on('error', err => {
        // Handle the error.
      })
      .on('data', row => {
        // `row` is a Row object.
      })
      .on('end', () => {
        // All rows retrieved.
      });
    //-
    // If you anticipate many results, you can end a stream early to prevent
    // unnecessary processing.
    //-
    // table
    //   .createReadStream()
    //   .on('data', function (row) {
    //     this.end();
    //   });

    //-
    // Specify arbitrary keys for a non-contiguous set of rows.
    // The total size of the keys must remain under 1MB, after encoding.
    //-
    // table.createReadStream({
    //   keys: [
    //     'alincoln',
    //     'gwashington'
    //   ]
    // });

    //-
    // Scan for row keys that contain a specific prefix.
    //-
    // table.createReadStream({
    //   prefix: 'gwash'
    // });

    //-
    // Specify a contiguous range of rows to read by supplying `start` and `end`
    // keys.
    //
    // If the `start` key is omitted, it is interpreted as an empty string.
    // If the `end` key is omitted, it is interpreted as infinity.
    //-
    // table.createReadStream({
    //   start: 'alincoln',
    //   end: 'gwashington'
    // });

    //-
    // Specify multiple ranges.
    //-
    // table.createReadStream({
    //   ranges: [{
    //     start: 'alincoln',
    //     end: 'gwashington'
    //   }, {
    //     start: 'tjefferson',
    //     end: 'jadams'
    //   }]
    // });

    //-
    // Apply a {@link Filter} to the contents of the specified rows.
    //-
    // table.createReadStream({
    //   filter: [
    //     {
    //       column: 'gwashington'
    //     }, {
    //       value: 1
    //     }
    //   ]
    // });
    //

decodePolicyEtag(policy)

static decodePolicyEtag(policy: Policy): Policy;

Formats the decodes policy etag value to string.

Parameter
Name	Description
policy	Policy

Returns
Type	Description
Policy

delete(gaxOptions)

delete(gaxOptions?: CallOptions): Promise<DeleteTableResponse>;

Parameter
Name	Description
gaxOptions	CallOptions

Returns
Type	Description
Promise<DeleteTableResponse>

delete(gaxOptions, callback)

delete(gaxOptions: CallOptions, callback: DeleteTableCallback): void;

Parameters
Name	Description
gaxOptions	CallOptions
callback	DeleteTableCallback

Returns
Type	Description
void

delete(callback)

delete(callback: DeleteTableCallback): void;

Parameter
Name	Description
callback	DeleteTableCallback

Returns
Type	Description
void

deleteRows(prefix, gaxOptions)

deleteRows(prefix: string, gaxOptions?: CallOptions): Promise<DeleteRowsResponse>;

Parameters
Name	Description
prefix	string
gaxOptions	CallOptions

Returns
Type	Description
Promise<DeleteRowsResponse>

deleteRows(prefix, gaxOptions, callback)

deleteRows(prefix: string, gaxOptions: CallOptions, callback: DeleteRowsCallback): void;

Parameters
Name	Description
prefix	string
gaxOptions	CallOptions
callback	DeleteRowsCallback

Returns
Type	Description
void

deleteRows(prefix, callback)

deleteRows(prefix: string, callback: DeleteRowsCallback): void;

Parameters
Name	Description
prefix	string
callback	DeleteRowsCallback

Returns
Type	Description
void

exists(gaxOptions)

exists(gaxOptions?: CallOptions): Promise<TableExistsResponse>;

Parameter
Name	Description
gaxOptions	CallOptions

Returns
Type	Description
Promise<TableExistsResponse>

exists(gaxOptions, callback)

exists(gaxOptions: CallOptions, callback: TableExistsCallback): void;

Parameters
Name	Description
gaxOptions	CallOptions
callback	TableExistsCallback

Returns
Type	Description
void

exists(callback)

exists(callback: TableExistsCallback): void;

Parameter
Name	Description
callback	TableExistsCallback

Returns
Type	Description
void

family(id)

family(id: string): Family;

Get a reference to a Table Family.

Parameter
Name	Description
id	string The family unique identifier.

Returns
Type	Description
Family	{Family}

Example

const family = table.family('my-family');

formatName_(instanceName, id)

static formatName_(instanceName: string, id: string): string;

Formats the table name to include the Bigtable cluster.

Parameters
Name	Description
instanceName	string The formatted instance name.
id	string

Returns
Type	Description
string

Example

Table.formatName_(
  'projects/my-project/zones/my-zone/instances/my-instance',
  'my-table'
);
//
'projects/my-project/zones/my-zone/instances/my-instance/tables/my-table'

generateConsistencyToken()

generateConsistencyToken(): Promise<GenerateConsistencyTokenResponse>;

Returns
Type	Description
Promise<GenerateConsistencyTokenResponse>

generateConsistencyToken(callback)

generateConsistencyToken(callback: GenerateConsistencyTokenCallback): void;

Parameter
Name	Description
callback	GenerateConsistencyTokenCallback

Returns
Type	Description
void

get(options)

get(options?: GetTableOptions): Promise<GetTableResponse>;

Parameter
Name	Description
options	GetTableOptions

Returns
Type	Description
Promise<GetTableResponse>

get(options, callback)

get(options: GetTableOptions, callback: GetTableCallback): void;

Parameters
Name	Description
options	GetTableOptions
callback	GetTableCallback

Returns
Type	Description
void

get(callback)

get(callback: GetTableCallback): void;

Parameter
Name	Description
callback	GetTableCallback

Returns
Type	Description
void

getFamilies(gaxOptions)

getFamilies(gaxOptions?: CallOptions): Promise<GetFamiliesResponse>;

Parameter
Name	Description
gaxOptions	CallOptions

Returns
Type	Description
Promise<GetFamiliesResponse>

getFamilies(gaxOptions, callback)

getFamilies(gaxOptions: CallOptions, callback: GetFamiliesCallback): void;

Parameters
Name	Description
gaxOptions	CallOptions
callback	GetFamiliesCallback

Returns
Type	Description
void

getFamilies(callback)

getFamilies(callback: GetFamiliesCallback): void;

Parameter
Name	Description
callback	GetFamiliesCallback

Returns
Type	Description
void

getIamPolicy(options)

getIamPolicy(options?: GetIamPolicyOptions): Promise<[Policy]>;

Parameter
Name	Description
options	GetIamPolicyOptions

Returns
Type	Description
Promise<[Policy]>

getIamPolicy(options, callback)

getIamPolicy(options: GetIamPolicyOptions, callback: GetIamPolicyCallback): void;

Parameters
Name	Description
options	GetIamPolicyOptions
callback	GetIamPolicyCallback

Returns
Type	Description
void

getMetadata(options)

getMetadata(options?: GetMetadataOptions): Promise<GetMetadataResponse>;

Parameter
Name	Description
options	GetMetadataOptions

Returns
Type	Description
Promise<GetMetadataResponse>

getMetadata(options, callback)

getMetadata(options: GetMetadataOptions, callback: GetMetadataCallback): void;

Parameters
Name	Description
options	GetMetadataOptions
callback	GetMetadataCallback

Returns
Type	Description
void

getMetadata(callback)

getMetadata(callback: GetMetadataCallback): void;

Parameter
Name	Description
callback	GetMetadataCallback

Returns
Type	Description
void

getReplicationStates(gaxOptions)

getReplicationStates(gaxOptions?: CallOptions): Promise<GetReplicationStatesResponse>;

Parameter
Name	Description
gaxOptions	CallOptions

Returns
Type	Description
Promise<GetReplicationStatesResponse>

getReplicationStates(gaxOptions, callback)

getReplicationStates(gaxOptions: CallOptions, callback: GetReplicationStatesCallback): void;

Parameters
Name	Description
gaxOptions	CallOptions
callback	GetReplicationStatesCallback

Returns
Type	Description
void

getReplicationStates(callback)

getReplicationStates(callback: GetReplicationStatesCallback): void;

Parameter
Name	Description
callback	GetReplicationStatesCallback

Returns
Type	Description
void

getRows(options)

getRows(options?: GetRowsOptions): Promise<GetRowsResponse>;

Parameter
Name	Description
options	GetRowsOptions

Returns
Type	Description
Promise<GetRowsResponse>

getRows(options, callback)

getRows(options: GetRowsOptions, callback: GetRowsCallback): void;

Parameters
Name	Description
options	GetRowsOptions
callback	GetRowsCallback

Returns
Type	Description
void

getRows(callback)

getRows(callback: GetRowsCallback): void;

Parameter
Name	Description
callback	GetRowsCallback

Returns
Type	Description
void

insert(entries, gaxOptions)

insert(entries: Entry | Entry[], gaxOptions?: CallOptions): Promise<InsertRowsResponse>;

Parameters
Name	Description
entries	Entry | Entry[]
gaxOptions	CallOptions

Returns
Type	Description
Promise<InsertRowsResponse>

insert(entries, gaxOptions, callback)

insert(entries: Entry | Entry[], gaxOptions: CallOptions, callback: InsertRowsCallback): void;

Parameters
Name	Description
entries	Entry | Entry[]
gaxOptions	CallOptions
callback	InsertRowsCallback

Returns
Type	Description
void

insert(entries, callback)

insert(entries: Entry | Entry[], callback: InsertRowsCallback): void;

Parameters
Name	Description
entries	Entry | Entry[]
callback	InsertRowsCallback

Returns
Type	Description
void

mutate(entries, options)

mutate(entries: Entry | Entry[], options?: MutateOptions): Promise<MutateResponse>;

Parameters
Name	Description
entries	Entry | Entry[]
options	MutateOptions

Returns
Type	Description
Promise<MutateResponse>

mutate(entries, options, callback)

mutate(entries: Entry | Entry[], options: MutateOptions, callback: MutateCallback): void;

Parameters
Name	Description
entries	Entry | Entry[]
options	MutateOptions
callback	MutateCallback

Returns
Type	Description
void

mutate(entries, callback)

mutate(entries: Entry | Entry[], callback: MutateCallback): void;

Parameters
Name	Description
entries	Entry | Entry[]
callback	MutateCallback

Returns
Type	Description
void

row(key)

row(key: string): Row;

Get a reference to a table row.

Parameter
Name	Description
key	string The row key.

Returns
Type	Description
Row	{Row}

Example

const row = table.row('lincoln');

sampleRowKeys(gaxOptions)

sampleRowKeys(gaxOptions?: CallOptions): Promise<SampleRowsKeysResponse>;

Parameter
Name	Description
gaxOptions	CallOptions

Returns
Type	Description
Promise<SampleRowsKeysResponse>

sampleRowKeys(gaxOptions, callback)

sampleRowKeys(gaxOptions: CallOptions, callback: SampleRowKeysCallback): void;

Parameters
Name	Description
gaxOptions	CallOptions
callback	SampleRowKeysCallback

Returns
Type	Description
void

sampleRowKeys(callback)

sampleRowKeys(callback?: SampleRowKeysCallback): void;

Parameter
Name	Description
callback	SampleRowKeysCallback

Returns
Type	Description
void

sampleRowKeysStream(gaxOptions)

sampleRowKeysStream(gaxOptions?: CallOptions): any;

Returns a sample of row keys in the table as a readable object stream.

See for more details.

Parameter
Name	Description
gaxOptions	CallOptions Request configuration options, outlined here: https://googleapis.github.io/gax-nodejs/CallSettings.html.

Returns
Type	Description
any	{stream}

Example

table.sampleRowKeysStream()
  .on('error', console.error)
  .on('data', function(key) {
    // Do something with the `key` object.
  });

//-
// If you anticipate many results, you can end a stream early to prevent
// unnecessary processing.
//-
table.sampleRowKeysStream()
  .on('data', function(key) {
    this.end();
  });

setIamPolicy(policy, gaxOptions)

setIamPolicy(policy: Policy, gaxOptions?: CallOptions): Promise<SetIamPolicyResponse>;

Parameters
Name	Description
policy	Policy
gaxOptions	CallOptions

Returns
Type	Description
Promise<SetIamPolicyResponse>

setIamPolicy(policy, callback)

setIamPolicy(policy: Policy, callback: SetIamPolicyCallback): void;

Parameters
Name	Description
policy	Policy
callback	SetIamPolicyCallback

Returns
Type	Description
void

setIamPolicy(policy, gaxOptions, callback)

setIamPolicy(policy: Policy, gaxOptions: CallOptions, callback: SetIamPolicyCallback): void;

Parameters
Name	Description
policy	Policy
gaxOptions	CallOptions
callback	SetIamPolicyCallback

Returns
Type	Description
void

testIamPermissions(permissions, gaxOptions)

testIamPermissions(permissions: string | string[], gaxOptions?: CallOptions): Promise<TestIamPermissionsResponse>;

Parameters
Name	Description
permissions	string | string[]
gaxOptions	CallOptions

Returns
Type	Description
Promise<TestIamPermissionsResponse>

testIamPermissions(permissions, callback)

testIamPermissions(permissions: string | string[], callback: TestIamPermissionsCallback): void;

Parameters
Name	Description
permissions	string | string[]
callback	TestIamPermissionsCallback

Returns
Type	Description
void

testIamPermissions(permissions, gaxOptions, callback)

testIamPermissions(permissions: string | string[], gaxOptions: CallOptions, callback: TestIamPermissionsCallback): void;

Parameters
Name	Description
permissions	string | string[]
gaxOptions	CallOptions
callback	TestIamPermissionsCallback

Returns
Type	Description
void

truncate(gaxOptions)

truncate(gaxOptions?: CallOptions): Promise<TruncateResponse>;

Parameter
Name	Description
gaxOptions	CallOptions

Returns
Type	Description
Promise<TruncateResponse>

truncate(gaxOptions, callback)

truncate(gaxOptions: CallOptions, callback: TruncateCallback): void;

Parameters
Name	Description
gaxOptions	CallOptions
callback	TruncateCallback

Returns
Type	Description
void

truncate(callback)

truncate(callback: TruncateCallback): void;

Parameter
Name	Description
callback	TruncateCallback

Returns
Type	Description
void

waitForReplication()

waitForReplication(): Promise<WaitForReplicationResponse>;

Returns
Type	Description
Promise<WaitForReplicationResponse>

waitForReplication(callback)

waitForReplication(callback: WaitForReplicationCallback): void;

Parameter
Name	Description
callback	WaitForReplicationCallback

Returns
Type	Description
void