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

Resource: HiveTable

Menyimpan informasi tabel Hive. Objek ini mencakup nama tabel, skema (nama dan jenis kolom), lokasi data, format penyimpanan, info serde, dll. Pesan ini sangat cocok dengan objek Tabel di IMetastoreClient

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

string

ID. Nama resource. Format: projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}

description

string

Opsional. Deskripsi tabel. Panjang maksimumnya adalah 4.000 karakter.

storageDescriptor

object (StorageDescriptor)

Wajib. Deskriptor penyimpanan tabel.

createTime

string (Timestamp format)

Hanya output. Waktu pembuatan tabel.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

partitionKeys[]

object (FieldSchema)

Opsional. Kunci partisi tabel.

parameters

map (key: string, value: string)

Opsional. Menyimpan properti yang terkait dengan tabel. Ukuran maksimum adalah 4 MiB.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

viewOriginalText

string

Opsional. Teks tampilan asli. Kosong untuk non-penayangan. Ukuran maksimumnya adalah 16 MiB.

viewExpandedText

string

Opsional. Teks tampilan yang diperluas. Kosong untuk non-penayangan. Ukuran maksimumnya adalah 16 MiB.

tableType

string

Hanya output. Jenis tabel. Ini adalah EKSTERNAL untuk tabel Hive BigLake.

updateTime

string (Timestamp format)

Hanya output. Waktu pembaruan tabel.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

StorageDescriptor

Berisi informasi tentang penyimpanan fisik data tabel.

Representasi 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
}
Kolom
columns[]

object (FieldSchema)

Wajib. Menentukan kolom tabel.

locationUri

string

Opsional. URI penyimpanan cloud tempat tabel berada. Nilai defaultnya adalah <database_location_uri>/<table_name>. Panjang maksimumnya adalah 4.000 karakter.

inputFormat

string

Opsional. Nama class Java yang sepenuhnya memenuhi syarat untuk format input. Panjang maksimumnya adalah 4.000 karakter.

outputFormat

string

Opsional. Nama class Java yang sepenuhnya memenuhi syarat dari format output. Panjang maksimumnya adalah 4.000 karakter.

serdeInfo

object (SerdeInfo)

Opsional. Informasi serialisasi dan deserialisasi.

bucketCols[]

string

Opsional. Mengelompokkan kolom peredam, mengelompokkan kolom, dan mengelompokkan kolom

sortCols[]

object (Order)

Opsional. Urutan pengurutan data di setiap bucket

parameters

map (key: string, value: string)

Opsional. Pasangan nilai kunci untuk deskriptor penyimpanan. Ukuran maksimum adalah 10 KiB.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

skewedInfo

object (SkewedInfo)

Opsional. Informasi kecondongan data tabel.

compressed

boolean

Opsional. Apakah tabel dikompresi.

numBuckets

integer

Opsional. Jumlah bucket dalam tabel.

storedAsSubDirs

boolean

Opsional. Apakah tabel disimpan sebagai subdirektori.

FieldSchema

Informasi skema kolom.

Representasi JSON
{
  "name": string,
  "type": string,
  "comment": string
}
Kolom
name

string

Wajib. Nama kolom. Panjang maksimumnya adalah 767 karakter.

type

string

Wajib. Jenis kolom. Panjang maksimumnya adalah 128 karakter.

comment

string

Opsional. Komentar kolom. Panjang maksimumnya adalah 256 karakter.

SerdeInfo

Informasi serialisasi dan deserialisasi.

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

string

Wajib. Nama SerDe. Nama tabel secara default. Panjang maksimumnya adalah 128 karakter.

serializationLib

string

Wajib. Nama class Java yang sepenuhnya memenuhi syarat dari library serialisasi. Panjang maksimumnya adalah 4.000 karakter.

description

string

Opsional. Deskripsi serde. Panjang maksimumnya adalah 4.000 karakter.

parameters

map (key: string, value: string)

Opsional. Parameter serde. Ukuran maksimum adalah 10 KiB.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

serializerClass

string

Opsional. Nama class Java yang sepenuhnya memenuhi syarat dari serializer. Panjang maksimumnya adalah 4.000 karakter.

deserializerClass

string

Opsional. Nama class Java yang sepenuhnya memenuhi syarat dari deserializer. Panjang maksimumnya adalah 4.000 karakter.

serdeType

enum (SerdeType)

Opsional. Jenis serde.

SerdeType

Jenis serde.

Enum
SERDE_TYPE_UNSPECIFIED Jenis serde tidak ditentukan.
HIVE Hive.
SCHEMA_REGISTRY Registry skema.

Pesanan

Tata urutan data yang disimpan per kolom.

Representasi JSON
{
  "col": string,
  "order": integer
}
Kolom
col

string

Wajib. Nama kolom. Panjang maksimumnya adalah 767 karakter.

order

integer

Wajib. Menentukan urutan pengurutan kolom. Menaik jika 1, menurun jika 0.

SkewedInfo

Menyimpan semua informasi tentang tabel miring.

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

string

Wajib. Nama kolom yang miring. Panjang maksimum adalah 256 karakter per nama kolom.

skewedColValues[]

object (SkewedColumnValue)

Wajib. Nilai kolom yang miring.

skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

Wajib. Lokasi nilai kunci yang miring.

SkewedColumnValue

Nilai kolom yang miring.

Representasi JSON
{
  "values": [
    string
  ]
}
Kolom
values[]

string

Wajib. Nilai kolom yang miring. Panjang maksimum adalah 256 karakter per nilai.

SkewedKeyValuesLocation

Nilai kunci yang miring dan lokasi yang sesuai.

Representasi JSON
{
  "values": [
    string
  ],
  "location": string
}
Kolom
values[]

string

Wajib. Nilai kolom yang miring. Panjang maksimum adalah 256 karakter per nilai.

location

string

Wajib. Lokasi nilai kolom yang miring. Panjang maksimumnya adalah 4.000 karakter.

Metode

create

Membuat tabel hive baru.

delete

Menghapus tabel yang ada yang ditentukan oleh nama tabel.

get

Mendapatkan tabel yang ditentukan oleh nama resource.

list

Mencantumkan semua tabel hive dalam project tertentu di bawah katalog dan database hive.

patch

Memperbarui tabel yang ada yang ditentukan oleh nama tabel.