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

Recurso: HiveTable

Almacena la información de la tabla de Hive. Incluye el nombre de la tabla, el esquema (nombres y tipos de columnas), la ubicación de los datos, el formato de almacenamiento, la información de serde, etcétera. Este mensaje coincide estrechamente con el objeto Table en IMetastoreClient.

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

string

Es el identificador. Nombre del recurso. Formato: projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}

description

string

Es opcional. Descripción de la tabla. La longitud máxima es de 4,000 caracteres.

storageDescriptor

object (StorageDescriptor)

Obligatorio. Es el descriptor de almacenamiento de la tabla.

createTime

string (Timestamp format)

Solo salida. La hora de creación de la tabla.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

partitionKeys[]

object (FieldSchema)

Es opcional. Son las claves de partición de la tabla.

parameters

map (key: string, value: string)

Es opcional. Almacena las propiedades asociadas con la tabla. El tamaño máximo es de 4 MiB.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

viewOriginalText

string

Es opcional. Es el texto de la vista original. Está vacío para los elementos que no son vistas. El tamaño máximo es de 16 MiB.

viewExpandedText

string

Es opcional. Es el texto de la vista expandida. Está vacío para los elementos que no son vistas. El tamaño máximo es de 16 MiB.

tableType

string

Solo salida. El tipo de tabla. Es EXTERNAL para las tablas de Hive de BigLake.

updateTime

string (Timestamp format)

Solo salida. Es la fecha y hora de actualización de la tabla.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

StorageDescriptor

Contiene información sobre el almacenamiento físico de los datos de la tabla.

Representación 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
}
Campos
columns[]

object (FieldSchema)

Obligatorio. Especifica las columnas de la tabla.

locationUri

string

Es opcional. Es el URI de Cloud Storage en el que se encuentra la tabla. La configuración predeterminada es <database_location_uri>/<table_name>. La longitud máxima es de 4,000 caracteres.

inputFormat

string

Es opcional. El nombre de clase de Java completamente calificado del formato de entrada. La longitud máxima es de 4,000 caracteres.

outputFormat

string

Es opcional. El nombre de clase de Java completamente calificado del formato de salida. La longitud máxima es de 4,000 caracteres.

serdeInfo

object (SerdeInfo)

Es opcional. Información de serialización y deserialización

bucketCols[]

string

Es opcional. Columnas de agrupación de reductores, de agrupamiento en clústeres y de discretización

sortCols[]

object (Order)

Es opcional. Orden de clasificación de los datos en cada bucket

parameters

map (key: string, value: string)

Es opcional. Son pares clave-valor para el descriptor de almacenamiento. El tamaño máximo es de 10 KiB.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

skewedInfo

object (SkewedInfo)

Es opcional. Es información sobre el sesgo de los datos de la tabla.

compressed

boolean

Es opcional. Indica si la tabla está comprimida.

numBuckets

integer

Es opcional. Es la cantidad de buckets de la tabla.

storedAsSubDirs

boolean

Es opcional. Indica si la tabla se almacena como subdirectorios.

FieldSchema

Es la información del esquema del campo.

Representación JSON
{
  "name": string,
  "type": string,
  "comment": string
}
Campos
name

string

Obligatorio. Es el nombre del campo. La longitud máxima es de 767 caracteres.

type

string

Obligatorio. Es el tipo del campo. La longitud máxima es de 128 caracteres.

comment

string

Es opcional. Es el comentario del campo. La longitud máxima es de 256 caracteres.

SerdeInfo

Información de serialización y deserialización

Representación JSON
{
  "name": string,
  "serializationLib": string,
  "description": string,
  "parameters": {
    string: string,
    ...
  },
  "serializerClass": string,
  "deserializerClass": string,
  "serdeType": enum (SerdeType)
}
Campos
name

string

Obligatorio. Nombre del SerDe. Es el nombre de la tabla de forma predeterminada. La longitud máxima es de 128 caracteres.

serializationLib

string

Obligatorio. El nombre de clase de Java completamente calificado de la biblioteca de serialización. La longitud máxima es de 4,000 caracteres.

description

string

Es opcional. Es la descripción del serde. La longitud máxima es de 4,000 caracteres.

parameters

map (key: string, value: string)

Es opcional. Son los parámetros del serde. El tamaño máximo es de 10 KiB.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

serializerClass

string

Es opcional. Es el nombre de clase de Java completamente calificado del serializador. La longitud máxima es de 4,000 caracteres.

deserializerClass

string

Es opcional. Es el nombre de clase de Java completamente calificado del deserializador. La longitud máxima es de 4,000 caracteres.

serdeType

enum (SerdeType)

Es opcional. Es el tipo de serde.

SerdeType

Son los tipos de serde.

Enums
SERDE_TYPE_UNSPECIFIED No se especificó el tipo de serde.
HIVE Hive
SCHEMA_REGISTRY Registro de esquemas

Pedido

Es el orden de clasificación de los datos almacenados por columna.

Representación JSON
{
  "col": string,
  "order": integer
}
Campos
col

string

Obligatorio. El nombre de la columna. La longitud máxima es de 767 caracteres.

order

integer

Obligatorio. Define el orden de clasificación de la columna. Es 1 si es ascendente y 0 si es descendente.

SkewedInfo

Almacena toda la información sobre la tabla sesgada.

Representación JSON
{
  "skewedColNames": [
    string
  ],
  "skewedColValues": [
    {
      object (SkewedColumnValue)
    }
  ],
  "skewedKeyValuesLocations": [
    {
      object (SkewedKeyValuesLocation)
    }
  ]
}
Campos
skewedColNames[]

string

Obligatorio. Son los nombres de las columnas que están sesgadas. La longitud máxima es de 256 caracteres por nombre de columna.

skewedColValues[]

object (SkewedColumnValue)

Obligatorio. Son los valores de la columna sesgada.

skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

Obligatorio. Son las ubicaciones de los valores de clave sesgados.

SkewedColumnValue

Son los valores de la columna sesgada.

Representación JSON
{
  "values": [
    string
  ]
}
Campos
values[]

string

Obligatorio. Son los valores de la columna sesgada. La longitud máxima es de 256 caracteres por valor.

SkewedKeyValuesLocation

Son los valores de clave sesgados y su ubicación correspondiente.

Representación JSON
{
  "values": [
    string
  ],
  "location": string
}
Campos
values[]

string

Obligatorio. Son los valores de la columna sesgada. La longitud máxima es de 256 caracteres por valor.

location

string

Obligatorio. Ubicación de los valores de columna sesgados. La longitud máxima es de 4,000 caracteres.

Métodos

create

Crea una tabla de Hive nueva.

delete

Borra una tabla existente especificada por el nombre de la tabla.

get

Obtiene la tabla especificada por el nombre del recurso.

list

Enumera todas las tablas de Hive en un proyecto especificado en el catálogo y la base de datos de Hive.

patch

Actualiza una tabla existente especificada por el nombre de la tabla.