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

리소스: HiveTable

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

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

(선택사항) 입력 형식의 정규화된 Java 클래스 이름입니다. 최대 길이는 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

(선택사항) 역직렬화기의 정규화된 Java 클래스 이름입니다. 최대 길이는 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

 테이블 이름으로 지정된 기존 테이블을 삭제합니다.

get

 리소스 이름으로 지정된 테이블을 가져옵니다.

list

 Hive 카탈로그 및 데이터베이스 아래 지정된 프로젝트의 모든 Hive 테이블을 나열합니다.

patch

 테이블 이름으로 지정된 기존 테이블을 업데이트합니다.