이 페이지는 Cloud Translation API를 통해 번역되었습니다.

REST Resource: projects.locations.services

리소스: 서비스
메서드

리소스: 서비스

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

JSON 표현

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`) }, "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,
  "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)
  },
  "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)` 메타스토어 서비스의 확장 구성
`scheduledBackup`	`object (ScheduledBackup)` 선택사항입니다. 메타스토어 서비스의 예약된 백업 구성입니다.
`deletionProtection`	`boolean` 선택사항입니다. Dataproc 메타스토어를 실수로 삭제하지 않도록 보호해야 하는지 여부를 나타냅니다.
통합 필드 `metastore_config`. 기본 메타스토어 서비스 기술 (메타스토어 쿼리를 제공하는 소프트웨어)에 관한 구성 속성입니다. `metastore_config`은 다음 중 하나여야 합니다.
`hiveMetastoreConfig`	`object (HiveMetastoreConfig)` Hive 메타스토어 소프트웨어를 메타스토어 서비스로 실행하는 것과 관련된 구성 정보입니다.

HiveMetastoreConfig

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

JSON 표현

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

{
  "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` 형식입니다.

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}`.

통합 필드 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가 포함됩니다.

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`) } ] }

필드

필드
`consumers[]`	`object (Consumer)` 변경할 수 없습니다. Dataproc Metastore 인스턴스의 소비자 측 네트워크 구성입니다.

consumers[]

object (Consumer)

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

소비자

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

JSON 표현

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,
  "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`) } }

필드

dataCatalogConfig

object (DataCatalogConfig)

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

DataCatalogConfig

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

JSON 표현
{ "enabled": boolean }

필드

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

enabled

boolean

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

MaintenanceWindow

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

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

필드

필드
`hourOfDay`	`integer` 기간이 시작되는 시간 (0~23)입니다.
`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 표현

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,
  "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}`.

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

enum (LogFormat)

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

LogFormat

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

ScalingConfig

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

JSON 표현

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)
  },

  // 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입니다.

autoscalingFactor

number

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

autoscalingEnabled

boolean

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

limitConfig

object (LimitConfig)

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

LimitConfig

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

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

필드

필드
`maxScalingFactor`	`number` 선택사항입니다. 서비스가 자동 확장되어야 하는 최대 배율입니다.
`minScalingFactor`	`number` 선택사항입니다. 서비스가 자동 확장되어야 하는 가장 낮은 배율입니다.

maxScalingFactor

number

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

minScalingFactor

number

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

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 메타데이터 쿼리
`restore`	백업에서 서비스를 복원합니다.
`setIamPolicy`	지정된 리소스의 액세스 제어 정책을 설정합니다.
`startMigration`	관리형 이전 프로세스를 시작합니다.
`testIamPermissions`	지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.

REST Resource: projects.locations.services 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

리소스: 서비스

HiveMetastoreConfig

KerberosConfig

보안 비밀

EndpointProtocol

AuxiliaryVersionConfig

NetworkConfig

소비자

주

등급

MetadataIntegration

DataCatalogConfig

MaintenanceWindow

MetadataManagementActivity

MetadataExport

주

복원

주

RestoreType

ReleaseChannel

EncryptionConfig

DatabaseType

TelemetryConfig

LogFormat

ScalingConfig

InstanceSize

AutoscalingConfig

LimitConfig

ScheduledBackup

LatestBackup

주

메서드

REST Resource: projects.locations.services