REST Resource: projects.locations.catalogs.databases

Resource: Database

Database is the container of tables.

JSON representation
{
 "name": string,
 "createTime": string,
 "updateTime": string,
 "deleteTime": string,
 "expireTime": string,
 "type": enum (Type ),
 // Union field options can be only one of the following:
 "hiveOptions": {
 object (HiveDatabaseOptions )
 }
 // 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}

createTime

string (Timestamp format)

Output only. The creation time of the database.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014年10月02日T15:01:23Z" and "2014年10月02日T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The last modification time of the database.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014年10月02日T15:01:23Z" and "2014年10月02日T15:01:23.045123456Z".

deleteTime

string (Timestamp format)

Output only. The deletion time of the database. Only set after the database is deleted.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014年10月02日T15:01:23Z" and "2014年10月02日T15:01:23.045123456Z".

expireTime

string (Timestamp format)

Output only. The time when this database is considered expired. Only set after the database is deleted.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014年10月02日T15:01:23Z" and "2014年10月02日T15:01:23.045123456Z".

type

enum (Type )

The database type.

Union field options. Options specified for the database type. options can be only one of the following:
hiveOptions

object (HiveDatabaseOptions )

Options of a Hive database.

HiveDatabaseOptions

Options of a Hive database.

JSON representation
{
 "locationUri": string,
 "parameters": {
 string: string,
 ...
 }
}
Fields
locationUri

string

Cloud Storage folder URI where the database data is stored, starting with "gs://".

parameters

map (key: string, value: string)

Stores user supplied Hive database parameters.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Type

The database type.

Enums
TYPE_UNSPECIFIED The type is not specified.
HIVE Represents a database storing tables compatible with Hive Metastore tables.

Methods

create

Creates a new database.

delete

Deletes an existing database specified by the database ID.

get

Gets the database specified by the resource name.

list

List all databases in a specified catalog.

patch

Updates an existing database specified by the database ID.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年07月02日 UTC.