Method: hive.v1beta.projects.catalogs.databases.tables.partitions.batchCreate

테이블에 파티션을 추가합니다.

HTTP 요청

POST https://biglake.googleapis.com/hive/v1beta/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:batchCreate

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 파티션을 추가할 테이블에 대한 참조입니다(projects/{project}/catalogs/{catalogs}/databases/{database}/tables/{table} 형식).

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "requests": [
    {
      object (CreatePartitionRequest)
    }
  ],
  "skipExistingPartitions": boolean
}
필드
requests[]

object (CreatePartitionRequest)

필수 항목입니다. 테이블에 파티션을 추가하는 요청입니다.

skipExistingPartitions

boolean

선택사항입니다. Hive Metastore API의 ifNotExists 플래그에 해당합니다. 플래그가 false로 설정되면 파티션이 이미 존재하는 경우 서버에서 ALREADY_EXISTS를 반환합니다. 플래그가 true로 설정되면 서버에서 기존 파티션을 건너뛰고 존재하지 않는 파티션만 삽입합니다. 한 번에 최대 900개의 파티션을 삽입할 수 있습니다.

응답 본문

partitions.batchCreate의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "partitions": [
    {
      object (Partition)
    }
  ]
}
필드
partitions[]

object (Partition)

추가된 파티션 목록입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

CreatePartitionRequest

CreatePartition의 요청 메시지입니다. 파티션은 순서가 지정된 목록인 값으로 고유하게 식별됩니다. 따라서 별도의 이름 또는 파티션 ID 필드가 없습니다.

JSON 표현
{
  "parent": string,
  "partition": {
    object (Partition)
  }
}
필드
parent

string

필수 항목입니다. 파티션을 추가할 테이블에 대한 참조입니다(projects/{project}/catalogs/{catalogs}/databases/{databases}/tables/{table} 형식).

partition

object (Partition)

필수 항목입니다. 추가할 파티션입니다.