Package google.cloud.metastore.v1alpha

Índice

DataprocMetastore

Configura y administra servicios de metastore. Los servicios de Metastore son implementaciones nativas de OSS de software de administración de metadatos técnicos completamente administradas, con alta disponibilidad, de reparación automática y con ajuste de escala automático. Cada servicio de metastore expone un extremo de red a través del cual se entregan las consultas de metadatos. Las consultas de metadatos pueden provenir de varias fuentes, como Apache Hive, Apache Presto y Apache Spark.

La API de Dataproc Metastore define el siguiente modelo de recursos:

  • El servicio funciona con una colección de proyectos de Google Cloud, llamada /projects/*.
  • Cada proyecto tiene una colección de ubicaciones disponibles, denominadas /locations/* (una ubicación debe hacer referencia a un region de Google Cloud).
  • Cada ubicación tiene una colección de servicios, llamada /services/*.
  • Los servicios de Dataproc Metastore son recursos con nombres del siguiente formato:

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

AlterMetadataResourceLocation

rpc AlterMetadataResourceLocation(AlterMetadataResourceLocationRequest) returns (Operation)

Altera la ubicación del recurso de metadatos. El recurso de metadatos puede ser una base de datos, una tabla o una partición. Esta función solo actualiza el directorio superior del recurso de metadatos correspondiente y no transfiere ningún dato existente a la ubicación nueva.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

AlterTableProperties

rpc AlterTableProperties(AlterTablePropertiesRequest) returns (Operation)

Modifica las propiedades de la tabla de metadatos.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

CancelMigration

rpc CancelMigration(CancelMigrationRequest) returns (Operation)

Cancela el proceso de migración administrada en curso.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

CompleteMigration

rpc CompleteMigration(CompleteMigrationRequest) returns (Operation)

Completa el proceso de migración administrada. El servicio de Dataproc Metastore cambiará a usar su propia base de datos de backend después de que se complete la migración.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

CreateBackup

rpc CreateBackup(CreateBackupRequest) returns (Operation)

Crea una copia de seguridad nueva en un proyecto y una ubicación determinados.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

CreateMetadataImport

rpc CreateMetadataImport(CreateMetadataImportRequest) returns (Operation)

Crea una MetadataImport nueva en un proyecto y una ubicación determinados.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

CreateService

rpc CreateService(CreateServiceRequest) returns (Operation)

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

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

DeleteBackup

rpc DeleteBackup(DeleteBackupRequest) returns (Operation)

Borra una sola copia de seguridad.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

DeleteMigrationExecution

rpc DeleteMigrationExecution(DeleteMigrationExecutionRequest) returns (Operation)

Borra una sola ejecución de migración.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Operation)

Borra un solo servicio.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

ExportMetadata

rpc ExportMetadata(ExportMetadataRequest) returns (Operation)

Exporta metadatos de un servicio.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

GetBackup

rpc GetBackup(GetBackupRequest) returns (Backup)

Obtiene los detalles de una sola copia de seguridad.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

GetMetadataImport

rpc GetMetadataImport(GetMetadataImportRequest) returns (MetadataImport)

Obtiene los detalles de una sola importación.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

GetMigrationExecution

rpc GetMigrationExecution(GetMigrationExecutionRequest) returns (MigrationExecution)

Obtiene los detalles de una sola ejecución de migración.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

GetService

rpc GetService(GetServiceRequest) returns (Service)

Obtiene los detalles de un solo servicio.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

ListBackups

rpc ListBackups(ListBackupsRequest) returns (ListBackupsResponse)

Muestra una lista de las copias de seguridad de un servicio.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

ListMetadataImports

rpc ListMetadataImports(ListMetadataImportsRequest) returns (ListMetadataImportsResponse)

Muestra una lista de las importaciones de un servicio.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

ListMigrationExecutions

rpc ListMigrationExecutions(ListMigrationExecutionsRequest) returns (ListMigrationExecutionsResponse)

Muestra una lista de las ejecuciones de migración en un servicio.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

ListServices

rpc ListServices(ListServicesRequest) returns (ListServicesResponse)

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

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

MoveTableToDatabase

rpc MoveTableToDatabase(MoveTableToDatabaseRequest) returns (Operation)

Mover una tabla a otra base de datos

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

QueryMetadata

rpc QueryMetadata(QueryMetadataRequest) returns (Operation)

Consulta los metadatos de Dataproc Metastore.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

RemoveIamPolicy

rpc RemoveIamPolicy(RemoveIamPolicyRequest) returns (RemoveIamPolicyResponse)

Quita las políticas de IAM adjuntas de un recurso

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

RestoreService

rpc RestoreService(RestoreServiceRequest) returns (Operation)

Restablece un servicio a partir de una copia de seguridad.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

StartMigration

rpc StartMigration(StartMigrationRequest) returns (Operation)

Inicia el proceso de migración administrada.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

UpdateMetadataImport

rpc UpdateMetadataImport(UpdateMetadataImportRequest) returns (Operation)

Actualiza una sola importación. Solo se puede actualizar el campo de descripción de MetadataImport.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Operation)

Actualiza los parámetros de un solo servicio.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

DataprocMetastoreFederation

Configura y administra los servicios de federación de metastore. El servicio de Dataproc Metastore Federation permite federar una colección de metastores de backend, como BigQuery, Dataplex Lakes y otros metastores de Dataproc. El servicio de federación expone una URL de gRPC a través de la cual se entregan los metadatos de los metastores de backend en el momento de la consulta.

La API de Dataproc Metastore Federation define el siguiente modelo de recursos: * El servicio funciona con una colección de proyectos de Google Cloud. * Cada proyecto tiene una colección de ubicaciones disponibles. * Cada ubicación tiene una colección de federaciones. * Las federaciones de Dataproc Metastore son recursos con nombres del tipo projects/{project_number}/locations/{location_id}/federations/{federation_id}.

CreateFederation

rpc CreateFederation(CreateFederationRequest) returns (Operation)

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

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

DeleteFederation

rpc DeleteFederation(DeleteFederationRequest) returns (Operation)

Borra una sola federación.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

GetFederation

rpc GetFederation(GetFederationRequest) returns (Federation)

Obtiene los detalles de una sola federación.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

ListFederations

rpc ListFederations(ListFederationsRequest) returns (ListFederationsResponse)

Enumera las federaciones en un proyecto y una ubicación.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

UpdateFederation

rpc UpdateFederation(UpdateFederationRequest) returns (Operation)

Actualiza los campos de una federación.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

AlterMetadataResourceLocationRequest

Mensaje de solicitud para DataprocMetastore.AlterMetadataResourceLocation.

Campos
service

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore para mutar metadatos, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.services.mutateMetadata
resource_name

string

Obligatorio. El nombre del recurso de metadatos relativo en el siguiente formato

databases/{database_id} o databases/{database_id}/tables/{table_id} o databases/{database_id}/tables/{table_id}/partitions/{partition_id}

location_uri

string

Obligatorio. Es el URI de la nueva ubicación para el recurso de metadatos.

AlterMetadataResourceLocationResponse

Este tipo no tiene campos.

Mensaje de respuesta para DataprocMetastore.AlterMetadataResourceLocation.

AlterTablePropertiesRequest

Mensaje de solicitud para DataprocMetastore.AlterTableProperties.

Campos
service

string

Obligatorio. El nombre de recurso relativo del servicio de Dataproc Metastore que se usa para modificar las propiedades de la tabla de metadatos, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.services.mutateMetadata
table_name

string

Obligatorio. El nombre de la tabla que contiene las propiedades que deseas modificar con el siguiente formato.

databases/{database_id}/tables/{table_id}

update_mask

FieldMask

Es una máscara de campo que especifica las propiedades de la tabla de metadatos que se reemplazan con la actualización. Los campos especificados en update_mask se relacionan con el recurso (no con la solicitud completa). Un campo se reemplaza si está en la máscara.

Por ejemplo, dadas las propiedades de destino:

properties {
  a: 1
  b: 2
}

Y una propiedad de actualización:

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

Luego, si la máscara de campo es:

paths: ["properties.b", "properties.c"]

entonces el resultado será el siguiente:

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

map<string, string>

Un mapa que describe los valores deseados que se deben mutar. Si update_mask está vacío, las propiedades no se actualizarán. De lo contrario, las propiedades solo alteran el valor cuyas rutas de acceso asociadas existen en la máscara de actualización.

AlterTablePropertiesResponse

Este tipo no tiene campos.

Mensaje de respuesta para DataprocMetastore.AlterTableProperties.

AutoscalingConfig

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

Campos
autoscaling_factor

float

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

autoscaling_enabled

bool

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

limit_config

LimitConfig

Opcional. El LimitConfig del servicio.

AuxiliaryVersionConfig

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

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.

config_overrides

map<string, 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.

network_config

NetworkConfig

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

BackendMetastore

Representa un metastore de backend para la integración.

Campos
name

string

Es el nombre de recurso relativo del metastore que se está federando. A continuación, se muestran los formatos de los nombres de recursos relativos para los metastores admitidos actualmente:

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

MetastoreType

Es el tipo de metastore de backend.

MetastoreType

Es el tipo de metastore de backend.

Enums
METASTORE_TYPE_UNSPECIFIED No se configuró el tipo de metastore.
DATAPLEX El metastore de backend es Dataplex.
BIGQUERY El metastore de backend es BigQuery.
DATAPROC_METASTORE El metastore de backend es Dataproc Metastore.

Copia de seguridad

Son los detalles de un recurso de copia de seguridad.

Campos
name

string

Inmutable. El nombre de recurso relativo de la copia de seguridad, con el siguiente formato:

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

create_time

Timestamp

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

end_time

Timestamp

Solo salida. Es la hora en la que se terminó de crear la copia de seguridad.

state

State

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

service_revision

Service

Solo salida. Es la revisión del servicio en el momento de la copia de seguridad.

description

string

Es la descripción de la copia de seguridad.

restoring_services[]

string

Solo salida. Servicios que se restablecen desde la copia de seguridad

Estado

Es el estado actual de la copia de seguridad.

Enums
STATE_UNSPECIFIED Se desconoce el estado de la copia de seguridad.
CREATING Se está creando la copia de seguridad.
DELETING Se está borrando la copia de seguridad.
ACTIVE La copia de seguridad está activa y lista para usarse.
FAILED No se pudo crear la copia de seguridad.
RESTORING Se está restableciendo la copia de seguridad.

CancelMigrationRequest

Mensaje de solicitud para DataprocMetastore.CancelMigration.

Campos
service

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore al que se cancelará la migración en curso, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.migrations.cancel

CancelMigrationResponse

Mensaje de respuesta para DataprocMetastore.CancelMigration.

Campos
migration_execution

string

El nombre de recurso relativo de la ejecución de la migración, con el siguiente formato:

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

CompleteMigrationRequest

Mensaje de solicitud para DataprocMetastore.CompleteMigration.

Campos
service

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore al que se completará la migración, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.migrations.complete

CompleteMigrationResponse

Mensaje de respuesta para DataprocMetastore.CompleteMigration.

Campos
migration_execution

string

El nombre de recurso relativo de la ejecución de la migración, con el siguiente formato:

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

CreateBackupRequest

Mensaje de solicitud para DataprocMetastore.CreateBackup.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo del servicio en el que se creará una copia de seguridad del siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.backups.create
backup_id

string

Obligatorio. Es el ID de la copia de seguridad, que se usa como el componente final del nombre de la copia de seguridad.

Este valor debe tener entre 1 y 64 caracteres, comenzar con una letra, terminar con una letra o un número, y debe contener caracteres ASCII alfanuméricos o guiones.

backup

Backup

Obligatorio. La copia de seguridad que se creará. El campo name se ignora. Se debe proporcionar el ID de la copia de seguridad creada en el campo backup_id de la solicitud.

request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

CreateFederationRequest

Es un mensaje de solicitud para CreateFederation.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo de la ubicación en la que se creará un servicio de integración, en el siguiente formato:

projects/{project_number}/locations/{location_id}

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.federations.create
federation_id

string

Obligatorio. Es el ID de la federación del metastore, que se usa como el componente final del nombre de la federación del metastore.

Este valor debe tener entre 2 y 63 caracteres inclusive, comenzar con una letra, terminar con una letra o un número, y constar de guiones o caracteres alfanuméricos ASCII.

federation

Federation

Obligatorio. La federación de Metastore que se creará. El campo name se ignora. Se debe proporcionar el ID de la federación de metastore creada en el campo federation_id de la solicitud.

request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

CreateMetadataImportRequest

Mensaje de solicitud para DataprocMetastore.CreateMetadataImport.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo del servicio en el que se creará una importación de almacén de metadatos, con el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.imports.create
metadata_import_id

string

Obligatorio. Es el ID de la importación de metadatos, que se usa como el componente final del nombre de la importación de metadatos.

Este valor debe tener entre 1 y 64 caracteres, comenzar con una letra, terminar con una letra o un número, y debe contener caracteres ASCII alfanuméricos o guiones.

metadata_import

MetadataImport

Obligatorio. La importación de metadatos que se creará El campo name se ignora. Se debe proporcionar el ID de la importación de metadatos creada en el campo metadata_import_id de la solicitud.

request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

CreateServiceRequest

Mensaje de solicitud para DataprocMetastore.CreateService.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo de la ubicación en la que se creará un servicio de almacén de metadatos, con el siguiente formato:

projects/{project_number}/locations/{location_id}

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.services.create
service_id

string

Obligatorio. Es el ID del servicio de metastore, que se usa como el componente final del nombre del servicio de metastore.

Este valor debe tener entre 2 y 63 caracteres inclusive, comenzar con una letra, terminar con una letra o un número, y constar de guiones o caracteres alfanuméricos ASCII.

service

Service

Obligatorio. Es el servicio de Metastore que se creará. El campo name se ignora. Se debe proporcionar el ID del servicio de metastore creado en el campo service_id de la solicitud.

request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

DataCatalogConfig

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

Campos
enabled

bool

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.

DatabaseDumpSpec

Este tipo no tiene campos.

La especificación del volcado de base de datos desde el que se importarán o exportarán datos.

Tipo

Es el tipo de volcado de la base de datos.

Enums
TYPE_UNSPECIFIED Se desconoce el tipo de volcado de la base de datos.
MYSQL El volcado de la base de datos es un archivo de volcado de MySQL.
AVRO El volcado de la base de datos contiene archivos Avro.

DataplexConfig

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

Campos
lake_resources

map<string, 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/{project_number}/locations/{location_id}/lakes/{lake_id}.

DeleteBackupRequest

Mensaje de solicitud para DataprocMetastore.DeleteBackup.

Campos
name

string

Obligatorio. Es el nombre de recurso relativo de la copia de seguridad que se borrará, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.backups.delete
request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

DeleteFederationRequest

Es un mensaje de solicitud para DeleteFederation.

Campos
name

string

Obligatorio. Es el nombre de recurso relativo de la federación de metastore que se borrará, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.federations.delete
request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

DeleteMigrationExecutionRequest

Mensaje de solicitud para DataprocMetastore.DeleteMigrationExecution.

Campos
name

string

Obligatorio. Es el nombre de recurso relativo de la migración que se borrará, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.migrations.delete
request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

DeleteServiceRequest

Mensaje de solicitud para DataprocMetastore.DeleteService.

Campos
name

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore que se borrará, con el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.services.delete
request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

EncryptionConfig

Configuración de encriptación del servicio

Campos
kms_key

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/{project_number}/locations/{location_id}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}

ErrorDetails

Detalles del error en el mensaje de error público de DataprocMetastore.QueryMetadata.

Campos
details

map<string, string>

Detalles estructurados adicionales sobre este error.

Las claves definen los elementos de falla. El valor describe la excepción o los detalles del artículo.

ExportMetadataRequest

Mensaje de solicitud para DataprocMetastore.ExportMetadata.

Campos
service

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore para ejecutar la exportación, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.services.export
request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

database_dump_type

Type

Opcional. Es el tipo de volcado de la base de datos. Si no se especifica, se establece de forma predeterminada como MYSQL.

Campo de unión destination. Obligatorio. Es el destino al que se exportan los metadatos. destination puede ser solo uno de los siguientes:
destination_gcs_folder

string

Un URI de Cloud Storage de una carpeta, con el formato gs://<bucket_name>/<path_inside_bucket>. Debajo de ella, se creará una subcarpeta <export_folder> que contendrá los archivos exportados.

Federación

Representa una federación de varios metatiendas de backend.

Campos
name

string

Inmutable. Es el nombre de recurso relativo de la federación, con el formato: projects/{project_number}/locations/{location_id}/federations/{federation_id}`.

create_time

Timestamp

Solo salida. Es la hora en la que se creó la federación del metastore.

update_time

Timestamp

Solo salida. La hora en la que se actualizó por última vez la federación del metastore.

labels

map<string, string>

Etiquetas definidas por el usuario para la integración de metastore.

version

string

Inmutable. La versión del metastore de Apache Hive de la federación. Todas las versiones del metastore de backend deben ser compatibles con la versión de la federación.

backend_metastores

map<int32, BackendMetastore>

Un mapa de la clasificación de BackendMetastore a BackendMetastore desde el que el servicio de integración entrega metadatos en el momento de la consulta. La clave del mapa representa el orden en el que se deben evaluar los BackendMetastore para resolver los nombres de las bases de datos en el momento de la consulta y debe ser mayor o igual a cero. Se evaluará un BackendMetastore con un número más bajo antes que un BackendMetastore con un número más alto.

endpoint_uri

string

Solo salida. El extremo de la federación.

state

State

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

state_message

string

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

uid

string

Solo salida. El identificador de recursos único a nivel global de la federación del metastore.

Estado

Es el estado actual de la integración.

Enums
STATE_UNSPECIFIED Se desconoce el estado de la federación del metastore.
CREATING La federación del metastore está en proceso de creación.
ACTIVE La integración de metastore se está ejecutando y está lista para entregar consultas.
UPDATING Se está actualizando la federación del metastore. Se puede seguir usando, pero no se pueden aceptar solicitudes de actualización adicionales ni borrarse en este momento.
DELETING Se está borrando la federación del almacén de metadatos. No se puede usar.
ERROR La federación del almacén de metadatos encontró un error y no se puede usar. Se debe borrar la federación del almacén de metadatos.

GetBackupRequest

Mensaje de solicitud para DataprocMetastore.GetBackup.

Campos
name

string

Obligatorio. Es el nombre de recurso relativo de la copia de seguridad que se recuperará, con el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.backups.get

GetFederationRequest

Mensaje de solicitud para GetFederation.

Campos
name

string

Obligatorio. El nombre de recurso relativo de la federación de metastore que se recuperará, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.federations.get

GetMetadataImportRequest

Mensaje de solicitud para DataprocMetastore.GetMetadataImport.

Campos
name

string

Obligatorio. Es el nombre de recurso relativo de la importación de metadatos que se recuperará, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.imports.get

GetMigrationExecutionRequest

Mensaje de solicitud para DataprocMetastore.GetMigrationExecution.

Campos
name

string

Obligatorio. El nombre de recurso relativo de la ejecución de migración que se recuperará, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.migrations.get

GetServiceRequest

Mensaje de solicitud para DataprocMetastore.GetService.

Campos
name

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore que se recuperará, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • metastore.services.get

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.

Campos
version

string

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

config_overrides

map<string, 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.

kerberos_config

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 UpdateService y especifica la ruta de este campo (hive_metastore_config.kerberos_config) en el update_mask de la solicitud, mientras omites este campo del service de la solicitud.

endpoint_protocol

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.

auxiliary_versions

map<string, 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.

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.

KerberosConfig

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

Campos
keytab

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.

krb5_config_gcs_uri

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.

Lake

Representa un recurso de Lake

Campos
name

string

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

LatestBackup

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

Campos
backup_id

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.

start_time

Timestamp

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

state

State

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

duration

Duration

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

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.

LimitConfig

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

Campos
max_scaling_factor

float

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

min_scaling_factor

float

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

ListBackupsRequest

Mensaje de solicitud para DataprocMetastore.ListBackups.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo del servicio cuyas copias de seguridad se enumerarán, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.backups.list
page_size

int32

Opcional. Es la cantidad máxima de copias de seguridad que se mostrarán. La respuesta puede contener menos de la cantidad máxima. Si no se especifica, no se devuelven más de 500 copias de seguridad. El valor máximo es 1,000. Los valores superiores a 1,000 se cambiarán a 1,000.

page_token

string

Opcional. Un token de página, recibido desde una llamada DataprocMetastore.ListBackups anterior. Proporciona este token para recuperar la página siguiente.

Para recuperar la primera página, proporciona un token de página vacío.

Cuando se realiza la paginación, los demás parámetros proporcionados a DataprocMetastore.ListBackups deben coincidir con la llamada que proporcionó el token de página.

filter

string

Opcional. Es el filtro que se aplicará a los resultados de la lista.

order_by

string

Opcional. Especifica el orden de los resultados como se describe en Orden de clasificación. Si no se especifica, los resultados se ordenarán en el orden predeterminado.

ListBackupsResponse

Mensaje de respuesta para DataprocMetastore.ListBackups.

Campos
backups[]

Backup

Las copias de seguridad del servicio especificado

next_page_token

string

Es un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

unreachable[]

string

Ubicaciones en las que no se pudo acceder.

ListFederationsRequest

Mensaje de solicitud para ListFederations.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo de la ubicación de las federaciones de metastore que se enumerarán, en el siguiente formato: projects/{project_number}/locations/{location_id}.

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.federations.list
page_size

int32

Opcional. Es la cantidad máxima de federaciones que se mostrarán. La respuesta puede contener menos de la cantidad máxima. Si no se especifica, no se devuelven más de 500 servicios. El valor máximo es 1,000. Los valores superiores a 1,000 se cambiarán a 1,000.

page_token

string

Opcional. Es un token de página, recibido desde una llamada a ListFederationServices anterior. Proporciona este token para recuperar la página siguiente.

Para recuperar la primera página, proporciona un token de página vacío.

Cuando se realiza la paginación, los demás parámetros proporcionados a ListFederationServices deben coincidir con la llamada que proporcionó el token de página.

filter

string

Opcional. Es el filtro que se aplicará a los resultados de la lista.

order_by

string

Opcional. Especifica el orden de los resultados como se describe en Orden de clasificación. Si no se especifica, los resultados se ordenarán en el orden predeterminado.

ListFederationsResponse

Mensaje de respuesta para ListFederations

Campos
federations[]

Federation

Los servicios en la ubicación especificada

next_page_token

string

Es un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

unreachable[]

string

Ubicaciones en las que no se pudo acceder.

ListMetadataImportsRequest

Mensaje de solicitud para DataprocMetastore.ListMetadataImports.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo del servicio cuyos metadatos se importan a la lista, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.imports.list
page_size

int32

Opcional. Es la cantidad máxima de importaciones que se mostrarán. La respuesta puede contener menos de la cantidad máxima. Si no se especifica, no se devuelven más de 500 importaciones. El valor máximo es 1,000. Los valores superiores a 1,000 se cambiarán a 1,000.

page_token

string

Opcional. Un token de página, recibido desde una llamada DataprocMetastore.ListServices anterior. Proporciona este token para recuperar la página siguiente.

Para recuperar la primera página, proporciona un token de página vacío.

Cuando se realiza la paginación, los demás parámetros proporcionados a DataprocMetastore.ListServices deben coincidir con la llamada que proporcionó el token de página.

filter

string

Opcional. Es el filtro que se aplicará a los resultados de la lista.

order_by

string

Opcional. Especifica el orden de los resultados como se describe en Orden de clasificación. Si no se especifica, los resultados se ordenarán en el orden predeterminado.

ListMetadataImportsResponse

Mensaje de respuesta para DataprocMetastore.ListMetadataImports.

Campos
metadata_imports[]

MetadataImport

Las importaciones en el servicio especificado.

next_page_token

string

Es un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

unreachable[]

string

Ubicaciones en las que no se pudo acceder.

ListMigrationExecutionsRequest

Mensaje de solicitud para DataprocMetastore.ListMigrationExecutions.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo del servicio cuyas ejecuciones de migración se enumerarán, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.migrations.list
page_size

int32

Opcional. Es la cantidad máxima de ejecuciones de migración que se mostrarán. La respuesta puede contener menos de la cantidad máxima. Si no se especifica, no se devuelven más de 500 ejecuciones de migración. El valor máximo es 1,000. Los valores superiores a 1,000 se cambiarán a 1,000.

page_token

string

Opcional. Un token de página, recibido desde una llamada DataprocMetastore.ListMigrationExecutions anterior. Proporciona este token para recuperar la página siguiente.

Para recuperar la primera página, proporciona un token de página vacío.

Cuando se realiza la paginación, los demás parámetros proporcionados a DataprocMetastore.ListMigrationExecutions deben coincidir con la llamada que proporcionó el token de página.

filter

string

Opcional. Es el filtro que se aplicará a los resultados de la lista.

order_by

string

Opcional. Especifica el orden de los resultados como se describe en Orden de clasificación. Si no se especifica, los resultados se ordenarán en el orden predeterminado.

ListMigrationExecutionsResponse

Mensaje de respuesta para DataprocMetastore.ListMigrationExecutions.

Campos
migration_executions[]

MigrationExecution

Las ejecuciones de migración en el servicio especificado

next_page_token

string

Es un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

unreachable[]

string

Ubicaciones en las que no se pudo acceder.

ListServicesRequest

Mensaje de solicitud para DataprocMetastore.ListServices.

Campos
parent

string

Obligatorio. Es el nombre de recurso relativo de la ubicación de los servicios de metastore que se enumerarán, en el siguiente formato:

projects/{project_number}/locations/{location_id}

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • metastore.services.list
page_size

int32

Opcional. Es la cantidad máxima de servicios que se mostrarán. La respuesta puede contener menos de la cantidad máxima. Si no se especifica, no se devuelven más de 500 servicios. El valor máximo es 1,000. Los valores superiores a 1,000 se cambiarán a 1,000.

page_token

string

Opcional. Un token de página, recibido desde una llamada DataprocMetastore.ListServices anterior. Proporciona este token para recuperar la página siguiente.

Para recuperar la primera página, proporciona un token de página vacío.

Cuando se realiza la paginación, los demás parámetros proporcionados a DataprocMetastore.ListServices deben coincidir con la llamada que proporcionó el token de página.

filter

string

Opcional. Es el filtro que se aplicará a los resultados de la lista.

order_by

string

Opcional. Especifica el orden de los resultados como se describe en Orden de clasificación. Si no se especifica, los resultados se ordenarán en el orden predeterminado.

ListServicesResponse

Mensaje de respuesta para DataprocMetastore.ListServices.

Campos
services[]

Service

Los servicios en la ubicación especificada

next_page_token

string

Es un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

unreachable[]

string

Ubicaciones en las que no se pudo acceder.

LocationMetadata

Metadatos sobre el servicio en una ubicación.

Campos
supported_hive_metastore_versions[]

HiveMetastoreVersion

Las versiones de Hive Metastore que se pueden usar cuando se crea un servicio de almacén de metadatos nuevo en esta ubicación. El servidor garantiza que solo un HiveMetastoreVersion en la lista establezca is_default.

multi_region_metadata

MultiRegionMetadata

Los metadatos multirregionales si la región actual es multirregional

custom_region_metadata[]

CustomRegionMetadata

Son las posibles configuraciones admitidas si la región actual es una región personalizada.

CustomRegionMetadata

Metadatos sobre una región personalizada. Solo se propaga si la región es personalizada. Para una sola región o varias, estará vacío.

Campos
required_read_write_regions[]

string

Las regiones de lectura y escritura de esta región personalizada.

optional_read_only_regions[]

string

Las regiones de solo lectura de esta región personalizada.

witness_region

string

La región testigo de Spanner para esta región personalizada.

HiveMetastoreVersion

Es una especificación de una versión compatible del software de Hive Metastore.

Campos
version

string

Es la versión semántica del software de Hive Metastore.

is_default

bool

Indica si el servidor elegirá version si se crea un servicio de almacén de metadatos con un HiveMetastoreConfig que omite version.

MultiRegionMetadata

Los metadatos de la multirregión que incluye las regiones constituyentes Los metadatos solo se propagan si la región es multirregional. En el caso de una sola región o una región doble personalizada, estará vacío.

Campos
constituent_regions[]

string

Las regiones que constituyen la multirregión

MaintenanceWindow

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

Campos
hour_of_day

Int32Value

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

day_of_week

DayOfWeek

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

MetadataExport

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

Campos
start_time

Timestamp

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

end_time

Timestamp

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

state

State

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

database_dump_type

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:

destination_gcs_uri

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.

MetadataImport

Un recurso de metastore que importa metadatos.

Campos
name

string

Inmutable. El nombre de recurso relativo de la importación de metadatos, con el siguiente formato:

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

description

string

Es la descripción de la importación de metadatos.

create_time

Timestamp

Solo salida. Es la hora en que se inició la importación de metadatos.

update_time

Timestamp

Solo salida. Es la hora en la que se actualizó la importación de metadatos por última vez.

end_time

Timestamp

Solo salida. Es la hora en que finalizó la importación de metadatos.

state

State

Solo salida. Es el estado actual de la importación de metadatos.

Campo de unión metadata. Los metadatos que se importarán metadata puede ser solo uno de los siguientes:
database_dump

DatabaseDump

Inmutable. Un volcado de base de datos de la base de datos de un metastore preexistente

DatabaseDump

Es una especificación de la ubicación y los metadatos de un volcado de base de datos de un sistema de administración de bases de datos relacionales.

Campos
database_type
(deprecated)

DatabaseType

Es el tipo de base de datos.

gcs_uri

string

Es un URI de objeto o carpeta de Cloud Storage que especifica la fuente desde la que se importarán los metadatos. Debe comenzar con gs://.

source_database
(deprecated)

string

Es el nombre de la base de datos de origen.

type

Type

Opcional. Es el tipo de volcado de la base de datos. Si no se especifica, se establece de forma predeterminada como MYSQL.

DatabaseType

Es el tipo de base de datos.

Enums
DATABASE_TYPE_UNSPECIFIED Se desconoce el tipo de la base de datos de origen.
MYSQL El tipo de la base de datos de origen es MySQL.

Estado

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

Enums
STATE_UNSPECIFIED Se desconoce el estado de la importación de metadatos.
RUNNING La importación de metadatos está en ejecución.
SUCCEEDED La importación de metadatos se completó correctamente.
UPDATING Se está actualizando la importación de metadatos.
FAILED No se pudo realizar la importación de metadatos y se revirtieron los cambios que se intentaron realizar.

MetadataIntegration

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

Campos
data_catalog_config

DataCatalogConfig

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

dataplex_config

DataplexConfig

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

MetadataManagementActivity

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

Campos
metadata_exports[]

MetadataExport

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

restores[]

Restore

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

MigrationExecution

Son los detalles de un recurso de ejecución de migración.

Campos
name

string

Solo salida. El nombre de recurso relativo de la ejecución de la migración, con el siguiente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}

create_time

Timestamp

Solo salida. Es la hora en que se inició la ejecución de la migración.

end_time

Timestamp

Solo salida. Es la hora en la que finalizó la ejecución de la migración.

state

State

Solo salida. Es el estado actual de la ejecución de la migración.

phase

Phase

Solo salida. La fase actual de la ejecución de la migración.

state_message

string

Solo salida. Información adicional sobre el estado actual de la ejecución de la migración.

Campo de unión migration_config. La información de configuración que requiere Dataproc Metastore para iniciar el proceso de migración migration_config puede ser solo una de las siguientes:
cloud_sql_migration_config

CloudSQLMigrationConfig

Información de configuración específica para migrar desde un metastore de Hive autoadministrado en Google Cloud que usa Cloud SQL como base de datos de backend a Dataproc Metastore.

CloudSQLMigrationConfig

Información de configuración para migrar desde un metastore de Hive autoadministrado en Google Cloud que usa Cloud SQL como base de datos de backend a Dataproc Metastore.

Campos
cdc_config

CdcConfig

Obligatorio. Información de configuración para iniciar las transmisiones de captura de datos modificados (CDC) desde la base de datos del cliente a la base de datos de backend de Dataproc Metastore. Dataproc Metastore cambia a usar su base de datos de backend después de la fase de migración de sistemas.

cloud_sql_connection_config

CloudSQLConnectionConfig

Obligatorio. Información de configuración para establecer la conexión de la base de datos del cliente antes de la fase de migración de sistemas

CdcConfig

Información de configuración para iniciar las transmisiones de captura de datos modificados (CDC) desde la base de datos del cliente a la base de datos de backend de Dataproc Metastore.

Campos
vpc_network

string

Obligatorio. Es el nombre completamente calificado de la red de VPC de la instancia de Cloud SQL o la red de VPC compartida a la que se conectará Datastream, en el siguiente formato: projects/{project_id}/locations/global/networks/{network_id}. Obtén más información en https://cloud.google.com/datastream/docs/network-connectivity-options#privateconnectivity.

subnet_ip_range

string

Obligatorio. Un rango de IP de CIDR /29 para una conexión de intercambio de tráfico con DataStream

username

string

Obligatorio. Es el nombre de usuario que debe usar el servicio de Datastream para la conexión de MySQL.

password

string

Obligatorio. Solo entrada. La contraseña del usuario que debe usar el servicio de Datastream para la conexión de MySQL. Este campo no se muestra a pedido.

reverse_proxy_subnet

string

Obligatorio. La URL del recurso de subred para crear la instancia de VM que aloja el proxy inverso. Obtén más información en https://cloud.google.com/datastream/docs/private-connectivity#reverse-csql-proxy. La subred debe residir en la red proporcionada en la solicitud a la que se conectará Datastream y debe estar en la misma región que Datastream, en el siguiente formato. projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}

bucket

string

Opcional. El bucket en el que se escribirán los datos de eventos de transmisión intermedios. El nombre del bucket no debe tener ningún prefijo como "gs://". Consulta los requisitos para nombrar los buckets. Este campo es opcional. Si no se establece, se usará el bucket de Artifacts Cloud Storage.

root_path

string

Opcional. La ruta de acceso raíz dentro del bucket de Cloud Storage. Los datos de eventos de transmisión se escribirán en esta ruta. El valor predeterminado es /migration.

CloudSQLConnectionConfig

Información de configuración para establecer la conexión de la base de datos del cliente antes de la fase de migración de sistemas

Campos
instance_connection_name

string

Obligatorio. Nombre de la conexión de la base de datos de Cloud SQL (project_id:region:instance_name)

ip_address

string

Obligatorio. La dirección IP privada de la instancia de Cloud SQL

port

int32

Obligatorio. Es el puerto de red de la base de datos.

hive_database_name

string

Obligatorio. Es el nombre de la base de datos de Hive.

username

string

Obligatorio. El nombre de usuario que usará el servicio de Dataproc Metastore para conectarse a la base de datos.

password

string

Obligatorio. Solo entrada. La contraseña del usuario que usará el servicio de Dataproc Metastore para conectarse a la base de datos Este campo no se muestra a pedido.

proxy_subnet

string

Obligatorio. El nombre de recurso relativo de la subred en la que se implementará el servicio de proxy SOCKS5. La subred debe residir en una red a través de la cual se pueda acceder a la instancia de Cloud SQL. El nombre del recurso debe tener el formato projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}.

nat_subnet

string

Obligatorio. El nombre de recurso relativo de la subred que se usará para Private Service Connect. Ten en cuenta que esta no puede ser una subred normal y que solo se usa para NAT. (https://cloud.google.com/vpc/docs/about-vpc-hosted-services#psc-subnets). Esta subred se usa para publicar el servicio de proxy SOCKS5. El tamaño de la subred debe ser de al menos /29 y debe residir en una red a través de la cual se pueda acceder a la instancia de Cloud SQL. El nombre del recurso debe tener el formato projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}.

Fase

La fase actual de la ejecución de la migración.

Enums
PHASE_UNSPECIFIED Se desconoce la fase de la ejecución de la migración.
REPLICATION La fase de replicación hace referencia a la fase de migración en la que Dataproc Metastore ejecuta una canalización para replicar los cambios en la base de datos del cliente en su base de datos de backend. Durante esta fase, Dataproc Metastore usa la base de datos del cliente como la base de datos de backend del metastore de Hive.
CUTOVER La fase de migración de sistemas hace referencia a la fase de migración en la que Dataproc Metastore cambia a usar su propia base de datos de backend. La migración entra en esta fase cuando el cliente termina de migrar todos sus clústeres o cargas de trabajo a Dataproc Metastore y activa CompleteMigration.

Estado

Es el estado actual de la ejecución de la migración.

Enums
STATE_UNSPECIFIED Se desconoce el estado de la ejecución de la migración.
STARTING Se está iniciando la ejecución de la migración.
RUNNING Se está ejecutando la ejecución de la migración.
CANCELLING Se está cancelando la ejecución de la migración.
AWAITING_USER_ACTION La ejecución de la migración está esperando la acción del usuario.
SUCCEEDED La ejecución de la migración se completó correctamente.
FAILED No se pudo ejecutar la migración.
CANCELLED Se canceló la ejecución de la migración.
DELETING Se borrará la ejecución de la migración.

MoveTableToDatabaseRequest

Mensaje de solicitud para DataprocMetastore.MoveTableToDatabase.

Campos
service

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore para mutar metadatos, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.services.mutateMetadata
table_name

string

Obligatorio. Es el nombre de la tabla que se moverá.

db_name

string

Obligatorio. Es el nombre de la base de datos en la que reside la tabla.

destination_db_name

string

Obligatorio. Es el nombre de la base de datos a la que se debe mover la tabla.

MoveTableToDatabaseResponse

Este tipo no tiene campos.

Mensaje de respuesta para DataprocMetastore.MoveTableToDatabase.

MultiRegionConfig

La configuración multirregional del servicio de Dataproc Metastore

Campos
certificates[]
(deprecated)

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.

custom_region_config

CustomRegionConfig

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.

Campos
read_write_regions[]

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.

read_only_regions[]

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.

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.

Campos
certificate
(deprecated)

string

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

expiration_time
(deprecated)

Timestamp

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

NetworkConfig

Configuración de red para el servicio de Dataproc Metastore

Campos
consumers[]

Consumer

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

custom_routes_enabled

bool

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.

Campos
endpoint_uri

string

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

endpoint_location

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/{project_number}/regions/{region_id}/subnetworks/{subnetwork_id}

OperationMetadata

Representa los metadatos de una operación de larga duración.

Campos
create_time

Timestamp

Solo salida. La hora en que se creó la operación.

end_time

Timestamp

Solo salida. La hora a la que finalizó la operación.

target

string

Solo salida. Ruta de recurso definida por el servidor para el destino de la operación.

verb

string

Solo salida. Nombre del verbo que ejecuta la operación.

status_message

string

Solo salida. Estado legible de la operación, si lo hay.

requested_cancellation

bool

Solo salida. Identifica si el emisor solicitó la cancelación de la operación. Las operaciones que se cancelaron de forma correcta tienen el valor [Operation.error][] con un google.rpc.Status.code de 1, que corresponde a Code.CANCELLED.

api_version

string

Solo salida. La versión de la API solo se usa para iniciar la operación.

QueryMetadataRequest

Mensaje de solicitud para DataprocMetastore.QueryMetadata.

Campos
service

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore para consultar metadatos, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.services.queryMetadata
query

string

Obligatorio. Una consulta de SQL de solo lectura para ejecutar en la base de datos de metadatos. La consulta no puede cambiar ni mutar los datos.

QueryMetadataResponse

Mensaje de respuesta para DataprocMetastore.QueryMetadata.

Campos
result_manifest_uri

string

El URI del manifiesto es un vínculo a una instancia JSON en Cloud Storage. Esta instancia se manifiesta de inmediato junto con QueryMetadataResponse. El contenido del URI no se puede volver a recuperar hasta que finaliza la consulta de la operación de larga duración en los metadatos.

RemoveIamPolicyRequest

Mensaje de solicitud para DataprocMetastore.RemoveIamPolicy.

Campos
resource

string

Obligatorio. Es el nombre de recurso relativo del recurso de plano de datos para quitar la política de IAM, en el siguiente formato:

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

asynchronous

bool

Opcional. Quita de forma asíncrona la política de IAM adjunta a la base de datos o la tabla cuando se establece. El valor predeterminado es falso.

RemoveIamPolicyResponse

Mensaje de respuesta para DataprocMetastore.RemoveIamPolicy.

Campos
success

bool

Es verdadero si la política se quita correctamente.

Restablecer

Los detalles de una operación de restablecimiento de metadatos

Campos
start_time

Timestamp

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

end_time

Timestamp

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

state

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/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}

type

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

backup_location

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

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.

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.

RestoreServiceRequest

Mensaje de solicitud para [DataprocMetastore.Restore][].

Campos
service

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore para ejecutar el restablecimiento, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.services.restore
backup

string

Opcional. 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/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}: Es mutuamente excluyente con backup_location y se debe establecer exactamente uno de los dos.

La autorización requiere el siguiente permiso IAM en el recurso especificado backup:

  • metastore.backups.use
backup_location

string

Opcional. Un URI de Cloud Storage que especifique la ubicación de los artefactos de copia de seguridad, es decir, los archivos Avro de copia de seguridad en "avro/", backup_metastore.json y service.json, en el siguiente formato:

gs://<path_to_backup>: Es mutuamente excluyente con backup y se debe establecer exactamente uno de los dos.

restore_type

RestoreType

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

request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

ScalingConfig

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

Campos
autoscaling_config

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:
instance_size

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 = scaling_factor(0.1))

scaling_factor

float

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.

ScheduledBackup

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

Campos
enabled

bool

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

cron_schedule

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.

time_zone

string

Opcional. Especifica la zona horaria que se usará cuando se interprete cron_schedule. 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.

next_scheduled_time

Timestamp

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

backup_location

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.

latest_backup

LatestBackup

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

Secreto

Un valor almacenado de forma segura.

Campos

Campo de unión value.

value puede ser una de las siguientes opciones:

cloud_secret

string

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

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

Servicio

Un servicio de metastore administrado que entrega consultas de metadatos.

Campos
name

string

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

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

create_time

Timestamp

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

update_time

Timestamp

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

labels

map<string, string>

Etiquetas definidas por el usuario para el servicio de metastore.

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/{project_number}/global/networks/{network_id}

endpoint_uri

string

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

port

int32

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

state

State

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

state_message

string

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

artifact_gcs_uri

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

Tier

Es el nivel del servicio.

metadata_integration

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.

maintenance_window

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.

metadata_management_activity

MetadataManagementActivity

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

release_channel

ReleaseChannel

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

encryption_config

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.

network_config

NetworkConfig

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

database_type

DatabaseType

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

telemetry_config

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.

scaling_config

ScalingConfig

Configuración de escalamiento del servicio de metastore

multi_region_config

MultiRegionConfig

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

scheduled_backup

ScheduledBackup

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

deletion_protection

bool

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:
hive_metastore_config

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.

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.

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.

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.

StartMigrationRequest

Mensaje de solicitud para DataprocMetastore.StartMigration.

Campos
service

string

Obligatorio. Es el nombre de recurso relativo del servicio de metastore al que se comenzará a migrar, en el siguiente formato:

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

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.migrations.start
migration_execution

MigrationExecution

Obligatorio. Los detalles de configuración de la migración

request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

TelemetryConfig

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

Campos
log_format

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.

UpdateFederationRequest

Es un mensaje de solicitud para UpdateFederation.

Campos
update_mask

FieldMask

Obligatorio. Es una máscara de campo que se usa para especificar los campos que la actualización reemplazará en el recurso de la federación del metastore. Los campos especificados en update_mask se relacionan con el recurso (no con la solicitud completa). Un campo se reemplaza si está en la máscara.

federation

Federation

Obligatorio. La federación de metastore que se actualizará. El servidor solo combina campos en el servicio si se especifican en update_mask.

El campo name de la federación de metastore se usa para identificar el servicio de metastore que se actualizará.

La autorización requiere el siguiente permiso IAM en el recurso especificado federation:

  • metastore.federations.update
request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

UpdateMetadataImportRequest

Mensaje de solicitud para DataprocMetastore.UpdateMetadataImport.

Campos
update_mask

FieldMask

Obligatorio. Es una máscara de campo que se usa para especificar los campos que la actualización reemplazará en el recurso de importación de metadatos. Los campos especificados en update_mask se relacionan con el recurso (no con la solicitud completa). Un campo se reemplaza si está en la máscara.

metadata_import

MetadataImport

Obligatorio. La importación de metadatos que deseas actualizar El servidor solo combina campos en la importación si se especifican en update_mask.

El campo name de la importación de metadatos se usa para identificar la importación del metastore que se actualizará.

La autorización requiere el siguiente permiso IAM en el recurso especificado metadataImport:

  • metastore.imports.update
request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).

UpdateServiceRequest

Mensaje de solicitud para DataprocMetastore.UpdateService.

Campos
update_mask

FieldMask

Obligatorio. Es una máscara de campo que se usa para especificar los campos que la actualización reemplazará en el recurso de servicio de metastore. Los campos especificados en update_mask se relacionan con el recurso (no con la solicitud completa). Un campo se reemplaza si está en la máscara.

service

Service

Obligatorio. El servicio de Metastore que se actualizará. El servidor solo combina campos en el servicio si se especifican en update_mask.

El campo name del servicio de metastore se usa para identificar el servicio de metastore que se actualizará.

La autorización requiere el siguiente permiso IAM en el recurso especificado service:

  • metastore.services.update
request_id

string

Opcional. Un ID de solicitud Especifica un ID de solicitud único para permitir que el servidor ignore la solicitud si se completó. El servidor ignorará las solicitudes posteriores que proporcionen un ID de solicitud duplicado durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, si se agota el tiempo de espera de una solicitud inicial, seguida de otra solicitud con el mismo ID de solicitud, el servidor ignora la segunda solicitud para evitar la creación de compromisos duplicados.

El ID de solicitud debe ser un UUID válido. No se admite un UUID cero (00000000-0000-0000-0000-000000000000).