# REST Resource: projects.locations.catalogs.databases.tables

- [Resource: Table](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#Table)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#Table.SCHEMA_REPRESENTATION)
- [HiveTableOptions](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#HiveTableOptions)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#HiveTableOptions.SCHEMA_REPRESENTATION)
- [StorageDescriptor](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#StorageDescriptor)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#StorageDescriptor.SCHEMA_REPRESENTATION)
- [SerDeInfo](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#SerDeInfo)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#SerDeInfo.SCHEMA_REPRESENTATION)
- [Type](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#Type)
- [Methods](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#METHODS_SUMMARY)

## Resource: Table

Represents a table.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "deleteTime": string, "expireTime": string, "type": enum (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#Type`), "etag": string, // Union field `options` can be only one of the following: "hiveOptions": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#HiveTableOptions`) } // End of list of possible types for union field `options`. } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name. Format: projects/{project_id_or_number}/locations/{locationId}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId} |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The creation time of the table. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The last modification time of the table. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `deleteTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The deletion time of the table. Only set after the table is deleted. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `expireTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when this table is considered expired. Only set after the table is deleted. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `type` | ``enum (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#Type`)`` The table type. |
| `etag` | `string` The checksum of a table object computed by the server based on the value of other fields. It may be sent on update requests to ensure the client has an up-to-date value before proceeding. It is only checked for update table operations. |
| Union field `options`. Options specified for the table type. `options` can be only one of the following: ||
| `hiveOptions` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#HiveTableOptions`)`` Options of a Hive table. |

## HiveTableOptions

Options of a Hive table.

| JSON representation |
|---|
| ``` { "parameters": { string: string, ... }, "tableType": string, "storageDescriptor": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#StorageDescriptor`) } } ``` |

| Fields ||
|---|---|
| `parameters` | `map (key: string, value: string)` Stores user supplied Hive table parameters. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `tableType` | `string` Hive table type. For example, MANAGED_TABLE, EXTERNAL_TABLE. |
| `storageDescriptor` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#StorageDescriptor`)`` Stores physical storage information of the data. |

## StorageDescriptor

Stores physical storage information of the data.

| JSON representation |
|---|
| ``` { "locationUri": string, "inputFormat": string, "outputFormat": string, "serdeInfo": { object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#SerDeInfo`) } } ``` |

| Fields ||
|---|---|
| `locationUri` | `string` Cloud Storage folder URI where the table data is stored, starting with "gs://". |
| `inputFormat` | `string` The fully qualified Java class name of the input format. |
| `outputFormat` | `string` The fully qualified Java class name of the output format. |
| `serdeInfo` | ``object (`https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables#SerDeInfo`)`` Serializer and deserializer information. |

## SerDeInfo

Serializer and deserializer information.

| JSON representation |
|---|
| ``` { "serializationLib": string } ``` |

| Fields ||
|---|---|
| `serializationLib` | `string` The fully qualified Java class name of the serialization library. |

## Type

The table type.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | The type is not specified. |
| `HIVE` | Represents a table compatible with Hive Metastore tables. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables/create` | Creates a new table. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables/delete` | Deletes an existing table specified by the table ID. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables/get` | Gets the table specified by the resource name. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables/list` | List all tables in a specified database. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables/patch` | Updates an existing table specified by the table ID. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs.databases.tables/rename` | Renames an existing table specified by the table ID. |