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

משאב: HiveTable

שומר את פרטי טבלת ה-Hive. הוא כולל את שם הטבלה, הסכימה (שמות וסוגים של עמודות), מיקום הנתונים, פורמט האחסון, פרטי ה-SerDe וכו'. ההודעה הזו דומה מאוד לאובייקט Table ב-IMetastoreClient

ייצוג ב-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 עם 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)

זה שינוי אופציונלי. מאחסן את המאפיינים שמשויכים לטבלה. הגודל המקסימלי הוא 4MiB.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
viewOriginalText

string

זה שינוי אופציונלי. הטקסט של התצוגה המקורית. אם לא רוצים להציג את התצוגה, משאירים את השדה ריק. הגודל המקסימלי הוא 16MiB.
viewExpandedText

string

זה שינוי אופציונלי. הטקסט בתצוגה המורחבת. אם לא רוצים להציג את התצוגה, משאירים את השדה ריק. הגודל המקסימלי הוא 16MiB.
tableType

string

פלט בלבד. סוג הטבלה. הערך הוא EXTERNAL לטבלאות hive ב-BigLake.
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

זה שינוי אופציונלי. כתובת ה-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)

זה שינוי אופציונלי. צמדי מפתח/ערך לתיאור האחסון. הגודל המקסימלי הוא 10Kib.

אובייקט שמכיל רשימה של "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. הגודל המקסימלי הוא 10Kib.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
serializerClass

string

זה שינוי אופציונלי. שם המחלקה המלא של Java של ה-serializer. האורך המקסימלי הוא 4,000 תווים.
deserializerClass

string

זה שינוי אופציונלי. השם המלא של מחלקת ה-Java של ה-deserializer. האורך המקסימלי הוא 4,000 תווים.
serdeType

enum (SerdeType)

זה שינוי אופציונלי. סוג ה-serde.

SerdeType

סוגי ה-serde.

טיפוסים בני מנייה (enum)
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 תווים.

Methods

create

 יוצר טבלת Hive חדשה.

delete

 מוחק טבלה קיימת שצוינה לפי שם הטבלה.

get

 הפונקציה מחזירה את הטבלה שצוינה לפי שם המשאב.

list

 הצגת רשימה של כל טבלאות Hive בפרויקט שצוין בקטלוג ובמסד הנתונים של Hive.

patch

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