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

Recurso: HiveTable

Armazena as informações da tabela do Hive. 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 é muito semelhante 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 texto original da visualização. 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 de 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, clustering e bucket do redutor

sortCols[]

object (Order)

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

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 buckets na tabela.

storedAsSubDirs

boolean

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

FieldSchema

Informações do esquema do 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 do 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 do serde. O tamanho máximo é de 4.000 caracteres.

parameters

map (key: string, value: string)

Opcional. Parâmetros do 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 de serde.

SerdeType

Os tipos de serde.

Tipos enumerados
SERDE_TYPE_UNSPECIFIED O tipo de 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 for 1, decrescente se for 0.

SkewedInfo

Armazena todas as informações sobre a tabela inclinada.

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

string

Obrigatório. Os nomes das colunas que estão distorcidas. O tamanho máximo é de 256 caracteres por nome de coluna.

skewedColValues[]

object (SkewedColumnValue)

Obrigatório. Os valores de coluna distorcidos.

skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

Obrigatório. Os locais dos valores de chave distorcidos.

SkewedColumnValue

Os valores de coluna distorcidos.

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

string

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

SkewedKeyValuesLocation

Os valores de chave distorcidos e o local correspondente.

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

string

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

location

string

Obrigatório. O local dos valores de coluna distorcidos. O tamanho máximo é de 4.000 caracteres.

Métodos

create

Cria uma nova tabela do Hive em um banco de dados especificado.

delete

Exclui uma tabela do Hive especificada.

get

Recebe detalhes de uma tabela do Hive especificada.

list

Lista todas as tabelas do Hive em um banco de dados especificado.

patch

Atualiza uma tabela do Hive em um banco de dados especificado.