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

Ressource: HiveTable

Speichert die Informationen zur Hive-Tabelle. Sie enthält den Tabellennamen, das Schema (Spaltennamen und -typen), den Datenspeicherort, das Speicherformat, SerDe-Informationen usw. Diese Nachricht entspricht weitgehend dem Table-Objekt in IMetastoreClient.

JSON-Darstellung 
{
  "name": string,
  "description": string,
  "storageDescriptor": {
    object (StorageDescriptor)
  },
  "createTime": string,
  "partitionKeys": [
    {
      object (FieldSchema)
    }
  ],
  "parameters": {
    string: string,
    ...
  },
  "viewOriginalText": string,
  "viewExpandedText": string,
  "tableType": string,
  "updateTime": string
}
Felder
name

string

ID. Der Ressourcenname. Format: projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}
description

string

Optional. Beschreibung der Tabelle. Die maximale Länge beträgt 4.000 Zeichen.
storageDescriptor

object (StorageDescriptor)

Erforderlich. Speicherdeskriptor der Tabelle.
createTime

string (Timestamp format)

Nur Ausgabe. Der Erstellungszeitpunkt der Tabelle.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
partitionKeys[]

object (FieldSchema)

Optional. Die Partitionsschlüssel der Tabelle.
parameters

map (key: string, value: string)

Optional. Speichert die mit der Tabelle verknüpften Eigenschaften. Die maximale Größe beträgt 4 MiB.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
viewOriginalText

string

Optional. Der ursprüngliche Text der Ansicht. Bei nicht aufgerufenen Inhalten leer. Die maximale Größe beträgt 16 MiB.
viewExpandedText

string

Optional. Der Text in der maximierten Ansicht. Bei nicht aufgerufenen Inhalten leer. Die maximale Größe beträgt 16 MiB.
tableType

string

Nur Ausgabe. Der Typ der Tabelle. Für BigLake-Hive-Tabellen ist dies EXTERNAL.
updateTime

string (Timestamp format)

Nur Ausgabe. Die Aktualisierungszeit der Tabelle.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

StorageDescriptor

Enthält Informationen zum physischen Speicher der Tabellendaten.

JSON-Darstellung 
{
  "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
}
Felder
columns[]

object (FieldSchema)

Erforderlich. Gibt die Spalten der Tabelle an.
locationUri

string

Optional. Der Cloud Storage-URI, unter dem sich die Tabelle befindet. Die Standardeinstellung ist <database_location_uri>/<table_name>. Die maximale Länge beträgt 4.000 Zeichen.
inputFormat

string

Optional. Der vollständig qualifizierte Java-Klassenname des Eingabeformats. Die maximale Länge beträgt 4.000 Zeichen.
outputFormat

string

Optional. Der vollständig qualifizierte Java-Klassenname des Ausgabeformats. Die maximale Länge beträgt 4.000 Zeichen.
serdeInfo

object (SerdeInfo)

Optional. Informationen zur Serialisierung und Deserialisierung.
bucketCols[]

string

Optional. Reducer-Gruppierungsspalten, Clustering-Spalten und Bucket-Spalten
sortCols[]

object (Order)

Optional. Sortierreihenfolge der Daten in jedem Bucket
parameters

map (key: string, value: string)

Optional. Schlüssel/Wert-Paare für den Speicherdeskriptor. Die maximale Größe beträgt 10 KiB.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
skewedInfo

object (SkewedInfo)

Optional. Informationen zur Datenverzerrung in Tabellen.
compressed

boolean

Optional. Gibt an, ob die Tabelle komprimiert ist.
numBuckets

integer

Optional. Die Anzahl der Buckets in der Tabelle.
storedAsSubDirs

boolean

Optional. Gibt an, ob die Tabelle als Unterverzeichnisse gespeichert wird.

FieldSchema

Informationen zum Feldschema.

JSON-Darstellung 
{
  "name": string,
  "type": string,
  "comment": string
}
Felder
name

string

Erforderlich. Name des Feldes. Die maximale Länge beträgt 767 Zeichen.
type

string

Erforderlich. Typ des Felds. Die maximale Länge beträgt 128 Zeichen.
comment

string

Optional. Kommentar zum Feld. Die maximale Länge beträgt 256 Zeichen.

SerdeInfo

Informationen zur Serialisierung und Deserialisierung.

JSON-Darstellung 
{
  "name": string,
  "serializationLib": string,
  "description": string,
  "parameters": {
    string: string,
    ...
  },
  "serializerClass": string,
  "deserializerClass": string,
  "serdeType": enum (SerdeType)
}
Felder
name

string

Erforderlich. Name der SerDe. Standardmäßig der Tabellenname. Die maximale Länge beträgt 128 Zeichen.
serializationLib

string

Erforderlich. Der vollständig qualifizierte Java-Klassenname der Serialisierungsbibliothek. Die maximale Länge beträgt 4.000 Zeichen.
description

string

Optional. Beschreibung der Serialisierung und Deserialisierung. Die maximale Länge beträgt 4.000 Zeichen.
parameters

map (key: string, value: string)

Optional. Parameter der SerDe. Die maximale Größe beträgt 10 KiB.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
serializerClass

string

Optional. Der voll qualifizierte Java-Klassenname des Serializers. Die maximale Länge beträgt 4.000 Zeichen.
deserializerClass

string

Optional. Der vollständig qualifizierte Java-Klassenname des Deserializers. Die maximale Länge beträgt 4.000 Zeichen.
serdeType

enum (SerdeType)

Optional. Der Serde-Typ.

SerdeType

Die Serde-Typen.

Enums
SERDE_TYPE_UNSPECIFIED Der Serde-Typ ist nicht angegeben.
HIVE Hive
SCHEMA_REGISTRY Schema-Registry

Auftrag

Sortierreihenfolge der gespeicherten Daten pro Spalte.

JSON-Darstellung 
{
  "col": string,
  "order": integer
}
Felder
col

string

Erforderlich. Der Name der Spalte, Die maximale Länge beträgt 767 Zeichen.
order

integer

Erforderlich. Definiert die Sortierreihenfolge der Spalte. Aufsteigend, wenn 1, absteigend, wenn 0.

SkewedInfo

Speichert alle Informationen zur verzerrten Tabelle.

JSON-Darstellung 
{
  "skewedColNames": [
    string
  ],
  "skewedColValues": [
    {
      object (SkewedColumnValue)
    }
  ],
  "skewedKeyValuesLocations": [
    {
      object (SkewedKeyValuesLocation)
    }
  ]
}
Felder
skewedColNames[]

string

Erforderlich. Die Spaltennamen, die verzerrt sind. Die maximale Länge beträgt 256 Zeichen pro Spaltenname.
skewedColValues[]

object (SkewedColumnValue)

Erforderlich. Die verzerrten Spaltenwerte.
skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

Erforderlich. Die Standorte der verzerrten Schlüsselwerte.

SkewedColumnValue

Die verzerrten Spaltenwerte.

JSON-Darstellung 
{
  "values": [
    string
  ]
}
Felder
values[]

string

Erforderlich. Die verzerrten Spaltenwerte. Die maximale Länge beträgt 256 Zeichen pro Wert.

SkewedKeyValuesLocation

Die verzerrten Schlüsselwerte und die entsprechende Position.

JSON-Darstellung 
{
  "values": [
    string
  ],
  "location": string
}
Felder
values[]

string

Erforderlich. Die verzerrten Spaltenwerte. Die maximale Länge beträgt 256 Zeichen pro Wert.
location

string

Erforderlich. Der Speicherort der verzerrten Spaltenwerte. Die maximale Länge beträgt 4.000 Zeichen.

Methoden

create

 Erstellt eine neue Hive-Tabelle.

delete

 Löscht eine vorhandene Tabelle, die durch den Tabellennamen angegeben wird.

get

 Ruft die durch den Ressourcennamen angegebene Tabelle ab.

list

 Alle Hive-Tabellen in einem angegebenen Projekt unter dem Hive-Katalog und der Hive-Datenbank auflisten.

patch

 Aktualisiert eine vorhandene Tabelle, die durch den Tabellennamen angegeben wird.