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

Risorsa: HiveTable

Memorizza le informazioni sulla tabella Hive. Include il nome della tabella, lo schema (nomi e tipi di colonne), la posizione dei dati, il formato di archiviazione, le informazioni di SerDe e così via. Questo messaggio corrisponde esattamente all'oggetto Table in IMetastoreClient

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

string

Identificatore. Nome della risorsa. Formato: projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}

description

string

Facoltativo. Descrizione della tabella. La lunghezza massima è di 4000 caratteri.

storageDescriptor

object (StorageDescriptor)

Obbligatorio. Descrittore di archiviazione della tabella.

createTime

string (Timestamp format)

Solo output. L'ora di creazione della tabella.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

partitionKeys[]

object (FieldSchema)

Facoltativo. Le chiavi di partizionamento della tabella.

parameters

map (key: string, value: string)

Facoltativo. Memorizza le proprietà associate alla tabella. La dimensione massima è 4 MiB.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

viewOriginalText

string

Facoltativo. Il testo della visualizzazione originale. Vuoto per non visualizzazione. La dimensione massima è 16 MiB.

viewExpandedText

string

Facoltativo. Il testo della visualizzazione espansa. Vuoto per non visualizzazione. La dimensione massima è 16 MiB.

tableType

string

Solo output. Il tipo di tabella. Questo è EXTERNAL per le tabelle Hive BigLake.

updateTime

string (Timestamp format)

Solo output. L'ora di aggiornamento della tabella.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

StorageDescriptor

Contiene informazioni sullo spazio di archiviazione fisico dei dati della tabella.

Rappresentazione 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
}
Campi
columns[]

object (FieldSchema)

Obbligatorio. Specifica le colonne della tabella.

locationUri

string

Facoltativo. L'URI Cloud Storage in cui si trova la tabella. Il valore predefinito è <database_location_uri>/<table_name>. La lunghezza massima è di 4000 caratteri.

inputFormat

string

Facoltativo. Il nome completo della classe Java del formato di input. La lunghezza massima è di 4000 caratteri.

outputFormat

string

Facoltativo. Il nome completo della classe Java del formato di output. La lunghezza massima è di 4000 caratteri.

serdeInfo

object (SerdeInfo)

Facoltativo. Informazioni sulla serializzazione e sulla deserializzazione.

bucketCols[]

string

Facoltativo. Colonne di raggruppamento, clustering e bucketing del riduttore

sortCols[]

object (Order)

Facoltativo. Ordinamento dei dati in ogni bucket

parameters

map (key: string, value: string)

Facoltativo. Coppie chiave-valore per il descrittore di archiviazione. La dimensione massima è 10 KiB.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

skewedInfo

object (SkewedInfo)

Facoltativo. Informazioni sulla distorsione dei dati della tabella.

compressed

boolean

Facoltativo. Indica se la tabella è compressa.

numBuckets

integer

Facoltativo. Il numero di bucket nella tabella.

storedAsSubDirs

boolean

Facoltativo. Indica se la tabella è archiviata come sottodirectory.

FieldSchema

Informazioni sullo schema dei campi.

Rappresentazione JSON
{
  "name": string,
  "type": string,
  "comment": string
}
Campi
name

string

Obbligatorio. Nome del campo. La lunghezza massima è di 767 caratteri.

type

string

Obbligatorio. Tipo di campo. La lunghezza massima è di 128 caratteri.

comment

string

Facoltativo. Commento del campo. La lunghezza massima è di 256 caratteri.

SerdeInfo

Informazioni sulla serializzazione e sulla deserializzazione.

Rappresentazione JSON
{
  "name": string,
  "serializationLib": string,
  "description": string,
  "parameters": {
    string: string,
    ...
  },
  "serializerClass": string,
  "deserializerClass": string,
  "serdeType": enum (SerdeType)
}
Campi
name

string

Obbligatorio. Nome del SerDe. Nome della tabella per impostazione predefinita. La lunghezza massima è di 128 caratteri.

serializationLib

string

Obbligatorio. Il nome completo della classe Java della libreria di serializzazione. La lunghezza massima è di 4000 caratteri.

description

string

Facoltativo. Descrizione del SerDe. La lunghezza massima è di 4000 caratteri.

parameters

map (key: string, value: string)

Facoltativo. Parametri del SerDe. La dimensione massima è 10 KiB.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

serializerClass

string

Facoltativo. Il nome completo della classe Java del serializzatore. La lunghezza massima è di 4000 caratteri.

deserializerClass

string

Facoltativo. Il nome completo della classe Java del deserializzatore. La lunghezza massima è di 4000 caratteri.

serdeType

enum (SerdeType)

Facoltativo. Il tipo di SerDe.

SerdeType

I tipi di SerDe.

Enum
SERDE_TYPE_UNSPECIFIED Il tipo di SerDe non è specificato.
HIVE Hive.
SCHEMA_REGISTRY Registro di schemi.

Ordine

Ordinamento dei dati archiviati per colonna.

Rappresentazione JSON
{
  "col": string,
  "order": integer
}
Campi
col

string

Obbligatorio. Il nome della colonna. La lunghezza massima è di 767 caratteri.

order

integer

Obbligatorio. Definisce l'ordinamento della colonna. In ordine crescente se 1, in ordine decrescente se 0.

SkewedInfo

Memorizza tutte le informazioni sulla tabella asimmetrica.

Rappresentazione JSON
{
  "skewedColNames": [
    string
  ],
  "skewedColValues": [
    {
      object (SkewedColumnValue)
    }
  ],
  "skewedKeyValuesLocations": [
    {
      object (SkewedKeyValuesLocation)
    }
  ]
}
Campi
skewedColNames[]

string

Obbligatorio. I nomi delle colonne con asimmetria. La lunghezza massima è di 256 caratteri per nome di colonna.

skewedColValues[]

object (SkewedColumnValue)

Obbligatorio. I valori della colonna con asimmetria.

skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

Obbligatorio. Le posizioni dei valori delle chiavi asimmetriche.

SkewedColumnValue

I valori della colonna con asimmetria.

Rappresentazione JSON
{
  "values": [
    string
  ]
}
Campi
values[]

string

Obbligatorio. I valori della colonna con asimmetria. La lunghezza massima è di 256 caratteri per valore.

SkewedKeyValuesLocation

I valori delle chiavi asimmetriche e la relativa posizione.

Rappresentazione JSON
{
  "values": [
    string
  ],
  "location": string
}
Campi
values[]

string

Obbligatorio. I valori della colonna con asimmetria. La lunghezza massima è di 256 caratteri per valore.

location

string

Obbligatorio. La posizione dei valori della colonna asimmetrica. La lunghezza massima è di 4000 caratteri.

Metodi

create

Crea una nuova tabella Hive in un database specificato.

delete

Elimina una tabella Hive specificata.

get

Recupera i dettagli di una tabella Hive specificata.

list

Elenca tutte le tabelle Hive in un database specificato.

patch

Aggiorna una tabella Hive esistente in un database specificato.