REST Resource: projects.locations.services

리소스: 서비스

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

JSON 표현 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "network": string,
  "endpointUri": string,
  "port": integer,
  "state": enum (State),
  "stateMessage": string,
  "artifactGcsUri": string,
  "tier": enum (Tier),
  "metadataIntegration": {
    object (MetadataIntegration)
  },
  "maintenanceWindow": {
    object (MaintenanceWindow)
  },
  "uid": string,
  "metadataManagementActivity": {
    object (MetadataManagementActivity)
  },
  "releaseChannel": enum (ReleaseChannel),
  "encryptionConfig": {
    object (EncryptionConfig)
  },
  "networkConfig": {
    object (NetworkConfig)
  },
  "databaseType": enum (DatabaseType),
  "telemetryConfig": {
    object (TelemetryConfig)
  },
  "scalingConfig": {
    object (ScalingConfig)
  },
  "multiRegionConfig": {
    object (MultiRegionConfig)
  },
  "scheduledBackup": {
    object (ScheduledBackup)
  },
  "deletionProtection": boolean,

  // Union field metastore_config can be only one of the following:
  "hiveMetastoreConfig": {
    object (HiveMetastoreConfig)
  }
  // End of list of possible types for union field metastore_config.
}
필드
name

string

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

projects/{projectNumber}/locations/{locationId}/services/{serviceId}.
createTime

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
labels

map (key: string, value: string)

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

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
network

string

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

projects/{projectNumber}/global/networks/{network_id}.
endpointUri

string

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

integer

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

enum (State)

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

string

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

string

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

enum (Tier)

서비스 등급입니다.
metadataIntegration

object (MetadataIntegration)

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

object (MaintenanceWindow)

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

string

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

object (MetadataManagementActivity)

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

enum (ReleaseChannel)

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

object (EncryptionConfig)

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

object (NetworkConfig)

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

enum (DatabaseType)

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

object (TelemetryConfig)

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

object (ScalingConfig)

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

object (MultiRegionConfig)

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

object (ScheduledBackup)

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

boolean

선택사항입니다. Dataproc 메타스토어를 실수로 삭제하지 않도록 보호해야 하는지 여부를 나타냅니다.
통합 필드 metastore_config. 기본 메타스토어 서비스 기술 (메타스토어 쿼리를 제공하는 소프트웨어)에 관한 구성 속성입니다. metastore_config은 다음 중 하나여야 합니다.
hiveMetastoreConfig

object (HiveMetastoreConfig)

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

HiveMetastoreConfig

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

JSON 표현 
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "kerberosConfig": {
    object (KerberosConfig)
  },
  "endpointProtocol": enum (EndpointProtocol),
  "auxiliaryVersions": {
    string: {
      object (AuxiliaryVersionConfig)
    },
    ...
  }
}
필드
version

string

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

map (key: string, value: string)

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

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
kerberosConfig

object (KerberosConfig)

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

enum (EndpointProtocol)

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

map (key: string, value: object (AuxiliaryVersionConfig))

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

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

KerberosConfig

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

JSON 표현 
{
  "keytab": {
    object (Secret)
  },
  "principal": string,
  "krb5ConfigGcsUri": string
}
필드
keytab

object (Secret)

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

string

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

string

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

보안 비밀

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

JSON 표현 
{

  // Union field value can be only one of the following:
  "cloudSecret": string
  // End of list of possible types for union field value.
}
필드

통합 필드 value.

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

string

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

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

EndpointProtocol

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

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

AuxiliaryVersionConfig

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

JSON 표현 
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "networkConfig": {
    object (NetworkConfig)
  }
}
필드
version

string

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

map (key: string, value: string)

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

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
networkConfig

object (NetworkConfig)

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

NetworkConfig

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

JSON 표현 
{
  "consumers": [
    {
      object (Consumer)
    }
  ],
  "customRoutesEnabled": boolean
}
필드
consumers[]

object (Consumer)

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

boolean

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

소비자

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

JSON 표현 
{
  "endpointUri": string,
  "endpointLocation": string,

  // Union field vpc_resource can be only one of the following:
  "subnetwork": string
  // End of list of possible types for union field vpc_resource.
}
필드
endpointUri

string

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

string

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

통합 필드 vpc_resource.

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

string

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

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

주

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

열거형
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)
  },
  "dataplexConfig": {
    object (DataplexConfig)
  }
}
필드
dataCatalogConfig

object (DataCatalogConfig)

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

object (DataplexConfig)

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

DataCatalogConfig

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

JSON 표현 
{
  "enabled": boolean
}
필드
enabled

boolean

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

DataplexConfig

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

JSON 표현 
{
  "lakeResources": {
    string: {
      object (Lake)
    },
    ...
  }
}
필드
lakeResources

map (key: string, value: object (Lake))

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

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

레이크

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

JSON 표현 
{
  "name": string
}
필드
name

string

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

MaintenanceWindow

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

JSON 표현 
{
  "hourOfDay": integer,
  "dayOfWeek": enum (DayOfWeek)
}
필드
hourOfDay

integer

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

enum (DayOfWeek)

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

MetadataManagementActivity

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

JSON 표현 
{
  "metadataExports": [
    {
      object (MetadataExport)
    }
  ],
  "restores": [
    {
      object (Restore)
    }
  ]
}
필드
metadataExports[]

object (MetadataExport)

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

object (Restore)

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

MetadataExport

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

JSON 표현 
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "databaseDumpType": enum (Type),

  // Union field destination can be only one of the following:
  "destinationGcsUri": string
  // End of list of possible types for union field destination.
}
필드
startTime

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
endTime

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
state

enum (State)

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

enum (Type)

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

통합 필드 destination.

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

string

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

주

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

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

복원

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

JSON 표현 
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "backup": string,
  "type": enum (RestoreType),
  "details": string,
  "backupLocation": string
}
필드
startTime

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
endTime

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
state

enum (State)

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

string

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

projects/{projectId}/locations/{locationId}/services/{serviceId}/backups/{backupId}.
type

enum (RestoreType)

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

string

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

string

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

주

복원의 현재 상태입니다.

열거형
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

string

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

projects/{projectNumber}/locations/{locationId}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}.

DatabaseType

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

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

TelemetryConfig

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

JSON 표현 
{
  "logFormat": enum (LogFormat)
}
필드
logFormat

enum (LogFormat)

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

LogFormat

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

ScalingConfig

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

JSON 표현 
{
  "autoscalingConfig": {
    object (AutoscalingConfig)
  },

  // Union field scaling_model can be only one of the following:
  "instanceSize": enum (InstanceSize),
  "scalingFactor": number
  // End of list of possible types for union field scaling_model.
}
필드
autoscalingConfig

object (AutoscalingConfig)

선택사항입니다. 자동 확장 구성
통합 필드 scaling_model. 사전 결정된 인스턴스 크기 또는 숫자 배율을 나타냅니다. scaling_model은 다음 중 하나여야 합니다.
instanceSize

enum (InstanceSize)

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

number

크기 조정 계수로, 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 (LimitConfig)
  }
}
필드
autoscalingFactor

number

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

boolean

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

object (LimitConfig)

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

LimitConfig

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

JSON 표현 
{
  "maxScalingFactor": number,
  "minScalingFactor": number
}
필드
maxScalingFactor

number

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

number

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

MultiRegionConfig

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

JSON 표현 
{
  "certificates": [
    {
      object (RootCACertificate)
    }
  ],
  "customRegionConfig": {
    object (CustomRegionConfig)
  }
}
필드
certificates[]
(deprecated)

object (RootCACertificate)

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

object (CustomRegionConfig)

RootCACertificate

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

JSON 표현 
{
  "certificate": string,
  "expirationTime": string
}
필드
certificate
(deprecated)

string

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

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

CustomRegionConfig

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

JSON 표현 
{
  "readWriteRegions": [
    string
  ],
  "readOnlyRegions": [
    string
  ]
}
필드
readWriteRegions[]

string

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

string

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

ScheduledBackup

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

JSON 표현 
{
  "enabled": boolean,
  "cronSchedule": string,
  "timeZone": string,
  "nextScheduledTime": string,
  "backupLocation": string,
  "latestBackup": {
    object (LatestBackup)
  }
}
필드
enabled

boolean

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

string

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

string

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

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
backupLocation

string

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

object (LatestBackup)

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

LatestBackup

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

JSON 표현 
{
  "backupId": string,
  "startTime": string,
  "state": enum (State),
  "duration": string
}
필드
backupId

string

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

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
state

enum (State)

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

string (Duration format)

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

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

주

백업의 현재 상태입니다.

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

메서드

alterLocation

 메타데이터 리소스 위치를 변경합니다.

alterTableProperties

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

cancelMigration

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

completeMigration

 관리형 이전 프로세스를 완료합니다.

create

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

delete

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

exportMetadata

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

get

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

getIamPolicy

 리소스의 액세스 제어 정책을 가져옵니다.

list

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

moveTableToDatabase

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

patch

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

queryMetadata

 Dataproc Metastore 메타데이터 쿼리

removeIamPolicy

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

restore

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

setIamPolicy

 지정된 리소스의 액세스 제어 정책을 설정합니다.

startMigration

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

testIamPermissions

 지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.