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

Recurso: HiveTable

Armazena as informações da tabela do Hive. Ela inclui o nome da tabela, o esquema (nomes e tipos de colunas), o local dos dados, o formato de armazenamento, as informações de serde etc. Essa mensagem corresponde ao objeto Table no IMetastoreClient.

Representação 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

Identificador. O nome do recurso. Formato: projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}
description

string

Opcional. Descrição da tabela. O tamanho máximo é de 4.000 caracteres.
storageDescriptor

object (StorageDescriptor)

Obrigatório. Descritor de armazenamento da tabela.
createTime

string (Timestamp format)

Apenas saída. A hora de criação da tabela.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
partitionKeys[]

object (FieldSchema)

Opcional. As chaves de partição da tabela.
parameters

map (key: string, value: string)

Opcional. Armazena as propriedades associadas à tabela. O tamanho máximo é de 4 MiB.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
viewOriginalText

string

Opcional. O formato original. Vazio para não visualização. O tamanho máximo é de 16 MiB.
viewExpandedText

string

Opcional. O texto da visualização expandida. Vazio para não visualização. O tamanho máximo é de 16 MiB.
tableType

string

Apenas saída. O tipo da tabela. É EXTERNAL para tabelas do Hive do BigLake.
updateTime

string (Timestamp format)

Apenas saída. A hora da atualização da tabela.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

StorageDescriptor

Contém informações sobre o armazenamento físico dos dados da tabela.

Representação 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)

Obrigatório. Especifica as colunas da tabela.
locationUri

string

Opcional. O URI do Cloud Storage em que a tabela está localizada. O valor padrão é <database_location_uri>/<table_name>. O tamanho máximo é de 4.000 caracteres.
inputFormat

string

Opcional. O nome totalmente qualificado da classe Java do formato de entrada. O tamanho máximo é de 4.000 caracteres.
outputFormat

string

Opcional. O nome da classe Java totalmente qualificado do formato de saída. O tamanho máximo é de 4.000 caracteres.
serdeInfo

object (SerdeInfo)

Opcional. Informações de serialização e desserialização.
bucketCols[]

string

Opcional. Colunas de agrupamento do redutor, de clustering e de agrupamento em intervalos
sortCols[]

object (Order)

Opcional. Ordem de classificação dos dados em cada agrupamento
parameters

map (key: string, value: string)

Opcional. Pares de chave-valor para o descritor de armazenamento. O tamanho máximo é de 10 Kib.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
skewedInfo

object (SkewedInfo)

Opcional. Informações sobre o desvio de dados da tabela.
compressed

boolean

Opcional. Se a tabela está compactada.
numBuckets

integer

Opcional. O número de intervalos na tabela.
storedAsSubDirs

boolean

Opcional. Se a tabela é armazenada como subdiretórios.

FieldSchema

Informações do esquema de campo.

Representação JSON 
{
  "name": string,
  "type": string,
  "comment": string
}
Campos
name

string

Obrigatório. Nome do campo. O tamanho máximo é de 767 caracteres.
type

string

Obrigatório. Tipo do campo. O tamanho máximo é de 128 caracteres.
comment

string

Opcional. Comentário do campo. O tamanho máximo é de 256 caracteres.

SerdeInfo

Informações de serialização e desserialização.

Representação JSON 
{
  "name": string,
  "serializationLib": string,
  "description": string,
  "parameters": {
    string: string,
    ...
  },
  "serializerClass": string,
  "deserializerClass": string,
  "serdeType": enum (SerdeType)
}
Campos
name

string

Obrigatório. Nome da SerDe. Nome da tabela por padrão. O tamanho máximo é de 128 caracteres.
serializationLib

string

Obrigatório. O nome totalmente qualificado da classe Java da biblioteca de serialização. O tamanho máximo é de 4.000 caracteres.
description

string

Opcional. Descrição da serde. O tamanho máximo é de 4.000 caracteres.
parameters

map (key: string, value: string)

Opcional. Parâmetros da SerDe. O tamanho máximo é de 10 Kib.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
serializerClass

string

Opcional. O nome totalmente qualificado da classe Java do serializador. O tamanho máximo é de 4.000 caracteres.
deserializerClass

string

Opcional. O nome totalmente qualificado da classe Java do desserializador. O tamanho máximo é de 4.000 caracteres.
serdeType

enum (SerdeType)

Opcional. O tipo serde.

SerdeType

Os tipos de serde.

Tipos enumerados
SERDE_TYPE_UNSPECIFIED O tipo serde não foi especificado.
HIVE Hive.
SCHEMA_REGISTRY Registro de esquema.

Pedido

Ordem de classificação dos dados armazenados por coluna.

Representação JSON 
{
  "col": string,
  "order": integer
}
Campos
col

string

Obrigatório. O nome da coluna. O tamanho máximo é de 767 caracteres.
order

integer

Obrigatório. Define a ordem de classificação da coluna. Crescente se 1, decrescente se 0.

SkewedInfo

Armazena todas as informações sobre a tabela com distorção.

Representação JSON 
{
  "skewedColNames": [
    string
  ],
  "skewedColValues": [
    {
      object (SkewedColumnValue)
    }
  ],
  "skewedKeyValuesLocations": [
    {
      object (SkewedKeyValuesLocation)
    }
  ]
}
Campos
skewedColNames[]

string

Obrigatório. Os nomes das colunas que estão com viés. O tamanho máximo é de 256 caracteres por nome de coluna.
skewedColValues[]

object (SkewedColumnValue)

Obrigatório. Os valores de coluna com viés.
skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

Obrigatório. Os locais dos valores de chave com viés.

SkewedColumnValue

Os valores de coluna com viés.

Representação JSON 
{
  "values": [
    string
  ]
}
Campos
values[]

string

Obrigatório. Os valores de coluna com viés. O tamanho máximo é de 256 caracteres por valor.

SkewedKeyValuesLocation

Os valores de chave enviesados e a localização correspondente.

Representação JSON 
{
  "values": [
    string
  ],
  "location": string
}
Campos
values[]

string

Obrigatório. Os valores de coluna com viés. O tamanho máximo é de 256 caracteres por valor.
location

string

Obrigatório. O local dos valores de coluna com distorção. O tamanho máximo é de 4.000 caracteres.

Métodos

create

 Cria uma tabela do Hive.

delete

 Exclui uma tabela especificada pelo nome dela.

get

 Recebe a tabela especificada pelo nome do recurso.

list

 Lista todas as tabelas do Hive em um projeto especificado no catálogo e banco de dados do Hive.

patch

 Atualiza uma tabela especificada pelo nome dela.