- 리소스: HiveTable
- StorageDescriptor
- FieldSchema
- SerdeInfo
- SerdeType
- Order
- SkewedInfo
- SkewedColumnValue
- SkewedKeyValuesLocation
- 메서드
리소스: HiveTable
Hive 테이블 정보를 저장합니다. 테이블 이름, 스키마(열 이름 및 유형), 데이터 위치, 스토리지 형식, serde 정보 등이 포함됩니다. 이 메시지는 IMetastoreClient의 Table 객체와 매우 유사합니다.
| JSON 표현 |
|---|
{ "name": string, "description": string, "storageDescriptor": { object ( |
| 필드 | |
|---|---|
name |
식별자. 리소스 이름입니다. 형식: projects/{project_id_or_number}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId} |
description |
(선택사항) 테이블에 대한 설명입니다. 최대 길이는 4,000자(영문 기준)입니다. |
storageDescriptor |
필수 항목입니다. 테이블의 스토리지 설명자입니다. |
createTime |
출력 전용입니다. 테이블 생성 시간 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
partitionKeys[] |
(선택사항) 테이블의 파티션 키입니다. |
parameters |
(선택사항) 테이블과 연결된 속성을 저장합니다. 최대 크기는 4MiB입니다.
|
viewOriginalText |
(선택사항) 원본 뷰 텍스트입니다. 뷰가 아닌 경우 비어 있습니다. 최대 크기는 16MiB입니다. |
viewExpandedText |
(선택사항) 펼친 뷰 텍스트입니다. 뷰가 아닌 경우 비어 있습니다. 최대 크기는 16MiB입니다. |
tableType |
출력 전용입니다. 테이블의 유형입니다. BigLake Hive 테이블의 경우 EXTERNAL입니다. |
updateTime |
출력 전용입니다. 테이블 업데이트 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
StorageDescriptor
테이블 데이터의 물리적 스토리지에 대한 정보가 포함됩니다.
| JSON 표현 |
|---|
{ "columns": [ { object ( |
| 필드 | |
|---|---|
columns[] |
필수 항목입니다. 테이블의 열을 지정합니다. |
locationUri |
(선택사항) 테이블이 있는 Cloud Storage URI입니다. 기본값은 |
inputFormat |
(선택사항) 입력 형식의 정규화된 자바 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다. |
outputFormat |
(선택사항) 출력 형식의 정규화된 Java 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다. |
serdeInfo |
(선택사항) 직렬화 및 역직렬화 정보 |
bucketCols[] |
(선택사항) 리듀서 그룹화 열, 클러스터링 열, 버케팅 열 |
sortCols[] |
(선택사항) 각 버킷에 있는 데이터의 정렬 순서 |
parameters |
(선택사항) 스토리지 설명자의 키-값 쌍입니다. 최대 크기는 10Kib입니다.
|
skewedInfo |
(선택사항) 테이블 데이터 왜도 정보입니다. |
compressed |
(선택사항) 테이블 압축 여부입니다. |
numBuckets |
(선택사항) 테이블의 버킷 수입니다. |
storedAsSubDirs |
(선택사항) 테이블이 하위 디렉터리로 저장되는지 여부입니다. |
FieldSchema
필드 스키마 정보
| JSON 표현 |
|---|
{ "name": string, "type": string, "comment": string } |
| 필드 | |
|---|---|
name |
필수 항목입니다. 필드 이름입니다. 최대 길이는 767자(영문 기준)입니다. |
type |
필수 항목입니다. 필드 유형입니다. 최대 길이는 128자(영문 기준)입니다. |
comment |
(선택사항) 필드 주석입니다. 최대 길이는 256자(영문 기준)입니다. |
SerdeInfo
직렬화 및 역직렬화 정보
| JSON 표현 |
|---|
{
"name": string,
"serializationLib": string,
"description": string,
"parameters": {
string: string,
...
},
"serializerClass": string,
"deserializerClass": string,
"serdeType": enum ( |
| 필드 | |
|---|---|
name |
필수 항목입니다. SerDe의 이름입니다. 기본적으로 테이블 이름입니다. 최대 길이는 128자(영문 기준)입니다. |
serializationLib |
필수 항목입니다. 직렬화 라이브러리의 정규화된 Java 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다. |
description |
(선택사항) serde에 대한 설명입니다. 최대 길이는 4,000자(영문 기준)입니다. |
parameters |
(선택사항) serde의 매개변수입니다. 최대 크기는 10Kib입니다.
|
serializerClass |
(선택사항) 직렬 변환기의 정규화된 Java 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다. |
deserializerClass |
(선택사항) 역직렬 변환기의 정규화된 자바 클래스 이름입니다. 최대 길이는 4,000자(영문 기준)입니다. |
serdeType |
(선택사항) serde 유형입니다. |
SerdeType
serde 유형입니다.
| 열거형 | |
|---|---|
SERDE_TYPE_UNSPECIFIED |
serde 유형이 지정되지 않았습니다. |
HIVE |
Hive |
SCHEMA_REGISTRY |
스키마 레지스트리 |
주문
열당 저장된 데이터의 정렬 순서입니다.
| JSON 표현 |
|---|
{ "col": string, "order": integer } |
| 필드 | |
|---|---|
col |
필수 항목입니다. 열 이름입니다. 최대 길이는 767자(영문 기준)입니다. |
order |
필수 항목입니다. 열의 정렬 순서를 정의합니다. 1이면 오름차순, 0이면 내림차순입니다. |
SkewedInfo
편향된 테이블에 대한 모든 정보를 저장합니다.
| JSON 표현 |
|---|
{ "skewedColNames": [ string ], "skewedColValues": [ { object ( |
| 필드 | |
|---|---|
skewedColNames[] |
필수 항목입니다. 편향된 열 이름입니다. 최대 길이는 열 이름당 256자(영문 기준)입니다. |
skewedColValues[] |
필수 항목입니다. 편향된 열 값입니다. |
skewedKeyValuesLocations[] |
필수 항목입니다. 편향된 키 값 위치입니다. |
SkewedColumnValue
편향된 열 값입니다.
| JSON 표현 |
|---|
{ "values": [ string ] } |
| 필드 | |
|---|---|
values[] |
필수 항목입니다. 편향된 열 값입니다. 최대 길이는 값당 256자(영문 기준)입니다. |
SkewedKeyValuesLocation
편향된 키 값과 해당 위치입니다.
| JSON 표현 |
|---|
{ "values": [ string ], "location": string } |
| 필드 | |
|---|---|
values[] |
필수 항목입니다. 편향된 열 값입니다. 최대 길이는 값당 256자(영문 기준)입니다. |
location |
필수 항목입니다. 편향된 열 값의 위치입니다. 최대 길이는 4,000자(영문 기준)입니다. |
메서드 |
|
|---|---|
|
지정된 데이터베이스에 새 Hive 테이블을 만듭니다. |
|
지정된 Hive 테이블을 삭제합니다. |
|
지정된 Hive 테이블의 세부정보를 가져옵니다. |
|
지정된 데이터베이스의 모든 Hive 테이블을 나열합니다. |
|
지정된 데이터베이스의 기존 Hive 테이블을 업데이트합니다. |