Skip to main content

tables

Overview

Nametables
TypeResource
Idgoogle.bigtableadmin.tables

Fields

NameDatatypeDescription
namestringThe unique name of the table. Values are of the form projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*. Views: NAME_ONLY, SCHEMA_VIEW, REPLICATION_VIEW, STATS_VIEW, FULL
granularitystringImmutable. The granularity (i.e. MILLIS) at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to MILLIS. Views: SCHEMA_VIEW, FULL.
restoreInfoobjectInformation about a table restore.
statsobjectApproximate statistics related to a table. These statistics are calculated infrequently, while simultaneously, data in the table can change rapidly. Thus the values reported here (e.g. row count) are very likely out-of date, even the instant they are received in this API. Thus, only treat these values as approximate. IMPORTANT: Everything below is approximate, unless otherwise specified.
changeStreamConfigobjectChange stream configuration.
clusterStatesobjectOutput only. Map from cluster ID to per-cluster table state. If it could not be determined whether or not the table has data in a particular cluster (for example, if its zone is unavailable), then there will be an entry for the cluster with UNKNOWN replication_status. Views: REPLICATION_VIEW, ENCRYPTION_VIEW, FULL
columnFamiliesobjectThe column families configured for this table, mapped by column family ID. Views: SCHEMA_VIEW, STATS_VIEW, FULL
deletionProtectionbooleanSet to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: The table. The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs.

Methods

NameAccessible byRequired ParamsDescription
getSELECTinstancesId, projectsId, tablesIdGets metadata information about the specified table.
listSELECTinstancesId, projectsIdLists all tables served from a specified instance.
createINSERTinstancesId, projectsIdCreates a new table in the specified instance. The table can be created with a full set of initial column families, specified in the request.
deleteDELETEinstancesId, projectsId, tablesIdPermanently deletes a specified table and all of its data.
_listEXECinstancesId, projectsIdLists all tables served from a specified instance.
check_consistencyEXECinstancesId, projectsId, tablesIdChecks replication consistency based on a consistency token, that is, if replication has caught up based on the conditions specified in the token and the check request.
drop_row_rangeEXECinstancesId, projectsId, tablesIdPermanently drop/delete a row range from a specified table. The request can specify whether to delete all rows in a table, or only those that match a particular prefix.
generate_consistency_tokenEXECinstancesId, projectsId, tablesIdGenerates a consistency token for a Table, which can be used in CheckConsistency to check whether mutations to the table that finished before this call started have been replicated. The tokens will be available for 90 days.
modify_column_familiesEXECinstancesId, projectsId, tablesIdPerforms a series of column family modifications on the specified table. Either all or none of the modifications will occur before this method returns, but data requests received prior to that point may see a table where only some modifications have taken effect.
patchEXECinstancesId, projectsId, tablesIdUpdates a specified table.
restoreEXECinstancesId, projectsIdCreate a new table by restoring from a completed backup. The returned table long-running operation can be used to track the progress of the operation, and to cancel it. The metadata field type is RestoreTableMetadata. The response type is Table, if successful.
undeleteEXECinstancesId, projectsId, tablesIdRestores a specified table which was accidentally deleted.