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

checkConsistency(token, callback)

  checkConsistency 
 ( 
 token 
 : 
  
 string 
 , 
  
 callback 
 : 
  
 CheckConsistencyCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
token
string
Returns
Type
Description
void

create(options)

  create 
 ( 
 options 
 ?: 
  
 CreateTableOptions 
 ) 
 : 
  
 Promise<CreateTableResponse> 
 ; 
 
Parameter
Name
Description
Returns
Type
Description
Promise < CreateTableResponse >

create(options, callback)

  create 
 ( 
 options 
 : 
  
 CreateTableOptions 
 , 
  
 callback 
 : 
  
 CreateTableCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
Returns
Type
Description
void

create(callback)

  create 
 ( 
 callback 
 : 
  
 CreateTableCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
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
Returns
Type
Description
void

createBackup(id, config, callback)

  createBackup 
 ( 
 id 
 : 
  
 string 
 , 
  
 config 
 : 
  
 CreateBackupConfig 
 , 
  
 callback 
 : 
  
 CreateBackupCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
id
string
config
CreateBackupConfig
Returns
Type
Description
void

createFamily(id, options)

  createFamily 
 ( 
 id 
 : 
  
 string 
 , 
  
 options 
 ?: 
  
 CreateFamilyOptions 
 ) 
 : 
  
 Promise<CreateFamilyResponse> 
 ; 
 
Parameters
Name
Description
id
string
Returns
Type
Description
Promise < CreateFamilyResponse >

createFamily(id, options, callback)

  createFamily 
 ( 
 id 
 : 
  
 string 
 , 
  
 options 
 : 
  
 CreateFamilyOptions 
 , 
  
 callback 
 : 
  
 CreateFamilyCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
id
string
Returns
Type
Description
void

createFamily(id, callback)

  createFamily 
 ( 
 id 
 : 
  
 string 
 , 
  
 callback 
 : 
  
 CreateFamilyCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
id
string
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

{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
Returns
Type
Description

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
Returns
Type
Description
void

delete(callback)

  delete 
 ( 
 callback 
 : 
  
 DeleteTableCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
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
Returns
Type
Description
void

deleteRows(prefix, callback)

  deleteRows 
 ( 
 prefix 
 : 
  
 string 
 , 
  
 callback 
 : 
  
 DeleteRowsCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
prefix
string
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
Returns
Type
Description
void

exists(callback)

  exists 
 ( 
 callback 
 : 
  
 TableExistsCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
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}

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

generateConsistencyToken(callback)

  generateConsistencyToken 
 ( 
 callback 
 : 
  
 GenerateConsistencyTokenCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
Returns
Type
Description
void

get(options)

  get 
 ( 
 options 
 ?: 
  
 GetTableOptions 
 ) 
 : 
  
 Promise<GetTableResponse> 
 ; 
 
Parameter
Name
Description
options
Returns
Type
Description
Promise < GetTableResponse >

get(options, callback)

  get 
 ( 
 options 
 : 
  
 GetTableOptions 
 , 
  
 callback 
 : 
  
 GetTableCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
options
callback
Returns
Type
Description
void

get(callback)

  get 
 ( 
 callback 
 : 
  
 GetTableCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
callback
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
Returns
Type
Description
void

getFamilies(callback)

  getFamilies 
 ( 
 callback 
 : 
  
 GetFamiliesCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
Returns
Type
Description
void

getIamPolicy(options)

  getIamPolicy 
 ( 
 options 
 ?: 
  
 GetIamPolicyOptions 
 ) 
 : 
  
 Promise 
< [ 
 Policy 
 ]>; 
 
Parameter
Name
Description
Returns
Type
Description
Promise <[ Policy ]>

getIamPolicy(options, callback)

  getIamPolicy 
 ( 
 options 
 : 
  
 GetIamPolicyOptions 
 , 
  
 callback 
 : 
  
 GetIamPolicyCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
Returns
Type
Description
void
  getMetadata 
 ( 
 options 
 ?: 
  
 GetMetadataOptions 
 ) 
 : 
  
 Promise<GetMetadataResponse> 
 ; 
 
Parameter
Name
Description
Returns
Type
Description
Promise < GetMetadataResponse >
  getMetadata 
 ( 
 options 
 : 
  
 GetMetadataOptions 
 , 
  
 callback 
 : 
  
 GetMetadataCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
Returns
Type
Description
void
  getMetadata 
 ( 
 callback 
 : 
  
 GetMetadataCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
Returns
Type
Description
void

getReplicationStates(gaxOptions)

  getReplicationStates 
 ( 
 gaxOptions 
 ?: 
  
 CallOptions 
 ) 
 : 
  
 Promise<GetReplicationStatesResponse> 
 ; 
 
Parameter
Name
Description
gaxOptions
CallOptions
Returns
Type
Description

getReplicationStates(gaxOptions, callback)

  getReplicationStates 
 ( 
 gaxOptions 
 : 
  
 CallOptions 
 , 
  
 callback 
 : 
  
 GetReplicationStatesCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
gaxOptions
CallOptions
Returns
Type
Description
void

getReplicationStates(callback)

  getReplicationStates 
 ( 
 callback 
 : 
  
 GetReplicationStatesCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
Returns
Type
Description
void

setIamPolicy(policy, gaxOptions)

  setIamPolicy 
 ( 
 policy 
 : 
  
 Policy 
 , 
  
 gaxOptions 
 ?: 
  
 CallOptions 
 ) 
 : 
  
 Promise<SetIamPolicyResponse> 
 ; 
 
Parameters
Name
Description
policy
gaxOptions
CallOptions
Returns
Type
Description
Promise < SetIamPolicyResponse >

setIamPolicy(policy, callback)

  setIamPolicy 
 ( 
 policy 
 : 
  
 Policy 
 , 
  
 callback 
 : 
  
 SetIamPolicyCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
policy
Returns
Type
Description
void

setIamPolicy(policy, gaxOptions, callback)

  setIamPolicy 
 ( 
 policy 
 : 
  
 Policy 
 , 
  
 gaxOptions 
 : 
  
 CallOptions 
 , 
  
 callback 
 : 
  
 SetIamPolicyCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
policy
gaxOptions
CallOptions
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

testIamPermissions(permissions, callback)

  testIamPermissions 
 ( 
 permissions 
 : 
  
 string 
  
 | 
  
 string 
 [], 
  
 callback 
 : 
  
 TestIamPermissionsCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameters
Name
Description
permissions
string | string[]
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
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
Returns
Type
Description
void

truncate(callback)

  truncate 
 ( 
 callback 
 : 
  
 TruncateCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
callback
Returns
Type
Description
void

waitForReplication()

  waitForReplication 
 () 
 : 
  
 Promise<WaitForReplicationResponse> 
 ; 
 
Returns
Type
Description

waitForReplication(callback)

  waitForReplication 
 ( 
 callback 
 : 
  
 WaitForReplicationCallback 
 ) 
 : 
  
 void 
 ; 
 
Parameter
Name
Description
Returns
Type
Description
void
Create a Mobile Website
View Site in Mobile | Classic
Share by: