REST Resource: hive.v1.projects.catalogs

משאב: HiveCatalog

‫HiveCatalog מכיל מסדי נתונים וטבלאות של Spark/Hive ב-BigLake Metastore. כשיוצרים משאבים בקטלוג, מומלץ לוודא שהמיקום של קטגוריית האחסון, המיקום של מנוע Spark או Hive או כל מיקום אחר של מחשוב זהים. אפשר לראות את הקטלוג כיעד להעברה של מאגר מטא נתונים של Hive מקומי ל-GCP.

ייצוג ב-JSON 
{
  "name": string,
  "description": string,
  "locationUri": string,
  "replicas": [
    {
      object (Replica)
    }
  ],
  "createTime": string,
  "updateTime": string
}
שדות
name

string

מזהה. שם המשאב פורמט: projects/{project_id_or_number}/catalogs/{catalogId}
description

string

זה שינוי אופציונלי. מאחסן את תיאור הקטלוג. האורך המקסימלי הוא 4,000 תווים.
locationUri

string

חובה. נתיב המיקום ב-Cloud Storage שבו נמצא הקטלוג. פורמט: gs://bucket/path/to/catalog האורך המקסימלי הוא 4,000 תווים.
replicas[]

object (Replica)

פלט בלבד. העותקים המשוכפלים של המטא-נתונים של הקטלוג.
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".
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".

רפליקה

העתק של הקטלוג.

ייצוג ב-JSON 
{
  "region": string,
  "state": enum (State)
}
שדות
region

string

פלט בלבד. האזור של העותק. לדוגמה us-east1.
state

enum (State)

פלט בלבד. המצב הנוכחי של העותק.

מדינה

אם הקטלוג משוכפל למספר אזורים, ה-enum הזה מתאר את המצב הנוכחי של העותק המשוכפל.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED מצב הרפליקה לא ידוע.
STATE_PRIMARY מציין שהרפליקה היא העותק הראשי שאפשר לכתוב בו.
STATE_PRIMARY_IN_PROGRESS מציין שהעותק המשוכפל הוקצה לאחרונה כעותק הראשי, אבל עדיין אי אפשר לכתוב לכל מסדי הנתונים.
STATE_SECONDARY מציין שהרפליקה היא רפליקה משנית לקריאה בלבד.

Methods

create

 יוצר קטלוג חדש של Hive.

delete

 מחיקת קטלוג קיים שצוין באמצעות מזהה הקטלוג.

failover

 מעבירים את הקטלוג ליתירות כשל באזור חדש של רפליקה ראשית.

get

 מקבל את הקטלוג שצוין לפי שם המשאב.

list

 הצגת רשימה של כל הקטלוגים בפרויקט שצוין.

patch

 עדכון של קטלוג קיים.