REST Resource: hive.v1.projects.catalogs.databases.tables

资源：HiveTable

存储 Hive 表信息。它包括表名称、架构（列名称和类型）、数据位置、存储格式、serde 信息等。此消息与 IMetastoreClient 中的 Table 对象非常相似

JSON 表示法 
{
  "name": string,
  "description": string,
  "storageDescriptor": {
    object (StorageDescriptor)
  },
  "createTime": string,
  "partitionKeys": [
    {
      object (FieldSchema)
    }
  ],
  "parameters": {
    string: string,
    ...
  },
  "viewOriginalText": string,
  "viewExpandedText": string,
  "tableType": string,
  "updateTime": string
}
字段
name

string

标识符。资源名称。 格式：projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}
description

string

可选。表的说明。长度上限为 4,000 个字符。
storageDescriptor

object (StorageDescriptor)

必需。表的存储描述符。
createTime

string (Timestamp format)

仅限输出。表的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
partitionKeys[]

object (FieldSchema)

可选。表的分区键。
parameters

map (key: string, value: string)

可选。存储与表相关联的属性。大小上限为 4 MiB。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
viewOriginalText

string

可选。旧版视图文本。如果不是观看，则为空。大小上限为 16 MiB。
viewExpandedText

string

可选。展开视图文本。如果不是观看，则为空。大小上限为 16 MiB。
tableType

string

仅限输出。表的类型。对于 BigLake Hive 表，此值为 EXTERNAL。
updateTime

string (Timestamp format)

仅限输出。表格的更新时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

StorageDescriptor

包含有关表数据的物理存储的信息。

JSON 表示法 
{
  "columns": [
    {
      object (FieldSchema)
    }
  ],
  "locationUri": string,
  "inputFormat": string,
  "outputFormat": string,
  "serdeInfo": {
    object (SerdeInfo)
  },
  "bucketCols": [
    string
  ],
  "sortCols": [
    {
      object (Order)
    }
  ],
  "parameters": {
    string: string,
    ...
  },
  "skewedInfo": {
    object (SkewedInfo)
  },
  "compressed": boolean,
  "numBuckets": integer,
  "storedAsSubDirs": boolean
}
字段
columns[]

object (FieldSchema)

必需。指定表的列。
locationUri

string

可选。相应表所在的 Cloud Storage URI。默认为 <database_location_uri>/<table_name>。长度上限为 4,000 个字符。
inputFormat

string

可选。输入格式的完全限定 Java 类名称。长度上限为 4,000 个字符。
outputFormat

string

可选。输出格式的完全限定 Java 类名称。长度上限为 4,000 个字符。
serdeInfo

object (SerdeInfo)

可选。序列化和反序列化信息。
bucketCols[]

string

可选。Reducer 分组列、聚簇列和分桶列
sortCols[]

object (Order)

可选。每个分桶中数据的排序顺序
parameters

map (key: string, value: string)

可选。存储描述符的键值对。大小上限为 10 Kib。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
skewedInfo

object (SkewedInfo)

可选。表数据倾斜信息。
compressed

boolean

可选。相应表是否已压缩。
numBuckets

integer

可选。表中的分桶数量。
storedAsSubDirs

boolean

可选。表是否存储为子目录。

FieldSchema

字段架构信息。

JSON 表示法 
{
  "name": string,
  "type": string,
  "comment": string
}
字段
name

string

必需。字段的名称。长度上限为 767 个字符。
type

string

必需。字段的类型。长度上限为 128 个字符。
comment

string

可选。字段的注释。长度上限为 256 个字符。

SerdeInfo

序列化和反序列化信息。

JSON 表示法 
{
  "name": string,
  "serializationLib": string,
  "description": string,
  "parameters": {
    string: string,
    ...
  },
  "serializerClass": string,
  "deserializerClass": string,
  "serdeType": enum (SerdeType)
}
字段
name

string

必需。SerDe 的名称。默认情况下为表名称。长度上限为 128 个字符。
serializationLib

string

必需。序列化库的完全限定 Java 类名称。长度上限为 4,000 个字符。
description

string

可选。serde 的说明。长度上限为 4,000 个字符。
parameters

map (key: string, value: string)

可选。serde 的参数。大小上限为 10 Kib。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
serializerClass

string

可选。序列化程序的完全限定 Java 类名称。长度上限为 4,000 个字符。
deserializerClass

string

可选。序列化器的完全限定 Java 类名称。长度上限为 4,000 个字符。
serdeType

enum (SerdeType)

可选。serde 类型。

SerdeType

serde 类型。

枚举
SERDE_TYPE_UNSPECIFIED 未指定 serde 类型。
HIVE Hive。
SCHEMA_REGISTRY 架构注册表。

订单

每列存储数据的排序顺序。

JSON 表示法 
{
  "col": string,
  "order": integer
}
字段
col

string

必需。列名称。长度上限为 767 个字符。
order

integer

必需。定义列的排序顺序。如果为 1，则为升序；如果为 0，则为降序。

SkewedInfo

存储有关倾斜表的所有信息。

JSON 表示法 
{
  "skewedColNames": [
    string
  ],
  "skewedColValues": [
    {
      object (SkewedColumnValue)
    }
  ],
  "skewedKeyValuesLocations": [
    {
      object (SkewedKeyValuesLocation)
    }
  ]
}
字段
skewedColNames[]

string

必需。存在偏态的列名称。每个列名称的长度上限为 256 个字符。
skewedColValues[]

object (SkewedColumnValue)

必需。倾斜的列值。
skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

必需。倾斜的键值位置。

SkewedColumnValue

倾斜的列值。

JSON 表示法 
{
  "values": [
    string
  ]
}
字段
values[]

string

必需。倾斜的列值。每个值的长度上限为 256 个字符。

SkewedKeyValuesLocation

倾斜的键值及其相应的位置。

JSON 表示法 
{
  "values": [
    string
  ],
  "location": string
}
字段
values[]

string

必需。倾斜的列值。每个值的长度上限为 256 个字符。
location

string

必需。倾斜列值的位置。长度上限为 4,000 个字符。

方法

create

 创建新的 Hive 表。

delete

 删除由表名称指定的现有表。

get

 获取由资源名称指定的表。

list

 列出指定项目下 Hive 目录和数据库中的所有 Hive 表。

patch

 更新由表名称指定的现有表。