Package google.cloud.metastore.v1alpha

Indice

• DataprocMetastore (interfaccia)
• DataprocMetastoreFederation (interfaccia)
• AlterMetadataResourceLocationRequest (messaggio)
• AlterMetadataResourceLocationResponse (messaggio)
• AlterTablePropertiesRequest (messaggio)
• AlterTablePropertiesResponse (messaggio)
• AutoscalingConfig (messaggio)
• AuxiliaryVersionConfig (messaggio)
• BackendMetastore (messaggio)
• BackendMetastore.MetastoreType (enum)
• Backup (messaggio)
• Backup.State (enum)
• CancelMigrationRequest (messaggio)
• CancelMigrationResponse (messaggio)
• CompleteMigrationRequest (messaggio)
• CompleteMigrationResponse (messaggio)
• CreateBackupRequest (messaggio)
• CreateFederationRequest (messaggio)
• CreateMetadataImportRequest (messaggio)
• CreateServiceRequest (messaggio)
• DataCatalogConfig (messaggio)
• DatabaseDumpSpec (messaggio)
• DatabaseDumpSpec.Type (enum)
• DataplexConfig (messaggio)
• DeleteBackupRequest (messaggio)
• DeleteFederationRequest (messaggio)
• DeleteMigrationExecutionRequest (messaggio)
• DeleteServiceRequest (messaggio)
• EncryptionConfig (messaggio)
• ErrorDetails (messaggio)
• ExportMetadataRequest (messaggio)
• Federation (messaggio)
• Federation.State (enum)
• GetBackupRequest (messaggio)
• GetFederationRequest (messaggio)
• GetMetadataImportRequest (messaggio)
• GetMigrationExecutionRequest (messaggio)
• GetServiceRequest (messaggio)
• HiveMetastoreConfig (messaggio)
• HiveMetastoreConfig.EndpointProtocol (enum)
• KerberosConfig (messaggio)
• Lake (messaggio)
• LatestBackup (messaggio)
• LatestBackup.State (enum)
• LimitConfig (messaggio)
• ListBackupsRequest (messaggio)
• ListBackupsResponse (messaggio)
• ListFederationsRequest (messaggio)
• ListFederationsResponse (messaggio)
• ListMetadataImportsRequest (messaggio)
• ListMetadataImportsResponse (messaggio)
• ListMigrationExecutionsRequest (messaggio)
• ListMigrationExecutionsResponse (messaggio)
• ListServicesRequest (messaggio)
• ListServicesResponse (messaggio)
• LocationMetadata (messaggio)
• LocationMetadata.CustomRegionMetadata (messaggio)
• LocationMetadata.HiveMetastoreVersion (messaggio)
• LocationMetadata.MultiRegionMetadata (messaggio)
• MaintenanceWindow (messaggio)
• MetadataExport (messaggio)
• MetadataExport.State (enum)
• MetadataImport (messaggio)
• MetadataImport.DatabaseDump (messaggio)
• MetadataImport.DatabaseDump.DatabaseType (enum)
• MetadataImport.State (enum)
• MetadataIntegration (messaggio)
• MetadataManagementActivity (messaggio)
• MigrationExecution (messaggio)
• MigrationExecution.CloudSQLMigrationConfig (messaggio)
• MigrationExecution.CloudSQLMigrationConfig.CdcConfig (messaggio)
• MigrationExecution.CloudSQLMigrationConfig.CloudSQLConnectionConfig (messaggio)
• MigrationExecution.Phase (enum)
• MigrationExecution.State (enum)
• MoveTableToDatabaseRequest (messaggio)
• MoveTableToDatabaseResponse (messaggio)
• MultiRegionConfig (messaggio)
• MultiRegionConfig.CustomRegionConfig (messaggio)
• MultiRegionConfig.RootCACertificate (messaggio) (obsoleto)
• NetworkConfig (messaggio)
• NetworkConfig.Consumer (messaggio)
• OperationMetadata (messaggio)
• QueryMetadataRequest (messaggio)
• QueryMetadataResponse (messaggio)
• RemoveIamPolicyRequest (messaggio)
• RemoveIamPolicyResponse (messaggio)
• Restore (messaggio)
• Restore.RestoreType (enum)
• Restore.State (enum)
• RestoreServiceRequest (messaggio)
• ScalingConfig (messaggio)
• ScalingConfig.InstanceSize (enum)
• ScheduledBackup (messaggio)
• Secret (messaggio)
• Service (messaggio)
• Service.DatabaseType (enum)
• Service.ReleaseChannel (enum)
• Service.State (enum)
• Service.Tier (enum)
• StartMigrationRequest (messaggio)
• TelemetryConfig (messaggio)
• TelemetryConfig.LogFormat (enum)
• UpdateFederationRequest (messaggio)
• UpdateMetadataImportRequest (messaggio)
• UpdateServiceRequest (messaggio)

DataprocMetastore

Configura e gestisce i servizi metastore. I servizi Metastore sono implementazioni di software di gestione dei metadati tecnici completamente gestite, ad alta disponibilità, con scalabilità automatica e riparazione automatica, native OSS. Ogni servizio metastore espone un endpoint di rete tramite il quale vengono eseguite le query sui metadati. Le query sui metadati possono provenire da una serie di origini, tra cui Apache Hive, Apache Presto e Apache Spark.

L'API Dataproc Metastore definisce il seguente modello di risorse:

• Il servizio funziona con una raccolta di progetti Google Cloud denominati: /projects/*
• Ogni progetto ha una raccolta di località disponibili, denominate: /locations/* (una località deve fare riferimento a un region Google Cloud)
• Ogni località ha una raccolta di servizi denominata: /services/*
• I servizi Dataproc Metastore sono risorse con nomi del seguente tipo:

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

AlterMetadataResourceLocation

rpc AlterMetadataResourceLocation(AlterMetadataResourceLocationRequest) returns (Operation) Modifica la posizione della risorsa dei metadati. La risorsa di metadati può essere un database, una tabella o una partizione. Questa funzionalità aggiorna solo la directory principale per la rispettiva risorsa di metadati e non trasferisce i dati esistenti nella nuova posizione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

AlterTableProperties
rpc AlterTableProperties(AlterTablePropertiesRequest) returns (Operation) Modifica le proprietà della tabella dei metadati. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

CancelMigration
rpc CancelMigration(CancelMigrationRequest) returns (Operation) Annullerà il processo di migrazione gestita in corso. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

CompleteMigration
rpc CompleteMigration(CompleteMigrationRequest) returns (Operation) Completa il processo di migrazione gestita. Il servizio Dataproc Metastore passerà all'utilizzo del proprio database di backend dopo la migrazione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

CreateBackup
rpc CreateBackup(CreateBackupRequest) returns (Operation) Crea un nuovo backup in un determinato progetto e posizione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

CreateMetadataImport
rpc CreateMetadataImport(CreateMetadataImportRequest) returns (Operation) Crea un nuovo MetadataImport in un determinato progetto e posizione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

CreateService
rpc CreateService(CreateServiceRequest) returns (Operation) Crea un servizio Metastore in un progetto e in una località. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

DeleteBackup
rpc DeleteBackup(DeleteBackupRequest) returns (Operation) Consente di eliminare un singolo backup. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

DeleteMigrationExecution
rpc DeleteMigrationExecution(DeleteMigrationExecutionRequest) returns (Operation) Consente di eliminare una singola esecuzione di migrazione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

DeleteService
rpc DeleteService(DeleteServiceRequest) returns (Operation) Consente di eliminare un singolo servizio. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

ExportMetadata
rpc ExportMetadata(ExportMetadataRequest) returns (Operation) Esporta i metadati da un servizio. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

GetBackup
rpc GetBackup(GetBackupRequest) returns (Backup) Recupera i dettagli di un singolo backup. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

GetMetadataImport
rpc GetMetadataImport(GetMetadataImportRequest) returns (MetadataImport) Recupera i dettagli di una singola importazione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

GetMigrationExecution
rpc GetMigrationExecution(GetMigrationExecutionRequest) returns (MigrationExecution) Recupera i dettagli di un'unica esecuzione della migrazione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

GetService
rpc GetService(GetServiceRequest) returns (Service) Recupera i dettagli di un singolo servizio. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

ListBackups
rpc ListBackups(ListBackupsRequest) returns (ListBackupsResponse) Elenca i backup in un servizio. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

ListMetadataImports
rpc ListMetadataImports(ListMetadataImportsRequest) returns (ListMetadataImportsResponse) Elenca le importazioni in un servizio. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

ListMigrationExecutions
rpc ListMigrationExecutions(ListMigrationExecutionsRequest) returns (ListMigrationExecutionsResponse) Elenca le esecuzioni di migrazione su un servizio. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

ListServices
rpc ListServices(ListServicesRequest) returns (ListServicesResponse) Elenca i servizi in un progetto e in una località. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

MoveTableToDatabase
rpc MoveTableToDatabase(MoveTableToDatabaseRequest) returns (Operation) Spostare una tabella in un altro database. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

QueryMetadata
rpc QueryMetadata(QueryMetadataRequest) returns (Operation) Esegui query sui metadati di Dataproc Metastore. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

RemoveIamPolicy
rpc RemoveIamPolicy(RemoveIamPolicyRequest) returns (RemoveIamPolicyResponse) Rimuove i criteri IAM allegati per una risorsa Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

RestoreService
rpc RestoreService(RestoreServiceRequest) returns (Operation) Ripristina un servizio da un backup. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

StartMigration
rpc StartMigration(StartMigrationRequest) returns (Operation) Avvia il processo di migrazione gestita. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

UpdateMetadataImport
rpc UpdateMetadataImport(UpdateMetadataImportRequest) returns (Operation) Aggiorna una singola importazione. È supportato l'aggiornamento solo del campo descrizione di MetadataImport. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

UpdateService
rpc UpdateService(UpdateServiceRequest) returns (Operation) Aggiorna i parametri di un singolo servizio. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

DataprocMetastoreFederation

Configura e gestisce i servizi di federazione del metastore. Il servizio Dataproc Metastore Federation consente di federare una raccolta di metastore di backend come BigQuery, Dataplex Lakes e altri metastore Dataproc. Il servizio di federazione espone un URL gRPC tramite il quale i metadati dei metastore di backend vengono pubblicati al momento della query.

L'API Dataproc Metastore Federation definisce il seguente modello di risorse: * Il servizio funziona con una raccolta di progetti Google Cloud. * Ogni progetto ha una raccolta di località disponibili. * Ogni località ha una raccolta di federazioni. * Le federazioni Dataproc Metastore sono risorse con nomi del tipo: projects/{project_number}/locations/{location_id}/federations/{federation_id}.

CreateFederation
rpc CreateFederation(CreateFederationRequest) returns (Operation) Crea una federazione di metastore in un progetto e in una località. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

DeleteFederation
rpc DeleteFederation(DeleteFederationRequest) returns (Operation) Consente di eliminare una singola federazione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

GetFederation
rpc GetFederation(GetFederationRequest) returns (Federation) Recupera i dettagli di una singola federazione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

ListFederations
rpc ListFederations(ListFederationsRequest) returns (ListFederationsResponse) Elenca le federazioni in un progetto e in una località. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

UpdateFederation
rpc UpdateFederation(UpdateFederationRequest) returns (Operation) Aggiorna i campi di una federazione. Ambiti di autorizzazione Richiede il seguente ambito OAuth: https://www.googleapis.com/auth/cloud-platform Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

AlterMetadataResourceLocationRequest

Richiedi messaggio per DataprocMetastore.AlterMetadataResourceLocation.

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio metastore per modificare i metadati, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.services.mutateMetadata
resource_name	string Obbligatorio. Il nome della risorsa dei metadati relativa nel seguente formato. databases/{database_id}, databases/{database_id}/tables/{table_id} o databases/{database_id}/tables/{table_id}/partitions/{partition_id}
location_uri	string Obbligatorio. L'URI della nuova posizione per la risorsa di metadati.

AlterMetadataResourceLocationResponse

Questo tipo non contiene campi.

Messaggio di risposta per DataprocMetastore.AlterMetadataResourceLocation.

AlterTablePropertiesRequest

Richiedi messaggio per DataprocMetastore.AlterTableProperties.

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio Dataproc Metastore utilizzato per modificare le proprietà della tabella dei metadati, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.services.mutateMetadata
table_name	string Obbligatorio. Il nome della tabella contenente le proprietà che stai modificando nel seguente formato. databases/{database_id}/tables/{table_id}
update_mask	FieldMask Una maschera di campo che specifica le proprietà della tabella dei metadati che vengono sovrascritte dall'aggiornamento. I campi specificati in update_mask sono relativi alla risorsa (non alla richiesta completa). Un campo viene sovrascritto se si trova nella maschera. Ad esempio, date le proprietà target: properties { a: 1 b: 2 } E una proprietà di aggiornamento: properties { a: 2 b: 3 c: 4 } Se la maschera del campo è: paths: ["properties.b", "properties.c"] il risultato sarà: properties { a: 1 b: 3 c: 4 }
properties	map<string, string> Una mappa che descrive i valori da modificare. Se update_mask è vuoto, le proprietà non verranno aggiornate. In caso contrario, le proprietà modificano solo il valore i cui percorsi associati esistono nella maschera di aggiornamento

AlterTablePropertiesResponse

Questo tipo non contiene campi.

Messaggio di risposta per DataprocMetastore.AlterTableProperties.

AutoscalingConfig

Rappresenta la configurazione della scalabilità automatica di un servizio metastore.

Campi
autoscaling_factor	float Solo output. Il fattore di scalabilità di un servizio con la scalabilità automatica abilitata.
autoscaling_enabled	bool Facoltativo. Indica se la scalabilità automatica è abilitata o meno per questo servizio.
limit_config	LimitConfig Facoltativo. Il LimitConfig del servizio.

AuxiliaryVersionConfig

Informazioni sulla configurazione per le versioni del servizio ausiliario.

Campi
version	string La versione del metastore Hive del servizio ausiliario. Deve essere inferiore alla versione del servizio metastore Hive principale.
config_overrides	map<string, string> Una mappatura di coppie chiave-valore di configurazione del metastore Hive da applicare al metastore Hive ausiliario (configurato in hive-site.xml) oltre agli override della versione principale. Se le chiavi sono presenti sia nelle sostituzioni della versione ausiliaria sia in quelle della versione principale, il valore delle sostituzioni della versione ausiliaria ha la precedenza.
network_config	NetworkConfig Solo output. La configurazione di rete contiene gli URI dell'endpoint del servizio di metastore Hive ausiliario.

BackendMetastore

Rappresenta un metastore di backend per la federazione.

Campi
name	string Il nome della risorsa relativa del metastore di cui viene eseguita la federazione. Di seguito sono riportati i formati dei nomi delle risorse relative per i metastore attualmente supportati: BigQuery projects/{project_id} Dataproc Metastore projects/{project_id}/locations/{location}/services/{service_id}
metastore_type	MetastoreType Il tipo di metastore di backend.

MetastoreType

Il tipo di metastore di backend.

Enum
METASTORE_TYPE_UNSPECIFIED	Il tipo di metastore non è impostato.
DATAPLEX	Il metastore di backend è Dataplex.
BIGQUERY	Il metastore di backend è BigQuery.
DATAPROC_METASTORE	Il metastore di backend è Dataproc Metastore.

Backup

I dettagli di una risorsa di backup.

Campi
name	string Immutabile. Il nome della risorsa relativa del backup, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}
create_time	Timestamp Solo output. L'ora di inizio del backup.
end_time	Timestamp Solo output. L'ora in cui è terminata la creazione del backup.
state	State Solo output. Lo stato attuale del backup.
service_revision	Service Solo output. La revisione del servizio al momento del backup.
description	string La descrizione del backup.
restoring_services[]	string Solo output. Servizi in fase di ripristino dal backup.

Stato

Lo stato attuale del backup.

Enum
STATE_UNSPECIFIED	Lo stato del backup è sconosciuto.
CREATING	Il backup è in fase di creazione.
DELETING	Il backup è in fase di eliminazione.
ACTIVE	Il backup è attivo e pronto per l'uso.
FAILED	Il backup non è riuscito.
RESTORING	Il backup è in fase di ripristino.

CancelMigrationRequest

Richiedi messaggio per DataprocMetastore.CancelMigration.

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio Metastore di destinazione dell'annullamento della migrazione in corso, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.migrations.cancel

CancelMigrationResponse

Messaggio di risposta per DataprocMetastore.CancelMigration.

Campi
migration_execution	string Il nome della risorsa relativa dell'esecuzione della migrazione, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}.

CompleteMigrationRequest

Richiedi messaggio per DataprocMetastore.CompleteMigration.

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio Metastore a cui completare la migrazione, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.migrations.complete

CompleteMigrationResponse

Messaggio di risposta per DataprocMetastore.CompleteMigration.

Campi
migration_execution	string Il nome della risorsa relativa dell'esecuzione della migrazione, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}.

CreateBackupRequest

Richiedi messaggio per DataprocMetastore.CreateBackup.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa del servizio in cui creare un backup del seguente tipo: projects/{project_number}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.backups.create
backup_id	string Obbligatorio. L'ID del backup, che viene utilizzato come componente finale del nome del backup. Questo valore deve essere compreso tra 1 e 64 caratteri, iniziare con una lettera, terminare con una lettera o un numero e essere costituito da caratteri ASCII alfanumerici o trattini.
backup	Backup Obbligatorio. Il backup da creare. Il campo name viene ignorato. L'ID del backup creato deve essere fornito nel campo backup_id della richiesta.
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

CreateFederationRequest

Messaggio di richiesta per CreateFederation.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa della località in cui creare un servizio di federazione, nel seguente formato: projects/{project_number}/locations/{location_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.federations.create
federation_id	string Obbligatorio. L'ID della federazione del metastore, che viene utilizzato come componente finale del nome della federazione del metastore. Questo valore deve avere una lunghezza compresa tra 2 e 63 caratteri, iniziare con una lettera, terminare con una lettera o un numero e essere costituito da caratteri ASCII alfanumerici o trattini.
federation	Federation Obbligatorio. La Metastore Federation da creare. Il campo name viene ignorato. L'ID della federazione del metastore creata deve essere fornito nel campo federation_id della richiesta.
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

CreateMetadataImportRequest

Richiedi messaggio per DataprocMetastore.CreateMetadataImport.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa del servizio in cui creare un'importazione del metastore, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.imports.create
metadata_import_id	string Obbligatorio. L'ID dell'importazione dei metadati, che viene utilizzato come componente finale del nome dell'importazione. Questo valore deve essere compreso tra 1 e 64 caratteri, iniziare con una lettera, terminare con una lettera o un numero e essere costituito da caratteri ASCII alfanumerici o trattini.
metadata_import	MetadataImport Obbligatorio. L'importazione dei metadati da creare. Il campo name viene ignorato. L'ID dell'importazione dei metadati creata deve essere fornito nel campo metadata_import_id della richiesta.
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

CreateServiceRequest

Richiedi messaggio per DataprocMetastore.CreateService.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa della posizione in cui creare un servizio metastore, nel seguente formato: projects/{project_number}/locations/{location_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.services.create
service_id	string Obbligatorio. L'ID del servizio Metastore, che viene utilizzato come componente finale del nome del servizio. Questo valore deve avere una lunghezza compresa tra 2 e 63 caratteri, iniziare con una lettera, terminare con una lettera o un numero e essere costituito da caratteri ASCII alfanumerici o trattini.
service	Service Obbligatorio. Il servizio Metastore da creare. Il campo name viene ignorato. L'ID del servizio Metastore creato deve essere fornito nel campo service_id della richiesta.
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

DataCatalogConfig

Specifica come i metadati del metastore devono essere integrati con il servizio Data Catalog.

Campi
enabled	bool Facoltativo. Definisce se i metadati del metastore devono essere sincronizzati con Data Catalog. Il valore predefinito è disattivare la sincronizzazione dei metadati del metastore con Data Catalog.

DatabaseDumpSpec

Questo tipo non contiene campi.

La specifica del dump del database da cui importare o in cui esportare.

Tipo

Il tipo di dump del database.

Enum
TYPE_UNSPECIFIED	Il tipo di dump del database è sconosciuto.
MYSQL	Il dump del database è un file di dump MySQL.
AVRO	Il dump del database contiene file Avro.

DataplexConfig

Specifica come i metadati del metastore devono essere integrati con il servizio Dataplex.

Campi
lake_resources	map<string, Lake> Un riferimento alle risorse del lake a cui è associato questo servizio metastore. La chiave è il nome della risorsa del lago. Esempio: projects/{project_number}/locations/{location_id}/lakes/{lake_id}.

DeleteBackupRequest

Richiedi messaggio per DataprocMetastore.DeleteBackup.

Campi
name	string Obbligatorio. Il nome della risorsa relativa del backup da eliminare, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.backups.delete
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

DeleteFederationRequest

Messaggio di richiesta per DeleteFederation.

Campi
name	string Obbligatorio. Il nome della risorsa relativa della federazione del metastore da eliminare, nel seguente formato: projects/{project_number}/locations/{location_id}/federations/{federation_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.federations.delete
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

DeleteMigrationExecutionRequest

Richiedi messaggio per DataprocMetastore.DeleteMigrationExecution.

Campi
name	string Obbligatorio. Il nome della risorsa relativa della migrazione da eliminare, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.migrations.delete
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

DeleteServiceRequest

Richiedi messaggio per DataprocMetastore.DeleteService.

Campi
name	string Obbligatorio. Il nome della risorsa relativa del servizio Metastore da eliminare, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.services.delete
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

EncryptionConfig

Impostazioni di crittografia per il servizio.

Campi
kms_key	string Il nome completo della chiave Cloud KMS fornita dal cliente da utilizzare per la crittografia dei dati del cliente, nel seguente formato: projects/{project_number}/locations/{location_id}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}.

ErrorDetails

Dettagli dell'errore nel messaggio di errore pubblico per DataprocMetastore.QueryMetadata.

Campi
details	map<string, string> Ulteriori dettagli strutturati su questo errore. Le chiavi definiscono gli elementi di errore. Il valore descrive l'eccezione o i dettagli dell'elemento.

ExportMetadataRequest

Richiedi messaggio per DataprocMetastore.ExportMetadata.

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio Metastore per eseguire l'esportazione, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.services.export
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.
database_dump_type	Type Facoltativo. Il tipo di dump del database. Se non specificato, il valore predefinito è MYSQL.
Campo unione destination. Obbligatorio. Destinazione in cui vengono esportati i metadati. destination può essere solo uno dei seguenti:
destination_gcs_folder	string Un URI Cloud Storage di una cartella, nel formato gs://<bucket_name>/<path_inside_bucket>. Sotto questa cartella verrà creata una sottocartella <export_folder> contenente i file esportati.

Federazione

Rappresenta una federazione di più metastore di backend.

Campi
name	string Immutabile. Il nome della risorsa relativa della federazione, nel formato: projects/{project_number}/locations/{location_id}/federations/{federation_id}`.
create_time	Timestamp Solo output. La data e l'ora di creazione della federazione del metastore.
update_time	Timestamp Solo output. L'ora dell'ultimo aggiornamento della federazione del metastore.
labels	map<string, string> Etichette definite dall'utente per la federazione del metastore.
version	string Immutabile. La versione del metastore Apache Hive della federazione. Tutte le versioni del metastore di backend devono essere compatibili con la versione della federazione.
backend_metastores	map<int32, BackendMetastore> Una mappatura dal ranking BackendMetastore ai BackendMetastore da cui il servizio di federazione pubblica i metadati al momento della query. La chiave mappa rappresenta l'ordine in cui devono essere valutati i valori BackendMetastore per risolvere i nomi dei database al momento della query e deve essere maggiore o uguale a zero. Un BackendMetastore con un numero inferiore verrà valutato prima di un BackendMetastore con un numero superiore.
endpoint_uri	string Solo output. L'endpoint della federazione.
state	State Solo output. Lo stato attuale della federazione.
state_message	string Solo output. Ulteriori informazioni sullo stato attuale della federazione del metastore, se disponibili.
uid	string Solo output. L'identificatore della risorsa univoco a livello globale della federazione del metastore.

Stato

Lo stato attuale della federazione.

Enum
STATE_UNSPECIFIED	Lo stato della federazione del metastore è sconosciuto.
CREATING	La federazione del metastore è in fase di creazione.
ACTIVE	La federazione del metastore è in esecuzione ed è pronta per gestire le query.
UPDATING	La federazione del metastore è in fase di aggiornamento. Rimane utilizzabile, ma al momento non può accettare ulteriori richieste di aggiornamento né essere eliminato.
DELETING	La federazione del metastore è in fase di eliminazione. Non può essere utilizzato.
ERROR	La federazione del metastore ha rilevato un errore e non può essere utilizzata. La federazione del metastore deve essere eliminata.

GetBackupRequest

Richiedi messaggio per DataprocMetastore.GetBackup.

Campi
name	string Obbligatorio. Il nome della risorsa relativa del backup da recuperare, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.backups.get

GetFederationRequest

Richiedi messaggio per GetFederation.

Campi
name	string Obbligatorio. Il nome della risorsa relativa della federazione del metastore da recuperare, nel seguente formato: projects/{project_number}/locations/{location_id}/federations/{federation_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.federations.get

GetMetadataImportRequest

Richiedi messaggio per DataprocMetastore.GetMetadataImport.

Campi
name	string Obbligatorio. Il nome della risorsa relativa dell'importazione dei metadati da recuperare, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/metadataImports/{import_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.imports.get

GetMigrationExecutionRequest

Richiedi messaggio per DataprocMetastore.GetMigrationExecution.

Campi
name	string Obbligatorio. Il nome della risorsa relativa dell'esecuzione della migrazione da recuperare, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.migrations.get

GetServiceRequest

Richiedi messaggio per DataprocMetastore.GetService.

Campi
name	string Obbligatorio. Il nome della risorsa relativa del servizio Metastore da recuperare, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata name: metastore.services.get

HiveMetastoreConfig

Specifica le informazioni di configurazione specifiche per l'esecuzione del software metastore Hive come servizio metastore.

Campi
version	string Immutabile. La versione dello schema del metastore Hive.
config_overrides	map<string, string> Una mappatura di coppie chiave-valore di configurazione del metastore Hive da applicare al metastore Hive (configurato in hive-site.xml). Le mappature sostituiscono le impostazioni predefinite di sistema (alcune chiavi non possono essere sostituite). Queste sostituzioni vengono applicate anche alle versioni ausiliarie e possono essere ulteriormente personalizzate in AuxiliaryVersionConfig della versione ausiliaria.
kerberos_config	KerberosConfig Informazioni utilizzate per configurare il servizio metastore Hive come entità di servizio in un realm Kerberos. Per disattivare Kerberos, utilizza il metodo UpdateService e specifica il percorso di questo campo (hive_metastore_config.kerberos_config) in update_mask della richiesta, omettendo questo campo da service della richiesta.
endpoint_protocol	EndpointProtocol Il protocollo da utilizzare per l'endpoint del servizio Metastore. Se non specificato, il valore predefinito è THRIFT.
auxiliary_versions	map<string, AuxiliaryVersionConfig> Una mappatura della versione del metastore Hive alla configurazione della versione ausiliaria. Se specificato, viene creato un servizio metastore Hive secondario insieme al servizio principale. Tutte le versioni ausiliarie devono essere precedenti alla versione principale del servizio. La chiave è il nome del servizio ausiliario e deve corrispondere all'espressione regolare a-z?. Ciò significa che il primo carattere deve essere una lettera minuscola e tutti i caratteri successivi devono essere trattini, lettere minuscole o cifre, tranne l'ultimo carattere, che non può essere un trattino.

EndpointProtocol

Protocolli disponibili per la pubblicazione dell'endpoint del servizio Metastore.

Enum
ENDPOINT_PROTOCOL_UNSPECIFIED	Il protocollo non è impostato.
THRIFT	Utilizza il protocollo Apache Thrift precedente per l'endpoint del servizio Metastore.
GRPC	Utilizza il protocollo gRPC modernizzato per l'endpoint del servizio Metastore.

KerberosConfig

Informazioni di configurazione per un'entità Kerberos.

Campi
keytab	Secret Un file keytab Kerberos che può essere utilizzato per autenticare un'entità di servizio con un KDC (Key Distribution Center) Kerberos.
principal	string Un'entità Kerberos esistente sia nel file keytab sia nel KDC per l'autenticazione. Un'entità tipica ha la forma primary/instance@REALM, ma non esiste un formato esatto.
krb5_config_gcs_uri	string Un URI Cloud Storage che specifica il percorso di un file krb5.conf. È nel formato gs://{bucket_name}/path/to/krb5.conf, anche se il file non deve essere chiamato krb5.conf in modo esplicito.

Lake

Rappresenta una risorsa Lake

Campi
name	string Il nome della risorsa Lake. Esempio: projects/{project_number}/locations/{location_id}/lakes/{lake_id}

LatestBackup

I dettagli dell'ultimo backup pianificato.

Campi
backup_id	string Solo output. L'ID di un backup pianificato in corso. Vuoto se non è in corso alcun backup.
start_time	Timestamp Solo output. L'ora di inizio del backup.
state	State Solo output. Lo stato attuale del backup.
duration	Duration Solo output. La durata del completamento del backup.

Stato

Lo stato attuale del backup.

Enum
STATE_UNSPECIFIED	Lo stato del backup è sconosciuto.
IN_PROGRESS	Il backup è in corso.
SUCCEEDED	Il backup è stato completato.
FAILED	Il backup non è riuscito.

LimitConfig

Rappresenta la configurazione del limite di scalabilità automatica di un servizio Metastore.

Campi
max_scaling_factor	float Facoltativo. Il fattore di scalabilità più elevato a cui deve essere applicata la scalabilità automatica del servizio.
min_scaling_factor	float Facoltativo. Il fattore di scalabilità più basso a cui deve essere applicato il ridimensionamento automatico del servizio.

ListBackupsRequest

Richiedi messaggio per DataprocMetastore.ListBackups.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa del servizio di cui elencare i backup, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/backups. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.backups.list
page_size	int32 Facoltativo. Il numero massimo di backup da restituire. La risposta potrebbe contenere meno del numero massimo. Se non specificato, non vengono restituiti più di 500 backup. Il valore massimo è 1000; i valori superiori a 1000 vengono modificati in 1000.
page_token	string Facoltativo. Un token di pagina ricevuto da una chiamata DataprocMetastore.ListBackups precedente. Fornisci questo token per recuperare la pagina successiva. Per recuperare la prima pagina, fornisci un token di pagina vuoto. Quando viene applicata la paginazione, gli altri parametri forniti a DataprocMetastore.ListBackups devono corrispondere alla chiamata che ha fornito il token pagina.
filter	string Facoltativo. Il filtro da applicare ai risultati dell'elenco.
order_by	string Facoltativo. Specifica l'ordinamento dei risultati come descritto in Ordine di ordinamento. Se non viene specificato, i risultati verranno ordinati nell'ordine predefinito.

ListBackupsResponse

Messaggio di risposta per DataprocMetastore.ListBackups.

Campi
backups[]	Backup I backup del servizio specificato.
next_page_token	string Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
unreachable[]	string Sedi che non è stato possibile raggiungere.

ListFederationsRequest

Messaggio di richiesta per ListFederations.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa alla posizione delle federazioni di metastore da elencare, nel seguente formato: projects/{project_number}/locations/{location_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.federations.list
page_size	int32 Facoltativo. Il numero massimo di federazioni da restituire. La risposta potrebbe contenere meno del numero massimo. Se non specificato, non vengono restituiti più di 500 servizi. Il valore massimo è 1000; i valori superiori a 1000 vengono modificati in 1000.
page_token	string Facoltativo. Un token di pagina ricevuto da una precedente chiamata ListFederationServices. Fornisci questo token per recuperare la pagina successiva. Per recuperare la prima pagina, fornisci un token di pagina vuoto. Quando esegui la paginazione, gli altri parametri forniti a ListFederationServices devono corrispondere alla chiamata che ha fornito il token pagina.
filter	string Facoltativo. Il filtro da applicare ai risultati dell'elenco.
order_by	string Facoltativo. Specifica l'ordinamento dei risultati come descritto in Ordine di ordinamento. Se non viene specificato, i risultati verranno ordinati nell'ordine predefinito.

ListFederationsResponse

Messaggio di risposta per ListFederations

Campi
federations[]	Federation I servizi nella località specificata.
next_page_token	string Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
unreachable[]	string Sedi che non è stato possibile raggiungere.

ListMetadataImportsRequest

Richiedi messaggio per DataprocMetastore.ListMetadataImports.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa del servizio di cui vuoi elencare i metadati importati, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/metadataImports. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.imports.list
page_size	int32 Facoltativo. Il numero massimo di importazioni da restituire. La risposta potrebbe contenere meno del numero massimo. Se non specificato, non vengono restituite più di 500 importazioni. Il valore massimo è 1000; i valori superiori a 1000 vengono modificati in 1000.
page_token	string Facoltativo. Un token di pagina ricevuto da una chiamata DataprocMetastore.ListServices precedente. Fornisci questo token per recuperare la pagina successiva. Per recuperare la prima pagina, fornisci un token di pagina vuoto. Quando viene applicata la paginazione, gli altri parametri forniti a DataprocMetastore.ListServices devono corrispondere alla chiamata che ha fornito il token pagina.
filter	string Facoltativo. Il filtro da applicare ai risultati dell'elenco.
order_by	string Facoltativo. Specifica l'ordinamento dei risultati come descritto in Ordine di ordinamento. Se non viene specificato, i risultati verranno ordinati nell'ordine predefinito.

ListMetadataImportsResponse

Messaggio di risposta per DataprocMetastore.ListMetadataImports.

Campi
metadata_imports[]	MetadataImport Le importazioni nel servizio specificato.
next_page_token	string Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
unreachable[]	string Sedi che non è stato possibile raggiungere.

ListMigrationExecutionsRequest

Richiedi messaggio per DataprocMetastore.ListMigrationExecutions.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa del servizio di cui elencare le esecuzioni di migrazione, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.migrations.list
page_size	int32 Facoltativo. Il numero massimo di esecuzioni di migrazione da restituire. La risposta potrebbe contenere meno del numero massimo. Se non specificato, non vengono restituite più di 500 esecuzioni di migrazione. Il valore massimo è 1000; i valori superiori a 1000 vengono modificati in 1000.
page_token	string Facoltativo. Un token di pagina ricevuto da una chiamata DataprocMetastore.ListMigrationExecutions precedente. Fornisci questo token per recuperare la pagina successiva. Per recuperare la prima pagina, fornisci un token di pagina vuoto. Quando viene applicata la paginazione, gli altri parametri forniti a DataprocMetastore.ListMigrationExecutions devono corrispondere alla chiamata che ha fornito il token pagina.
filter	string Facoltativo. Il filtro da applicare ai risultati dell'elenco.
order_by	string Facoltativo. Specifica l'ordinamento dei risultati come descritto in Ordine di ordinamento. Se non viene specificato, i risultati verranno ordinati nell'ordine predefinito.

ListMigrationExecutionsResponse

Messaggio di risposta per DataprocMetastore.ListMigrationExecutions.

Campi
migration_executions[]	MigrationExecution Le esecuzioni della migrazione sul servizio specificato.
next_page_token	string Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
unreachable[]	string Sedi che non è stato possibile raggiungere.

ListServicesRequest

Richiedi messaggio per DataprocMetastore.ListServices.

Campi
parent	string Obbligatorio. Il nome della risorsa relativa della posizione dei servizi metastore da elencare, nel seguente formato: projects/{project_number}/locations/{location_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent: metastore.services.list
page_size	int32 Facoltativo. Il numero massimo di servizi da restituire. La risposta potrebbe contenere meno del numero massimo. Se non specificato, non vengono restituiti più di 500 servizi. Il valore massimo è 1000; i valori superiori a 1000 vengono modificati in 1000.
page_token	string Facoltativo. Un token di pagina ricevuto da una chiamata DataprocMetastore.ListServices precedente. Fornisci questo token per recuperare la pagina successiva. Per recuperare la prima pagina, fornisci un token di pagina vuoto. Quando viene applicata la paginazione, gli altri parametri forniti a DataprocMetastore.ListServices devono corrispondere alla chiamata che ha fornito il token pagina.
filter	string Facoltativo. Il filtro da applicare ai risultati dell'elenco.
order_by	string Facoltativo. Specifica l'ordinamento dei risultati come descritto in Ordine di ordinamento. Se non viene specificato, i risultati verranno ordinati nell'ordine predefinito.

ListServicesResponse

Messaggio di risposta per DataprocMetastore.ListServices.

Campi
services[]	Service I servizi nella località specificata.
next_page_token	string Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
unreachable[]	string Sedi che non è stato possibile raggiungere.

LocationMetadata

Metadati relativi al servizio in una località.

Campi
supported_hive_metastore_versions[]	HiveMetastoreVersion Le versioni di Hive Metastore che possono essere utilizzate per creare un nuovo servizio metastore in questa posizione. Il server garantisce che esattamente un HiveMetastoreVersion nell'elenco imposterà is_default.
multi_region_metadata	MultiRegionMetadata I metadati multiregione se la regione corrente è multiregione.
custom_region_metadata[]	CustomRegionMetadata Possibili configurazioni supportate se la regione corrente è una regione personalizzata.

CustomRegionMetadata

Metadati relativi a una regione personalizzata. Viene compilato solo se la regione è una regione personalizzata. Per le regioni singole/multi, sarà vuoto.

Campi
required_read_write_regions[]	string Le regioni di lettura/scrittura per questa regione personalizzata.
optional_read_only_regions[]	string Le regioni di sola lettura per questa regione personalizzata.
witness_region	string La regione di attendibilità Spanner per questa regione personalizzata.

HiveMetastoreVersion

Una specifica di una versione supportata del software Hive Metastore.

Campi
version	string La versione semantica del software Hive Metastore.
is_default	bool Indica se version verrà scelto dal server se viene creato un servizio metastore con un HiveMetastoreConfig che omette version.

MultiRegionMetadata

I metadati della regione multipla che include le regioni costituenti. I metadati vengono compilati solo se la regione è multiregione. Per una singola regione o una regione doppia personalizzata, sarà vuoto.

Campi
constituent_regions[]	string Le regioni che costituiscono la multiregione.

MaintenanceWindow

Periodo di manutenzione. Specifica quando Dataproc Metastore può eseguire l'operazione di manutenzione del sistema per il servizio.

Campi
hour_of_day	Int32Value L'ora del giorno (0-23) in cui inizia la finestra.
day_of_week	DayOfWeek Il giorno della settimana in cui inizia la finestra.

MetadataExport

I dettagli di un'operazione di esportazione dei metadati.

Campi
start_time	Timestamp Solo output. L'ora di inizio dell'esportazione.
end_time	Timestamp Solo output. L'ora di fine dell'esportazione.
state	State Solo output. Lo stato attuale dell'esportazione.
database_dump_type	Type Solo output. Il tipo di dump del database.
Campo unione destination. destination può essere solo uno dei seguenti:
destination_gcs_uri	string Solo output. Un URI Cloud Storage di una cartella in cui vengono esportati i metadati, sotto forma di gs://<bucket_name>/<path_inside_bucket>/<export_folder>, dove <export_folder> viene generato automaticamente.

Stato

Lo stato attuale dell'esportazione dei metadati.

Enum
STATE_UNSPECIFIED	Lo stato dell'esportazione dei metadati è sconosciuto.
RUNNING	L'esportazione dei metadati è in esecuzione.
SUCCEEDED	L'esportazione dei metadati è stata completata correttamente.
FAILED	L'esportazione dei metadati non è riuscita.
CANCELLED	L'esportazione dei metadati è annullata.

MetadataImport

Una risorsa metastore che importa i metadati.

Campi
name	string Immutabile. Il nome della risorsa relativa dell'importazione dei metadati, del tipo: projects/{project_number}/locations/{location_id}/services/{service_id}/metadataImports/{metadata_import_id}.
description	string La descrizione dell'importazione dei metadati.
create_time	Timestamp Solo output. L'ora in cui è stata avviata l'importazione dei metadati.
update_time	Timestamp Solo output. L'ora dell'ultimo aggiornamento dell'importazione dei metadati.
end_time	Timestamp Solo output. L'ora in cui è terminata l'importazione dei metadati.
state	State Solo output. Lo stato attuale dell'importazione dei metadati.
Campo unione metadata. I metadati da importare. metadata può essere solo uno dei seguenti:
database_dump	DatabaseDump Immutabile. Un dump del database di un database di metastore preesistente.

DatabaseDump

Una specifica della posizione e dei metadati di un dump del database da un sistema di gestione di database relazionali.

Campi
database_type (deprecated)	DatabaseType Questo elemento è deprecato. Il tipo di database.
gcs_uri	string Un URI di un oggetto o di una cartella Cloud Storage che specifica l'origine da cui importare i metadati. Deve iniziare con gs://.
source_database (deprecated)	string Questo elemento è deprecato. Il nome del database di origine.
type	Type Facoltativo. Il tipo di dump del database. Se non specificato, il valore predefinito è MYSQL.

DatabaseType

Il tipo di database.

Enum
DATABASE_TYPE_UNSPECIFIED	Il tipo di database di origine è sconosciuto.
MYSQL	Il tipo di database di origine è MySQL.

Stato

Lo stato attuale dell'importazione dei metadati.

Enum
STATE_UNSPECIFIED	Lo stato dell'importazione dei metadati è sconosciuto.
RUNNING	L'importazione dei metadati è in esecuzione.
SUCCEEDED	L'importazione dei metadati è stata completata correttamente.
UPDATING	L'importazione dei metadati è in corso di aggiornamento.
FAILED	L'importazione dei metadati non è riuscita e le modifiche ai metadati tentate sono state annullate.

MetadataIntegration

Specifica come i metadati del metastore devono essere integrati con i servizi esterni.

Campi
data_catalog_config	DataCatalogConfig Facoltativo. La configurazione di integrazione per il servizio Data Catalog.
dataplex_config	DataplexConfig La configurazione di integrazione per il servizio Dataplex.

MetadataManagementActivity

Le attività di gestione dei metadati del servizio metastore.

Campi
metadata_exports[]	MetadataExport Solo output. Le ultime esportazioni dei metadati del servizio Metastore.
restores[]	Restore Solo output. Gli ultimi ripristini del servizio metastore.

MigrationExecution

I dettagli di una risorsa di esecuzione della migrazione.

Campi
name	string Solo output. Il nome della risorsa relativa dell'esecuzione della migrazione, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}
create_time	Timestamp Solo output. L'ora in cui è stata avviata l'esecuzione della migrazione.
end_time	Timestamp Solo output. L'ora in cui è terminata l'esecuzione della migrazione.
state	State Solo output. Lo stato attuale dell'esecuzione della migrazione.
phase	Phase Solo output. La fase corrente dell'esecuzione della migrazione.
state_message	string Solo output. Ulteriori informazioni sullo stato attuale dell'esecuzione della migrazione.
Campo unione migration_config. Le informazioni di configurazione richieste da Dataproc Metastore per avviare il processo di migrazione migration_config possono essere solo una delle seguenti:
cloud_sql_migration_config	CloudSQLMigrationConfig Informazioni di configurazione specifiche per la migrazione da metastore Hive autogestito su Google Cloud che utilizza Cloud SQL come database di backend a Dataproc Metastore.

CloudSQLMigrationConfig

Informazioni di configurazione per la migrazione da metastore Hive autogestito su Google Cloud che utilizza Cloud SQL come database di backend a Dataproc Metastore.

Campi
cdc_config	CdcConfig Obbligatorio. Informazioni sulla configurazione per avviare gli stream Change Data Capture (CDC) dal database del cliente al database di backend di Dataproc Metastore. Dataproc Metastore passa all'utilizzo del proprio database di backend dopo la fase di cutover della migrazione.
cloud_sql_connection_config	CloudSQLConnectionConfig Obbligatorio. Informazioni sulla configurazione per stabilire la connessione al database del cliente prima della fase di cutover della migrazione

CdcConfig

Informazioni sulla configurazione per avviare gli stream Change Data Capture (CDC) dal database del cliente al database di backend di Dataproc Metastore.

Campi
vpc_network	string Obbligatorio. Nome completo della rete VPC dell'istanza Cloud SQL o della rete VPC condivisa in cui Datastream eseguirà il peering, nel seguente formato: projects/{project_id}/locations/global/networks/{network_id}. Per ulteriori informazioni, consulta https://cloud.google.com/datastream/docs/network-connectivity-options#privateconnectivity
subnet_ip_range	string Obbligatorio. Un intervallo IP CIDR /29 per il peering con Datastream.
username	string Obbligatorio. Il nome utente che il servizio Datastream deve utilizzare per la connessione MySQL.
password	string Obbligatorio. Solo input. La password per l'utente che il servizio Datastream deve utilizzare per la connessione MySQL. Questo campo non viene restituito su richiesta.
reverse_proxy_subnet	string Obbligatorio. L'URL della risorsa della subnet in cui creare l'istanza VM che ospita il reverse proxy. Per ulteriori informazioni, consulta https://cloud.google.com/datastream/docs/private-connectivity#reverse-csql-proxy. La subnet deve trovarsi nella rete indicata nella richiesta in cui Datastream eseguirà il peering e deve trovarsi nella stessa regione di Datastream, nel seguente formato. projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}
bucket	string Facoltativo. Il bucket in cui scrivere i dati sugli eventi dello stream intermedio. Il nome del bucket non deve avere prefissi come "gs://". Consulta i requisiti per i nomi dei bucket. Questo campo è facoltativo. Se non impostato, verrà utilizzato il bucket Cloud Storage degli artefatti.
root_path	string Facoltativo. Il percorso principale all'interno del bucket Cloud Storage. I dati sugli eventi dello stream verranno scritti in questo percorso. Il valore predefinito è /migration.

CloudSQLConnectionConfig

Informazioni sulla configurazione per stabilire la connessione al database del cliente prima della fase di cutover della migrazione

Campi
instance_connection_name	string Obbligatorio. Nome della connessione al database Cloud SQL (project_id:region:instance_name)
ip_address	string Obbligatorio. L'indirizzo IP privato dell'istanza Cloud SQL.
port	int32 Obbligatorio. La porta di rete del database.
hive_database_name	string Obbligatorio. Il nome del database Hive.
username	string Obbligatorio. Il nome utente che il servizio Dataproc Metastore utilizzerà per connettersi al database.
password	string Obbligatorio. Solo input. La password per l'utente che il servizio Dataproc Metastore utilizzerà per connettersi al database. Questo campo non viene restituito su richiesta.
proxy_subnet	string Obbligatorio. Il nome della risorsa relativa della subnet in cui eseguire il deployment del servizio di proxy SOCKS5. La subnet deve trovarsi in una rete tramite la quale è accessibile l'istanza Cloud SQL. Il nome della risorsa deve essere nel formato projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}
nat_subnet	string Obbligatorio. Il nome della risorsa relativa della subnet da utilizzare per Private Service Connect. Tieni presente che non può essere una subnet normale e che viene utilizzata solo per NAT. (https://cloud.google.com/vpc/docs/about-vpc-hosted-services#psc-subnets) Questa subnet viene utilizzata per pubblicare il servizio di proxy SOCKS5. La dimensione della subnet deve essere almeno /29 e deve trovarsi in una rete tramite la quale è accessibile l'istanza Cloud SQL. Il nome della risorsa deve essere nel formato projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}

Fase

La fase corrente dell'esecuzione della migrazione.

Enum
PHASE_UNSPECIFIED	La fase di esecuzione della migrazione è sconosciuta.
REPLICATION	La fase di replica si riferisce alla fase di migrazione in cui Dataproc Metastore esegue una pipeline per replicare le modifiche nel database del cliente nel suo database di backend. Durante questa fase, Dataproc Metastore utilizza il database del cliente come database di backend del metastore Hive.
CUTOVER	La fase di cutover si riferisce alla fase di migrazione in cui Dataproc Metastore passa all'utilizzo del proprio database di backend. La migrazione entra in questa fase quando il cliente ha completato la migrazione di tutti i cluster/workload a Dataproc Metastore e attiva CompleteMigration.

Stato

Lo stato attuale dell'esecuzione della migrazione.

Enum
STATE_UNSPECIFIED	Lo stato di esecuzione della migrazione è sconosciuto.
STARTING	L'esecuzione della migrazione sta per iniziare.
RUNNING	L'esecuzione della migrazione è in corso.
CANCELLING	L'esecuzione della migrazione è in fase di annullamento.
AWAITING_USER_ACTION	L'esecuzione della migrazione è in attesa di un'azione dell'utente.
SUCCEEDED	L'esecuzione della migrazione è stata completata correttamente.
FAILED	L'esecuzione della migrazione non è riuscita.
CANCELLED	L'esecuzione della migrazione viene annullata.
DELETING	L'esecuzione della migrazione è in fase di eliminazione.

MoveTableToDatabaseRequest

Richiedi messaggio per DataprocMetastore.MoveTableToDatabase.

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio metastore per modificare i metadati, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.services.mutateMetadata
table_name	string Obbligatorio. Il nome della tabella da spostare.
db_name	string Obbligatorio. Il nome del database in cui si trova la tabella.
destination_db_name	string Obbligatorio. Il nome del database in cui spostare la tabella.

MoveTableToDatabaseResponse

Questo tipo non contiene campi.

Messaggio di risposta per DataprocMetastore.MoveTableToDatabase.

MultiRegionConfig

La configurazione multiregione per il servizio Dataproc Metastore.

Campi
certificates[] (deprecated)	RootCACertificate Questo elemento è deprecato. Solo output. L'elenco dei certificati CA radice utilizzati da un client gRPC per connettersi a un servizio Dataproc Metastore multiregionale.
custom_region_config	CustomRegionConfig

CustomRegionConfig

Configurazione personalizzata utilizzata per specificare le regioni in cui viene eseguito il servizio Metastore. Al momento è supportato solo nella regione multipla us.

Campi
read_write_regions[]	string Obbligatorio. L'elenco delle regioni di lettura/scrittura in cui viene eseguito il servizio metastore. Queste regioni devono far parte (o essere un sottoinsieme) della regione multipla.
read_only_regions[]	string Facoltativo. L'elenco delle regioni di sola lettura in cui viene eseguito il servizio Metastore. Queste regioni devono far parte (o essere un sottoinsieme) della regione multipla.

RootCACertificate

Questo elemento è deprecato.

Un client gRPC deve installare tutti i certificati CA radice per connettersi a un servizio Dataproc Metastore multiregionale e realizzare il failover.

Campi
certificate (deprecated)	string Questo elemento è deprecato. Il certificato CA radice in formato PEM. La lunghezza massima è 65536 byte.
expiration_time (deprecated)	Timestamp Questo elemento è deprecato. La data e l'ora di scadenza del certificato in formato timestamp.

NetworkConfig

Configurazione di rete per il servizio Dataproc Metastore.

Campi
consumers[]	Consumer Immutabile. La configurazione di rete lato consumer per l'istanza Dataproc Metastore.
custom_routes_enabled	bool Consente di importare ed esportare route personalizzate per la rete VPC in peering del servizio Dataproc Metastore.

Consumer

Contiene informazioni sulle configurazioni di rete del cliente.

Campi
endpoint_uri	string Solo output. L'URI dell'endpoint utilizzato per accedere al servizio Metastore.
endpoint_location	string Solo output. La posizione dell'URI dell'endpoint. Formato: projects/{project}/locations/{location}.
Campo unione vpc_resource. vpc_resource può essere solo uno dei seguenti:
subnetwork	string Immutabile. La sottorete del progetto del cliente da cui viene riservato un indirizzo IP e utilizzato come endpoint del servizio Dataproc Metastore. È accessibile agli host nella subnet e a tutti gli host in una subnet nella stessa regione e nella stessa rete. Nell'intervallo principale della subnet deve essere disponibile almeno un indirizzo IP. La subnet è specificata nel seguente formato: projects/{project_number}/regions/{region_id}/subnetworks/{subnetwork_id}

OperationMetadata

Rappresenta i metadati di un'operazione a lunga esecuzione.

Campi
create_time	Timestamp Solo output. L'ora in cui è stata creata l'operazione.
end_time	Timestamp Solo output. L'ora in cui è terminata l'esecuzione dell'operazione.
target	string Solo output. Percorso della risorsa definito dal server per il target dell'operazione.
verb	string Solo output. Nome del verbo eseguito dall'operazione.
status_message	string Solo output. Stato dell'operazione, se presente, leggibile da un utente.
requested_cancellation	bool Solo output. Indica se il chiamante ha richiesto l'annullamento dell'operazione. Le operazioni annullate correttamente hanno un valore [Operation.error][] con un google.rpc.Status.code pari a 1, corrispondente a Code.CANCELLED.
api_version	string Solo output. Versione dell'API utilizzata per avviare l'operazione.

QueryMetadataRequest

Richiedi messaggio per DataprocMetastore.QueryMetadata.

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio metastore per eseguire query sui metadati, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.services.queryMetadata
query	string Obbligatorio. Una query SQL di sola lettura da eseguire sul database dei metadati. La query non può modificare o mutare i dati.

QueryMetadataResponse

Messaggio di risposta per DataprocMetastore.QueryMetadata.

Campi
result_manifest_uri	string L'URI manifest è un link a un'istanza JSON in Cloud Storage. Questa istanza viene visualizzata immediatamente insieme a QueryMetadataResponse. I contenuti dell'URI non possono essere recuperati finché non termina la query dell'operazione a lungo termine sui metadati.

RemoveIamPolicyRequest

Richiedi messaggio per DataprocMetastore.RemoveIamPolicy.

Campi
resource	string Obbligatorio. Il nome della risorsa relativa della risorsa del piano dati da cui rimuovere il criterio IAM, nel seguente 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 Facoltativo. Rimuove il criterio IAM associato al database o alla tabella in modo asincrono quando è impostato. Il valore predefinito è false.

RemoveIamPolicyResponse

Messaggio di risposta per DataprocMetastore.RemoveIamPolicy.

Campi
success	bool Vero se il criterio viene rimosso correttamente.

Ripristina

I dettagli di un'operazione di ripristino dei metadati.

Campi
start_time	Timestamp Solo output. L'ora di inizio del ripristino.
end_time	Timestamp Solo output. L'ora di fine del ripristino.
state	State Solo output. Lo stato attuale del ripristino.
backup	string Solo output. Il nome della risorsa relativa del backup del servizio Metastore da cui eseguire il ripristino, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
type	RestoreType Solo output. Il tipo di ripristino.
details	string Solo output. I dettagli del ripristino contenenti la revisione del servizio di destinazione del ripristino, in formato JSON.
backup_location	string Facoltativo. Un URI Cloud Storage che specifica la posizione in cui sono archiviati gli elementi di backup, nel formato gs://<bucket_name>/<path_inside_bucket>.

RestoreType

Il tipo di ripristino. Se non specificato, il valore predefinito è METADATA_ONLY.

Enum
RESTORE_TYPE_UNSPECIFIED	Il tipo di ripristino è sconosciuto.
FULL	I metadati e la configurazione del servizio vengono ripristinati.
METADATA_ONLY	Vengono ripristinati solo i metadati del servizio.

Stato

Lo stato attuale del ripristino.

Enum
STATE_UNSPECIFIED	Lo stato del ripristino dei metadati è sconosciuto.
RUNNING	Il ripristino dei metadati è in corso.
SUCCEEDED	Il ripristino dei metadati è stato completato correttamente.
FAILED	Il ripristino dei metadati non è riuscito.
CANCELLED	Il ripristino dei metadati è stato annullato.

RestoreServiceRequest

Messaggio di richiesta per [DataprocMetastore.Restore][].

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio Metastore per eseguire il ripristino, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.services.restore
backup	string Facoltativo. Il nome della risorsa relativa del backup del servizio Metastore da cui eseguire il ripristino, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}. Esclusivamente compatibile con backup_location ed è necessario impostare esattamente uno dei due. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata backup: metastore.backups.use
backup_location	string Facoltativo. Un URI Cloud Storage che specifica la posizione degli elementi di backup, ovvero i file avro di backup in "avro/", backup_metastore.json e service.json, nel seguente formato: gs://<path_to_backup>. Esclusivamente compatibile con backup ed è necessario impostare esattamente uno dei due.
restore_type	RestoreType Facoltativo. Il tipo di ripristino. Se non specificato, il valore predefinito è METADATA_ONLY.
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

ScalingConfig

Rappresenta la configurazione di scalabilità di un servizio metastore.

Campi
autoscaling_config	AutoscalingConfig Facoltativo. La configurazione della scalabilità automatica.
Campo unione scaling_model. Rappresenta una dimensione dell'istanza predeterminata o un fattore di scalabilità numerico. scaling_model può essere solo uno dei seguenti:
instance_size	InstanceSize Un enum di dimensioni di istanze leggibili, con ogni dimensione di istanza associata a un valore float (ad es. InstanceSize.EXTRA_SMALL = scaling_factor(0.1))
scaling_factor	float Fattore di scala, incrementi di 0,1 per valori inferiori a 1,0 e incrementi di 1,0 per valori superiori a 1,0.

InstanceSize

Dimensioni delle istanze Metastore.

Enum
INSTANCE_SIZE_UNSPECIFIED	Dimensioni istanza non specificate
EXTRA_SMALL	Dimensioni dell'istanza extra small, mappate a un fattore di scalabilità di 0,1.
SMALL	Dimensioni piccole dell'istanza, mappate a un fattore di scalabilità di 0,5.
MEDIUM	Dimensioni dell'istanza medie, mappate a un fattore di scalabilità di 1,0.
LARGE	Dimensioni dell'istanza grandi, mappate a un fattore di scalabilità di 3,0.
EXTRA_LARGE	Dimensioni dell'istanza extra large, mappate a un fattore di scalabilità di 6,0.

ScheduledBackup

Specifica la configurazione del backup pianificato.

Campi
enabled	bool Facoltativo. Definisce se il backup pianificato è abilitato. Il valore predefinito è false.
cron_schedule	string Facoltativo. L'intervallo pianificato in formato CRON, consulta https://it.wikipedia.org/wiki/Cron. Il valore predefinito è vuoto: il backup pianificato non è abilitato. Deve essere specificato per abilitare i backup pianificati.
time_zone	string Facoltativo. Specifica il fuso orario da utilizzare per l'interpretazione di cron_schedule. Deve essere il nome di un fuso orario del database dei fusi orari (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), ad esempio America/Los_Angeles o Africa/Abidjan. Se non viene specificato, il valore predefinito è UTC.
next_scheduled_time	Timestamp Solo output. L'ora pianificata per l'inizio della successiva esecuzione dei backup.
backup_location	string Facoltativo. Un URI Cloud Storage di una cartella, nel formato gs://<bucket_name>/<path_inside_bucket>. Sotto questa cartella verrà archiviata una sottocartella <backup_folder> contenente i file di backup.
latest_backup	LatestBackup Solo output. I dettagli dell'ultimo backup pianificato.

Secret

Un valore archiviato in modo sicuro.

Campi
Campo unione value. value può essere solo uno dei seguenti:
cloud_secret	string Il nome della risorsa relativa di una versione del secret di Secret Manager, nel seguente formato: projects/{project_number}/secrets/{secret_id}/versions/{version_id}.

Servizio

Un servizio Metastore gestito che gestisce le query sui metadati.

Campi
name	string Immutabile. Il nome della risorsa relativa del servizio metastore, nel seguente formato: projects/{project_number}/locations/{location_id}/services/{service_id}.
create_time	Timestamp Solo output. L'ora in cui è stato creato il servizio Metastore.
update_time	Timestamp Solo output. La data e l'ora dell'ultimo aggiornamento del servizio metastore.
labels	map<string, string> Etichette definite dall'utente per il servizio Metastore.
network	string Immutabile. Il nome della risorsa relativa della rete VPC a cui è possibile accedere all'istanza. È specificato nel seguente formato: projects/{project_number}/global/networks/{network_id}.
endpoint_uri	string Solo output. L'URI dell'endpoint utilizzato per accedere al servizio Metastore.
port	int32 La porta TCP su cui viene raggiunto il servizio Metastore. Valore predefinito: 9083.
state	State Solo output. Lo stato attuale del servizio metastore.
state_message	string Solo output. Ulteriori informazioni sullo stato attuale del servizio Metastore, se disponibili.
artifact_gcs_uri	string Solo output. Un URI Cloud Storage (che inizia con gs://) che specifica dove sono archiviati gli elementi correlati al servizio metastore.
tier	Tier Il livello del servizio.
metadata_integration	MetadataIntegration Facoltativo. L'impostazione che definisce in che modo i metadati del metastore devono essere integrati con servizi e sistemi esterni.
maintenance_window	MaintenanceWindow Il periodo di manutenzione di un'ora del servizio metastore. Questo specifica quando il servizio può essere riavviato per la manutenzione nel fuso orario UTC. La finestra di manutenzione non è necessaria per i servizi con il tipo di database SPANNER.
uid	string Solo output. L'identificatore di risorsa univoco globale del servizio metastore.
metadata_management_activity	MetadataManagementActivity Solo output. Le attività di gestione dei metadati del servizio metastore.
release_channel	ReleaseChannel Immutabile. Il canale di rilascio del servizio. Se non specificato, il valore predefinito è STABLE.
encryption_config	EncryptionConfig Immutabile. Informazioni utilizzate per configurare il servizio Dataproc Metastore per criptare i dati at-rest dei clienti. Impossibile aggiornare.
network_config	NetworkConfig La configurazione che specifica le impostazioni di rete per il servizio Dataproc Metastore.
database_type	DatabaseType Immutabile. Il tipo di database in cui il servizio Metastore archivia i dati.
telemetry_config	TelemetryConfig La configurazione che specifica le impostazioni di telemetria per il servizio Dataproc Metastore. Se non specificato, il valore predefinito è JSON.
scaling_config	ScalingConfig Configurazione della scalabilità del servizio Metastore.
multi_region_config	MultiRegionConfig Facoltativo. Specifica le informazioni di configurazione multi-regione per il servizio metastore Hive.
scheduled_backup	ScheduledBackup Facoltativo. La configurazione del backup pianificato per il servizio metastore.
deletion_protection	bool Facoltativo. Indica se il metastore Dataproc deve essere protetto da eliminazioni accidentali.
Campo unione metastore_config. Proprietà di configurazione specifiche per la tecnologia del servizio metastore sottostante (il software che gestisce le query del metastore). metastore_config può essere solo uno dei seguenti:
hive_metastore_config	HiveMetastoreConfig Informazioni di configurazione specifiche per l'esecuzione del software del metastore Hive come servizio del metastore.

DatabaseType

Il tipo di database di backend per il servizio Metastore.

Enum
DATABASE_TYPE_UNSPECIFIED	Il valore DATABASE_TYPE non è impostato.
MYSQL	MySQL viene utilizzato per mantenere i dati del metastore.
SPANNER	Spanner viene utilizzato per mantenere i dati del metastore.

ReleaseChannel

I canali di rilascio raggruppano funzionalità con diversi livelli di stabilità. Le funzionalità più recenti possono essere introdotte inizialmente in canali di rilascio meno stabili e possono essere promosse automaticamente in canali di rilascio più stabili.

Enum
RELEASE_CHANNEL_UNSPECIFIED	Il canale di rilascio non è specificato.
CANARY	Il canale di rilascio CANARY contiene le funzionalità più recenti, che potrebbero essere instabili e soggette a problemi non risolti senza soluzioni alternative note. I servizi che utilizzano il canale di rilascio CANARY non sono soggetti ad alcun SLA.
STABLE	Il canale di rilascio STABLE contiene funzionalità considerate stabili e convalidate per l'uso in produzione.

Stato

Lo stato attuale del servizio metastore.

Enum
STATE_UNSPECIFIED	Lo stato del servizio metastore è sconosciuto.
CREATING	Il servizio Metastore è in fase di creazione.
ACTIVE	Il servizio Metastore è in esecuzione ed è pronto per gestire le query.
SUSPENDING	Il servizio Metastore sta per essere sospeso. La disponibilità per l'invio di query potrebbe interrompersi in modo imprevisto.
SUSPENDED	Il servizio Metastore è sospeso e non è in grado di gestire le query.
UPDATING	Il servizio metastore è in fase di aggiornamento. Rimane utilizzabile, ma al momento non può accettare ulteriori richieste di aggiornamento né essere eliminato.
DELETING	Il servizio Metastore è in fase di eliminazione. Non può essere utilizzato.
ERROR	Il servizio metastore ha riscontrato un errore e non può essere utilizzato. Il servizio metastore deve essere eliminato.
AUTOSCALING	Il servizio Dataproc Metastore 2 è in fase di ridimensionamento.
MIGRATING	Il servizio metastore sta elaborando una migrazione gestita.

Livello

Livelli di servizio disponibili.

Enum
TIER_UNSPECIFIED	Il livello non è impostato.
DEVELOPER	Il livello sviluppatore offre una scalabilità limitata e nessuna tolleranza di errore. Ideale per proof of concept a basso costo.
ENTERPRISE	Il livello Enterprise offre alta disponibilità multizona e una scalabilità sufficiente per i workload Dataproc Metastore di livello enterprise.

StartMigrationRequest

Richiedi messaggio per DataprocMetastore.StartMigration.

Campi
service	string Obbligatorio. Il nome della risorsa relativa del servizio Metastore a cui avviare la migrazione, nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.migrations.start
migration_execution	MigrationExecution Obbligatorio. I dettagli di configurazione per la migrazione.
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

TelemetryConfig

Configurazione della telemetria per il servizio Dataproc Metastore.

Campi
log_format	LogFormat Il formato di output dei log del servizio Dataproc Metastore.

LogFormat

Enum
LOG_FORMAT_UNSPECIFIED	LOG_FORMAT non è impostato.
LEGACY	L'output dei log utilizza il formato legacy textPayload.
JSON	L'output della registrazione utilizza il formato jsonPayload.

UpdateFederationRequest

Messaggio di richiesta per UpdateFederation.

Campi
update_mask	FieldMask Obbligatorio. Una maschera di campo utilizzata per specificare i campi da sovrascrivere nella risorsa della federazione del metastore dall'aggiornamento. I campi specificati in update_mask sono relativi alla risorsa (non alla richiesta completa). Un campo viene sovrascritto se si trova nella maschera.
federation	Federation Obbligatorio. La federazione del metastore da aggiornare. Il server unisce i campi nel servizio solo se sono specificati in update_mask. Il campo name della federazione del metastore viene utilizzato per identificare il servizio metastore da aggiornare. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata federation: metastore.federations.update
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

UpdateMetadataImportRequest

Richiedi messaggio per DataprocMetastore.UpdateMetadataImport.

Campi
update_mask	FieldMask Obbligatorio. Una maschera di campo utilizzata per specificare i campi da sovrascrivere nella risorsa di importazione dei metadati dall'aggiornamento. I campi specificati in update_mask sono relativi alla risorsa (non alla richiesta completa). Un campo viene sovrascritto se si trova nella maschera.
metadata_import	MetadataImport Obbligatorio. L'importazione dei metadati da aggiornare. Il server unisce i campi nell'importazione solo se sono specificati in update_mask. Il campo name dell'importazione dei metadati viene utilizzato per identificare l'importazione del metastore da aggiornare. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata metadataImport: metastore.imports.update
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.

UpdateServiceRequest

Richiedi messaggio per DataprocMetastore.UpdateService.

Campi
update_mask	FieldMask Obbligatorio. Una maschera di campo utilizzata per specificare i campi da sovrascrivere nella risorsa del servizio Metastore dall'aggiornamento. I campi specificati in update_mask sono relativi alla risorsa (non alla richiesta completa). Un campo viene sovrascritto se si trova nella maschera.
service	Service Obbligatorio. Il servizio Metastore da aggiornare. Il server unisce i campi nel servizio solo se sono specificati in update_mask. Il campo name del servizio Metastore viene utilizzato per identificare il servizio Metastore da aggiornare. L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata service: metastore.services.update
request_id	string Facoltativo. Un ID richiesta. Specifica un ID richiesta univoco per consentire al server di ignorarla se è stata completata. Il server ignorerà le richieste successive che forniscono un ID richiesta duplicato per almeno 60 minuti dopo la prima richiesta. Ad esempio, se una richiesta iniziale scade, seguita da un'altra richiesta con lo stesso ID richiesta, il server ignora la seconda richiesta per evitare la creazione di impegni duplicati. L'ID richiesta deve essere un UUID valido. Un UUID pari a zero (00000000-0000-0000-0000-000000000000) non è supportato.