Class Table (6.0.0)

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

Inheritance

TabularApiSurface > 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

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
//   }
// }

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

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