Package google.cloud.metastore.v1alpha

색인

DataprocMetastore

메타스토어 서비스를 구성하고 관리합니다. 메타스토어 서비스는 기술적인 메타데이터 관리 소프트웨어의 완전 관리형, 고가용성, 자동 확장, 자동 복구, OSS 기반 배포입니다. 각 메타스토어 서비스는 메타데이터 쿼리가 제공되는 네트워크 엔드포인트를 노출합니다. 메타데이터 쿼리는 Apache Hive, Apache Presto, Apache Spark를 비롯한 다양한 소스에서 발생할 수 있습니다.

Dataproc Metastore API는 다음과 같은 리소스 모델을 정의합니다.

  • 이 서비스는 /projects/*라는 이름의 Google Cloud 프로젝트 모음과 함께 작동합니다.
  • 각 프로젝트에는 사용 가능한 위치 모음이 있으며 이름은 /locations/*입니다. (위치는 Google Cloud region를 참조해야 함)
  • 각 위치에는 /services/*라는 서비스 모음이 있습니다.
  • Dataproc Metastore 서비스는 다음과 같은 형식의 이름을 가진 리소스입니다.

/projects/{project_number}/locations/{location_id}/services/{service_id}.

AlterMetadataResourceLocation

rpc AlterMetadataResourceLocation(AlterMetadataResourceLocationRequest) returns (Operation)

메타데이터 리소스 위치를 변경합니다. 메타데이터 리소스는 데이터베이스, 테이블 또는 파티션일 수 있습니다. 이 기능은 각 메타데이터 리소스의 상위 디렉터리만 업데이트하며 기존 데이터를 새 위치로 전송하지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

AlterTableProperties

rpc AlterTableProperties(AlterTablePropertiesRequest) returns (Operation)

메타데이터 테이블 속성을 변경합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

CancelMigration

rpc CancelMigration(CancelMigrationRequest) returns (Operation)

진행 중인 관리형 이전 프로세스를 취소합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

CompleteMigration

rpc CompleteMigration(CompleteMigrationRequest) returns (Operation)

관리형 이전 프로세스를 완료합니다. Dataproc Metastore 서비스는 마이그레이션이 완료되면 자체 백엔드 데이터베이스를 사용하도록 전환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

CreateBackup

rpc CreateBackup(CreateBackupRequest) returns (Operation)

특정 프로젝트와 위치에 새 백업을 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

CreateMetadataImport

rpc CreateMetadataImport(CreateMetadataImportRequest) returns (Operation)

특정 프로젝트 및 위치에 새 MetadataImport를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

CreateService

rpc CreateService(CreateServiceRequest) returns (Operation)

프로젝트 및 위치에 메타스토어 서비스를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

DeleteBackup

rpc DeleteBackup(DeleteBackupRequest) returns (Operation)

단일 백업을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

DeleteMigrationExecution

rpc DeleteMigrationExecution(DeleteMigrationExecutionRequest) returns (Operation)

단일 마이그레이션 실행을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Operation)

단일 서비스를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

ExportMetadata

rpc ExportMetadata(ExportMetadataRequest) returns (Operation)

서비스에서 메타데이터를 내보냅니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

GetBackup

rpc GetBackup(GetBackupRequest) returns (Backup)

단일 백업의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

GetMetadataImport

rpc GetMetadataImport(GetMetadataImportRequest) returns (MetadataImport)

단일 가져오기의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

GetMigrationExecution

rpc GetMigrationExecution(GetMigrationExecutionRequest) returns (MigrationExecution)

단일 이전 실행의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

GetService

rpc GetService(GetServiceRequest) returns (Service)

단일 서비스의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

ListBackups

rpc ListBackups(ListBackupsRequest) returns (ListBackupsResponse)

서비스의 백업을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

ListMetadataImports

rpc ListMetadataImports(ListMetadataImportsRequest) returns (ListMetadataImportsResponse)

서비스의 가져오기를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

ListMigrationExecutions

rpc ListMigrationExecutions(ListMigrationExecutionsRequest) returns (ListMigrationExecutionsResponse)

서비스의 마이그레이션 실행을 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

ListServices

rpc ListServices(ListServicesRequest) returns (ListServicesResponse)

프로젝트 및 위치의 서비스를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

MoveTableToDatabase

rpc MoveTableToDatabase(MoveTableToDatabaseRequest) returns (Operation)

테이블을 다른 데이터베이스로 이동합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

QueryMetadata

rpc QueryMetadata(QueryMetadataRequest) returns (Operation)

Dataproc Metastore 메타데이터 쿼리

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

RemoveIamPolicy

rpc RemoveIamPolicy(RemoveIamPolicyRequest) returns (RemoveIamPolicyResponse)

리소스에 연결된 IAM 정책을 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

RestoreService

rpc RestoreService(RestoreServiceRequest) returns (Operation)

백업에서 서비스를 복원합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

StartMigration

rpc StartMigration(StartMigrationRequest) returns (Operation)

관리형 이전 프로세스를 시작합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

UpdateMetadataImport

rpc UpdateMetadataImport(UpdateMetadataImportRequest) returns (Operation)

단일 가져오기를 업데이트합니다. MetadataImport의 설명 필드만 업데이트할 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Operation)

단일 서비스의 매개변수를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

DataprocMetastoreFederation

메타스토어 제휴 서비스를 구성하고 관리합니다. Dataproc Metastore Federation Service를 사용하면 BigQuery, Dataplex 레이크, 기타 Dataproc Metastore와 같은 백엔드 메타스토어 모음을 제휴할 수 있습니다. 제휴 서비스는 쿼리 시 백엔드 메타스토어의 메타데이터가 제공되는 gRPC URL을 노출합니다.

Dataproc Metastore Federation API는 다음과 같은 리소스 모델을 정의합니다. * 이 서비스는 Google Cloud 프로젝트 모음과 함께 작동합니다. * 각 프로젝트에는 사용 가능한 위치 모음이 있습니다. * 각 위치에는 제휴사 모음이 있습니다. * Dataproc Metastore 제휴는 이름이 projects/{project_number}/locations/{location_id}/federations/{federation_id} 형식인 리소스입니다.

CreateFederation

rpc CreateFederation(CreateFederationRequest) returns (Operation)

프로젝트 및 위치에 메타스토어 제휴를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

DeleteFederation

rpc DeleteFederation(DeleteFederationRequest) returns (Operation)

단일 제휴를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

GetFederation

rpc GetFederation(GetFederationRequest) returns (Federation)

단일 제휴의 세부정보를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

ListFederations

rpc ListFederations(ListFederationsRequest) returns (ListFederationsResponse)

프로젝트 및 위치의 제휴를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

UpdateFederation

rpc UpdateFederation(UpdateFederationRequest) returns (Operation)

제휴의 필드를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

AlterMetadataResourceLocationRequest

DataprocMetastore.AlterMetadataResourceLocation에 대한 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 메타데이터를 변경할 메타스토어 서비스의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.mutateMetadata
resource_name

string

필수 입력란입니다. 다음 형식의 상대 메타데이터 리소스 이름입니다.

databases/{database_id}, databases/{database_id}/tables/{table_id} 또는 databases/{database_id}/tables/{table_id}/partitions/{partition_id}

location_uri

string

필수 입력란입니다. 메타데이터 리소스의 새 위치 URI입니다.

AlterMetadataResourceLocationResponse

이 유형에는 필드가 없습니다.

DataprocMetastore.AlterMetadataResourceLocation의 응답 메시지입니다.

AlterTablePropertiesRequest

DataprocMetastore.AlterTableProperties에 대한 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 메타데이터 테이블 속성을 변경하는 데 사용되는 Dataproc Metastore 서비스의 상대 리소스 이름입니다(다음 형식).

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.mutateMetadata
table_name

string

필수 입력란입니다. 다음 형식의 변경할 속성이 포함된 테이블의 이름입니다.

databases/{database_id}/tables/{table_id}

update_mask

FieldMask

업데이트로 덮어쓰는 메타데이터 테이블 속성을 지정하는 필드 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다.

예를 들어 다음과 같은 타겟 속성이 있다고 가정해 보겠습니다.

properties {
  a: 1
  b: 2
}

업데이트 속성:

properties {
  a: 2
  b: 3
  c: 4
}

필드 마스크가 다음과 같은 경우:

경로: ["properties.b", "properties.c"]

그러면 결과는 다음과 같습니다.

properties {
  a: 1
  b: 3
  c: 4
}
properties

map<string, string>

변경하려는 원하는 값을 설명하는 맵입니다. update_mask가 비어 있으면 속성이 업데이트되지 않습니다. 그렇지 않으면 속성은 업데이트 마스크에 연결된 경로가 있는 값만 변경합니다.

AlterTablePropertiesResponse

이 유형에는 필드가 없습니다.

DataprocMetastore.AlterTableProperties의 응답 메시지입니다.

AutoscalingConfig

메타스토어 서비스의 자동 확장 구성을 나타냅니다.

필드
autoscaling_factor

float

출력 전용입니다. 자동 확장이 사용 설정된 서비스의 확장 계수입니다.

autoscaling_enabled

bool

선택사항입니다. 이 서비스에 자동 확장이 사용 설정되어 있는지 여부입니다.

limit_config

LimitConfig

선택사항입니다. 서비스의 LimitConfig입니다.

AuxiliaryVersionConfig

보조 서비스 버전의 구성 정보입니다.

필드
version

string

보조 서비스의 Hive 메타스토어 버전입니다. 기본 Hive 메타스토어 서비스의 버전보다 낮아야 합니다.

config_overrides

map<string, string>

기본 버전의 재정의 외에도 보조 Hive Metastore (hive-site.xml에 구성됨)에 적용할 Hive Metastore 구성 키-값 쌍의 매핑입니다. 보조 버전의 재정의와 기본 버전의 재정의에 모두 키가 있는 경우 보조 버전의 재정의 값이 우선 적용됩니다.

network_config

NetworkConfig

출력 전용입니다. 네트워크 구성에는 보조 Hive 메타스토어 서비스의 엔드포인트 URI가 포함됩니다.

BackendMetastore

제휴의 백엔드 메타스토어를 나타냅니다.

필드
name

string

제휴 중인 메타스토어의 상대적 리소스 이름입니다. 현재 지원되는 메타스토어의 상대 리소스 이름 형식은 다음과 같습니다.

  • BigQuery
    • projects/{project_id}
  • Dataproc Metastore
    • projects/{project_id}/locations/{location}/services/{service_id}
metastore_type

MetastoreType

백엔드 메타스토어의 유형입니다.

MetastoreType

백엔드 메타스토어의 유형입니다.

열거형
METASTORE_TYPE_UNSPECIFIED 메타스토어 유형이 설정되지 않았습니다.
DATAPLEX 백엔드 메타스토어는 Dataplex입니다.
BIGQUERY 백엔드 메타스토어는 BigQuery입니다.
DATAPROC_METASTORE 백엔드 메타스토어는 Dataproc Metastore입니다.

백업

백업 리소스의 세부정보입니다.

필드
name

string

변경할 수 없습니다. 백업의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}

create_time

Timestamp

출력 전용입니다. 백업이 시작된 시간입니다.

end_time

Timestamp

출력 전용입니다. 백업 생성이 완료된 시간입니다.

state

State

출력 전용입니다. 백업의 현재 상태입니다.

service_revision

Service

출력 전용입니다. 백업 시 서비스의 버전입니다.

description

string

백업에 대한 설명입니다.

restoring_services[]

string

출력 전용입니다. 백업에서 복원 중인 서비스

백업의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 백업 상태를 알 수 없습니다.
CREATING 백업을 생성하는 중입니다.
DELETING 백업을 삭제하는 중입니다.
ACTIVE 백업이 활성 상태이며 사용할 수 있습니다.
FAILED 백업에 실패했습니다.
RESTORING 백업을 복원하는 중입니다.

CancelMigrationRequest

DataprocMetastore.CancelMigration에 대한 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 진행 중인 이전을 취소할 메타스토어 서비스의 상대 리소스 이름입니다(다음 형식).

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.migrations.cancel

CancelMigrationResponse

DataprocMetastore.CancelMigration의 응답 메시지입니다.

필드
migration_execution

string

이전 실행의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}.

CompleteMigrationRequest

DataprocMetastore.CompleteMigration에 대한 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 마이그레이션을 완료할 메타스토어 서비스의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.migrations.complete

CompleteMigrationResponse

DataprocMetastore.CompleteMigration의 응답 메시지입니다.

필드
migration_execution

string

이전 실행의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}.

CreateBackupRequest

DataprocMetastore.CreateBackup에 대한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 백업을 만들 서비스의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_number}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.backups.create
backup_id

string

필수 입력란입니다. 백업 이름의 마지막 구성요소로 사용되는 백업의 ID입니다.

이 값은 1~64자(영문 기준)여야 하며 문자로 시작하고 문자나 숫자로 끝나야 하며 영숫자 ASCII 문자 또는 하이픈으로 구성되어야 합니다.

backup

Backup

필수 입력란입니다. 만들 백업입니다. name 필드는 무시됩니다. 생성된 백업의 ID는 요청의 backup_id 필드에 제공되어야 합니다.

request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

CreateFederationRequest

CreateFederation 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 제휴 서비스를 만들 위치의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.federations.create
federation_id

string

필수 입력란입니다. 메타스토어 제휴의 ID로, 메타스토어 제휴 이름의 마지막 구성요소로 사용됩니다.

이 값은 2~63자(영문 기준)여야 하며 문자로 시작하고 문자나 숫자로 끝나야 하며 영숫자 ASCII 문자 또는 하이픈으로 구성되어야 합니다.

federation

Federation

필수 입력란입니다. 만들 메타스토어 제휴입니다. name 필드는 무시됩니다. 생성된 메타스토어 제휴의 ID는 요청의 federation_id 필드에 제공되어야 합니다.

request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

CreateMetadataImportRequest

DataprocMetastore.CreateMetadataImport에 대한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 메타스토어 가져오기를 만들 서비스의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.imports.create
metadata_import_id

string

필수 입력란입니다. 메타데이터 가져오기의 ID로, 메타데이터 가져오기 이름의 마지막 구성요소로 사용됩니다.

이 값은 1~64자(영문 기준)여야 하며 문자로 시작하고 문자나 숫자로 끝나야 하며 영숫자 ASCII 문자 또는 하이픈으로 구성되어야 합니다.

metadata_import

MetadataImport

필수 입력란입니다. 만들려는 메타데이터 가져오기입니다. name 필드는 무시됩니다. 생성된 메타데이터 가져오기의 ID는 요청의 metadata_import_id 필드에 제공되어야 합니다.

request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

CreateServiceRequest

DataprocMetastore.CreateService에 대한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 메타스토어 서비스를 만들 위치의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.create
service_id

string

필수 입력란입니다. 메타스토어 서비스의 ID로, 메타스토어 서비스 이름의 마지막 구성요소로 사용됩니다.

이 값은 2~63자(영문 기준)여야 하며 문자로 시작하고 문자나 숫자로 끝나야 하며 영숫자 ASCII 문자 또는 하이픈으로 구성되어야 합니다.

service

Service

필수 입력란입니다. 만들 Metastore 서비스입니다. name 필드는 무시됩니다. 생성된 메타스토어 서비스의 ID는 요청의 service_id 필드에 제공되어야 합니다.

request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

DataCatalogConfig

메타스토어 메타데이터를 Data Catalog 서비스와 통합하는 방법을 지정합니다.

필드
enabled

bool

선택사항입니다. 메타스토어 메타데이터를 Data Catalog에 동기화할지 여부를 정의합니다. 기본값은 메타스토어 메타데이터를 Data Catalog에 동기화하지 않도록 설정하는 것입니다.

DatabaseDumpSpec

이 유형에는 필드가 없습니다.

가져오거나 내보낼 데이터베이스 덤프의 사양입니다.

유형

데이터베이스 덤프 유형입니다.

열거형
TYPE_UNSPECIFIED 데이터베이스 덤프 유형을 알 수 없습니다.
MYSQL 데이터베이스 덤프는 MySQL 덤프 파일입니다.
AVRO 데이터베이스 덤프에 Avro 파일이 포함되어 있습니다.

DataplexConfig

메타스토어 메타데이터를 Dataplex 서비스와 통합하는 방법을 지정합니다.

필드
lake_resources

map<string, Lake>

이 메타스토어 서비스가 연결된 레이크 리소스에 대한 참조입니다. 키는 호수 리소스 이름입니다. 예: projects/{project_number}/locations/{location_id}/lakes/{lake_id}

DeleteBackupRequest

DataprocMetastore.DeleteBackup에 대한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 백업의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.backups.delete
request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

DeleteFederationRequest

DeleteFederation 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 메타스토어 제휴의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/federations/{federation_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.federations.delete
request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

DeleteMigrationExecutionRequest

DataprocMetastore.DeleteMigrationExecution에 대한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 migrationExecution의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.migrations.delete
request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

DeleteServiceRequest

DataprocMetastore.DeleteService에 대한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 삭제할 메타스토어 서비스의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.delete
request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

EncryptionConfig

서비스의 암호화 설정입니다.

필드
kms_key

string

고객 데이터 암호화에 사용할 정규화된 고객 제공 Cloud KMS 키 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}.

ErrorDetails

DataprocMetastore.QueryMetadata의 공개 오류 메시지에 있는 오류 세부정보

필드
details

map<string, string>

이 오류에 관한 추가 구조화된 세부정보입니다.

키는 실패 항목을 정의합니다. 값은 상품의 예외 또는 세부정보를 설명합니다.

ExportMetadataRequest

DataprocMetastore.ExportMetadata에 대한 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 내보내기를 실행할 메타스토어 서비스의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.export
request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

database_dump_type

Type

선택사항입니다. 데이터베이스 덤프 유형입니다. 지정하지 않으면 기본적으로 MYSQL입니다.

통합 필드 destination. 필수 입력란입니다. 메타데이터가 내보내지는 대상입니다. destination은 다음 중 하나여야 합니다.
destination_gcs_folder

string

gs://<bucket_name>/<path_inside_bucket> 형식의 폴더의 Cloud Storage URI입니다. 내보낸 파일이 포함된 하위 폴더 <export_folder>가 아래에 생성됩니다.

제휴

여러 백엔드 메타스토어의 제휴를 나타냅니다.

필드
name

string

변경할 수 없습니다. 제휴의 상대 리소스 이름입니다. 형식은 'projects/{project_number}/locations/{location_id}/federations/{federation_id}`입니다.

create_time

Timestamp

출력 전용입니다. 메타스토어 제휴가 생성된 시간입니다.

update_time

Timestamp

출력 전용입니다. 메타스토어 제휴가 마지막으로 업데이트된 시간입니다.

labels

map<string, string>

메타스토어 제휴에 대한 사용자 정의 라벨입니다.

version

string

변경할 수 없습니다. 제휴의 Apache Hive 메타스토어 버전입니다. 모든 백엔드 메타스토어 버전은 제휴 버전과 호환되어야 합니다.

backend_metastores

map<int32, BackendMetastore>

BackendMetastore 순위에서 제휴 서비스가 쿼리 시 메타데이터를 제공하는 BackendMetastore로의 매핑입니다. 맵 키는 쿼리 시 데이터베이스 이름을 확인하기 위해 BackendMetastore를 평가해야 하는 순서를 나타내며 0보다 크거나 같아야 합니다. 숫자가 더 낮은 BackendMetastore가 숫자가 더 높은 BackendMetastore보다 먼저 평가됩니다.

endpoint_uri

string

출력 전용입니다. 제휴 엔드포인트입니다.

state

State

출력 전용입니다. 제휴의 현재 상태입니다.

state_message

string

출력 전용입니다. 메타스토어 제휴의 현재 상태에 대한 추가 정보(있는 경우)입니다.

uid

string

출력 전용입니다. 메타스토어 제휴의 전역적으로 고유한 리소스 식별자입니다.

제휴의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 메타스토어 제휴 상태를 알 수 없습니다.
CREATING 메타스토어 제휴를 만드는 중입니다.
ACTIVE 메타스토어 제휴가 실행 중이며 쿼리를 처리할 준비가 되었습니다.
UPDATING 메타스토어 제휴를 업데이트하는 중입니다. 계속 사용할 수 있지만 현재 추가 업데이트 요청을 수락하거나 삭제할 수 없습니다.
DELETING 메타스토어 제휴가 삭제되고 있습니다. 사용할 수 없습니다.
ERROR 메타스토어 제휴에 오류가 발생하여 사용할 수 없습니다. 메타스토어 제휴를 삭제해야 합니다.

GetBackupRequest

DataprocMetastore.GetBackup에 대한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 백업의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.backups.get

GetFederationRequest

GetFederation 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 메타스토어 제휴의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/federations/{federation_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.federations.get

GetMetadataImportRequest

DataprocMetastore.GetMetadataImport에 대한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 가져올 메타데이터 가져오기의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/metadataImports/{import_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.imports.get

GetMigrationExecutionRequest

DataprocMetastore.GetMigrationExecution에 대한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 검색할 이전 실행의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.migrations.get

GetServiceRequest

DataprocMetastore.GetService에 대한 요청 메시지입니다.

필드
name

string

필수 입력란입니다. 가져올 메타스토어 서비스의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_number}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.get

HiveMetastoreConfig

Hive 메타스토어 소프트웨어를 메타스토어 서비스로 실행하는 것과 관련된 구성 정보를 지정합니다.

필드
version

string

변경할 수 없습니다. Hive 메타스토어 스키마 버전입니다.

config_overrides

map<string, string>

Hive metastore (hive-site.xml에 구성됨)에 적용할 Hive metastore 구성 키-값 쌍 매핑입니다. 매핑은 시스템 기본값을 재정의합니다 (일부 키는 재정의할 수 없음). 이러한 재정의는 보조 버전에도 적용되며 보조 버전의 AuxiliaryVersionConfig에서 추가로 맞춤설정할 수 있습니다.

kerberos_config

KerberosConfig

Hive 메타스토어 서비스를 Kerberos 렐름의 서비스 사용자로 구성하는 데 사용되는 정보입니다. Kerberos를 사용 중지하려면 UpdateService 메서드를 사용하고 요청의 update_mask에 이 필드의 경로 (hive_metastore_config.kerberos_config)를 지정하면서 요청의 service에서 이 필드를 생략합니다.

endpoint_protocol

EndpointProtocol

metastore 서비스 엔드포인트에 사용할 프로토콜입니다. 지정하지 않으면 기본적으로 THRIFT입니다.

auxiliary_versions

map<string, AuxiliaryVersionConfig>

Hive 메타스토어 버전을 보조 버전 구성에 매핑합니다. 지정되면 기본 서비스와 함께 보조 Hive 메타스토어 서비스가 생성됩니다. 모든 보조 버전은 서비스의 기본 버전보다 낮아야 합니다. 키는 보조 서비스 이름이며 정규 표현식 a-z?와 일치해야 합니다. 즉, 첫 문자는 소문자이고 그 다음에 오는 모든 문자는 하이픈, 소문자, 숫자여야 합니다. 단, 마지막 문자에는 하이픈을 사용할 수 없습니다.

EndpointProtocol

metastore 서비스 엔드포인트를 제공하는 데 사용할 수 있는 프로토콜입니다.

열거형
ENDPOINT_PROTOCOL_UNSPECIFIED 프로토콜이 설정되지 않았습니다.
THRIFT metastore 서비스 엔드포인트에 레거시 Apache Thrift 프로토콜을 사용하세요.
GRPC metastore 서비스 엔드포인트에 현대화된 gRPC 프로토콜을 사용하세요.

KerberosConfig

Kerberos 사용자의 구성 정보입니다.

필드
keytab

Secret

Kerberos 키 배포 센터 (KDC)로 서비스 주체를 인증하는 데 사용할 수 있는 Kerberos Keytab 파일입니다.

principal

string

인증할 KDC 및 keytab에 모두 있는 Kerberos 주 구성원입니다. 일반적인 주체는 primary/instance@REALM 형식이지만 정확한 형식이 있는 것은 아닙니다.

krb5_config_gcs_uri

string

krb5.conf 파일의 경로를 지정하는 Cloud Storage URI입니다. 파일 이름을 krb5.conf로 명시적으로 지정할 필요는 없지만 gs://{bucket_name}/path/to/krb5.conf 형식입니다.

레이크

레이크 리소스를 나타냅니다.

필드
name

string

호수 리소스 이름입니다. 예: projects/{project_number}/locations/{location_id}/lakes/{lake_id}

LatestBackup

최근 예약된 백업의 세부정보입니다.

필드
backup_id

string

출력 전용입니다. 진행 중인 예약된 백업의 ID입니다. 백업이 진행 중이 아닌 경우 비어 있습니다.

start_time

Timestamp

출력 전용입니다. 백업이 시작된 시간입니다.

state

State

출력 전용입니다. 백업의 현재 상태입니다.

duration

Duration

출력 전용입니다. 백업 완료 시간입니다.

백업의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 백업 상태를 알 수 없습니다.
IN_PROGRESS 백업이 진행 중입니다.
SUCCEEDED 백업이 완료되었습니다.
FAILED 백업에 실패했습니다.

LimitConfig

메타스토어 서비스의 자동 확장 한도 구성을 나타냅니다.

필드
max_scaling_factor

float

선택사항입니다. 서비스가 자동 확장되어야 하는 최대 배율입니다.

min_scaling_factor

float

선택사항입니다. 서비스가 자동 확장되어야 하는 가장 낮은 배율입니다.

ListBackupsRequest

DataprocMetastore.ListBackups에 대한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 백업을 나열할 서비스의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/backups.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.backups.list
page_size

int32

선택사항입니다. 반환할 최대 백업 수입니다. 응답에 최대 개수보다 적은 수가 포함될 수 있습니다. 지정하지 않으면 최대 500개의 백업이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변경됩니다.

page_token

string

선택사항입니다. 이전 DataprocMetastore.ListBackups 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이 토큰을 입력합니다.

첫 번째 페이지를 검색하려면 빈 페이지 토큰을 제공합니다.

페이지로 나누는 경우, DataprocMetastore.ListBackups에 제공하는 다른 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

선택사항입니다. 목록 결과에 적용할 필터입니다.

order_by

string

선택사항입니다. 정렬 순서에 설명된 대로 결과 정렬을 지정합니다. 지정되지 않은 경우 결과가 기본 순서로 정렬됩니다.

ListBackupsResponse

DataprocMetastore.ListBackups의 응답 메시지입니다.

필드
backups[]

Backup

지정된 서비스의 백업입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListFederationsRequest

ListFederations 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 나열할 메타스토어 제휴 위치의 상대 리소스 이름으로, projects/{project_number}/locations/{location_id} 형식입니다.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.federations.list
page_size

int32

선택사항입니다. 반환할 최대 제휴 수입니다. 응답에 최대 개수보다 적은 수가 포함될 수 있습니다. 지정하지 않으면 최대 500개의 서비스가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변경됩니다.

page_token

string

선택사항입니다. 이전 ListFederationServices 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이 토큰을 입력합니다.

첫 번째 페이지를 검색하려면 빈 페이지 토큰을 제공합니다.

페이지로 나누는 경우, ListFederationServices에 제공하는 다른 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

선택사항입니다. 목록 결과에 적용할 필터입니다.

order_by

string

선택사항입니다. 정렬 순서에 설명된 대로 결과 정렬을 지정합니다. 지정되지 않은 경우 결과가 기본 순서로 정렬됩니다.

ListFederationsResponse

ListFederations의 응답 메시지입니다.

필드
federations[]

Federation

지정된 위치의 서비스입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListMetadataImportsRequest

DataprocMetastore.ListMetadataImports에 대한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 메타데이터가 목록으로 가져오는 서비스의 상대 리소스 이름이며 다음 형식입니다.

projects/{project_number}/locations/{location_id}/services/{service_id}/metadataImports.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.imports.list
page_size

int32

선택사항입니다. 반환할 최대 가져오기 수입니다. 응답에 최대 개수보다 적은 수가 포함될 수 있습니다. 지정하지 않으면 최대 500개의 가져오기가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변경됩니다.

page_token

string

선택사항입니다. 이전 DataprocMetastore.ListServices 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이 토큰을 입력합니다.

첫 번째 페이지를 검색하려면 빈 페이지 토큰을 제공합니다.

페이지로 나누는 경우, DataprocMetastore.ListServices에 제공하는 다른 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

선택사항입니다. 목록 결과에 적용할 필터입니다.

order_by

string

선택사항입니다. 정렬 순서에 설명된 대로 결과 정렬을 지정합니다. 지정되지 않은 경우 결과가 기본 순서로 정렬됩니다.

ListMetadataImportsResponse

DataprocMetastore.ListMetadataImports의 응답 메시지입니다.

필드
metadata_imports[]

MetadataImport

지정된 서비스의 가져오기입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListMigrationExecutionsRequest

DataprocMetastore.ListMigrationExecutions에 대한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 마이그레이션 실행을 나열할 서비스의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.migrations.list
page_size

int32

선택사항입니다. 반환할 최대 이전 실행 수입니다. 응답에 최대 개수보다 적은 수가 포함될 수 있습니다. 지정하지 않으면 최대 500개의 이전 실행이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변경됩니다.

page_token

string

선택사항입니다. 이전 DataprocMetastore.ListMigrationExecutions 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이 토큰을 입력합니다.

첫 번째 페이지를 검색하려면 빈 페이지 토큰을 제공합니다.

페이지로 나누는 경우, DataprocMetastore.ListMigrationExecutions에 제공하는 다른 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

선택사항입니다. 목록 결과에 적용할 필터입니다.

order_by

string

선택사항입니다. 정렬 순서에 설명된 대로 결과 정렬을 지정합니다. 지정되지 않은 경우 결과가 기본 순서로 정렬됩니다.

ListMigrationExecutionsResponse

DataprocMetastore.ListMigrationExecutions의 응답 메시지입니다.

필드
migration_executions[]

MigrationExecution

지정된 서비스의 이전 실행입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

unreachable[]

string

도달할 수 없는 위치입니다.

ListServicesRequest

DataprocMetastore.ListServices에 대한 요청 메시지입니다.

필드
parent

string

필수 입력란입니다. 나열할 메타스토어 서비스 위치의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.list
page_size

int32

선택사항입니다. 반환할 최대 서비스 수입니다. 응답에 최대 개수보다 적은 수가 포함될 수 있습니다. 지정하지 않으면 최대 500개의 서비스가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변경됩니다.

page_token

string

선택사항입니다. 이전 DataprocMetastore.ListServices 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이 토큰을 입력합니다.

첫 번째 페이지를 검색하려면 빈 페이지 토큰을 제공합니다.

페이지로 나누는 경우, DataprocMetastore.ListServices에 제공하는 다른 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

filter

string

선택사항입니다. 목록 결과에 적용할 필터입니다.

order_by

string

선택사항입니다. 정렬 순서에 설명된 대로 결과 정렬을 지정합니다. 지정되지 않은 경우 결과가 기본 순서로 정렬됩니다.

ListServicesResponse

DataprocMetastore.ListServices의 응답 메시지입니다.

필드
services[]

Service

지정된 위치의 서비스입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

unreachable[]

string

도달할 수 없는 위치입니다.

LocationMetadata

위치의 서비스에 대한 메타데이터입니다.

필드
supported_hive_metastore_versions[]

HiveMetastoreVersion

이 위치에서 새 Metastore 서비스를 만들 때 사용할 수 있는 Hive Metastore 버전입니다. 서버는 목록에서 정확히 하나의 HiveMetastoreVersionis_default를 설정하도록 보장합니다.

multi_region_metadata

MultiRegionMetadata

현재 리전이 멀티 리전인 경우 멀티 리전 메타데이터입니다.

custom_region_metadata[]

CustomRegionMetadata

현재 리전이 맞춤 리전인 경우 지원되는 구성입니다.

CustomRegionMetadata

맞춤 지역의 메타데이터입니다. 이 필드는 리전이 맞춤 리전인 경우에만 채워집니다. 단일/복수 리전의 경우 비어 있습니다.

필드
required_read_write_regions[]

string

이 맞춤 리전의 읽기-쓰기 리전입니다.

optional_read_only_regions[]

string

이 맞춤 리전의 읽기 전용 리전입니다.

witness_region

string

이 맞춤 리전의 Spanner 감시 리전입니다.

HiveMetastoreVersion

지원되는 Hive Metastore 소프트웨어 버전의 사양입니다.

필드
version

string

Hive Metastore 소프트웨어의 시맨틱 버전입니다.

is_default

bool

메타스토어 서비스가 version를 생략한 HiveMetastoreConfig로 생성된 경우 서버에서 version를 선택할지 여부입니다.

MultiRegionMetadata

구성 리전을 포함하는 멀티 리전의 메타데이터입니다. 메타데이터는 리전이 멀티 리전인 경우에만 채워집니다. 단일 리전 또는 맞춤 이중 리전의 경우 이 필드는 비어 있습니다.

필드
constituent_regions[]

string

멀티 리전을 구성하는 리전입니다.

MaintenanceWindow

유지보수 기간. Dataproc Metastore가 서비스에 시스템 유지보수 작업을 실행할 수 있는 시간을 지정합니다.

필드
hour_of_day

Int32Value

기간이 시작되는 시간 (0~23)입니다.

day_of_week

DayOfWeek

기간이 시작되는 요일입니다.

MetadataExport

메타데이터 내보내기 작업의 세부정보입니다.

필드
start_time

Timestamp

출력 전용입니다. 내보내기가 시작된 시간입니다.

end_time

Timestamp

출력 전용입니다. 내보내기가 종료된 시간입니다.

state

State

출력 전용입니다. 내보내기의 현재 상태입니다.

database_dump_type

Type

출력 전용입니다. 데이터베이스 덤프 유형입니다.

통합 필드 destination.

destination는 다음 중 하나여야 합니다.

destination_gcs_uri

string

출력 전용입니다. 메타데이터가 내보내지는 폴더의 Cloud Storage URI로, gs://<bucket_name>/<path_inside_bucket>/<export_folder> 형식이며 여기서 <export_folder>는 자동으로 생성됩니다.

메타데이터 내보내기의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 메타데이터 내보내기 상태를 알 수 없습니다.
RUNNING 메타데이터 내보내기가 실행 중입니다.
SUCCEEDED 메타데이터 내보내기가 완료되었습니다.
FAILED 메타데이터 내보내기에 실패했습니다.
CANCELLED 메타데이터 내보내기가 취소됩니다.

MetadataImport

메타데이터를 가져오는 메타스토어 리소스입니다.

필드
name

string

변경할 수 없습니다. 메타데이터 가져오기의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_number}/locations/{location_id}/services/{service_id}/metadataImports/{metadata_import_id}.

description

string

메타데이터 가져오기에 대한 설명입니다.

create_time

Timestamp

출력 전용입니다. 메타데이터 가져오기가 시작된 시간입니다.

update_time

Timestamp

출력 전용입니다. 메타데이터 가져오기가 마지막으로 업데이트된 시간입니다.

end_time

Timestamp

출력 전용입니다. 메타데이터 가져오기가 완료된 시간입니다.

state

State

출력 전용입니다. 메타데이터 가져오기의 현재 상태입니다.

통합 필드 metadata. 가져올 메타데이터입니다. metadata은 다음 중 하나여야 합니다.
database_dump

DatabaseDump

변경할 수 없습니다. 기존 메타스토어의 데이터베이스에서 가져온 데이터베이스 덤프입니다.

DatabaseDump

관계형 데이터베이스 관리 시스템의 데이터베이스 덤프 위치 및 메타데이터에 관한 사양입니다.

필드
database_type
(deprecated)

DatabaseType

데이터베이스의 유형입니다.

gcs_uri

string

메타데이터를 가져올 소스를 지정하는 Cloud Storage 객체 또는 폴더 URI입니다. gs://로 시작해야 합니다.

source_database
(deprecated)

string

소스 데이터베이스의 이름입니다.

type

Type

선택사항입니다. 데이터베이스 덤프 유형입니다. 지정하지 않으면 기본적으로 MYSQL입니다.

DatabaseType

데이터베이스의 유형입니다.

열거형
DATABASE_TYPE_UNSPECIFIED 소스 데이터베이스의 유형을 알 수 없습니다.
MYSQL 소스 데이터베이스의 유형은 MySQL입니다.

메타데이터 가져오기의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 메타데이터 가져오기 상태를 알 수 없습니다.
RUNNING 메타데이터 가져오기가 실행 중입니다.
SUCCEEDED 메타데이터 가져오기가 완료되었습니다.
UPDATING 메타데이터 가져오기를 업데이트하는 중입니다.
FAILED 메타데이터 가져오기에 실패했으며 시도된 메타데이터 변경사항이 롤백되었습니다.

MetadataIntegration

메타스토어 메타데이터를 외부 서비스와 통합하는 방법을 지정합니다.

필드
data_catalog_config

DataCatalogConfig

선택사항입니다. Data Catalog 서비스의 통합 구성입니다.

dataplex_config

DataplexConfig

Dataplex 서비스의 통합 구성입니다.

MetadataManagementActivity

메타스토어 서비스의 메타데이터 관리 활동입니다.

필드
metadata_exports[]

MetadataExport

출력 전용입니다. 메타스토어 서비스의 최신 메타데이터 내보내기입니다.

restores[]

Restore

출력 전용입니다. metastore 서비스의 최신 복원입니다.

MigrationExecution

이전 실행 리소스의 세부정보입니다.

필드
name

string

출력 전용입니다. 이전 실행의 상대 리소스 이름입니다(projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id} 형식).

create_time

Timestamp

출력 전용입니다. 이전 실행이 시작된 시간입니다.

end_time

Timestamp

출력 전용입니다. 이전 실행이 완료된 시간입니다.

state

State

출력 전용입니다. 이전 실행의 현재 상태입니다.

phase

Phase

출력 전용입니다. 마이그레이션 실행의 현재 단계입니다.

state_message

string

출력 전용입니다. 이전 실행의 현재 상태에 관한 추가 정보입니다.

통합 필드 migration_config. Dataproc Metastore에서 마이그레이션 프로세스 migration_config를 시작하는 데 필요한 구성 정보는 다음 중 하나여야 합니다.
cloud_sql_migration_config

CloudSQLMigrationConfig

Cloud SQL을 백엔드 데이터베이스로 사용하여 Google Cloud의 자체 관리형 Hive 메타스토어에서 Dataproc Metastore로 마이그레이션하는 것과 관련된 구성 정보입니다.

CloudSQLMigrationConfig

Cloud SQL을 백엔드 데이터베이스로 사용하여 Google Cloud의 자체 관리형 Hive 메타스토어에서 Dataproc Metastore로 마이그레이션하기 위한 구성 정보입니다.

필드
cdc_config

CdcConfig

필수 입력란입니다. 고객 데이터베이스에서 Dataproc metastore의 백엔드 데이터베이스로 변경 데이터 캡처(CDC) 스트림을 시작하기 위한 구성 정보입니다. Dataproc Metastore는 마이그레이션의 컷오버 단계 후에 자체 백엔드 데이터베이스를 사용하도록 전환합니다.

cloud_sql_connection_config

CloudSQLConnectionConfig

필수 입력란입니다. 마이그레이션의 컷오버 단계 전에 고객 데이터베이스 연결을 설정하기 위한 구성 정보

CdcConfig

고객 데이터베이스에서 Dataproc metastore의 백엔드 데이터베이스로 변경 데이터 캡처(CDC) 스트림을 시작하기 위한 구성 정보입니다.

필드
vpc_network

string

필수 입력란입니다. Cloud SQL 인스턴스의 VPC 네트워크 또는 Datastream이 피어링할 공유 VPC 네트워크의 정규화된 이름(projects/{project_id}/locations/global/networks/{network_id} 형식) 자세한 내용은 https://cloud.google.com/datastream/docs/network-connectivity-options#privateconnectivity를 참고하세요.

subnet_ip_range

string

필수 입력란입니다. Datastream과의 피어링을 위한 /29 CIDR IP 범위

username

string

필수 입력란입니다. Datastream 서비스가 MySQL 연결에 사용해야 하는 사용자 이름입니다.

password

string

필수 입력란입니다. 입력 전용입니다. Datastream 서비스가 MySQL 연결에 사용해야 하는 사용자의 비밀번호입니다. 이 필드는 요청 시 반환되지 않습니다.

reverse_proxy_subnet

string

필수 입력란입니다. 리버스 프록시를 호스팅하는 VM 인스턴스를 만들기 위한 서브네트워크 리소스의 URL입니다. 자세한 내용은 https://cloud.google.com/datastream/docs/private-connectivity#reverse-csql-proxy를 참고하세요. 서브네트워크는 Datastream에서 피어링할 요청에 제공된 네트워크에 있어야 하며 다음 형식으로 Datastream과 동일한 리전에 있어야 합니다. projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}

bucket

string

선택사항입니다. 중간 스트림 이벤트 데이터를 쓸 버킷입니다. 버킷 이름에는 'gs://'와 같은 프리픽스가 없어야 합니다. 버킷 이름 지정 요구사항을 참고하세요. 이 필드는 선택사항입니다. 설정하지 않으면 아티팩트 Cloud Storage 버킷이 사용됩니다.

root_path

string

선택사항입니다. Cloud Storage 버킷 내의 루트 경로입니다. 스트림 이벤트 데이터가 이 경로에 쓰여집니다. 기본값은 /migration입니다.

CloudSQLConnectionConfig

마이그레이션의 컷오버 단계 전에 고객 데이터베이스 연결을 설정하기 위한 구성 정보

필드
instance_connection_name

string

필수 입력란입니다. Cloud SQL 데이터베이스 연결 이름 (project_id:region:instance_name)

ip_address

string

필수 입력란입니다. Cloud SQL 인스턴스의 비공개 IP 주소입니다.

port

int32

필수 입력란입니다. 데이터베이스의 네트워크 포트입니다.

hive_database_name

string

필수 입력란입니다. Hive 데이터베이스 이름입니다.

username

string

필수 입력란입니다. Dataproc Metastore 서비스가 데이터베이스에 연결하는 데 사용할 사용자 이름입니다.

password

string

필수 입력란입니다. 입력 전용입니다. Dataproc Metastore 서비스가 데이터베이스에 연결하는 데 사용할 사용자의 비밀번호입니다. 이 필드는 요청 시 반환되지 않습니다.

proxy_subnet

string

필수 입력란입니다. SOCKS5 프록시 서비스를 배포할 서브네트워크의 관련 리소스 이름입니다. 서브네트워크는 Cloud SQL 인스턴스에 액세스할 수 있는 네트워크에 있어야 합니다. 리소스 이름은 projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id} 형식이어야 합니다.

nat_subnet

string

필수 입력란입니다. Private Service Connect에 사용할 서브네트워크의 관련 리소스 이름입니다. 이는 일반 서브넷일 수 없으며 NAT에만 사용됩니다. (https://cloud.google.com/vpc/docs/about-vpc-hosted-services#psc-subnets) 이 서브넷은 SOCKS5 프록시 서비스를 게시하는 데 사용됩니다. 서브넷 크기는 /29 이상이어야 하며 Cloud SQL 인스턴스에 액세스할 수 있는 네트워크에 있어야 합니다. 리소스 이름은 projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id} 형식이어야 합니다.

단계

마이그레이션 실행의 현재 단계입니다.

열거형
PHASE_UNSPECIFIED 마이그레이션 실행 단계를 알 수 없습니다.
REPLICATION 복제 단계는 Dataproc Metastore가 고객 데이터베이스의 변경사항을 백엔드 데이터베이스로 복제하기 위한 파이프라인을 실행하는 마이그레이션 단계를 의미합니다. 이 단계에서 Dataproc Metastore는 고객 데이터베이스를 Hive 메타스토어 백엔드 데이터베이스로 사용합니다.
CUTOVER 컷오버 단계는 Dataproc Metastore가 자체 백엔드 데이터베이스를 사용하도록 전환하는 마이그레이션 단계를 말합니다. 고객이 모든 클러스터/워크로드를 Dataproc Metastore로 마이그레이션하고 CompleteMigration를 트리거하면 마이그레이션이 이 단계로 전환됩니다.

이전 실행의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 마이그레이션 실행 상태를 알 수 없습니다.
STARTING 마이그레이션 실행이 시작됩니다.
RUNNING 마이그레이션 실행이 진행 중입니다.
CANCELLING 마이그레이션 실행을 취소하는 중입니다.
AWAITING_USER_ACTION 마이그레이션 실행에서 사용자 작업을 기다리는 중입니다.
SUCCEEDED 이전 실행이 완료되었습니다.
FAILED 마이그레이션 실행에 실패했습니다.
CANCELLED 마이그레이션 실행이 취소됩니다.
DELETING 마이그레이션 실행을 삭제하는 중입니다.

MoveTableToDatabaseRequest

DataprocMetastore.MoveTableToDatabase에 대한 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 메타데이터를 변경할 메타스토어 서비스의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.mutateMetadata
table_name

string

필수 입력란입니다. 이동할 테이블의 이름입니다.

db_name

string

필수 입력란입니다. 테이블이 있는 데이터베이스의 이름입니다.

destination_db_name

string

필수 입력란입니다. 테이블을 이동해야 하는 데이터베이스의 이름입니다.

MoveTableToDatabaseResponse

이 유형에는 필드가 없습니다.

DataprocMetastore.MoveTableToDatabase의 응답 메시지입니다.

MultiRegionConfig

Dataproc Metastore 서비스의 멀티 리전 구성입니다.

필드
certificates[]
(deprecated)

RootCACertificate

출력 전용입니다. gRPC 클라이언트가 멀티 리전 Dataproc Metastore 서비스에 연결하는 데 사용하는 루트 CA 인증서 목록입니다.

custom_region_config

CustomRegionConfig

CustomRegionConfig

메타스토어 서비스가 실행되는 리전을 지정하는 데 사용되는 맞춤 구성입니다. 현재 us 멀티 리전에서만 지원됩니다.

필드
read_write_regions[]

string

필수 입력란입니다. 메타스토어 서비스가 실행되는 읽기/쓰기 리전 목록입니다. 이러한 리전은 멀티 리전의 일부 (또는 하위 집합)여야 합니다.

read_only_regions[]

string

선택사항입니다. 메타스토어 서비스가 실행되는 읽기 전용 리전 목록입니다. 이러한 리전은 멀티 리전의 일부 (또는 하위 집합)여야 합니다.

RootCACertificate

gRPC 클라이언트는 멀티 리전 Dataproc Metastore 서비스에 연결하고 페일오버를 실행하려면 모든 루트 CA 인증서를 설치해야 합니다.

필드
certificate
(deprecated)

string

PEM 형식의 루트 CA 인증서입니다. 최대 길이는 65,536바이트입니다.

expiration_time
(deprecated)

Timestamp

타임스탬프 형식의 인증서 만료 시간입니다.

NetworkConfig

Dataproc Metastore 서비스의 네트워크 구성

필드
consumers[]

Consumer

변경할 수 없습니다. Dataproc Metastore 인스턴스의 소비자 측 네트워크 구성입니다.

custom_routes_enabled

bool

Dataproc Metastore 서비스의 피어링된 VPC 네트워크에 대해 커스텀 경로를 가져오고 내보낼 수 있도록 합니다.

소비자

고객의 네트워크 구성에 관한 정보를 포함합니다.

필드
endpoint_uri

string

출력 전용입니다. 메타스토어 서비스에 액세스하는 데 사용되는 엔드포인트의 URI입니다.

endpoint_location

string

출력 전용입니다. 엔드포인트 URI의 위치입니다. 형식은 projects/{project}/locations/{location}입니다.

통합 필드 vpc_resource.

vpc_resource는 다음 중 하나여야 합니다.

subnetwork

string

변경할 수 없습니다. IP 주소가 예약되고 Dataproc Metastore 서비스의 엔드포인트로 사용되는 고객 프로젝트의 서브넷입니다. 서브넷의 호스트와 동일한 리전 및 동일한 네트워크의 서브넷에 있는 모든 호스트에서 액세스할 수 있습니다. 서브넷의 기본 범위에 사용 가능한 IP 주소가 하나 이상 있어야 합니다. 서브넷은 다음 형식으로 지정됩니다.

projects/{project_number}/regions/{region_id}/subnetworks/{subnetwork_id}

OperationMetadata

장기 실행 작업의 메타데이터를 나타냅니다.

필드
create_time

Timestamp

출력 전용입니다. 작업이 생성된 시간입니다.

end_time

Timestamp

출력 전용입니다. 작업 실행이 완료된 시간입니다.

target

string

출력 전용입니다. 작업 대상에 대한 서버 정의 리소스 경로입니다.

verb

string

출력 전용입니다. 작업에 의해 실행된 동사의 이름입니다.

status_message

string

출력 전용입니다. 상태에 대한 인간이 읽을 수 있는 상태입니다(존재하는 경우).

requested_cancellation

bool

출력 전용입니다. 호출자가 작업 취소를 요청했는지 여부를 나타냅니다. 성공적으로 취소된 작업은 Code.CANCELLED에 해당하는 google.rpc.Status.code가 1인 [Operation.error][] 값을 갖습니다.

api_version

string

출력 전용입니다. 작업을 시작하는 데 사용되는 API 버전입니다.

QueryMetadataRequest

DataprocMetastore.QueryMetadata에 대한 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 메타데이터를 쿼리할 메타스토어 서비스의 상대 리소스 이름이며 다음 형식입니다.

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.queryMetadata
query

string

필수 입력란입니다. 메타데이터 데이터베이스에 대해 실행할 읽기 전용 SQL 쿼리입니다. 쿼리는 데이터를 변경하거나 변형할 수 없습니다.

QueryMetadataResponse

DataprocMetastore.QueryMetadata의 응답 메시지입니다.

필드
result_manifest_uri

string

매니페스트 URI는 Cloud Storage의 JSON 인스턴스에 대한 링크입니다. 이 인스턴스는 QueryMetadataResponse와 함께 즉시 표시됩니다. 메타데이터에 대한 장기 실행 작업 쿼리가 완료될 때까지 URI의 콘텐츠를 검색할 수 없습니다.

RemoveIamPolicyRequest

DataprocMetastore.RemoveIamPolicy에 대한 요청 메시지입니다.

필드
resource

string

필수 입력란입니다. IAM 정책을 삭제할 데이터 영역 리소스의 상대 리소스 이름입니다(다음 형식).

projects/{project_id}/locations/{location_id}/services/{service_id}/databases/{database_id} 또는 projects/{project_id}/locations/{location_id}/services/{service_id}/databases/{database_id}/tables/{table_id}.

asynchronous

bool

선택사항입니다. 데이터베이스 또는 테이블에 연결된 IAM 정책이 설정되면 비동기식으로 삭제합니다. 기본값은 false입니다.

RemoveIamPolicyResponse

DataprocMetastore.RemoveIamPolicy의 응답 메시지입니다.

필드
success

bool

정책이 삭제된 경우 true입니다.

복원

메타데이터 복원 작업의 세부정보입니다.

필드
start_time

Timestamp

출력 전용입니다. 복원이 시작된 시간입니다.

end_time

Timestamp

출력 전용입니다. 복원이 종료된 시간입니다.

state

State

출력 전용입니다. 복원의 현재 상태입니다.

backup

string

출력 전용입니다. 복원할 메타스토어 서비스 백업의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.

type

RestoreType

출력 전용입니다. 복원 유형입니다.

details

string

출력 전용입니다. 복원할 서비스의 버전이 포함된 복원 세부정보(JSON 형식)입니다.

backup_location

string

선택사항입니다. 백업 아티팩트가 저장되는 위치를 지정하는 Cloud Storage URI(gs://<bucket_name>/<path_inside_bucket> 형식)입니다.

RestoreType

복원 유형입니다. 지정하지 않으면 기본적으로 METADATA_ONLY입니다.

열거형
RESTORE_TYPE_UNSPECIFIED 복원 유형을 알 수 없습니다.
FULL 서비스의 메타데이터 및 구성이 복원됩니다.
METADATA_ONLY 서비스의 메타데이터만 복원됩니다.

복원의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 메타데이터 복원 상태를 알 수 없습니다.
RUNNING 메타데이터 복원이 실행 중입니다.
SUCCEEDED 메타데이터 복원이 완료되었습니다.
FAILED 메타데이터 복원에 실패했습니다.
CANCELLED 메타데이터 복원이 취소됩니다.

RestoreServiceRequest

[DataprocMetastore.Restore][] 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 복원을 실행할 메타스토어 서비스의 상대 리소스 이름입니다(다음 형식).

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.restore
backup

string

선택사항입니다. 복원할 메타스토어 서비스 백업의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}. backup_location와 상호 배타적이며 둘 중 하나만 설정해야 합니다.

승인을 처리하려면 지정된 리소스 backup에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.backups.use
backup_location

string

선택사항입니다. 백업 아티팩트의 위치(예: 'avro/' 아래의 백업 Avro 파일, backup_metastore.json, service.json)를 지정하는 Cloud Storage URI로, 다음 형식입니다.

gs://<path_to_backup>. backup와 상호 배타적이며 둘 중 하나만 설정해야 합니다.

restore_type

RestoreType

선택사항입니다. 복원 유형입니다. 지정하지 않으면 기본적으로 METADATA_ONLY입니다.

request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

ScalingConfig

메타스토어 서비스의 확장 구성을 나타냅니다.

필드
autoscaling_config

AutoscalingConfig

선택사항입니다. 자동 확장 구성

통합 필드 scaling_model. 사전 결정된 인스턴스 크기 또는 숫자 배율을 나타냅니다. scaling_model은 다음 중 하나여야 합니다.
instance_size

InstanceSize

읽을 수 있는 인스턴스 크기의 enum으로, 각 인스턴스 크기는 부동 소수점 값에 매핑됩니다 (예: InstanceSize.EXTRA_SMALL = scaling_factor(0.1)).

scaling_factor

float

크기 조정 계수로, 1.0 미만의 값에는 0.1씩 증가하고 1.0을 초과하는 값에는 1.0씩 증가합니다.

InstanceSize

메타스토어 인스턴스 크기

열거형
INSTANCE_SIZE_UNSPECIFIED 지정되지 않은 인스턴스 크기
EXTRA_SMALL 초소형 인스턴스 크기로, 확장 인수 0.1에 매핑됩니다.
SMALL 작은 인스턴스 크기로, 확장 인수 0.5에 매핑됩니다.
MEDIUM 중형 인스턴스 크기로, 배율 1.0에 매핑됩니다.
LARGE 대규모 인스턴스 크기로, 확장 인수 3.0에 매핑됩니다.
EXTRA_LARGE 초대형 인스턴스 크기로, 확장 인수 6.0에 매핑됩니다.

ScheduledBackup

예약된 백업의 구성을 지정합니다.

필드
enabled

bool

선택사항입니다. 예약된 백업이 사용 설정되어 있는지 정의합니다. 기본값은 false입니다.

cron_schedule

string

선택사항입니다. Cron 형식의 예약된 간격입니다(https://en.wikipedia.org/wiki/Cron 참고). 기본값은 비어 있습니다. 예약된 백업이 사용 설정되지 않은 것입니다. 예약된 백업을 사용 설정하려면 지정해야 합니다.

time_zone

string

선택사항입니다. cron_schedule을 해석할 때 사용할 시간대를 지정합니다. 시간대 데이터베이스(https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)의 시간대 이름이어야 합니다(예: America/Los_Angeles 또는 Africa/Abidjan). 지정하지 않으면 기본값은 UTC입니다.

next_scheduled_time

Timestamp

출력 전용입니다. 다음 백업 실행이 시작될 예정인 시간입니다.

backup_location

string

선택사항입니다. gs://<bucket_name>/<path_inside_bucket> 형식의 폴더의 Cloud Storage URI입니다. 백업 파일이 포함된 하위 폴더 <backup_folder>가 그 아래에 저장됩니다.

latest_backup

LatestBackup

출력 전용입니다. 최근 예약된 백업의 세부정보입니다.

보안 비밀

안전하게 저장된 값입니다.

필드

통합 필드 value.

value는 다음 중 하나여야 합니다.

cloud_secret

string

Secret Manager 보안 비밀 버전의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/secrets/{secret_id}/versions/{version_id}.

서비스

메타데이터 쿼리를 제공하는 관리형 메타스토어 서비스입니다.

필드
name

string

변경할 수 없습니다. 메타스토어 서비스의 상대 리소스 이름입니다(다음 형식).

projects/{project_number}/locations/{location_id}/services/{service_id}.

create_time

Timestamp

출력 전용입니다. metastore 서비스가 생성된 시간입니다.

update_time

Timestamp

출력 전용입니다. 메타스토어 서비스가 마지막으로 업데이트된 시간입니다.

labels

map<string, string>

메타스토어 서비스의 사용자 정의 라벨입니다.

network

string

변경할 수 없습니다. 인스턴스에 액세스할 수 있는 VPC 네트워크의 상대 리소스 이름입니다. 다음과 같은 형식으로 지정됩니다.

projects/{project_number}/global/networks/{network_id}.

endpoint_uri

string

출력 전용입니다. 메타스토어 서비스에 액세스하는 데 사용되는 엔드포인트의 URI입니다.

port

int32

Metastore 서비스에 연결되는 TCP 포트입니다. 기본값: 9083.

state

State

출력 전용입니다. 메타스토어 서비스의 현재 상태입니다.

state_message

string

출력 전용입니다. metastore 서비스의 현재 상태에 대한 추가 정보(있는 경우)입니다.

artifact_gcs_uri

string

출력 전용입니다. 메타스토어 서비스와 관련된 아티팩트가 저장되는 위치를 지정하는 Cloud Storage URI (gs://로 시작)입니다.

tier

Tier

서비스 등급입니다.

metadata_integration

MetadataIntegration

선택사항입니다. 메타스토어 메타데이터를 외부 서비스 및 시스템과 통합하는 방법을 정의하는 설정입니다.

maintenance_window

MaintenanceWindow

메타스토어 서비스의 1시간 유지보수 기간입니다. 유지보수를 위해 서비스를 다시 시작할 수 있는 시기를 UTC 시간으로 지정합니다. SPANNER 데이터베이스 유형의 서비스에는 유지보수 기간이 필요하지 않습니다.

uid

string

출력 전용입니다. 메타스토어 서비스의 전역적으로 고유한 리소스 식별자입니다.

metadata_management_activity

MetadataManagementActivity

출력 전용입니다. 메타스토어 서비스의 메타데이터 관리 활동입니다.

release_channel

ReleaseChannel

변경할 수 없습니다. 서비스의 출시 채널입니다. 지정하지 않으면 기본적으로 STABLE입니다.

encryption_config

EncryptionConfig

변경할 수 없습니다. 비활성 상태의 고객 데이터를 암호화하도록 Dataproc Metastore 서비스를 구성하는 데 사용되는 정보입니다. 이 설정은 업데이트할 수 없습니다.

network_config

NetworkConfig

Dataproc Metastore 서비스의 네트워크 설정을 지정하는 구성입니다.

database_type

DatabaseType

변경할 수 없습니다. 메타스토어 서비스가 데이터를 저장하는 데이터베이스 유형입니다.

telemetry_config

TelemetryConfig

Dataproc Metastore 서비스의 원격 분석 설정을 지정하는 구성입니다. 지정하지 않으면 기본값은 JSON입니다.

scaling_config

ScalingConfig

메타스토어 서비스의 확장 구성

multi_region_config

MultiRegionConfig

선택사항입니다. Hive 메타스토어 서비스의 멀티 리전 구성 정보를 지정합니다.

scheduled_backup

ScheduledBackup

선택사항입니다. 메타스토어 서비스의 예약된 백업 구성입니다.

deletion_protection

bool

선택사항입니다. Dataproc 메타스토어를 실수로 삭제하지 않도록 보호해야 하는지 여부를 나타냅니다.

통합 필드 metastore_config. 기본 메타스토어 서비스 기술 (메타스토어 쿼리를 제공하는 소프트웨어)에 관한 구성 속성입니다. metastore_config은 다음 중 하나여야 합니다.
hive_metastore_config

HiveMetastoreConfig

Hive 메타스토어 소프트웨어를 메타스토어 서비스로 실행하는 것과 관련된 구성 정보입니다.

DatabaseType

메타스토어 서비스의 백엔드 데이터베이스 유형입니다.

열거형
DATABASE_TYPE_UNSPECIFIED DATABASE_TYPE이 설정되지 않습니다.
MYSQL MySQL은 메타스토어 데이터를 유지하는 데 사용됩니다.
SPANNER Spanner는 메타스토어 데이터를 유지하는 데 사용됩니다.

ReleaseChannel

출시 채널은 다양한 수준의 안정성 기능을 번들로 제공합니다. 최신 기능은 처음에는 안정성이 낮은 출시 채널에 도입될 수 있으며 더 안정적인 출시 채널로 자동 승격될 수 있습니다.

열거형
RELEASE_CHANNEL_UNSPECIFIED 출시 채널이 지정되지 않았습니다.
CANARY CANARY 출시 채널에는 불안정할 수 있고 알려진 해결 방법 없이 미해결된 문제가 있을 수 있는 최신 기능들이 포함됩니다. CANARY 출시 채널을 사용하는 서비스에는 어떠한 SLA도 적용되지 않습니다.
STABLE STABLE 출시 채널에는 안정적인 것으로 간주되고 프로덕션 용도로 검증된 기능이 포함되어 있습니다.

메타스토어 서비스의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 메타스토어 서비스의 상태를 알 수 없습니다.
CREATING 메타스토어 서비스를 만드는 중입니다.
ACTIVE 메타스토어 서비스가 실행 중이며 쿼리를 처리할 준비가 되었습니다.
SUSPENDING 메타스토어 서비스가 정지됩니다. 쿼리 제공 기능이 예기치 않게 중단될 수 있습니다.
SUSPENDED Metastore 서비스가 정지되어 쿼리를 제공할 수 없습니다.
UPDATING 메타스토어 서비스를 업데이트하는 중입니다. 계속 사용할 수 있지만 현재 추가 업데이트 요청을 수락하거나 삭제할 수 없습니다.
DELETING Metastore 서비스를 삭제하는 중입니다. 사용할 수 없습니다.
ERROR 메타스토어 서비스에 오류가 발생하여 사용할 수 없습니다. 메타스토어 서비스를 삭제해야 합니다.
AUTOSCALING Dataproc Metastore 서비스 2가 확장 또는 축소되고 있습니다.
MIGRATING 메타스토어 서비스에서 관리형 마이그레이션을 처리하고 있습니다.

등급

사용 가능한 서비스 등급

열거형
TIER_UNSPECIFIED 등급이 설정되지 않았습니다.
DEVELOPER 개발자 등급은 확장성이 제한되며 내결함성을 제공하지 않습니다. 저비용 개념 증명에 적합합니다.
ENTERPRISE 엔터프라이즈 등급은 멀티 영역 고가용성과 엔터프라이즈급 Dataproc Metastore 워크로드에 충분한 확장성을 제공합니다.

StartMigrationRequest

DataprocMetastore.StartMigration에 대한 요청 메시지입니다.

필드
service

string

필수 입력란입니다. 이전을 시작할 메타스토어 서비스의 상대 리소스 이름입니다. 형식은 다음과 같습니다.

projects/{project_id}/locations/{location_id}/services/{service_id}.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.migrations.start
migration_execution

MigrationExecution

필수 입력란입니다. 이전의 구성 세부정보입니다.

request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

TelemetryConfig

Dataproc Metastore 서비스의 원격 분석 구성

필드
log_format

LogFormat

Dataproc Metastore 서비스 로그의 출력 형식입니다.

LogFormat

열거형
LOG_FORMAT_UNSPECIFIED LOG_FORMAT이 설정되지 않았습니다.
LEGACY 로깅 출력은 기존 textPayload 형식을 사용합니다.
JSON 로깅 출력은 jsonPayload 형식을 사용합니다.

UpdateFederationRequest

UpdateFederation 요청 메시지입니다.

필드
update_mask

FieldMask

필수 입력란입니다. 업데이트로 메타스토어 제휴 리소스에서 덮어쓸 필드를 지정하는 데 사용되는 필드 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다.

federation

Federation

필수 입력란입니다. 업데이트할 메타스토어 제휴입니다. 서버는 update_mask에 지정된 경우에만 서비스의 필드를 병합합니다.

메타스토어 제휴의 name 필드는 업데이트할 메타스토어 서비스를 식별하는 데 사용됩니다.

승인을 처리하려면 지정된 리소스 federation에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.federations.update
request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

UpdateMetadataImportRequest

DataprocMetastore.UpdateMetadataImport에 대한 요청 메시지입니다.

필드
update_mask

FieldMask

필수 입력란입니다. 업데이트로 메타데이터 가져오기 리소스에서 덮어쓸 필드를 지정하는 데 사용되는 필드 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다.

metadata_import

MetadataImport

필수 입력란입니다. 업데이트할 메타데이터 가져오기 서버는 update_mask에 지정된 경우에만 가져오기의 필드를 병합합니다.

메타데이터 가져오기의 name 필드는 업데이트할 메타스토어 가져오기를 식별하는 데 사용됩니다.

승인을 처리하려면 지정된 리소스 metadataImport에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.imports.update
request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.

UpdateServiceRequest

DataprocMetastore.UpdateService에 대한 요청 메시지입니다.

필드
update_mask

FieldMask

필수 입력란입니다. 업데이트로 메타스토어 서비스 리소스에서 덮어쓸 필드를 지정하는 데 사용되는 필드 마스크입니다. update_mask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다.

service

Service

필수 입력란입니다. 업데이트할 Metastore 서비스입니다. 서버는 update_mask에 지정된 경우에만 서비스의 필드를 병합합니다.

메타스토어 서비스의 name 필드는 업데이트할 메타스토어 서비스를 식별하는 데 사용됩니다.

승인을 처리하려면 지정된 리소스 service에 대해 다음과 같은 IAM 권한이 필요합니다.

  • metastore.services.update
request_id

string

선택사항입니다. 요청 ID입니다. 서버에서 완료된 요청을 무시할 수 있도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 중복 요청 ID를 제공하는 후속 요청을 무시합니다.

예를 들어 첫 번째 요청이 타임아웃된 후 동일한 요청 ID가 있는 다른 요청이 뒤따르면 서버는 중복 커밋이 생성되지 않도록 두 번째 요청을 무시합니다.

요청 ID는 유효한 UUID여야 합니다. 0 UUID (00000000-0000-0000-0000-000000000000)는 지원되지 않습니다.