Class Table (5.1.2)

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