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

Ressource : HiveTable

Stocke les informations de la table Hive. Il inclut le nom de la table, le schéma (noms et types de colonnes), l'emplacement des données, le format de stockage, les informations SerDe, etc. Ce message correspond étroitement à l'objet Table dans IMetastoreClient.

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

string

Identifiant. Nom de la ressource. Format : projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}
description

string

Facultatif. Description de la table. La longueur ne doit pas dépasser 4 000 caractères.
storageDescriptor

object (StorageDescriptor)

Obligatoire. Descripteur de stockage de la table.
createTime

string (Timestamp format)

Uniquement en sortie. Horodatage de création de la table.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
partitionKeys[]

object (FieldSchema)

Facultatif. Clés de partitionnement de la table.
parameters

map (key: string, value: string)

Facultatif. Stocke les propriétés associées à la table. La taille maximale est de 4 Mio.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
viewOriginalText

string

Facultatif. Affichage d'origine Vide pour les non-vues. La taille maximale est de 16 Mio.
viewExpandedText

string

Facultatif. Texte de la vue développée. Vide pour les non-vues. La taille maximale est de 16 Mio.
tableType

string

Uniquement en sortie. Type de la table. Cette valeur est EXTERNAL pour les tables Hive BigLake.
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de mise à jour de la table.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

StorageDescriptor

Contient des informations sur le stockage physique des données de la table.

Représentation 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
}
Champs
columns[]

object (FieldSchema)

Obligatoire. Spécifie les colonnes du tableau.
locationUri

string

Facultatif. URI Cloud Storage où se trouve la table. La valeur par défaut est <database_location_uri>/<table_name>. La longueur ne doit pas dépasser 4 000 caractères.
inputFormat

string

Facultatif. Nom complet de classe Java du format d'entrée. La longueur ne doit pas dépasser 4 000 caractères.
outputFormat

string

Facultatif. Nom complet de classe Java du format de sortie. La longueur ne doit pas dépasser 4 000 caractères.
serdeInfo

object (SerdeInfo)

Facultatif. Informations sur la sérialisation et la désérialisation.
bucketCols[]

string

Facultatif. Colonnes de regroupement et de clustering des réducteurs, et colonnes de répartition en buckets
sortCols[]

object (Order)

Facultatif. Ordre de tri des données dans chaque bucket
parameters

map (key: string, value: string)

Facultatif. Paires clé-valeur pour le descripteur de stockage. La taille maximale est de 10 Kio.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
skewedInfo

object (SkewedInfo)

Facultatif. Informations sur le décalage des données de table.
compressed

boolean

Facultatif. Indique si la table est compressée.
numBuckets

integer

Facultatif. Nombre de buckets dans le tableau.
storedAsSubDirs

boolean

Facultatif. Indique si la table est stockée sous forme de sous-répertoires.

FieldSchema

Informations sur le schéma du champ.

Représentation JSON 
{
  "name": string,
  "type": string,
  "comment": string
}
Champs
name

string

Obligatoire. Nom du champ. La longueur maximale est de 767 caractères.
type

string

Obligatoire. Type du champ. La longueur ne doit pas dépasser 128 caractères.
comment

string

Facultatif. Commentaire du champ. Elle ne doit pas comporter plus de 256 caractères.

SerdeInfo

Informations sur la sérialisation et la désérialisation.

Représentation JSON 
{
  "name": string,
  "serializationLib": string,
  "description": string,
  "parameters": {
    string: string,
    ...
  },
  "serializerClass": string,
  "deserializerClass": string,
  "serdeType": enum (SerdeType)
}
Champs
name

string

Obligatoire. Nom du SerDe. Nom de la table par défaut. La longueur ne doit pas dépasser 128 caractères.
serializationLib

string

Obligatoire. Nom complet de classe Java de la bibliothèque de sérialisation. La longueur ne doit pas dépasser 4 000 caractères.
description

string

Facultatif. Description de la sérialisation et de la désérialisation. La longueur ne doit pas dépasser 4 000 caractères.
parameters

map (key: string, value: string)

Facultatif. Paramètres du SerDe. La taille maximale est de 10 Kio.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
serializerClass

string

Facultatif. Nom complet de classe Java du sérialiseur. La longueur ne doit pas dépasser 4 000 caractères.
deserializerClass

string

Facultatif. Nom complet de classe Java du désérialiseur. La longueur ne doit pas dépasser 4 000 caractères.
serdeType

enum (SerdeType)

Facultatif. Type serde.

SerdeType

Types serde.

Enums
SERDE_TYPE_UNSPECIFIED Le type serde n'est pas spécifié.
HIVE Hive.
SCHEMA_REGISTRY Registre de schémas.

Commande

Ordre de tri des données stockées par colonne.

Représentation JSON 
{
  "col": string,
  "order": integer
}
Champs
col

string

Obligatoire. Nom de la colonne. La longueur maximale est de 767 caractères.
order

integer

Obligatoire. Définit l'ordre de tri de la colonne. Croissant si la valeur est 1, décroissant si la valeur est 0.

SkewedInfo

Stocke toutes les informations sur la table asymétrique.

Représentation JSON 
{
  "skewedColNames": [
    string
  ],
  "skewedColValues": [
    {
      object (SkewedColumnValue)
    }
  ],
  "skewedKeyValuesLocations": [
    {
      object (SkewedKeyValuesLocation)
    }
  ]
}
Champs
skewedColNames[]

string

Obligatoire. Noms des colonnes qui sont biaisées. La longueur maximale est de 256 caractères par nom de colonne.
skewedColValues[]

object (SkewedColumnValue)

Obligatoire. Valeurs de colonne asymétriques.
skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

Obligatoire. Emplacements des valeurs clés biaisées.

SkewedColumnValue

Valeurs de colonne asymétriques.

Représentation JSON 
{
  "values": [
    string
  ]
}
Champs
values[]

string

Obligatoire. Valeurs de colonne asymétriques. La longueur maximale est de 256 caractères par valeur.

SkewedKeyValuesLocation

Valeurs de clé asymétriques et emplacement correspondant.

Représentation JSON 
{
  "values": [
    string
  ],
  "location": string
}
Champs
values[]

string

Obligatoire. Valeurs de colonne asymétriques. La longueur maximale est de 256 caractères par valeur.
location

string

Obligatoire. Emplacement des valeurs de colonne asymétriques. La longueur ne doit pas dépasser 4 000 caractères.

Méthodes

create

 Crée une table Hive.

delete

 Supprime une table existante spécifiée par son nom.

get

 Récupère la table spécifiée par le nom de la ressource.

list

 Répertorie toutes les tables Hive d'un projet spécifié sous le catalogue et la base de données Hive.

patch

 Met à jour une table existante spécifiée par son nom.