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

Ressource: HiveTable

Speichert die Hive-Tabelleninformationen. Sie enthält den Tabellennamen, das Schema (Spaltennamen und -typen), den Datenspeicherort, das Speicherformat, die SerDe-Informationen usw. Diese Nachricht entspricht weitgehend dem Table-Objekt im 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 Attribute. 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 Text der ursprünglichen Ansicht. Leer für Nicht-Ansicht. Die maximale Größe beträgt 16 MiB.

viewExpandedText

string

Optional. Der Text der maximierten Ansicht. Leer für Nicht-Ansicht. Die maximale Größe beträgt 16 MiB.

tableType

string

Nur Ausgabe. Der Typ der Tabelle. Dies ist EXTERNAL für BigLake-Hive-Tabellen.

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der Aktualisierung 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 voll 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 Bucketing-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 des Felds. 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 des SerDe. Standardmäßig der Tabellenname. Die maximale Länge beträgt 128 Zeichen.

serializationLib

string

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

description

string

Optional. Beschreibung des SerDe. Die maximale Länge beträgt 4.000 Zeichen.

parameters

map (key: string, value: string)

Optional. Parameter der Serialisierung/Deserialisierung. 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 vollständig qualifizierte Java-Klassenname des Serializers. Die maximale Länge beträgt 4.000 Zeichen.

deserializerClass

string

Optional. Der vollständig qualifizierte Java-Klassenname des Deserialisierers. 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 Speicherorte 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 der entsprechende Speicherort.

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 in einer angegebenen Datenbank.

delete

Löscht eine angegebene Hive-Tabelle.

get

Ruft Details zu einer angegebenen Hive-Tabelle ab.

list

Listet alle Hive-Tabellen in einer angegebenen Datenbank auf.

patch

Aktualisiert eine vorhandene Hive-Tabelle in einer angegebenen Datenbank.