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

Risorsa: HiveTable

Memorizza le informazioni della 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 serializzazione/deserializzazione e così via. Questo messaggio corrisponde quasi 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. La vista originale. Lascia vuoto per le non visualizzazioni. La dimensione massima è 16 MiB.
viewExpandedText

string

Facoltativo. Il testo della visualizzazione espansa. Lascia vuoto per le non visualizzazioni. La dimensione massima è 16 MiB.
tableType

string

Solo output. Il tipo di tabella. Questo valore è 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 sull'archiviazione fisica 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 di 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 su serializzazione e deserializzazione.
bucketCols[]

string

Facoltativo. Colonne di raggruppamento del reducer, colonne di clustering e colonne di bucketing
sortCols[]

object (Order)

Facoltativo. Ordine di 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. Il tipo di campo. La lunghezza massima è di 128 caratteri.
comment

string

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

SerdeInfo

Informazioni su serializzazione e deserializzazione.

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

string

Obbligatorio. Nome di 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 di 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 schema.

Ordine

Ordine di 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'ordine di ordinamento della colonna. Crescente se 1, decrescente se 0.

SkewedInfo

Memorizza tutte le informazioni sulla tabella distorta.

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

string

Obbligatorio. I nomi delle colonne che sono distorti. La lunghezza massima è di 256 caratteri per nome colonna.
skewedColValues[]

object (SkewedColumnValue)

Obbligatorio. I valori delle colonne distorti.
skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

Obbligatorio. Le posizioni dei valori chiave distorti.

SkewedColumnValue

I valori delle colonne distorti.

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

string

Obbligatorio. I valori delle colonne distorti. La lunghezza massima è di 256 caratteri per valore.

SkewedKeyValuesLocation

I valori delle chiavi distorti e la relativa posizione.

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

string

Obbligatorio. I valori delle colonne distorti. La lunghezza massima è di 256 caratteri per valore.
location

string

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

Metodi

create

 Crea una nuova tabella Hive.

delete

 Elimina una tabella esistente specificata dal nome della tabella.

get

 Recupera la tabella specificata dal nome della risorsa.

list

 Elenca tutte le tabelle Hive in un progetto specificato nel catalogo e nel database Hive.

patch

 Aggiorna una tabella esistente specificata dal nome della tabella.