REST Resource: projects.locations.federations

資源:Federation

代表多個後端元資料儲存庫的聯合體。

JSON 表示法
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "version": string,
  "backendMetastores": {
    integer: {
      object (BackendMetastore)
    },
    ...
  },
  "endpointUri": string,
  "state": enum (State),
  "stateMessage": string,
  "uid": string
}
欄位
name

string

不可變動。聯邦的相對資源名稱,格式為:`projects/{projectNumber}/locations/{locationId}/federations/{federationId}`。

createTime

string (Timestamp format)

僅供輸出。建立元資料庫聯結的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

僅供輸出。上次更新元資料庫聯集的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

labels

map (key: string, value: string)

元資料庫聯集的使用者定義標籤。

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

version

string

不可變動。聯盟的 Apache Hive 中繼存放區版本。所有後端元資料庫版本都必須與聯合版本相容。

backendMetastores

map (key: integer, value: object (BackendMetastore))

BackendMetastore 排名到 BackendMetastore 的對應,聯合服務會在查詢時透過此對應提供中繼資料。對應索引鍵代表在查詢時,應評估 BackendMetastore 以解析資料庫名稱的順序,且應大於或等於零。編號較小的 BackendMetastore 會先於編號較大的 BackendMetastore 評估。

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

endpointUri

string

僅供輸出。聯盟端點。

state

enum (State)

僅供輸出。聯盟的目前狀態。

stateMessage

string

僅供輸出。與元資料庫聯合資料庫目前狀態相關的其他資訊 (如有)。

uid

string

僅供輸出。元資料庫聯合作業的全域專屬資源 ID。

BackendMetastore

代表聯合資料的後端元資料儲存庫。

JSON 表示法
{
  "name": string,
  "metastoreType": enum (MetastoreType)
}
欄位
name

string

要聯結的中繼存放區的相對資源名稱。以下列出目前支援的中介資料儲存庫的相對資源名稱格式:

  • BigQuery
    • projects/{projectId}
  • Dataproc 中繼存放區
    • projects/{projectId}/locations/{location}/services/{serviceId}
metastoreType

enum (MetastoreType)

後端元資料儲存庫的類型。

MetastoreType

後端元資料儲存庫的類型。

列舉
METASTORE_TYPE_UNSPECIFIED 未設定元資料庫類型。
BIGQUERY 後端中繼資料儲存庫是 BigQuery。
DATAPROC_METASTORE 後端元資料儲存庫是 Dataproc Metastore。

狀態

聯盟的目前狀態。

列舉
STATE_UNSPECIFIED Metastore 聯合資料庫的狀態不明。
CREATING 元資料庫聯合服務正在建立中。
ACTIVE 元資料庫聯合服務正在執行,可供查詢使用。
UPDATING 正在更新元資料庫聯合服務。目前仍可使用,但無法接受額外的更新要求,也無法刪除。
DELETING 正在刪除 Metastore 聯盟。無法使用。
ERROR Metastore 聯合服務發生錯誤,無法使用。應刪除中繼存放區聯盟。

方法

create

在專案和位置中建立元資料庫聯合。

delete

刪除單一聯盟。

get

取得單一聯合作業的詳細資料。

getIamPolicy

取得資源的存取權控管政策。

list

列出專案和位置中的聯合作業。

patch

更新聯邦的欄位。

setIamPolicy

設定指定資源的存取權控管政策。

testIamPermissions

傳回呼叫者在指定資源上擁有的權限。