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

ID。資源名稱。格式：projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}
description

string

選用。資料表說明。最長不得超過 4000 個半形字元。
storageDescriptor

object (StorageDescriptor)

這是必要旗標，資料表的儲存空間描述元。
createTime

string (Timestamp format)

僅供輸出。資料表的建立時間。

使用 RFC 3339，產生的輸出內容一律會經過 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 正規化，並使用 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>。最長不得超過 4000 個半形字元。
inputFormat

string

選用。輸入格式的完整 Java 類別名稱。最長不得超過 4000 個半形字元。
outputFormat

string

選用。輸出格式的完整 Java 類別名稱。最長不得超過 4000 個半形字元。
serdeInfo

object (SerdeInfo)

選用。序列化和還原序列化資訊。
bucketCols[]

string

選用。縮減器分組資料欄、叢集資料欄和分組資料欄
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

選用。資料表中的 bucket 數量。
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 類別名稱。最長不得超過 4000 個半形字元。
description

string

選用。serde 的說明。最長不得超過 4000 個半形字元。
parameters

map (key: string, value: string)

選用。serde 的參數。大小上限為 10 KiB。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
serializerClass

string

選用。序列化程式的完整 Java 類別名稱。最長不得超過 4000 個半形字元。
deserializerClass

string

選用。還原序列化程式的完整 Java 類別名稱。最長不得超過 4000 個半形字元。
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

這是必要旗標，偏斜資料欄值的位置。最長不得超過 4000 個半形字元。

方法

create

 建立新的 Hive 資料表。

delete

 刪除指定資料表名稱的現有資料表。

get

 取得資源名稱指定的資料表。

list

 列出 Hive 目錄和資料庫中指定專案的所有 Hive 資料表。

patch

 更新資料表名稱指定的現有資料表。