- 리소스: 서비스
- JSON 표현
- HiveMetastoreConfig
- KerberosConfig
- 보안 비밀
- EndpointProtocol
- AuxiliaryVersionConfig
- NetworkConfig
- 소비자
- 상태
- 등급
- MetadataIntegration
- DataCatalogConfig
- MaintenanceWindow
- MetadataManagementActivity
- MetadataExport
- 상태
- 복원
- 상태
- RestoreType
- ReleaseChannel
- EncryptionConfig
- DatabaseType
- TelemetryConfig
- LogFormat
- ScalingConfig
- InstanceSize
- AutoscalingConfig
- LimitConfig
- ScheduledBackup
- LatestBackup
- 상태
- 메서드
리소스: 서비스
메타데이터 쿼리를 제공하는 관리형 메타스토어 서비스입니다.
JSON 표현 |
---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "network": string, "endpointUri": string, "port": integer, "state": enum ( |
필드 | |
---|---|
name |
변경할 수 없습니다. 메타스토어 서비스의 상대 리소스 이름입니다(다음 형식).
|
createTime |
출력 전용입니다. metastore 서비스가 생성된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
updateTime |
출력 전용입니다. 메타스토어 서비스가 마지막으로 업데이트된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
labels |
메타스토어 서비스의 사용자 정의 라벨입니다.
|
network |
변경할 수 없습니다. 인스턴스에 액세스할 수 있는 VPC 네트워크의 상대 리소스 이름입니다. 다음과 같은 형식으로 지정됩니다.
|
endpointUri |
출력 전용입니다. 메타스토어 서비스에 액세스하는 데 사용되는 엔드포인트의 URI입니다. |
port |
Metastore 서비스에 연결되는 TCP 포트입니다. 기본값: 9083. |
state |
출력 전용입니다. 메타스토어 서비스의 현재 상태입니다. |
stateMessage |
출력 전용입니다. metastore 서비스의 현재 상태에 대한 추가 정보(있는 경우)입니다. |
artifactGcsUri |
출력 전용입니다. 메타스토어 서비스와 관련된 아티팩트가 저장되는 위치를 지정하는 Cloud Storage URI ( |
tier |
서비스 등급입니다. |
metadataIntegration |
선택사항입니다. 메타스토어 메타데이터를 외부 서비스 및 시스템과 통합하는 방법을 정의하는 설정입니다. |
maintenanceWindow |
메타스토어 서비스의 1시간 유지보수 기간입니다. 유지보수를 위해 서비스를 다시 시작할 수 있는 시기를 UTC 시간으로 지정합니다. SPANNER 데이터베이스 유형의 서비스에는 유지보수 기간이 필요하지 않습니다. |
uid |
출력 전용입니다. 메타스토어 서비스의 전역적으로 고유한 리소스 식별자입니다. |
metadataManagementActivity |
출력 전용입니다. 메타스토어 서비스의 메타데이터 관리 활동입니다. |
releaseChannel |
변경할 수 없습니다. 서비스의 출시 채널입니다. 지정하지 않으면 기본적으로 |
encryptionConfig |
변경할 수 없습니다. 비활성 상태의 고객 데이터를 암호화하도록 Dataproc Metastore 서비스를 구성하는 데 사용되는 정보입니다. 이 설정은 업데이트할 수 없습니다. |
networkConfig |
Dataproc Metastore 서비스의 네트워크 설정을 지정하는 구성입니다. |
databaseType |
변경할 수 없습니다. 메타스토어 서비스가 데이터를 저장하는 데이터베이스 유형입니다. |
telemetryConfig |
Dataproc Metastore 서비스의 원격 분석 설정을 지정하는 구성입니다. 지정하지 않으면 기본값은 |
scalingConfig |
메타스토어 서비스의 확장 구성 |
scheduledBackup |
선택사항입니다. 메타스토어 서비스의 예약된 백업 구성입니다. |
deletionProtection |
선택사항입니다. Dataproc 메타스토어를 실수로 삭제하지 않도록 보호해야 하는지 여부를 나타냅니다. |
통합 필드 metastore_config . 기본 메타스토어 서비스 기술 (메타스토어 쿼리를 제공하는 소프트웨어)에 관한 구성 속성입니다. metastore_config 은 다음 중 하나여야 합니다. |
|
hiveMetastoreConfig |
Hive 메타스토어 소프트웨어를 메타스토어 서비스로 실행하는 것과 관련된 구성 정보입니다. |
HiveMetastoreConfig
Hive 메타스토어 소프트웨어를 메타스토어 서비스로 실행하는 것과 관련된 구성 정보를 지정합니다.
JSON 표현 |
---|
{ "version": string, "configOverrides": { string: string, ... }, "kerberosConfig": { object ( |
필드 | |
---|---|
version |
변경할 수 없습니다. Hive 메타스토어 스키마 버전입니다. |
configOverrides |
Hive metastore (
|
kerberosConfig |
Hive 메타스토어 서비스를 Kerberos 렐름의 서비스 사용자로 구성하는 데 사용되는 정보입니다. Kerberos를 사용 중지하려면 |
endpointProtocol |
metastore 서비스 엔드포인트에 사용할 프로토콜입니다. 지정하지 않으면 기본적으로 |
auxiliaryVersions |
Hive 메타스토어 버전을 보조 버전 구성에 매핑합니다. 지정되면 기본 서비스와 함께 보조 Hive 메타스토어 서비스가 생성됩니다. 모든 보조 버전은 서비스의 기본 버전보다 낮아야 합니다. 키는 보조 서비스 이름이며 정규 표현식 a-z?와 일치해야 합니다. 즉, 첫 문자는 소문자이고 그 다음에 오는 모든 문자는 하이픈, 소문자, 숫자여야 합니다. 단, 마지막 문자에는 하이픈을 사용할 수 없습니다.
|
KerberosConfig
Kerberos 사용자의 구성 정보입니다.
JSON 표현 |
---|
{
"keytab": {
object ( |
필드 | |
---|---|
keytab |
Kerberos 키 배포 센터 (KDC)로 서비스 주체를 인증하는 데 사용할 수 있는 Kerberos Keytab 파일입니다. |
principal |
인증할 KDC 및 keytab에 모두 있는 Kerberos 주 구성원입니다. 일반적인 주체는 |
krb5ConfigGcsUri |
krb5.conf 파일의 경로를 지정하는 Cloud Storage URI입니다. 파일 이름을 krb5.conf로 명시적으로 지정할 필요는 없지만 |
보안 비밀
안전하게 저장된 값입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드
|
|
cloudSecret |
Secret Manager 보안 비밀 버전의 상대 리소스 이름입니다(다음 형식).
|
EndpointProtocol
metastore 서비스 엔드포인트를 제공하는 데 사용할 수 있는 프로토콜입니다.
열거형 | |
---|---|
ENDPOINT_PROTOCOL_UNSPECIFIED |
프로토콜이 설정되지 않았습니다. |
THRIFT |
metastore 서비스 엔드포인트에 레거시 Apache Thrift 프로토콜을 사용하세요. |
GRPC |
metastore 서비스 엔드포인트에 현대화된 gRPC 프로토콜을 사용하세요. |
AuxiliaryVersionConfig
보조 서비스 버전의 구성 정보입니다.
JSON 표현 |
---|
{
"version": string,
"configOverrides": {
string: string,
...
},
"networkConfig": {
object ( |
필드 | |
---|---|
version |
보조 서비스의 Hive 메타스토어 버전입니다. 기본 Hive 메타스토어 서비스의 버전보다 낮아야 합니다. |
configOverrides |
기본 버전의 재정의 외에도 보조 Hive Metastore (
|
networkConfig |
출력 전용입니다. 네트워크 구성에는 보조 Hive 메타스토어 서비스의 엔드포인트 URI가 포함됩니다. |
NetworkConfig
Dataproc Metastore 서비스의 네트워크 구성
JSON 표현 |
---|
{
"consumers": [
{
object ( |
필드 | |
---|---|
consumers[] |
변경할 수 없습니다. Dataproc Metastore 인스턴스의 소비자 측 네트워크 구성입니다. |
소비자
고객의 네트워크 구성에 관한 정보를 포함합니다.
JSON 표현 |
---|
{ "endpointUri": string, "endpointLocation": string, // Union field |
필드 | |
---|---|
endpointUri |
출력 전용입니다. 메타스토어 서비스에 액세스하는 데 사용되는 엔드포인트의 URI입니다. |
endpointLocation |
출력 전용입니다. 엔드포인트 URI의 위치입니다. 형식은 |
통합 필드
|
|
subnetwork |
변경할 수 없습니다. IP 주소가 예약되고 Dataproc Metastore 서비스의 엔드포인트로 사용되는 고객 프로젝트의 서브넷입니다. 서브넷의 호스트와 동일한 리전 및 동일한 네트워크의 서브넷에 있는 모든 호스트에서 액세스할 수 있습니다. 서브넷의 기본 범위에 사용 가능한 IP 주소가 하나 이상 있어야 합니다. 서브넷은 다음 형식으로 지정됩니다.
|
주
메타스토어 서비스의 현재 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
메타스토어 서비스의 상태를 알 수 없습니다. |
CREATING |
메타스토어 서비스를 만드는 중입니다. |
ACTIVE |
메타스토어 서비스가 실행 중이며 쿼리를 처리할 준비가 되었습니다. |
SUSPENDING |
메타스토어 서비스가 정지됩니다. 쿼리 제공 기능이 예기치 않게 중단될 수 있습니다. |
SUSPENDED |
Metastore 서비스가 정지되어 쿼리를 제공할 수 없습니다. |
UPDATING |
메타스토어 서비스를 업데이트하는 중입니다. 계속 사용할 수 있지만 현재 추가 업데이트 요청을 수락하거나 삭제할 수 없습니다. |
DELETING |
Metastore 서비스를 삭제하는 중입니다. 사용할 수 없습니다. |
ERROR |
메타스토어 서비스에 오류가 발생하여 사용할 수 없습니다. 메타스토어 서비스를 삭제해야 합니다. |
AUTOSCALING |
Dataproc Metastore 서비스 2가 확장 또는 축소되고 있습니다. |
MIGRATING |
메타스토어 서비스에서 관리형 마이그레이션을 처리하고 있습니다. |
등급
사용 가능한 서비스 등급
열거형 | |
---|---|
TIER_UNSPECIFIED |
등급이 설정되지 않았습니다. |
DEVELOPER |
개발자 등급은 확장성이 제한되며 내결함성을 제공하지 않습니다. 저비용 개념 증명에 적합합니다. |
ENTERPRISE |
엔터프라이즈 등급은 멀티 영역 고가용성과 엔터프라이즈급 Dataproc Metastore 워크로드에 충분한 확장성을 제공합니다. |
MetadataIntegration
메타스토어 메타데이터를 외부 서비스와 통합하는 방법을 지정합니다.
JSON 표현 |
---|
{
"dataCatalogConfig": {
object ( |
필드 | |
---|---|
dataCatalogConfig |
선택사항입니다. Data Catalog 서비스의 통합 구성입니다. |
DataCatalogConfig
메타스토어 메타데이터를 Data Catalog 서비스와 통합하는 방법을 지정합니다.
JSON 표현 |
---|
{ "enabled": boolean } |
필드 | |
---|---|
enabled |
선택사항입니다. 메타스토어 메타데이터를 Data Catalog에 동기화할지 여부를 정의합니다. 기본값은 메타스토어 메타데이터를 Data Catalog에 동기화하지 않도록 설정하는 것입니다. |
MaintenanceWindow
유지보수 기간. Dataproc Metastore가 서비스에 시스템 유지보수 작업을 실행할 수 있는 시간을 지정합니다.
JSON 표현 |
---|
{
"hourOfDay": integer,
"dayOfWeek": enum ( |
필드 | |
---|---|
hourOfDay |
기간이 시작되는 시간 (0~23)입니다. |
dayOfWeek |
기간이 시작되는 요일입니다. |
MetadataManagementActivity
메타스토어 서비스의 메타데이터 관리 활동입니다.
JSON 표현 |
---|
{ "metadataExports": [ { object ( |
필드 | |
---|---|
metadataExports[] |
출력 전용입니다. 메타스토어 서비스의 최신 메타데이터 내보내기입니다. |
restores[] |
출력 전용입니다. metastore 서비스의 최신 복원입니다. |
MetadataExport
메타데이터 내보내기 작업의 세부정보입니다.
필드 | |
---|---|
startTime |
출력 전용입니다. 내보내기가 시작된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
endTime |
출력 전용입니다. 내보내기가 종료된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
state |
출력 전용입니다. 내보내기의 현재 상태입니다. |
databaseDumpType |
출력 전용입니다. 데이터베이스 덤프 유형입니다. |
통합 필드
|
|
destinationGcsUri |
출력 전용입니다. 메타데이터가 내보내지는 폴더의 Cloud Storage URI로, |
주
메타데이터 내보내기의 현재 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
메타데이터 내보내기 상태를 알 수 없습니다. |
RUNNING |
메타데이터 내보내기가 실행 중입니다. |
SUCCEEDED |
메타데이터 내보내기가 완료되었습니다. |
FAILED |
메타데이터 내보내기에 실패했습니다. |
CANCELLED |
메타데이터 내보내기가 취소됩니다. |
복원
메타데이터 복원 작업의 세부정보입니다.
JSON 표현 |
---|
{ "startTime": string, "endTime": string, "state": enum ( |
필드 | |
---|---|
startTime |
출력 전용입니다. 복원이 시작된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
endTime |
출력 전용입니다. 복원이 종료된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
state |
출력 전용입니다. 복원의 현재 상태입니다. |
backup |
출력 전용입니다. 복원할 메타스토어 서비스 백업의 상대 리소스 이름입니다. 형식은 다음과 같습니다.
|
type |
출력 전용입니다. 복원 유형입니다. |
details |
출력 전용입니다. 복원할 서비스의 버전이 포함된 복원 세부정보(JSON 형식)입니다. |
backupLocation |
선택사항입니다. 백업 아티팩트가 저장되는 위치를 지정하는 Cloud Storage URI( |
주
복원의 현재 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
메타데이터 복원 상태를 알 수 없습니다. |
RUNNING |
메타데이터 복원이 실행 중입니다. |
SUCCEEDED |
메타데이터 복원이 완료되었습니다. |
FAILED |
메타데이터 복원에 실패했습니다. |
CANCELLED |
메타데이터 복원이 취소됩니다. |
RestoreType
복원 유형입니다. 지정하지 않으면 기본적으로 METADATA_ONLY
입니다.
열거형 | |
---|---|
RESTORE_TYPE_UNSPECIFIED |
복원 유형을 알 수 없습니다. |
FULL |
서비스의 메타데이터 및 구성이 복원됩니다. |
METADATA_ONLY |
서비스의 메타데이터만 복원됩니다. |
ReleaseChannel
출시 채널은 다양한 수준의 안정성 기능을 번들로 제공합니다. 최신 기능은 처음에는 안정성이 낮은 출시 채널에 도입될 수 있으며 더 안정적인 출시 채널로 자동 승격될 수 있습니다.
열거형 | |
---|---|
RELEASE_CHANNEL_UNSPECIFIED |
출시 채널이 지정되지 않았습니다. |
CANARY |
CANARY 출시 채널에는 불안정할 수 있고 알려진 해결 방법 없이 미해결된 문제가 있을 수 있는 최신 기능들이 포함됩니다. CANARY 출시 채널을 사용하는 서비스에는 어떠한 SLA도 적용되지 않습니다. |
STABLE |
STABLE 출시 채널에는 안정적인 것으로 간주되고 프로덕션 용도로 검증된 기능이 포함되어 있습니다. |
EncryptionConfig
서비스의 암호화 설정입니다.
JSON 표현 |
---|
{ "kmsKey": string } |
필드 | |
---|---|
kmsKey |
고객 데이터 암호화에 사용할 정규화된 고객 제공 Cloud KMS 키 이름입니다(다음 형식).
|
DatabaseType
메타스토어 서비스의 백엔드 데이터베이스 유형입니다.
열거형 | |
---|---|
DATABASE_TYPE_UNSPECIFIED |
DATABASE_TYPE이 설정되지 않습니다. |
MYSQL |
MySQL은 메타스토어 데이터를 유지하는 데 사용됩니다. |
SPANNER |
Spanner는 메타스토어 데이터를 유지하는 데 사용됩니다. |
TelemetryConfig
Dataproc Metastore 서비스의 원격 분석 구성
JSON 표현 |
---|
{
"logFormat": enum ( |
필드 | |
---|---|
logFormat |
Dataproc Metastore 서비스 로그의 출력 형식입니다. |
LogFormat
열거형 | |
---|---|
LOG_FORMAT_UNSPECIFIED |
LOG_FORMAT이 설정되지 않았습니다. |
LEGACY |
로깅 출력은 기존 textPayload 형식을 사용합니다. |
JSON |
로깅 출력은 jsonPayload 형식을 사용합니다. |
ScalingConfig
메타스토어 서비스의 확장 구성을 나타냅니다.
JSON 표현 |
---|
{ "autoscalingConfig": { object ( |
필드 | |
---|---|
autoscalingConfig |
선택사항입니다. 자동 확장 구성 |
통합 필드 scaling_model . 사전 결정된 인스턴스 크기 또는 숫자 배율을 나타냅니다. scaling_model 은 다음 중 하나여야 합니다. |
|
instanceSize |
읽을 수 있는 인스턴스 크기의 enum으로, 각 인스턴스 크기는 부동 소수점 값에 매핑됩니다 (예: InstanceSize.EXTRA_SMALL = scalingFactor(0.1)). |
scalingFactor |
크기 조정 계수로, 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에 매핑됩니다. |
AutoscalingConfig
메타스토어 서비스의 자동 확장 구성을 나타냅니다.
JSON 표현 |
---|
{
"autoscalingFactor": number,
"autoscalingEnabled": boolean,
"limitConfig": {
object ( |
필드 | |
---|---|
autoscalingFactor |
출력 전용입니다. 자동 확장이 사용 설정된 서비스의 확장 계수입니다. |
autoscalingEnabled |
선택사항입니다. 이 서비스에 자동 확장이 사용 설정되어 있는지 여부입니다. |
limitConfig |
선택사항입니다. 서비스의 LimitConfig입니다. |
LimitConfig
메타스토어 서비스의 자동 확장 한도 구성을 나타냅니다.
JSON 표현 |
---|
{ "maxScalingFactor": number, "minScalingFactor": number } |
필드 | |
---|---|
maxScalingFactor |
선택사항입니다. 서비스가 자동 확장되어야 하는 최대 배율입니다. |
minScalingFactor |
선택사항입니다. 서비스가 자동 확장되어야 하는 가장 낮은 배율입니다. |
ScheduledBackup
예약된 백업의 구성을 지정합니다.
JSON 표현 |
---|
{
"enabled": boolean,
"cronSchedule": string,
"timeZone": string,
"nextScheduledTime": string,
"backupLocation": string,
"latestBackup": {
object ( |
필드 | |
---|---|
enabled |
선택사항입니다. 예약된 백업이 사용 설정되어 있는지 정의합니다. 기본값은 false입니다. |
cronSchedule |
선택사항입니다. Cron 형식의 예약된 간격입니다(https://en.wikipedia.org/wiki/Cron 참고). 기본값은 비어 있습니다. 예약된 백업이 사용 설정되지 않은 것입니다. 예약된 백업을 사용 설정하려면 지정해야 합니다. |
timeZone |
선택사항입니다. cronSchedule을 해석할 때 사용할 시간대를 지정합니다. 시간대 데이터베이스(https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)의 시간대 이름이어야 합니다(예: America/Los_Angeles 또는 Africa/Abidjan). 지정하지 않으면 기본값은 UTC입니다. |
nextScheduledTime |
출력 전용입니다. 다음 백업 실행이 시작될 예정인 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
backupLocation |
선택사항입니다. |
latestBackup |
출력 전용입니다. 최근 예약된 백업의 세부정보입니다. |
LatestBackup
최근 예약된 백업의 세부정보입니다.
JSON 표현 |
---|
{
"backupId": string,
"startTime": string,
"state": enum ( |
필드 | |
---|---|
backupId |
출력 전용입니다. 진행 중인 예약된 백업의 ID입니다. 백업이 진행 중이 아닌 경우 비어 있습니다. |
startTime |
출력 전용입니다. 백업이 시작된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
state |
출력 전용입니다. 백업의 현재 상태입니다. |
duration |
출력 전용입니다. 백업 완료 시간입니다. 소수점 아래가 최대 9자리까지이고 ' |
주
백업의 현재 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
백업 상태를 알 수 없습니다. |
IN_PROGRESS |
백업이 진행 중입니다. |
SUCCEEDED |
백업이 완료되었습니다. |
FAILED |
백업에 실패했습니다. |
메서드 |
|
---|---|
|
메타데이터 리소스 위치를 변경합니다. |
|
메타데이터 테이블 속성을 변경합니다. |
|
진행 중인 관리형 이전 프로세스를 취소합니다. |
|
관리형 이전 프로세스를 완료합니다. |
|
프로젝트 및 위치에 메타스토어 서비스를 만듭니다. |
|
단일 서비스를 삭제합니다. |
|
서비스에서 메타데이터를 내보냅니다. |
|
단일 서비스의 세부정보를 가져옵니다. |
|
리소스의 액세스 제어 정책을 가져옵니다. |
|
프로젝트 및 위치의 서비스를 나열합니다. |
|
테이블을 다른 데이터베이스로 이동합니다. |
|
단일 서비스의 매개변수를 업데이트합니다. |
|
Dataproc Metastore 메타데이터 쿼리 |
|
백업에서 서비스를 복원합니다. |
|
지정된 리소스의 액세스 제어 정책을 설정합니다. |
|
관리형 이전 프로세스를 시작합니다. |
|
지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다. |