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

리소스: HiveTable

Hive 테이블 정보를 저장합니다. 테이블 이름, 스키마(열 이름 및 유형), 데이터 위치, 스토리지 형식, serde 정보 등이 포함됩니다. 이 메시지는 IMetastoreClient의 Table 객체와 매우 유사합니다.

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

string

식별자. 리소스 이름입니다. 형식: projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}

description

string

(선택사항) 테이블에 대한 설명입니다. 최대 길이는 4,000자(영문 기준)입니다.

storageDescriptor

object (StorageDescriptor)

필수 항목입니다. 테이블의 스토리지 설명자입니다.

createTime

string (Timestamp format)

출력 전용입니다. 테이블 생성 시간

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

partitionKeys[]

object (FieldSchema)

(선택사항) 테이블의 파티션 키입니다.

parameters

map (key: string, value: string)

(선택사항) 테이블과 연결된 속성을 저장합니다. 최대 크기는 4MiB입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

viewOriginalText

string

(선택사항) 원본 뷰 텍스트입니다. 뷰가 아닌 경우 비어 있습니다. 최대 크기는 16MiB입니다.

viewExpandedText

string

(선택사항) 펼친 뷰 텍스트입니다. 뷰가 아닌 경우 비어 있습니다. 최대 크기는 16MiB입니다.

tableType

string

출력 전용입니다. 테이블의 유형입니다. BigLake Hive 테이블의 경우 EXTERNAL입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 테이블 업데이트 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

StorageDescriptor

테이블 데이터의 물리적 스토리지에 대한 정보가 포함됩니다.

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
}
필드
columns[]

object (FieldSchema)

필수 항목입니다. 테이블의 열을 지정합니다.

locationUri

string

(선택사항) 테이블이 있는 Cloud Storage URI입니다. 기본값은 <database_location_uri>/<table_name>입니다. 최대 길이는 4,000자(영문 기준)입니다.

inputFormat

string

(선택사항) 입력 형식의 정규화된 자바 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다.

outputFormat

string

(선택사항) 출력 형식의 정규화된 Java 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다.

serdeInfo

object (SerdeInfo)

(선택사항) 직렬화 및 역직렬화 정보

bucketCols[]

string

(선택사항) 리듀서 그룹화 열, 클러스터링 열, 버케팅 열

sortCols[]

object (Order)

(선택사항) 각 버킷에 있는 데이터의 정렬 순서

parameters

map (key: string, value: string)

(선택사항) 스토리지 설명자의 키-값 쌍입니다. 최대 크기는 10Kib입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

skewedInfo

object (SkewedInfo)

(선택사항) 테이블 데이터 왜도 정보입니다.

compressed

boolean

(선택사항) 테이블 압축 여부입니다.

numBuckets

integer

(선택사항) 테이블의 버킷 수입니다.

storedAsSubDirs

boolean

(선택사항) 테이블이 하위 디렉터리로 저장되는지 여부입니다.

FieldSchema

필드 스키마 정보

JSON 표현
{
  "name": string,
  "type": string,
  "comment": string
}
필드
name

string

필수 항목입니다. 필드 이름입니다. 최대 길이는 767자(영문 기준)입니다.

type

string

필수 항목입니다. 필드 유형입니다. 최대 길이는 128자(영문 기준)입니다.

comment

string

(선택사항) 필드 주석입니다. 최대 길이는 256자(영문 기준)입니다.

SerdeInfo

직렬화 및 역직렬화 정보

JSON 표현
{
  "name": string,
  "serializationLib": string,
  "description": string,
  "parameters": {
    string: string,
    ...
  },
  "serializerClass": string,
  "deserializerClass": string,
  "serdeType": enum (SerdeType)
}
필드
name

string

필수 항목입니다. SerDe의 이름입니다. 기본적으로 테이블 이름입니다. 최대 길이는 128자(영문 기준)입니다.

serializationLib

string

필수 항목입니다. 직렬화 라이브러리의 정규화된 Java 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다.

description

string

(선택사항) serde에 대한 설명입니다. 최대 길이는 4,000자(영문 기준)입니다.

parameters

map (key: string, value: string)

(선택사항) serde의 매개변수입니다. 최대 크기는 10Kib입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

serializerClass

string

(선택사항) 직렬 변환기의 정규화된 Java 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다.

deserializerClass

string

(선택사항) 역직렬 변환기의 정규화된 자바 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다.

serdeType

enum (SerdeType)

(선택사항) serde 유형입니다.

SerdeType

serde 유형입니다.

열거형
SERDE_TYPE_UNSPECIFIED serde 유형이 지정되지 않았습니다.
HIVE Hive
SCHEMA_REGISTRY 스키마 레지스트리

주문

열당 저장된 데이터의 정렬 순서입니다.

JSON 표현
{
  "col": string,
  "order": integer
}
필드
col

string

필수 항목입니다. 열 이름입니다. 최대 길이는 767자(영문 기준)입니다.

order

integer

필수 항목입니다. 열의 정렬 순서를 정의합니다. 1이면 오름차순, 0이면 내림차순입니다.

SkewedInfo

편향된 테이블에 대한 모든 정보를 저장합니다.

JSON 표현
{
  "skewedColNames": [
    string
  ],
  "skewedColValues": [
    {
      object (SkewedColumnValue)
    }
  ],
  "skewedKeyValuesLocations": [
    {
      object (SkewedKeyValuesLocation)
    }
  ]
}
필드
skewedColNames[]

string

필수 항목입니다. 편향된 열 이름입니다. 최대 길이는 열 이름당 256자(영문 기준)입니다.

skewedColValues[]

object (SkewedColumnValue)

필수 항목입니다. 편향된 열 값입니다.

skewedKeyValuesLocations[]

object (SkewedKeyValuesLocation)

필수 항목입니다. 편향된 키 값 위치입니다.

SkewedColumnValue

편향된 열 값입니다.

JSON 표현
{
  "values": [
    string
  ]
}
필드
values[]

string

필수 항목입니다. 편향된 열 값입니다. 최대 길이는 값당 256자(영문 기준)입니다.

SkewedKeyValuesLocation

편향된 키 값과 해당 위치입니다.

JSON 표현
{
  "values": [
    string
  ],
  "location": string
}
필드
values[]

string

필수 항목입니다. 편향된 열 값입니다. 최대 길이는 값당 256자(영문 기준)입니다.

location

string

필수 항목입니다. 편향된 열 값의 위치입니다. 최대 길이는 4,000자(영문 기준)입니다.

메서드

create

지정된 데이터베이스에 새 Hive 테이블을 만듭니다.

delete

지정된 Hive 테이블을 삭제합니다.

get

지정된 Hive 테이블의 세부정보를 가져옵니다.

list

지정된 데이터베이스의 모든 Hive 테이블을 나열합니다.

patch

지정된 데이터베이스의 기존 Hive 테이블을 업데이트합니다.