REST Resource: projects.locations.services

Recurso: Service

Un servicio de metastore administrado que entrega consultas de metadatos.

Representación 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.
}
Campos
name

string

Inmutable. Es el nombre de recurso relativo del servicio de metastore, en el siguiente formato:

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

createTime

string (Timestamp format)

Solo salida. Es la hora en la que se creó el servicio de metastore.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizó el servicio de metastore por última vez.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Etiquetas definidas por el usuario para el servicio de metastore.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

network

string

Inmutable. Es el nombre de recurso relativo de la red de VPC en la que se puede acceder a la instancia. Se especifica de la siguiente manera:

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

endpointUri

string

Solo salida. Es el URI del extremo que se usa para acceder al servicio de metastore.

port

integer

Es el puerto TCP al que se llega al servicio de metastore. Configuración predeterminada: 9083.

state

enum (State)

Solo salida. Es el estado actual del servicio de metastore.

stateMessage

string

Solo salida. Información adicional sobre el estado actual del servicio de metastore, si está disponible

artifactGcsUri

string

Solo salida. Es un URI de Cloud Storage (que comienza con gs://) que especifica dónde se almacenan los artefactos relacionados con el servicio de metastore.

tier

enum (Tier)

Es el nivel del servicio.

metadataIntegration

object (MetadataIntegration)

Opcional. Es el parámetro de configuración que define cómo se deben integrar los metadatos del almacén de metadatos con los servicios y sistemas externos.

maintenanceWindow

object (MaintenanceWindow)

El período de mantenimiento de una hora del servicio de metastore Especifica cuándo se puede reiniciar el servicio por motivos de mantenimiento en la hora UTC. No se necesita un período de mantenimiento para los servicios con el tipo de base de datos SPANNER.

uid

string

Solo salida. Es el identificador de recursos único a nivel global del servicio de metastore.

metadataManagementActivity

object (MetadataManagementActivity)

Solo salida. Las actividades de administración de metadatos del servicio de metastore

releaseChannel

enum (ReleaseChannel)

Inmutable. Es el canal de versiones del servicio. Si no se especifica, se establece de forma predeterminada como STABLE.

encryptionConfig

object (EncryptionConfig)

Inmutable. Información que se usa para configurar el servicio de Dataproc Metastore para encriptar los datos del cliente en reposo. No se puede actualizar.

networkConfig

object (NetworkConfig)

Es la configuración que especifica la configuración de red del servicio de Dataproc Metastore.

databaseType

enum (DatabaseType)

Inmutable. Es el tipo de base de datos en el que el servicio de Metastore almacena sus datos.

telemetryConfig

object (TelemetryConfig)

La configuración que especifica la configuración de la telemetría para el servicio de Dataproc Metastore. Si no se especifica, el valor predeterminado es JSON.

scalingConfig

object (ScalingConfig)

Configuración de escalamiento del servicio de metastore

multiRegionConfig

object (MultiRegionConfig)

Opcional. Especifica la información de configuración multirregional para el servicio de almacén de metadatos de Hive.

scheduledBackup

object (ScheduledBackup)

Opcional. La configuración de la copia de seguridad programada para el servicio de metastore

deletionProtection

boolean

Opcional. Indica si el metastore de dataproc debe protegerse contra eliminaciones accidentales.

Campo de unión metastore_config. Propiedades de configuración específicas de la tecnología subyacente del servicio de metastore (el software que entrega consultas de metastore). metastore_config puede ser solo uno de los siguientes:
hiveMetastoreConfig

object (HiveMetastoreConfig)

Información de configuración específica para ejecutar el software del almacén de metadatos de Hive como el servicio del almacén de metadatos.

HiveMetastoreConfig

Especifica información de configuración específica para ejecutar el software del almacén de metadatos de Hive como el servicio del almacén de metadatos.

Representación JSON
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "kerberosConfig": {
    object (KerberosConfig)
  },
  "endpointProtocol": enum (EndpointProtocol),
  "auxiliaryVersions": {
    string: {
      object (AuxiliaryVersionConfig)
    },
    ...
  }
}
Campos
version

string

Inmutable. Es la versión del esquema del metastore de Hive.

configOverrides

map (key: string, value: string)

Es una asignación de pares clave-valor de configuración del metastore de Hive que se aplica al metastore de Hive (configurado en hive-site.xml). Las asignaciones anulan los valores predeterminados del sistema (no se pueden anular algunas claves). Estas anulaciones también se aplican a las versiones auxiliares y se pueden personalizar aún más en el AuxiliaryVersionConfig de la versión auxiliar.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

kerberosConfig

object (KerberosConfig)

Es la información que se usa para configurar el servicio de almacén de metadatos de Hive como una principal de servicio en un dominio de Kerberos. Para inhabilitar Kerberos, usa el método services.patch y especifica la ruta de este campo (hiveMetastoreConfig.kerberos_config) en el updateMask de la solicitud, mientras omites este campo del service de la solicitud.

endpointProtocol

enum (EndpointProtocol)

Es el protocolo que se usará para el extremo del servicio de metastore. Si no se especifica, se establece de forma predeterminada como THRIFT.

auxiliaryVersions

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

Una asignación de la versión del metastore de Hive a la configuración de la versión auxiliar. Cuando se especifica, se crea un servicio de metastore de Hive secundario junto con el servicio principal. Todas las versiones auxiliares deben ser inferiores a la versión principal del servicio. La clave es el nombre del servicio auxiliar y debe coincidir con la expresión regular a-z?. Esto significa que el primer carácter debe ser una letra minúscula y todos los caracteres siguientes deben ser guiones, minúsculas o dígitos, excepto el último carácter, que no puede ser un guion.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

KerberosConfig

Información de configuración para un principal de Kerberos.

Representación JSON
{
  "keytab": {
    object (Secret)
  },
  "principal": string,
  "krb5ConfigGcsUri": string
}
Campos
keytab

object (Secret)

Un archivo keytab de Kerberos que se puede usar para autenticar un principal de servicio con un centro de distribución de claves (KDC) de Kerberos.

principal

string

Un principal de Kerberos que existe en el archivo keytab y en el KDC para autenticar. Un principal típico tiene el formato primary/instance@REALM, pero no hay un formato exacto.

krb5ConfigGcsUri

string

Un URI de Cloud Storage que especifique la ruta de acceso a un archivo krb5.conf Tiene el formato gs://{bucket_name}/path/to/krb5.conf, aunque no es necesario que el archivo se llame krb5.conf de forma explícita.

Secreto

Un valor almacenado de forma segura.

Representación JSON
{

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

Campo de unión value.

value puede ser una de las siguientes opciones:

cloudSecret

string

El nombre de recurso relativo de una versión secreta de Secret Manager, en el siguiente formato:

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

EndpointProtocol

Protocolos disponibles para entregar el extremo del servicio de metastore.

Enums
ENDPOINT_PROTOCOL_UNSPECIFIED No se configuró el protocolo.
THRIFT Usa el protocolo heredado de Apache Thrift para el extremo del servicio de metastore.
GRPC Usa el protocolo gRPC modernizado para el extremo del servicio de metastore.

AuxiliaryVersionConfig

Información de la configuración de las versiones del servicio auxiliar.

Representación JSON
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "networkConfig": {
    object (NetworkConfig)
  }
}
Campos
version

string

La versión del almacén de metadatos de Hive del servicio auxiliar. Debe ser inferior a la versión del servicio principal de almacén de metadatos de Hive.

configOverrides

map (key: string, value: string)

Es una asignación de pares clave-valor de configuración del metastore de Hive que se aplica al metastore auxiliar de Hive (configurado en hive-site.xml), además de las anulaciones de la versión principal. Si las claves están presentes en las anulaciones de la versión auxiliar y en las anulaciones de la versión principal, el valor de las anulaciones de la versión auxiliar tiene prioridad.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

networkConfig

object (NetworkConfig)

Solo salida. La configuración de red contiene los URIs de extremo del servicio auxiliar de almacén de metadatos de Hive.

NetworkConfig

Configuración de red para el servicio de Dataproc Metastore

Representación JSON
{
  "consumers": [
    {
      object (Consumer)
    }
  ],
  "customRoutesEnabled": boolean
}
Campos
consumers[]

object (Consumer)

Inmutable. La configuración de red del consumidor para la instancia de Dataproc Metastore

customRoutesEnabled

boolean

Permite importar y exportar rutas personalizadas para la red de VPC con intercambio de tráfico del servicio de Dataproc Metastore.

Consumidor

Contiene información de las configuraciones de red del cliente.

Representación 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.
}
Campos
endpointUri

string

Solo salida. Es el URI del extremo que se usa para acceder al servicio de metastore.

endpointLocation

string

Solo salida. La ubicación del URI del extremo. Formato: projects/{project}/locations/{location}.

Campo de unión vpc_resource.

vpc_resource puede ser una de las siguientes opciones:

subnetwork

string

Inmutable. Es la subred del proyecto del cliente desde la que se reserva una dirección IP y se usa como extremo del servicio de Dataproc Metastore. Los hosts de la subred y todos los hosts de una subred en la misma región y red pueden acceder a ella. Debe haber al menos una dirección IP disponible en el rango principal de la subred. La subred se especifica de la siguiente manera:

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

Estado

Es el estado actual del servicio de metastore.

Enums
STATE_UNSPECIFIED Se desconoce el estado del servicio de metastore.
CREATING El servicio de Metastore está en proceso de creación.
ACTIVE El servicio de metastore se está ejecutando y está listo para entregar consultas.
SUSPENDING El servicio de Metastore entrará en suspensión. Es posible que la disponibilidad de la publicación de consultas cese de forma inesperada.
SUSPENDED El servicio de Metastore está suspendido y no puede entregar consultas.
UPDATING Se está actualizando el servicio de metastore. Se puede seguir usando, pero no se pueden aceptar solicitudes de actualización adicionales ni borrarse en este momento.
DELETING Se está borrando el servicio de metastore. No se puede usar.
ERROR El servicio de metastore encontró un error y no se puede usar. Se debe borrar el servicio de metastore.
AUTOSCALING Se está escalando el servicio de Dataproc Metastore 2 hacia arriba o hacia abajo.
MIGRATING El servicio de metastore está procesando una migración administrada.

Nivel

Niveles de servicio disponibles

Enums
TIER_UNSPECIFIED No se estableció el nivel.
DEVELOPER El nivel de desarrollador proporciona escalabilidad limitada y no presenta tolerancia a errores. Es ideal para pruebas de concepto de bajo costo.
ENTERPRISE El nivel empresarial proporciona alta disponibilidad en varias zonas y suficiente escalabilidad para las cargas de trabajo de Dataproc Metastore de nivel empresarial.

MetadataIntegration

Especifica cómo se deben integrar los metadatos de Metastore con los servicios externos.

Representación JSON
{
  "dataCatalogConfig": {
    object (DataCatalogConfig)
  },
  "dataplexConfig": {
    object (DataplexConfig)
  }
}
Campos
dataCatalogConfig

object (DataCatalogConfig)

Opcional. La configuración de integración para el servicio de Data Catalog

dataplexConfig

object (DataplexConfig)

La configuración de integración para el servicio de Dataplex

DataCatalogConfig

Especifica cómo se deben integrar los metadatos del almacén de metadatos con el servicio de Data Catalog.

Representación JSON
{
  "enabled": boolean
}
Campos
enabled

boolean

Opcional. Define si los metadatos del almacén de metadatos se deben sincronizar con Data Catalog. El valor predeterminado es inhabilitar la sincronización de metadatos de Metastore con Data Catalog.

DataplexConfig

Especifica cómo se deben integrar los metadatos de Metastore con el servicio de Dataplex.

Representación JSON
{
  "lakeResources": {
    string: {
      object (Lake)
    },
    ...
  }
}
Campos
lakeResources

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

Es una referencia a los recursos de Lake a los que está conectado este servicio de metastore. La clave es el nombre del recurso del lago. Ejemplo: projects/{projectNumber}/locations/{locationId}/lakes/{lake_id}.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Lake

Representa un recurso de Lake

Representación JSON
{
  "name": string
}
Campos
name

string

Es el nombre del recurso de Lake. Ejemplo: projects/{projectNumber}/locations/{locationId}/lakes/{lake_id}

MaintenanceWindow

Período de mantenimiento Esto especifica cuándo Dataproc Metastore puede realizar la operación de mantenimiento del sistema en el servicio.

Representación JSON
{
  "hourOfDay": integer,
  "dayOfWeek": enum (DayOfWeek)
}
Campos
hourOfDay

integer

Es la hora del día (de 0 a 23) en la que comienza el período.

dayOfWeek

enum (DayOfWeek)

Es el día de la semana en el que comienza el período.

MetadataManagementActivity

Las actividades de administración de metadatos del servicio de metastore

Representación JSON
{
  "metadataExports": [
    {
      object (MetadataExport)
    }
  ],
  "restores": [
    {
      object (Restore)
    }
  ]
}
Campos
metadataExports[]

object (MetadataExport)

Solo salida. Las exportaciones de metadatos más recientes del servicio de Metastore

restores[]

object (Restore)

Solo salida. Los restablecimientos más recientes del servicio de Metastore

MetadataExport

Son los detalles de una operación de exportación de metadatos.

Representación 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.
}
Campos
startTime

string (Timestamp format)

Solo salida. Es la hora en que comenzó la exportación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Solo salida. Es la hora en la que finalizó la exportación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Solo salida. Es el estado actual de la exportación.

databaseDumpType

enum (Type)

Solo salida. Es el tipo de volcado de la base de datos.

Campo de unión destination.

destination puede ser una de las siguientes opciones:

destinationGcsUri

string

Solo salida. Es un URI de Cloud Storage de una carpeta a la que se exportan los metadatos, en forma de gs://<bucket_name>/<path_inside_bucket>/<export_folder>, donde <export_folder> se genera automáticamente.

Estado

Es el estado actual de la exportación de metadatos.

Enums
STATE_UNSPECIFIED Se desconoce el estado de la exportación de metadatos.
RUNNING La exportación de metadatos se está ejecutando.
SUCCEEDED La exportación de metadatos se completó correctamente.
FAILED No se pudo realizar la exportación de metadatos.
CANCELLED Se cancela la exportación de metadatos.

Restablecer

Los detalles de una operación de restablecimiento de metadatos

Representación JSON
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "backup": string,
  "type": enum (RestoreType),
  "details": string,
  "backupLocation": string
}
Campos
startTime

string (Timestamp format)

Solo salida. La hora en que comenzó el restablecimiento.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Solo salida. Es la hora en que finalizó el restablecimiento.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Solo salida. El estado actual del restablecimiento.

backup

string

Solo salida. Es el nombre de recurso relativo de la copia de seguridad del servicio de metastore desde la que se debe restablecer, en el siguiente formato:

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

type

enum (RestoreType)

Solo salida. Es el tipo de restablecimiento.

details

string

Solo salida. Los detalles de restablecimiento que contienen la revisión del servicio al que se restablecerá, en formato JSON

backupLocation

string

Opcional. Un URI de Cloud Storage que especifique dónde se almacenan los artefactos de la copia de seguridad, en el formato gs://<bucket_name>/<path_inside_bucket>.

Estado

El estado actual del restablecimiento.

Enums
STATE_UNSPECIFIED Se desconoce el estado del restablecimiento de metadatos.
RUNNING Se está ejecutando el restablecimiento de metadatos.
SUCCEEDED El restablecimiento de metadatos se completó correctamente.
FAILED No se pudo restablecer los metadatos.
CANCELLED Se canceló el restablecimiento de metadatos.

RestoreType

Es el tipo de restablecimiento. Si no se especifica, se establece de forma predeterminada como METADATA_ONLY.

Enums
RESTORE_TYPE_UNSPECIFIED El tipo de restablecimiento es desconocido.
FULL Se restablecen los metadatos y la configuración del servicio.
METADATA_ONLY Solo se restablecen los metadatos del servicio.

ReleaseChannel

Los canales de versiones agrupan funciones con diferentes niveles de estabilidad. Las funciones más nuevas pueden introducirse inicialmente en canales de versiones menos estables y ascender automáticamente a canales de versiones más estables.

Enums
RELEASE_CHANNEL_UNSPECIFIED No se especificó el canal de lanzamiento.
CANARY El canal de lanzamiento CANARY contiene las funciones más recientes, que pueden ser inestables y estar sujetas a problemas sin resolver y sin solución alternativa conocida. Los servicios que usan el canal de versiones CANARY no están sujetos a ningún ANS.
STABLE El canal de versiones STABLE contiene funciones que se consideran estables y que se validaron para su uso en producción.

EncryptionConfig

Configuración de encriptación del servicio

Representación JSON
{
  "kmsKey": string
}
Campos
kmsKey

string

El nombre de clave de Cloud KMS completamente calificado que proporcionó el cliente para usar en la encriptación de datos del cliente, en el siguiente formato:

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

DatabaseType

Es el tipo de base de datos de backend para el servicio de metastore.

Enums
DATABASE_TYPE_UNSPECIFIED No se estableció DATABASE_TYPE.
MYSQL MySQL se usa para conservar los datos del metastore.
SPANNER Spanner se usa para conservar los datos del metastore.

TelemetryConfig

Configuración de la telemetría para el servicio de Dataproc Metastore

Representación JSON
{
  "logFormat": enum (LogFormat)
}
Campos
logFormat

enum (LogFormat)

Es el formato de salida de los registros del servicio de Dataproc Metastore.

LogFormat

Enums
LOG_FORMAT_UNSPECIFIED No se configuró LOG_FORMAT.
LEGACY El resultado de registro usa el formato textPayload heredado.
JSON El resultado de registro usa el formato jsonPayload.

ScalingConfig

Representa la configuración de escalamiento de un servicio de almacén de metadatos.

Representación 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.
}
Campos
autoscalingConfig

object (AutoscalingConfig)

Opcional. La configuración del ajuste de escala automático

Campo de unión scaling_model. Representa un tamaño de instancia predeterminado o un factor de escalamiento numérico. scaling_model puede ser solo uno de los siguientes:
instanceSize

enum (InstanceSize)

Una enumeración de tamaños de instancias legibles, con cada tamaño de instancia asignado a un valor de número de punto flotante (p.ej., InstanceSize.EXTRA_SMALL = scalingFactor(0.1))

scalingFactor

number

Es el factor de escalamiento, con incrementos de 0.1 para valores inferiores a 1.0 y de 1.0 para valores superiores a 1.0.

InstanceSize

Tamaños de las instancias de Metastore

Enums
INSTANCE_SIZE_UNSPECIFIED Tamaño de la instancia no especificado
EXTRA_SMALL Tamaño de instancia extrapequeño, se asigna a un factor de escalamiento de 0.1.
SMALL El tamaño de la instancia pequeña se asigna a un factor de escalamiento de 0.5.
MEDIUM Tamaño de instancia medio, se asigna a un factor de escalamiento de 1.0.
LARGE Tamaño de instancia grande, se asigna a un factor de escalamiento de 3.0.
EXTRA_LARGE Tamaño de instancia extragrande, se asigna a un factor de escalamiento de 6.0.

AutoscalingConfig

Representa la configuración de escalamiento automático de un servicio de metastore.

Representación JSON
{
  "autoscalingFactor": number,
  "autoscalingEnabled": boolean,
  "limitConfig": {
    object (LimitConfig)
  }
}
Campos
autoscalingFactor

number

Solo salida. Es el factor de escalamiento de un servicio con el ajuste de escala automático habilitado.

autoscalingEnabled

boolean

Opcional. Indica si el ajuste de escala automático está habilitado para este servicio.

limitConfig

object (LimitConfig)

Opcional. El LimitConfig del servicio.

LimitConfig

Representa la configuración del límite de ajuste de escala automático de un servicio de metastore.

Representación JSON
{
  "maxScalingFactor": number,
  "minScalingFactor": number
}
Campos
maxScalingFactor

number

Opcional. Es el factor de escalamiento más alto al que se debe ajustar automáticamente el servicio.

minScalingFactor

number

Opcional. Es el factor de escalamiento más bajo al que se debe ajustar automáticamente el servicio.

MultiRegionConfig

La configuración multirregional del servicio de Dataproc Metastore

Representación JSON
{
  "certificates": [
    {
      object (RootCACertificate)
    }
  ],
  "customRegionConfig": {
    object (CustomRegionConfig)
  }
}
Campos
certificates[]
(deprecated)

object (RootCACertificate)

Solo salida. Es la lista de certificados de AC raíz que usa un cliente gRPC para conectarse a un servicio multirregional de Dataproc Metastore.

customRegionConfig

object (CustomRegionConfig)

RootCACertificate

Un cliente de gRPC debe instalar todos los certificados de AC raíz para conectarse a un servicio de Dataproc Metastore multirregional y lograr la conmutación por error.

Representación JSON
{
  "certificate": string,
  "expirationTime": string
}
Campos
certificate
(deprecated)

string

El certificado de la AC raíz en formato PEM. La longitud máxima es de 65,536 bytes.

expirationTime
(deprecated)

string (Timestamp format)

Es la hora de vencimiento del certificado en formato de marca de tiempo.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

CustomRegionConfig

Configuración personalizada que se usa para especificar las regiones en las que se ejecuta el servicio de metastore. Actualmente, solo se admite en la multirregión us.

Representación JSON
{
  "readWriteRegions": [
    string
  ],
  "readOnlyRegions": [
    string
  ]
}
Campos
readWriteRegions[]

string

Obligatorio. Es la lista de regiones de lectura y escritura en las que se ejecuta el servicio de metastore. Estas regiones deben ser parte (o subconjunto) de la multirregión.

readOnlyRegions[]

string

Opcional. Es la lista de regiones de solo lectura en las que se ejecuta el servicio de metastore. Estas regiones deben ser parte (o subconjunto) de la multirregión.

ScheduledBackup

Aquí se especifica la configuración de la copia de seguridad programada.

Representación JSON
{
  "enabled": boolean,
  "cronSchedule": string,
  "timeZone": string,
  "nextScheduledTime": string,
  "backupLocation": string,
  "latestBackup": {
    object (LatestBackup)
  }
}
Campos
enabled

boolean

Opcional. Define si la copia de seguridad programada está habilitada. El valor predeterminado es falso.

cronSchedule

string

Opcional. Es el intervalo programado en formato Cron. Consulta https://en.wikipedia.org/wiki/Cron. El valor predeterminado está vacío: no se habilita la copia de seguridad programada. Se debe especificar para habilitar las copias de seguridad programadas.

timeZone

string

Opcional. Especifica la zona horaria que se usará cuando se interprete cronSchedule. Debe ser un nombre de zona horaria de la base de datos de zonas horarias (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), p.ej., America/Los_Angeles o Africa/Abidjan. Si no se especifica, el valor predeterminado es UTC.

nextScheduledTime

string (Timestamp format)

Solo salida. Es la hora a la que está programada la próxima ejecución de copias de seguridad.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

backupLocation

string

Opcional. Un URI de Cloud Storage de una carpeta, con el formato gs://<bucket_name>/<path_inside_bucket>. Debajo de ella, se almacenará una subcarpeta <backup_folder> que contiene archivos de copia de seguridad.

latestBackup

object (LatestBackup)

Solo salida. Los detalles de la copia de seguridad programada más reciente

LatestBackup

Los detalles de la copia de seguridad programada más reciente

Representación JSON
{
  "backupId": string,
  "startTime": string,
  "state": enum (State),
  "duration": string
}
Campos
backupId

string

Solo salida. El ID de una copia de seguridad programada en curso. Está vacío si no hay ninguna copia de seguridad en curso.

startTime

string (Timestamp format)

Solo salida. La hora en que se inició la copia de seguridad.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Solo salida. Es el estado actual de la copia de seguridad.

duration

string (Duration format)

Solo salida. Es la duración de la finalización de la copia de seguridad.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

Estado

Es el estado actual de la copia de seguridad.

Enums
STATE_UNSPECIFIED Se desconoce el estado de la copia de seguridad.
IN_PROGRESS La copia de seguridad está en curso.
SUCCEEDED Se completó la copia de seguridad.
FAILED No se pudo crear la copia de seguridad.

Métodos

alterLocation

Altera la ubicación del recurso de metadatos.

alterTableProperties

Modifica las propiedades de la tabla de metadatos.

cancelMigration

Cancela el proceso de migración administrada en curso.

completeMigration

Completa el proceso de migración administrada.

create

Crea un servicio de metastore en un proyecto y una ubicación.

delete

Borra un solo servicio.

exportMetadata

Exporta metadatos de un servicio.

get

Obtiene los detalles de un solo servicio.

getIamPolicy

Permite obtener la política de control de acceso de un recurso.

list

Enumera los servicios en un proyecto y una ubicación.

moveTableToDatabase

Mover una tabla a otra base de datos

patch

Actualiza los parámetros de un solo servicio.

queryMetadata

Consulta los metadatos de Dataproc Metastore.

removeIamPolicy

Quita las políticas de IAM adjuntas de un recurso

restore

Restablece un servicio a partir de una copia de seguridad.

setIamPolicy

Permite configurar la política de control de acceso en el recurso especificado.

startMigration

Inicia el proceso de migración administrada.

testIamPermissions

Permite mostrar los permisos que tiene un emisor para un recurso especificado.