Package google.cloud.metastore.v1

Index

Dataproc Metastore

Configure et gère les services de métastore. Les services de métastore sont des déploiements de logiciels de gestion des métadonnées techniques OSS natifs, entièrement gérés, hautement disponibles, avec scaling et réparation automatiques. Chaque service de métadisque expose un point de terminaison réseau via lequel les requêtes de métadonnées sont diffusées. Les requêtes de métadonnées peuvent provenir de diverses sources, y compris Apache Hive, Apache Presto et Apache Spark.

L'API Dataproc Metastore définit le modèle de ressources suivant:

  • Le service fonctionne avec une collection de projets Google Cloud, nommés: /projects/*
  • Chaque projet comporte une collection d'emplacements disponibles, nommés /locations/* (un emplacement doit faire référence à un region Google Cloud).
  • Chaque emplacement possède un ensemble de services nommé /services/*.
  • Les services Dataproc Metastore sont des ressources dont le nom se présente sous la forme suivante:

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

AlterMetadataResourceLocation

rpc AlterMetadataResourceLocation(AlterMetadataResourceLocationRequest) returns (Operation)

Modifier l'emplacement de la ressource de métadonnées. La ressource de métadonnées peut être une base de données, une table ou une partition. Cette fonctionnalité ne met à jour que le répertoire parent de la ressource de métadonnées correspondante et ne transfère aucune donnée existante vers le nouvel emplacement.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

AlterTableProperties

rpc AlterTableProperties(AlterTablePropertiesRequest) returns (Operation)

Modifier les propriétés de la table de métadonnées

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CancelMigration

rpc CancelMigration(CancelMigrationRequest) returns (Operation)

Annule le processus de migration gérée en cours.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CompleteMigration

rpc CompleteMigration(CompleteMigrationRequest) returns (Operation)

Termine le processus de migration gérée. Le service Dataproc Metastore passera à l'utilisation de sa propre base de données de backend une fois la migration terminée.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateBackup

rpc CreateBackup(CreateBackupRequest) returns (Operation)

Crée une sauvegarde dans un projet et un emplacement donnés.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateMetadataImport

rpc CreateMetadataImport(CreateMetadataImportRequest) returns (Operation)

Crée une importation de métadonnées dans un projet et un emplacement donnés.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateService

rpc CreateService(CreateServiceRequest) returns (Operation)

Crée un service de metastore dans un projet et un emplacement.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteBackup

rpc DeleteBackup(DeleteBackupRequest) returns (Operation)

Supprime une seule sauvegarde.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteMigrationExecution

rpc DeleteMigrationExecution(DeleteMigrationExecutionRequest) returns (Operation)

Supprime une seule exécution de migration.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Operation)

Supprime un seul service.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ExportMetadata

rpc ExportMetadata(ExportMetadataRequest) returns (Operation)

Exporte les métadonnées d'un service.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetBackup

rpc GetBackup(GetBackupRequest) returns (Backup)

Récupère les détails d'une seule sauvegarde.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetMetadataImport

rpc GetMetadataImport(GetMetadataImportRequest) returns (MetadataImport)

Récupère les informations d'une seule importation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetMigrationExecution

rpc GetMigrationExecution(GetMigrationExecutionRequest) returns (MigrationExecution)

Récupère les détails d'une seule exécution de migration.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetService

rpc GetService(GetServiceRequest) returns (Service)

Récupère les détails d'un seul service.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListBackups

rpc ListBackups(ListBackupsRequest) returns (ListBackupsResponse)

Répertorie les sauvegardes d'un service.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListMetadataImports

rpc ListMetadataImports(ListMetadataImportsRequest) returns (ListMetadataImportsResponse)

Répertorie les importations dans un service.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListMigrationExecutions

rpc ListMigrationExecutions(ListMigrationExecutionsRequest) returns (ListMigrationExecutionsResponse)

Répertorie les exécutions de migration sur un service.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListServices

rpc ListServices(ListServicesRequest) returns (ListServicesResponse)

Répertorie les services d'un projet et d'un emplacement.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

MoveTableToDatabase

rpc MoveTableToDatabase(MoveTableToDatabaseRequest) returns (Operation)

Déplacer une table vers une autre base de données

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

QueryMetadata

rpc QueryMetadata(QueryMetadataRequest) returns (Operation)

Interrogez les métadonnées Dataproc Metastore.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

RestoreService

rpc RestoreService(RestoreServiceRequest) returns (Operation)

Restaure un service à partir d'une sauvegarde.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

StartMigration

rpc StartMigration(StartMigrationRequest) returns (Operation)

Lance le processus de migration gérée.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateMetadataImport

rpc UpdateMetadataImport(UpdateMetadataImportRequest) returns (Operation)

Met à jour une seule importation. Seul le champ de description de MetadataImport peut être mis à jour.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Operation)

Met à jour les paramètres d'un seul service.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DataprocMetastoreFederation

Configure et gère les services de fédération de métastore. Le service de fédération Dataproc Metastore permet de fédérer une collection de métastores backend tels que BigQuery, Dataplex Lakes et d'autres métastores Dataproc. Le service de fédération expose une URL gRPC via laquelle les métadonnées des métastores backend sont diffusées au moment de la requête.

L'API Dataproc Metastore Federation définit le modèle de ressources suivant: * Le service fonctionne avec un ensemble de projets Google Cloud. * Chaque projet dispose d'un ensemble d'emplacements disponibles. * Chaque emplacement dispose d'une collection de fédérations. * Les fédérations Dataproc Metastore sont des ressources dont le nom se présente sous la forme projects/{project_number}/locations/{location_id}/federations/{federation_id}.

CreateFederation

rpc CreateFederation(CreateFederationRequest) returns (Operation)

Crée une fédération de métastore dans un projet et un emplacement.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteFederation

rpc DeleteFederation(DeleteFederationRequest) returns (Operation)

Supprime une seule fédération.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetFederation

rpc GetFederation(GetFederationRequest) returns (Federation)

Récupère les détails d'une seule fédération.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListFederations

rpc ListFederations(ListFederationsRequest) returns (ListFederationsResponse)

Répertorie les fédérations d'un projet et d'un emplacement donnés.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateFederation

rpc UpdateFederation(UpdateFederationRequest) returns (Operation)

Met à jour les champs d'une fédération.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

AlterMetadataResourceLocationRequest

Message de requête pour DataprocMetastore.AlterMetadataResourceLocation.

Champs
service

string

Obligatoire. Nom de ressource relatif du service Metastore pour modifier les métadonnées, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.services.mutateMetadata
resource_name

string

Obligatoire. Nom de la ressource de métadonnées relatif au format suivant.

databases/{database_id}, databases/{database_id}/tables/{table_id} ou databases/{database_id}/tables/{table_id}/partitions/{partition_id}

location_uri

string

Obligatoire. Nouvel URI d'emplacement de la ressource de métadonnées.

AlterMetadataResourceLocationResponse

Ce type ne comporte aucun champ.

Message de réponse pour DataprocMetastore.AlterMetadataResourceLocation.

AlterTablePropertiesRequest

Message de requête pour DataprocMetastore.AlterTableProperties.

Champs
service

string

Obligatoire. Nom de ressource relatif du service Dataproc Metastore utilisé pour modifier les propriétés de la table de métadonnées, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.services.mutateMetadata
table_name

string

Obligatoire. Nom de la table contenant les propriétés que vous modifiez, au format suivant :

databases/{database_id}/tables/{table_id}

update_mask

FieldMask

Masque de champ spécifiant les propriétés de la table de métadonnées qui sont écrasées par la mise à jour. Les champs spécifiés dans update_mask sont relatifs à la ressource (et non à la requête complète). Un champ est écrasé s'il figure dans le masque.

Par exemple, avec les propriétés cibles suivantes:

properties {
  a: 1
  b: 2
}

Et des propriétés de mise à jour:

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

Si le masque de champ est:

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

Le résultat sera:

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

map<string, string>

Carte décrivant les valeurs souhaitées à modifier. Si "update_mask" est vide, les propriétés ne seront pas mises à jour. Sinon, les propriétés ne modifient que la valeur dont les chemins associés existent dans le masque de mise à jour.

AlterTablePropertiesResponse

Ce type ne comporte aucun champ.

Message de réponse pour DataprocMetastore.AlterTableProperties.

AutoscalingConfig

Représente la configuration d'autoscaling d'un service Metastore.

Champs
autoscaling_factor

float

Uniquement en sortie. Facteur de scaling d'un service avec l'autoscaling activé.

autoscaling_enabled

bool

Facultatif. Indique si l'autoscaling est activé pour ce service.

limit_config

LimitConfig

Facultatif. LimitConfig du service.

AuxiliaryVersionConfig

Informations de configuration pour les versions auxiliaires du service.

Champs
version

string

Version du métastore Hive du service auxiliaire. Elle doit être inférieure à la version du service de métastore Hive principal.

config_overrides

map<string, string>

Mappage des paires clé-valeur de configuration du métastore Hive à appliquer au métastore Hive auxiliaire (configuré dans hive-site.xml) en plus des remplacements de la version principale. Si des clés sont présentes à la fois dans les forçages de la version auxiliaire et dans ceux de la version principale, la valeur des forçages de la version auxiliaire est prioritaire.

network_config

NetworkConfig

Uniquement en sortie. La configuration réseau contient les URI de point de terminaison du service de métastore Hive auxiliaire.

BackendMetastore

Représente un métastore backend pour la fédération.

Champs
name

string

Nom de ressource relatif du métastore en cours de fédération. Vous trouverez ci-dessous les formats des noms de ressources relatifs pour les métastores actuellement compatibles:

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

MetastoreType

Type du métastore de backend.

MetastoreType

Type du métastore de backend.

Enums
METASTORE_TYPE_UNSPECIFIED Le type de métastore n'est pas défini.
BIGQUERY Le métastore backend est BigQuery.
DATAPROC_METASTORE Le métastore backend est Dataproc Metastore.

Sauvegarde

Détails d'une ressource de sauvegarde.

Champs
name

string

Immuable. Nom de ressource relatif de la sauvegarde, au format suivant:

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

create_time

Timestamp

Uniquement en sortie. Heure de début de la sauvegarde.

end_time

Timestamp

Uniquement en sortie. Heure à laquelle la sauvegarde a été créée.

state

State

Uniquement en sortie. État actuel de la sauvegarde.

service_revision

Service

Uniquement en sortie. Révision du service au moment de la sauvegarde.

description

string

Description de la sauvegarde.

restoring_services[]

string

Uniquement en sortie. Services en cours de restauration à partir de la sauvegarde

État

État actuel de la sauvegarde.

Enums
STATE_UNSPECIFIED L'état de la sauvegarde est inconnu.
CREATING La sauvegarde est en cours de création.
DELETING La sauvegarde est en cours de suppression.
ACTIVE La sauvegarde est active et prête à l'emploi.
FAILED La sauvegarde a échoué.
RESTORING La sauvegarde est en cours de restauration.

CancelMigrationRequest

Message de requête pour DataprocMetastore.CancelMigration.

Champs
service

string

Obligatoire. Nom de ressource relatif du service de métastore vers lequel annuler la migration en cours, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.migrations.cancel

CancelMigrationResponse

Message de réponse pour DataprocMetastore.CancelMigration.

Champs
migration_execution

string

Nom de ressource relatif de l'exécution de la migration, au format suivant:

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

CompleteMigrationRequest

Message de requête pour DataprocMetastore.CompleteMigration.

Champs
service

string

Obligatoire. Nom de ressource relatif du service de métastore vers lequel effectuer la migration, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.migrations.complete

CompleteMigrationResponse

Message de réponse pour DataprocMetastore.CompleteMigration.

Champs
migration_execution

string

Nom de ressource relatif de l'exécution de la migration, au format suivant:

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

CreateBackupRequest

Message de requête pour DataprocMetastore.CreateBackup.

Champs
parent

string

Obligatoire. Nom de ressource relatif du service dans lequel créer une sauvegarde, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.backups.create
backup_id

string

Obligatoire. ID de la sauvegarde, qui constitue le dernier composant du nom de la sauvegarde.

Cette valeur doit comporter entre 1 et 64 caractères, commencer par une lettre, se terminer par une lettre ou un chiffre, et être composée de caractères alphanumériques ASCII ou de traits d'union.

backup

Backup

Obligatoire. Sauvegarde à créer. Le champ name est ignoré. L'ID de la sauvegarde créée doit être fourni dans le champ backup_id de la requête.

request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

CreateFederationRequest

Message de requête pour CreateFederation.

Champs
parent

string

Obligatoire. Nom de ressource relatif de l'emplacement dans lequel créer un service de fédération, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.federations.create
federation_id

string

Obligatoire. ID de la fédération de métamagasins, qui est utilisé comme composant final du nom de la fédération de métamagasins.

Cette valeur doit comporter entre 2 et 63 caractères, commencer par une lettre, se terminer par une lettre ou un chiffre, et être composée de caractères ASCII alphanumériques ou de traits d'union.

federation

Federation

Obligatoire. Fédération Metastore à créer. Le champ name est ignoré. L'ID de la fédération de métamagasins créée doit être fourni dans le champ federation_id de la requête.

request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

CreateMetadataImportRequest

Message de requête pour DataprocMetastore.CreateMetadataImport.

Champs
parent

string

Obligatoire. Nom de ressource relatif du service dans lequel créer une importation Metastore, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.imports.create
metadata_import_id

string

Obligatoire. ID de l'importation de métadonnées, qui constitue le composant final du nom de l'importation de métadonnées.

Cette valeur doit comporter entre 1 et 64 caractères, commencer par une lettre, se terminer par une lettre ou un chiffre, et être composée de caractères alphanumériques ASCII ou de traits d'union.

metadata_import

MetadataImport

Obligatoire. Importation de métadonnées à créer. Le champ name est ignoré. L'ID de l'importation de métadonnées créée doit être fourni dans le champ metadata_import_id de la requête.

request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

CreateServiceRequest

Message de requête pour DataprocMetastore.CreateService.

Champs
parent

string

Obligatoire. Nom de ressource relatif de l'emplacement dans lequel créer un service Metastore, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.services.create
service_id

string

Obligatoire. ID du service Metastore, qui constitue le composant final du nom du service Metastore.

Cette valeur doit comporter entre 2 et 63 caractères, commencer par une lettre, se terminer par une lettre ou un chiffre, et être composée de caractères ASCII alphanumériques ou de traits d'union.

service

Service

Obligatoire. Service Metastore à créer. Le champ name est ignoré. L'ID du service de métastore créé doit être fourni dans le champ service_id de la requête.

request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

DataCatalogConfig

Spécifie comment les métadonnées Metastore doivent être intégrées au service Data Catalog.

Champs
enabled

bool

Facultatif. Indique si les métadonnées Metastore doivent être synchronisées avec Data Catalog. La valeur par défaut est la désactivation de la synchronisation des métadonnées Metastore avec Data Catalog.

DatabaseDumpSpec

Ce type ne comporte aucun champ.

Spécification du dump de base de données à partir duquel ou vers lequel importer ou exporter des données.

Type

Type du vidage de base de données.

Enums
TYPE_UNSPECIFIED Le type de vidage de la base de données est inconnu.
MYSQL Le fichier de vidage de la base de données est un fichier de vidage MySQL.
AVRO Le vidage de la base de données contient des fichiers Avro.

DeleteBackupRequest

Message de requête pour DataprocMetastore.DeleteBackup.

Champs
name

string

Obligatoire. Nom de ressource relatif de la sauvegarde à supprimer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.backups.delete
request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

DeleteFederationRequest

Message de requête pour DeleteFederation.

Champs
name

string

Obligatoire. Nom de ressource relatif de la fédération de métamagasins à supprimer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.federations.delete
request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

DeleteMigrationExecutionRequest

Message de requête pour DataprocMetastore.DeleteMigrationExecution.

Champs
name

string

Obligatoire. Nom de ressource relatif de la migrationExecution à supprimer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.migrations.delete
request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

DeleteServiceRequest

Message de requête pour DataprocMetastore.DeleteService.

Champs
name

string

Obligatoire. Nom de ressource relatif du service de métastore à supprimer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.services.delete
request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

EncryptionConfig

Paramètres de chiffrement du service.

Champs
kms_key

string

Nom complet de la clé Cloud KMS fournie par le client à utiliser pour le chiffrement des données client, au format suivant:

projects/{project_number}/locations/{location_id}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}.

ErrorDetails

Détails de l'erreur dans le message d'erreur public pour DataprocMetastore.QueryMetadata.

Champs
details

map<string, string>

Informations structurées supplémentaires sur cette erreur.

Les clés définissent les éléments de défaillance. La valeur décrit l'exception ou les détails de l'article.

ExportMetadataRequest

Message de requête pour DataprocMetastore.ExportMetadata.

Champs
service

string

Obligatoire. Nom de ressource relatif du service Metastore à exécuter pour l'exportation, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.services.export
request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

database_dump_type

Type

Facultatif. Type du vidage de base de données. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de MYSQL.

Champ d'union destination. Obligatoire. Destination vers laquelle les métadonnées sont exportées. destination ne peut être qu'un des éléments suivants :
destination_gcs_folder

string

URI Cloud Storage d'un dossier, au format gs://<bucket_name>/<path_inside_bucket>. Un sous-dossier <export_folder> contenant les fichiers exportés sera créé en dessous.

Fédération

Représente une fédération de plusieurs métamagasins backend.

Champs
name

string

Immuable. Nom de ressource relatif de la fédération, au format projects/{project_number}/locations/{location_id}/federations/{federation_id}`.

create_time

Timestamp

Uniquement en sortie. Heure à laquelle la fédération de métamagasins a été créée.

update_time

Timestamp

Uniquement en sortie. Heure de la dernière mise à jour de la fédération du métastore.

labels

map<string, string>

Étiquettes définies par l'utilisateur pour la fédération de metastore.

version

string

Immuable. Version du métastore Apache Hive de la fédération. Toutes les versions du métastore backend doivent être compatibles avec la version de la fédération.

backend_metastores

map<int32, BackendMetastore>

Mappage du classement BackendMetastore aux BackendMetastore à partir desquels le service de fédération diffuse des métadonnées au moment de la requête. La clé de mappage représente l'ordre dans lequel les BackendMetastore doivent être évalués pour résoudre les noms de base de données au moment de la requête. Elle doit être supérieure ou égale à zéro. Un BackendMetastore avec un numéro inférieur sera évalué avant un BackendMetastore avec un numéro supérieur.

endpoint_uri

string

Uniquement en sortie. Point de terminaison de la fédération.

state

State

Uniquement en sortie. État actuel de la fédération.

state_message

string

Uniquement en sortie. Informations supplémentaires sur l'état actuel de la fédération de métamagasins, si disponibles.

uid

string

Uniquement en sortie. Identifiant de ressource unique au niveau mondial de la fédération de métamagasins.

État

État actuel de la fédération.

Enums
STATE_UNSPECIFIED L'état de la fédération du métastore est inconnu.
CREATING La fédération de métamagasins est en cours de création.
ACTIVE La fédération de métamagasins est en cours d'exécution et prête à répondre aux requêtes.
UPDATING La fédération du métastore est en cours de mise à jour. Il reste utilisable, mais ne peut pas accepter de demandes de mise à jour supplémentaires ni être supprimé pour le moment.
DELETING La fédération du métastore est en cours de suppression. Il ne peut pas être utilisé.
ERROR Une erreur s'est produite lors de la fédération du métastore et celui-ci ne peut pas être utilisé. La fédération du métastore doit être supprimée.

GetBackupRequest

Message de requête pour DataprocMetastore.GetBackup.

Champs
name

string

Obligatoire. Nom de ressource relatif de la sauvegarde à récupérer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.backups.get

GetFederationRequest

Message de requête pour GetFederation.

Champs
name

string

Obligatoire. Nom de ressource relatif de la fédération de métamagasins à récupérer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.federations.get

GetMetadataImportRequest

Message de requête pour DataprocMetastore.GetMetadataImport.

Champs
name

string

Obligatoire. Nom de ressource relatif de l'importation de métadonnées à récupérer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.imports.get

GetMigrationExecutionRequest

Message de requête pour DataprocMetastore.GetMigrationExecution.

Champs
name

string

Obligatoire. Nom de ressource relatif de l'exécution de migration à récupérer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.migrations.get

GetServiceRequest

Message de requête pour DataprocMetastore.GetService.

Champs
name

string

Obligatoire. Nom de ressource relatif du service de métamagasin à récupérer, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • metastore.services.get

HiveMetastoreConfig

Spécifie les informations de configuration spécifiques à l'exécution du logiciel de métastore Hive en tant que service de métastore.

Champs
version

string

Immuable. Version du schéma du métastore Hive.

config_overrides

map<string, string>

Mappage des paires clé-valeur de configuration du metastore Hive à appliquer au metastore Hive (configuré dans hive-site.xml). Les mappages remplacent les valeurs par défaut du système (certaines clés ne peuvent pas être remplacées). Ces forçages sont également appliqués aux versions auxiliaires et peuvent être personnalisés davantage dans le fichier AuxiliaryVersionConfig de la version auxiliaire.

kerberos_config

KerberosConfig

Informations utilisées pour configurer le service de métastore Hive en tant que principal de service dans un domaine Kerberos. Pour désactiver Kerberos, utilisez la méthode UpdateService et spécifiez le chemin de ce champ (hive_metastore_config.kerberos_config) dans le update_mask de la requête, tout en omettant ce champ du service de la requête.

endpoint_protocol

EndpointProtocol

Protocole à utiliser pour le point de terminaison du service de metastore. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de THRIFT.

auxiliary_versions

map<string, AuxiliaryVersionConfig>

Mappage de la version du métastore Hive à la configuration de la version auxiliaire. Si cette option est spécifiée, un service de métastore Hive secondaire est créé conjointement au service principal. Toutes les versions auxiliaires doivent être antérieures à la version principale du service. La clé correspond au nom du service auxiliaire et doit respecter l'expression régulière a-z?. Cela signifie que le premier caractère doit être une lettre minuscule, et tous les caractères suivants doivent être des tirets, des lettres minuscules ou des chiffres, à l'exception du dernier caractère, qui ne peut pas être un tiret.

EndpointProtocol

Protocoles disponibles pour diffuser le point de terminaison du service de métastore.

Enums
ENDPOINT_PROTOCOL_UNSPECIFIED Le protocole n'est pas défini.
THRIFT Utilisez l'ancien protocole Apache Thrift pour le point de terminaison du service de metastore.
GRPC Utilisez le protocole gRPC modernisé pour le point de terminaison du service de metastore.

KerberosConfig

Informations de configuration pour un principal Kerberos.

Champs
keytab

Secret

Fichier keytab Kerberos pouvant être utilisé pour authentifier un compte principal de service avec un centre de distribution de clés (KDC) Kerberos.

principal

string

Compte principal Kerberos qui existe à la fois dans le fichier keytab et dans le KDC pour s'authentifier. Un principal se présente généralement sous la forme primary/instance@REALM, mais il n'existe pas de format strictement défini.

krb5_config_gcs_uri

string

URI Cloud Storage qui spécifie le chemin d'accès à un fichier krb5.conf Il se présente sous la forme gs://{bucket_name}/path/to/krb5.conf, mais le fichier n'a pas besoin d'être nommé krb5.conf explicitement.

LatestBackup

Détails de la dernière sauvegarde planifiée.

Champs
backup_id

string

Uniquement en sortie. ID d'une sauvegarde planifiée en cours. Vide si aucune sauvegarde n'est en cours.

start_time

Timestamp

Uniquement en sortie. Heure de début de la sauvegarde.

state

State

Uniquement en sortie. État actuel de la sauvegarde.

duration

Duration

Uniquement en sortie. Durée de la sauvegarde.

État

État actuel de la sauvegarde.

Enums
STATE_UNSPECIFIED L'état de la sauvegarde est inconnu.
IN_PROGRESS La sauvegarde est en cours.
SUCCEEDED La sauvegarde est terminée.
FAILED La sauvegarde a échoué.

LimitConfig

Représente la configuration de la limite d'autoscaling d'un service Metastore.

Champs
max_scaling_factor

float

Facultatif. Facteur de scaling maximal auquel le service doit être mis à l'échelle automatiquement.

min_scaling_factor

float

Facultatif. Facteur de scaling le plus bas auquel le service doit être mis à l'échelle automatiquement.

ListBackupsRequest

Message de requête pour DataprocMetastore.ListBackups.

Champs
parent

string

Obligatoire. Nom de ressource relatif du service dont vous souhaitez lister les sauvegardes, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.backups.list
page_size

int32

Facultatif. Nombre maximal de sauvegardes à renvoyer. La réponse peut contenir moins de 20 éléments. Si ce paramètre n'est pas spécifié, pas plus de 500 sauvegardes ne sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel DataprocMetastore.ListBackups précédent. Fournissez ce jeton pour récupérer la page suivante.

Pour récupérer la première page, fournissez un jeton de page vide.

Lors de la pagination, les autres paramètres fournis à DataprocMetastore.ListBackups doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Facultatif. Filtre à appliquer aux résultats de la liste.

order_by

string

Facultatif. Spécifiez l'ordre des résultats, comme décrit dans la section Ordre de tri. Si aucune valeur n'est spécifiée, les résultats sont triés dans l'ordre par défaut.

ListBackupsResponse

Message de réponse pour DataprocMetastore.ListBackups.

Champs
backups[]

Backup

Sauvegardes du service spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

unreachable[]

string

Emplacements inaccessibles.

ListFederationsRequest

Message de requête pour ListFederations.

Champs
parent

string

Obligatoire. Nom de ressource relatif de l'emplacement des fédérations de métastores à lister, au format suivant: projects/{project_number}/locations/{location_id}.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.federations.list
page_size

int32

Facultatif. Nombre maximal de fédérations à renvoyer. La réponse peut contenir moins de 20 éléments. Si ce paramètre n'est pas spécifié, 500 services au maximum sont renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListFederationServices précédent. Fournissez ce jeton pour récupérer la page suivante.

Pour récupérer la première page, fournissez un jeton de page vide.

Lors de la pagination, les autres paramètres fournis à ListFederationServices doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Facultatif. Filtre à appliquer aux résultats de la liste.

order_by

string

Facultatif. Spécifiez l'ordre des résultats, comme décrit dans la section Ordre de tri. Si aucune valeur n'est spécifiée, les résultats sont triés dans l'ordre par défaut.

ListFederationsResponse

Message de réponse pour ListFederations

Champs
federations[]

Federation

Services disponibles à l'emplacement spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

unreachable[]

string

Emplacements inaccessibles.

ListMetadataImportsRequest

Message de requête pour DataprocMetastore.ListMetadataImports.

Champs
parent

string

Obligatoire. Nom de ressource relatif du service dont les métadonnées sont importées pour la liste, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.imports.list
page_size

int32

Facultatif. Nombre maximal d'importations à renvoyer. La réponse peut contenir moins de 20 éléments. Si aucune valeur n'est spécifiée, 500 importations au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel DataprocMetastore.ListServices précédent. Fournissez ce jeton pour récupérer la page suivante.

Pour récupérer la première page, fournissez un jeton de page vide.

Lors de la pagination, les autres paramètres fournis à DataprocMetastore.ListServices doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Facultatif. Filtre à appliquer aux résultats de la liste.

order_by

string

Facultatif. Spécifiez l'ordre des résultats, comme décrit dans la section Ordre de tri. Si aucune valeur n'est spécifiée, les résultats sont triés dans l'ordre par défaut.

ListMetadataImportsResponse

Message de réponse pour DataprocMetastore.ListMetadataImports.

Champs
metadata_imports[]

MetadataImport

Les importations dans le service spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

unreachable[]

string

Emplacements inaccessibles.

ListMigrationExecutionsRequest

Message de requête pour DataprocMetastore.ListMigrationExecutions.

Champs
parent

string

Obligatoire. Nom de ressource relatif du service dont vous souhaitez lister les exécutions de migration, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.migrations.list
page_size

int32

Facultatif. Nombre maximal d'exécutions de migration à renvoyer. La réponse peut contenir moins de 20 éléments. Si ce paramètre n'est pas spécifié, pas plus de 500 exécutions de migration ne sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel DataprocMetastore.ListMigrationExecutions précédent. Fournissez ce jeton pour récupérer la page suivante.

Pour récupérer la première page, fournissez un jeton de page vide.

Lors de la pagination, les autres paramètres fournis à DataprocMetastore.ListMigrationExecutions doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Facultatif. Filtre à appliquer aux résultats de la liste.

order_by

string

Facultatif. Spécifiez l'ordre des résultats, comme décrit dans la section Ordre de tri. Si aucune valeur n'est spécifiée, les résultats sont triés dans l'ordre par défaut.

ListMigrationExecutionsResponse

Message de réponse pour DataprocMetastore.ListMigrationExecutions.

Champs
migration_executions[]

MigrationExecution

Exécutions de migration sur le service spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

unreachable[]

string

Emplacements inaccessibles.

ListServicesRequest

Message de requête pour DataprocMetastore.ListServices.

Champs
parent

string

Obligatoire. Nom de ressource relatif de l'emplacement des services Metastore à lister, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • metastore.services.list
page_size

int32

Facultatif. Nombre maximal de services à renvoyer. La réponse peut contenir moins de 20 éléments. Si ce paramètre n'est pas spécifié, 500 services au maximum sont renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel DataprocMetastore.ListServices précédent. Fournissez ce jeton pour récupérer la page suivante.

Pour récupérer la première page, fournissez un jeton de page vide.

Lors de la pagination, les autres paramètres fournis à DataprocMetastore.ListServices doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Facultatif. Filtre à appliquer aux résultats de la liste.

order_by

string

Facultatif. Spécifiez l'ordre des résultats, comme décrit dans la section Ordre de tri. Si aucune valeur n'est spécifiée, les résultats sont triés dans l'ordre par défaut.

ListServicesResponse

Message de réponse pour DataprocMetastore.ListServices.

Champs
services[]

Service

Services disponibles à l'emplacement spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

unreachable[]

string

Emplacements inaccessibles.

LocationMetadata

Métadonnées sur le service dans un emplacement.

Champs
supported_hive_metastore_versions[]

HiveMetastoreVersion

Versions du métastore Hive pouvant être utilisées lors de la création d'un service de métastore à cet emplacement. Le serveur garantit qu'un seul élément HiveMetastoreVersion de la liste définira la valeur is_default.

multi_region_metadata

MultiRegionMetadata

Métadonnées multirégionales si la région actuelle est multirégionale.

custom_region_metadata[]

CustomRegionMetadata

Configurations possibles si la région actuelle est une région personnalisée.

CustomRegionMetadata

Métadonnées d'une région personnalisée. Ce champ n'est renseigné que si la région est une région personnalisée. Pour les régions uniques ou multirégionales, il est vide.

Champs
required_read_write_regions[]

string

Régions de lecture/écriture de cette région personnalisée.

optional_read_only_regions[]

string

Régions de lecture seule de cette région personnalisée.

witness_region

string

Région témoin Spanner pour cette région personnalisée.

HiveMetastoreVersion

Spécification d'une version compatible du logiciel Hive Metastore.

Champs
version

string

Version sémantique du logiciel Hive Metastore.

is_default

bool

Indique si le serveur choisit version si un service de métastore est créé avec un HiveMetastoreConfig qui omet version.

MultiRegionMetadata

Métadonnées de l'emplacement multirégional qui inclut les régions constituantes. Les métadonnées ne sont renseignées que si la région est multirégionale. Pour une région unique ou une région duale personnalisée, il est vide.

Champs
constituent_regions[]

string

Régions constituant la zone multirégionale.

MaintenanceWindow

Intervalle de maintenance. Ce paramètre spécifie quand Dataproc Metastore peut effectuer une opération de maintenance système sur le service.

Champs
hour_of_day

Int32Value

Heure de début de la période (0-23).

day_of_week

DayOfWeek

Jour de la semaine au début de la période.

MetadataExport

Détails d'une opération d'exportation de métadonnées.

Champs
start_time

Timestamp

Uniquement en sortie. Heure de début de l'exportation.

end_time

Timestamp

Uniquement en sortie. Heure de fin de l'exportation.

state

State

Uniquement en sortie. État actuel de l'exportation.

database_dump_type

Type

Uniquement en sortie. Type du vidage de base de données.

Champ d'union destination.

destination ne peut être qu'un des éléments suivants :

destination_gcs_uri

string

Uniquement en sortie. URI Cloud Storage d'un dossier vers lequel les métadonnées sont exportées, au format gs://<bucket_name>/<path_inside_bucket>/<export_folder>, où <export_folder> est généré automatiquement.

État

État actuel de l'exportation des métadonnées.

Enums
STATE_UNSPECIFIED L'état de l'exportation des métadonnées est inconnu.
RUNNING L'exportation des métadonnées est en cours.
SUCCEEDED L'exportation des métadonnées a bien été effectuée.
FAILED Échec de l'exportation des métadonnées.
CANCELLED L'exportation des métadonnées est annulée.

MetadataImport

Ressource Metastore qui importe des métadonnées.

Champs
name

string

Immuable. Nom de ressource relatif de l'importation de métadonnées, au format suivant:

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

description

string

Description de l'importation des métadonnées.

create_time

Timestamp

Uniquement en sortie. Heure de début de l'importation des métadonnées.

update_time

Timestamp

Uniquement en sortie. Heure de la dernière mise à jour de l'importation des métadonnées.

end_time

Timestamp

Uniquement en sortie. Heure à laquelle l'importation des métadonnées a pris fin.

state

State

Uniquement en sortie. État actuel de l'importation des métadonnées.

Champ d'union metadata. Les métadonnées à importer. metadata ne peut être qu'un des éléments suivants :
database_dump

DatabaseDump

Immuable. Un vidage de base de données à partir de la base de données d'un métastore préexistant.

DatabaseDump

Spécification de l'emplacement et des métadonnées d'un vidage de base de données à partir d'un système de gestion de base de données relationnelle.

Champs
database_type
(deprecated)

DatabaseType

Type de la base de données.

gcs_uri

string

URI d'un objet ou d'un dossier Cloud Storage qui spécifie la source à partir de laquelle importer les métadonnées. Il doit commencer par gs://.

source_database
(deprecated)

string

Nom de la base de données source.

type

Type

Facultatif. Type du vidage de base de données. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de MYSQL.

DatabaseType

Type de la base de données.

Enums
DATABASE_TYPE_UNSPECIFIED Le type de la base de données source est inconnu.
MYSQL Le type de la base de données source est MySQL.

État

État actuel de l'importation des métadonnées.

Enums
STATE_UNSPECIFIED L'état de l'importation des métadonnées est inconnu.
RUNNING L'importation des métadonnées est en cours.
SUCCEEDED L'importation des métadonnées a bien été effectuée.
UPDATING L'importation des métadonnées est en cours de mise à jour.
FAILED L'importation des métadonnées a échoué, et les modifications des métadonnées ont été annulées.

MetadataIntegration

Spécifie comment les métadonnées de métastore doivent être intégrées aux services externes.

Champs
data_catalog_config

DataCatalogConfig

Facultatif. Configuration d'intégration du service Data Catalog.

MetadataManagementActivity

Activités de gestion des métadonnées du service de metastore.

Champs
metadata_exports[]

MetadataExport

Uniquement en sortie. Dernières exportations de métadonnées du service Metastore.

restores[]

Restore

Uniquement en sortie. Dernières restaurations du service de métastore.

MigrationExecution

Détails d'une ressource d'exécution de migration.

Champs
name

string

Uniquement en sortie. Nom de ressource relatif de l'exécution de la migration, au format suivant: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}

create_time

Timestamp

Uniquement en sortie. Heure de début de l'exécution de la migration.

end_time

Timestamp

Uniquement en sortie. Heure à laquelle l'exécution de la migration s'est terminée.

state

State

Uniquement en sortie. État actuel de l'exécution de la migration.

phase

Phase

Uniquement en sortie. Phase actuelle de l'exécution de la migration.

state_message

string

Uniquement en sortie. Informations supplémentaires sur l'état actuel de l'exécution de la migration.

Champ d'union migration_config. Les informations de configuration requises par Dataproc Metastore pour démarrer le processus de migration migration_config ne peuvent être que l'une des suivantes:
cloud_sql_migration_config

CloudSQLMigrationConfig

Informations de configuration spécifiques à la migration d'un métastore Hive autogéré sur Google Cloud à l'aide de Cloud SQL comme base de données de backend vers Dataproc Metastore.

CloudSQLMigrationConfig

Informations de configuration pour migrer d'un métastore Hive autogéré sur Google Cloud à l'aide de Cloud SQL comme base de données de backend vers Dataproc Metastore.

Champs
cdc_config

CdcConfig

Obligatoire. Informations de configuration pour démarrer les flux de capture des données modifiées (CDC, Change Data Capture) depuis la base de données client vers la base de données de back-end de Dataproc Metastore. Dataproc Metastore passe à l'utilisation de sa propre base de données de backend après la phase de basculement de la migration.

cloud_sql_connection_config

CloudSQLConnectionConfig

Obligatoire. Informations de configuration permettant d'établir la connexion à la base de données client avant la phase de basculement de la migration

CdcConfig

Informations de configuration pour démarrer les flux de capture des données modifiées (CDC, Change Data Capture) depuis la base de données client vers la base de données de back-end de Dataproc Metastore.

Champs
vpc_network

string

Obligatoire. Nom complet du réseau VPC de l'instance Cloud SQL ou du réseau VPC partagé auquel Datastream sera appairé, au format suivant: projects/{project_id}/locations/global/networks/{network_id}. Pour en savoir plus, consultez https://cloud.google.com/datastream/docs/network-connectivity-options#privateconnectivity.

subnet_ip_range

string

Obligatoire. Une plage d'adresses IP CIDR /29 pour l'appairage avec Datastream

username

string

Obligatoire. Nom d'utilisateur que le service Datastream doit utiliser pour la connexion MySQL.

password

string

Obligatoire. Uniquement en entrée. Mot de passe de l'utilisateur que le service Datastream doit utiliser pour la connexion MySQL. Ce champ n'est pas renvoyé sur demande.

reverse_proxy_subnet

string

Obligatoire. URL de la ressource de sous-réseau dans laquelle créer l'instance de VM hébergeant le proxy inverse. Pour en savoir plus, consultez https://cloud.google.com/datastream/docs/private-connectivity#reverse-csql-proxy. Le sous-réseau doit se trouver dans le réseau fourni dans la demande, auquel Datastream sera appairé, et dans la même région que Datastream, au format suivant. projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}

bucket

string

Facultatif. Bucket dans lequel les données d'événements de flux intermédiaires doivent être écrites. Le nom du bucket ne doit pas contenir de préfixe tel que "gs://". Consultez les règles de dénomination des buckets. Ce champ est facultatif. Si ce paramètre n'est pas défini, le bucket Cloud Storage des artefacts est utilisé.

root_path

string

Facultatif. Chemin d'accès racine dans le bucket Cloud Storage. Les données d'événement de flux seront écrites sur ce chemin d'accès. La valeur par défaut est /migration.

CloudSQLConnectionConfig

Informations de configuration permettant d'établir la connexion à la base de données client avant la phase de basculement de la migration

Champs
instance_connection_name

string

Obligatoire. Nom de la connexion à la base de données Cloud SQL (project_id:region:instance_name)

ip_address

string

Obligatoire. Adresse IP privée de l'instance Cloud SQL.

port

int32

Obligatoire. Port réseau de la base de données.

hive_database_name

string

Obligatoire. Nom de la base de données Hive.

username

string

Obligatoire. Nom d'utilisateur que le service Dataproc Metastore utilisera pour se connecter à la base de données.

password

string

Obligatoire. Uniquement en entrée. Mot de passe de l'utilisateur que le service Dataproc Metastore utilisera pour se connecter à la base de données. Ce champ n'est pas renvoyé sur demande.

proxy_subnet

string

Obligatoire. Nom de ressource relatif du sous-réseau dans lequel déployer le service proxy SOCKS5. Le sous-réseau doit se trouver sur un réseau permettant d'accéder à l'instance Cloud SQL. Le nom de la ressource doit être au format projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}.

nat_subnet

string

Obligatoire. Nom de ressource relatif du sous-réseau à utiliser pour Private Service Connect. Notez que ce sous-réseau ne peut pas être de type standard et qu'il n'est utilisé que pour le NAT (https://cloud.google.com/vpc/docs/about-vpc-hosted-services#psc-subnets). Ce sous-réseau est utilisé pour publier le service proxy SOCKS5. La taille du sous-réseau doit être d'au moins /29, et celui-ci doit se trouver dans un réseau permettant d'accéder à l'instance Cloud SQL. Le nom de la ressource doit être au format projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}.

Phase

Phase actuelle de l'exécution de la migration.

Enums
PHASE_UNSPECIFIED La phase d'exécution de la migration est inconnue.
REPLICATION La phase de réplication fait référence à la phase de migration lorsque Dataproc Metastore exécute un pipeline pour répliquer les modifications apportées à la base de données client dans sa base de données de backend. Au cours de cette phase, Dataproc Metastore utilise la base de données client comme base de données backend du métastore Hive.
CUTOVER La phase de basculement fait référence à la phase de migration au cours de laquelle Dataproc Metastore passe à l'utilisation de sa propre base de données de backend. La migration entre dans cette phase lorsque le client a terminé de migrer tous ses clusters/charges de travail vers Dataproc Metastore et déclenche CompleteMigration.

État

État actuel de l'exécution de la migration.

Enums
STATE_UNSPECIFIED L'état de l'exécution de la migration est inconnu.
STARTING L'exécution de la migration commence.
RUNNING L'exécution de la migration est en cours.
CANCELLING L'exécution de la migration est en cours d'annulation.
AWAITING_USER_ACTION L'exécution de la migration est en attente d'une action de l'utilisateur.
SUCCEEDED L'exécution de la migration a bien été effectuée.
FAILED L'exécution de la migration a échoué.
CANCELLED L'exécution de la migration est annulée.
DELETING L'exécution de la migration est en cours de suppression.

MoveTableToDatabaseRequest

Message de requête pour DataprocMetastore.MoveTableToDatabase.

Champs
service

string

Obligatoire. Nom de ressource relatif du service Metastore pour modifier les métadonnées, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.services.mutateMetadata
table_name

string

Obligatoire. Nom de la table à déplacer.

db_name

string

Obligatoire. Nom de la base de données dans laquelle se trouve la table.

destination_db_name

string

Obligatoire. Nom de la base de données dans laquelle la table doit être déplacée.

MoveTableToDatabaseResponse

Ce type ne comporte aucun champ.

Message de réponse pour DataprocMetastore.MoveTableToDatabase.

NetworkConfig

Configuration réseau du service Dataproc Metastore.

Champs
consumers[]

Consumer

Immuable. Configuration réseau côté client de l'instance Dataproc Metastore.

Consommateur

Inclut des informations sur les configurations réseau du client.

Champs
endpoint_uri

string

Uniquement en sortie. URI du point de terminaison utilisé pour accéder au service Metastore.

endpoint_location

string

Uniquement en sortie. Emplacement de l'URI du point de terminaison. Format : projects/{project}/locations/{location}.

Champ d'union vpc_resource.

vpc_resource ne peut être qu'un des éléments suivants :

subnetwork

string

Immuable. Sous-réseau du projet client à partir duquel une adresse IP est réservée et utilisée comme point de terminaison du service Dataproc Metastore. Il est accessible aux hôtes du sous-réseau et à tous les hôtes d'un sous-réseau de la même région et du même réseau. La plage principale du sous-réseau doit comporter au moins une adresse IP disponible. Le sous-réseau est spécifié au format suivant:

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

OperationMetadata

Représente les métadonnées d'une opération de longue durée.

Champs
create_time

Timestamp

Uniquement en sortie. Heure à laquelle l'opération a été créée.

end_time

Timestamp

Uniquement en sortie. Heure à laquelle l'opération a terminé son exécution.

target

string

Uniquement en sortie. Chemin d'accès à la ressource défini par le serveur pour la cible de l'opération.

verb

string

Uniquement en sortie. Nom du verbe exécuté par l'opération.

status_message

string

Uniquement en sortie. Statut lisible de l'opération, le cas échéant.

requested_cancellation

bool

Uniquement en sortie. Indique si l'appelant a demandé l'annulation de l'opération. Les opérations qui ont bien été annulées possèdent la valeur [Operation.error][] avec un code d'état google.rpc.Status.code de 1, correspondant au code Code.CANCELLED.

api_version

string

Uniquement en sortie. Version de l'API ayant permis de démarrer l'opération.

QueryMetadataRequest

Message de requête pour DataprocMetastore.QueryMetadata.

Champs
service

string

Obligatoire. Nom de ressource relatif du service Metastore à interroger pour les métadonnées, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.services.queryMetadata
query

string

Obligatoire. Requête SQL en lecture seule à exécuter sur la base de données de métadonnées. La requête ne peut pas modifier ni muter les données.

QueryMetadataResponse

Message de réponse pour DataprocMetastore.QueryMetadata.

Champs
result_manifest_uri

string

L'URI du fichier manifeste est associé à une instance JSON dans Cloud Storage. Cette instance se manifeste immédiatement avec QueryMetadataResponse. Le contenu de l'URI ne peut pas être récupéré tant que la requête d'opération de longue durée sur les métadonnées n'est pas terminée.

Restaurer

Détails d'une opération de restauration des métadonnées.

Champs
start_time

Timestamp

Uniquement en sortie. Heure à laquelle la restauration a commencé.

end_time

Timestamp

Uniquement en sortie. Heure de fin de la restauration.

state

State

Uniquement en sortie. État actuel de la restauration.

backup

string

Uniquement en sortie. Nom de ressource relatif de la sauvegarde du service Metastore à partir de laquelle effectuer la restauration, au format suivant:

projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.

type

RestoreType

Uniquement en sortie. Type de restauration.

details

string

Uniquement en sortie. Informations de restauration contenant la révision du service à restaurer, au format JSON.

backup_location

string

Facultatif. URI Cloud Storage spécifiant l'emplacement où les artefacts de sauvegarde sont stockés, au format gs://<bucket_name>/<path_inside_bucket>.

RestoreType

Type de restauration. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de METADATA_ONLY.

Enums
RESTORE_TYPE_UNSPECIFIED Le type de restauration est inconnu.
FULL Les métadonnées et la configuration du service sont restaurées.
METADATA_ONLY Seules les métadonnées du service sont restaurées.

État

État actuel de la restauration.

Enums
STATE_UNSPECIFIED L'état de la restauration des métadonnées est inconnu.
RUNNING La restauration des métadonnées est en cours.
SUCCEEDED La restauration des métadonnées a bien été effectuée.
FAILED La restauration des métadonnées a échoué.
CANCELLED La restauration des métadonnées est annulée.

RestoreServiceRequest

Message de requête pour [DataprocMetastore.Restore][].

Champs
service

string

Obligatoire. Nom de ressource relatif du service Metastore à exécuter pour la restauration, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.services.restore
backup

string

Facultatif. Nom de ressource relatif de la sauvegarde du service Metastore à partir de laquelle effectuer la restauration, au format suivant:

projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}. Valeur incompatible avec backup_location. Un seul des deux doit être défini.

L'autorisation IAM suivante est requise pour la ressource backup indiquée :

  • metastore.backups.use
backup_location

string

Facultatif. URI Cloud Storage spécifiant l'emplacement des artefacts de sauvegarde, à savoir les fichiers Avro de sauvegarde sous "avro/", backup_metastore.json et service.json, au format suivant:

gs://<path_to_backup>. Valeur incompatible avec backup. Un seul des deux doit être défini.

restore_type

RestoreType

Facultatif. Type de restauration. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de METADATA_ONLY.

request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

ScalingConfig

Représente la configuration de scaling d'un service de métastore.

Champs
autoscaling_config

AutoscalingConfig

Facultatif. Configuration de l'autoscaling.

Champ d'union scaling_model. Représente une taille d'instance prédéterminée ou un facteur de mise à l'échelle numérique. scaling_model ne peut être qu'un des éléments suivants :
instance_size

InstanceSize

Énumération des tailles d'instance lisibles, chaque taille d'instance étant mappée sur une valeur à virgule flottante (par exemple, InstanceSize.EXTRA_SMALL = scaling_factor(0,1))

scaling_factor

float

Facteur de scaling, par incréments de 0,1 pour les valeurs inférieures à 1,0 et par incréments de 1,0 pour les valeurs supérieures à 1,0.

InstanceSize

Tailles des instances Metastore

Enums
INSTANCE_SIZE_UNSPECIFIED Taille d'instance non spécifiée
EXTRA_SMALL La taille d'instance extra-petite correspond à un facteur de scaling de 0, 1.
SMALL La petite taille d'instance correspond à un facteur de scaling de 0, 5.
MEDIUM La taille d'instance moyenne correspond à un facteur de scaling de 1, 0.
LARGE La taille d'instance de grande taille correspond à un facteur de scaling de 3, 0.
EXTRA_LARGE La taille d'instance extra-large correspond à un facteur de scaling de 6, 0.

ScheduledBackup

Il spécifie la configuration de la sauvegarde planifiée.

Champs
enabled

bool

Facultatif. Définit si la sauvegarde planifiée est activée. La valeur par défaut est false.

cron_schedule

string

Facultatif. Intervalle planifié au format Cron (voir https://fr.wikipedia.org/wiki/Cron). Par défaut, il est vide: la sauvegarde planifiée n'est pas activée. Doit être spécifié pour activer les sauvegardes planifiées.

time_zone

string

Facultatif. Spécifie le fuseau horaire à utiliser lors de l'interprétation de cron_schedule. Doit correspondre au nom d'un fuseau horaire de la base de données des fuseaux horaires (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), par exemple "America/Los_Angeles" ou "Africa/Abidjan". Si ce champ n'est pas spécifié, le fuseau horaire par défaut est UTC.

next_scheduled_time

Timestamp

Uniquement en sortie. Heure à laquelle l'exécution de la prochaine sauvegarde est planifiée.

backup_location

string

Facultatif. URI Cloud Storage d'un dossier, au format gs://<bucket_name>/<path_inside_bucket>. Un sous-dossier <backup_folder> contenant des fichiers de sauvegarde sera stocké en dessous.

latest_backup

LatestBackup

Uniquement en sortie. Détails de la dernière sauvegarde planifiée.

Secret

Valeur stockée de manière sécurisée.

Champs

Champ d'union value.

value ne peut être qu'un des éléments suivants :

cloud_secret

string

Nom de ressource relatif d'une version de secret Secret Manager, au format suivant:

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

Service

Service de métastore géré qui répond aux requêtes de métadonnées.

Champs
name

string

Immuable. Nom de ressource relatif du service de métadisque, au format suivant:

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

create_time

Timestamp

Uniquement en sortie. Heure à laquelle le service de metastore a été créé.

update_time

Timestamp

Uniquement en sortie. Heure de la dernière mise à jour du service Metastore.

labels

map<string, string>

Étiquettes définies par l'utilisateur pour le service de metastore.

network

string

Immuable. Nom de ressource relatif du réseau VPC sur lequel l'instance est accessible. Il se présente sous la forme suivante:

projects/{project_number}/global/networks/{network_id}.

endpoint_uri

string

Uniquement en sortie. URI du point de terminaison utilisé pour accéder au service Metastore.

port

int32

Port TCP sur lequel le service Metastore est accessible. Par défaut : 9083.

state

State

Uniquement en sortie. État actuel du service de metastore.

state_message

string

Uniquement en sortie. Informations supplémentaires sur l'état actuel du service de metastore, si disponibles.

artifact_gcs_uri

string

Uniquement en sortie. URI Cloud Storage (commençant par gs://) qui spécifie l'emplacement où sont stockés les artefacts associés au service Metastore.

tier

Tier

Niveau du service.

metadata_integration

MetadataIntegration

Facultatif. Paramètre qui définit comment les métadonnées du métastore doivent être intégrées aux services et systèmes externes.

maintenance_window

MaintenanceWindow

Intervalle de maintenance d'une heure du service Metastore. Indique à quel moment le service peut être redémarré à des fins de maintenance, au format UTC. Une fenêtre de maintenance n'est pas nécessaire pour les services avec le type de base de données SPANNER.

uid

string

Uniquement en sortie. Identifiant de ressource unique au niveau mondial du service de métastore.

metadata_management_activity

MetadataManagementActivity

Uniquement en sortie. Activités de gestion des métadonnées du service de metastore.

release_channel

ReleaseChannel

Immuable. Version disponible du service. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de STABLE.

encryption_config

EncryptionConfig

Immuable. Informations utilisées pour configurer le service Dataproc Metastore afin de chiffrer les données client au repos. Ce paramètre ne peut pas être modifié.

network_config

NetworkConfig

Configuration spécifiant les paramètres réseau du service Dataproc Metastore.

database_type

DatabaseType

Immuable. Type de base de données dans laquelle le service Metastore stocke ses données.

telemetry_config

TelemetryConfig

Configuration spécifiant les paramètres de télémétrie pour le service Dataproc Metastore. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de JSON.

scaling_config

ScalingConfig

Configuration de scaling du service de metastore.

scheduled_backup

ScheduledBackup

Facultatif. Configuration de la sauvegarde planifiée pour le service Metastore.

deletion_protection

bool

Facultatif. Indique si le métastore Dataproc doit être protégé contre les suppressions accidentelles.

Champ d'union metastore_config. Propriétés de configuration spécifiques à la technologie de service de métastore sous-jacente (le logiciel qui répond aux requêtes de métastore). metastore_config ne peut être qu'un des éléments suivants :
hive_metastore_config

HiveMetastoreConfig

Informations de configuration spécifiques à l'exécution du logiciel de métastore Hive en tant que service de métastore.

DatabaseType

Type de base de données de backend pour le service Metastore.

Enums
DATABASE_TYPE_UNSPECIFIED Le paramètre DATABASE_TYPE n'est pas défini.
MYSQL MySQL est utilisé pour conserver les données du métastore.
SPANNER Spanner permet de conserver les données du métastore.

ReleaseChannel

Les canaux de publication regroupent des fonctionnalités de différents niveaux de stabilité. Les nouvelles fonctionnalités peuvent être introduites initialement dans des canaux de publication moins stables et peuvent être automatiquement promues dans des canaux de publication plus stables.

Enums
RELEASE_CHANNEL_UNSPECIFIED Le canal de publication n'est pas spécifié.
CANARY Le canal de publication CANARY contient les dernières fonctionnalités, qui peuvent être instables et présenter des problèmes non résolus et sans solutions de contournement connues. Les services utilisant le canal de publication CANARY ne sont soumis à aucun contrat de niveau de service.
STABLE Le canal de publication STABLE contient des fonctionnalités considérées comme stables et qui ont été validées pour une utilisation en production.

État

État actuel du service de metastore.

Enums
STATE_UNSPECIFIED L'état du service Metastore est inconnu.
CREATING Le service Metastore est en cours de création.
ACTIVE Le service Metastore est en cours d'exécution et prêt à répondre aux requêtes.
SUSPENDING Le service Metastore est en cours de suspension. Sa disponibilité pour le traitement des requêtes peut cesser de manière inattendue.
SUSPENDED Le service Metastore est suspendu et ne peut pas traiter les requêtes.
UPDATING Le service Metastore est en cours de mise à jour. Il reste utilisable, mais ne peut pas accepter de demandes de mise à jour supplémentaires ni être supprimé pour le moment.
DELETING Le service Metastore est en cours de suppression. Il ne peut pas être utilisé.
ERROR Le service Metastore a rencontré une erreur et ne peut pas être utilisé. Le service Metastore doit être supprimé.
AUTOSCALING Le service Dataproc Metastore 2 est en cours d'ajustement.
MIGRATING Le service Metastore traite une migration gérée.

Niveau

Niveaux de service disponibles.

Enums
TIER_UNSPECIFIED Le niveau n'est pas défini.
DEVELOPER Le niveau Développeur offre une évolutivité limitée et aucune tolérance aux pannes. Ce niveau est adapté aux démonstrations de faisabilité à faible coût.
ENTERPRISE Le niveau Enterprise offre une haute disponibilité multizone et une évolutivité suffisante pour les charges de travail Dataproc Metastore professionnelles.

StartMigrationRequest

Message de requête pour DataprocMetastore.StartMigration.

Champs
service

string

Obligatoire. Nom de ressource relatif du service Metastore vers lequel commencer la migration, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.migrations.start
migration_execution

MigrationExecution

Obligatoire. Informations de configuration de la migration.

request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

TelemetryConfig

Configuration de la télémétrie pour le service Dataproc Metastore.

Champs
log_format

LogFormat

Format de sortie des journaux du service Dataproc Metastore.

LogFormat

Enums
LOG_FORMAT_UNSPECIFIED La valeur LOG_FORMAT n'est pas définie.
LEGACY La sortie de journalisation utilise l'ancien format textPayload.
JSON La sortie de journalisation utilise le format jsonPayload.

UpdateFederationRequest

Message de requête pour UpdateFederation.

Champs
update_mask

FieldMask

Obligatoire. Masque de champ permettant de spécifier les champs à écraser dans la ressource de fédération de métamagasin lors de la mise à jour. Les champs spécifiés dans update_mask sont relatifs à la ressource (et non à la requête complète). Un champ est écrasé s'il figure dans le masque.

federation

Federation

Obligatoire. Fédération de métamagasins à mettre à jour. Le serveur ne fusionne les champs du service que s'ils sont spécifiés dans update_mask.

Le champ name de la fédération de metastore permet d'identifier le service de metastore à mettre à jour.

L'autorisation IAM suivante est requise pour la ressource federation indiquée :

  • metastore.federations.update
request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

UpdateMetadataImportRequest

Message de requête pour DataprocMetastore.UpdateMetadataImport.

Champs
update_mask

FieldMask

Obligatoire. Masque de champ permettant de spécifier les champs à écraser dans la ressource d'importation de métadonnées par la mise à jour. Les champs spécifiés dans update_mask sont relatifs à la ressource (et non à la requête complète). Un champ est écrasé s'il figure dans le masque.

metadata_import

MetadataImport

Obligatoire. Importation de métadonnées à mettre à jour. Le serveur ne fusionne les champs de l'importation que s'ils sont spécifiés dans update_mask.

Le champ name de l'importation de métadonnées permet d'identifier l'importation de métadonnées à mettre à jour.

L'autorisation IAM suivante est requise pour la ressource metadataImport indiquée :

  • metastore.imports.update
request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

UpdateServiceRequest

Message de requête pour DataprocMetastore.UpdateService.

Champs
update_mask

FieldMask

Obligatoire. Masque de champ permettant de spécifier les champs à écraser dans la ressource de service de metastore lors de la mise à jour. Les champs spécifiés dans update_mask sont relatifs à la ressource (et non à la requête complète). Un champ est écrasé s'il figure dans le masque.

service

Service

Obligatoire. Service Metastore à mettre à jour. Le serveur ne fusionne les champs du service que s'ils sont spécifiés dans update_mask.

Le champ name du service de metastore permet d'identifier le service de metastore à mettre à jour.

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.services.update
request_id

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.