- Ressource: Service
- Représentation JSON
- HiveMetastoreConfig
- KerberosConfig
- Secret
- EndpointProtocol
- AuxiliaryVersionConfig
- NetworkConfig
- Consommateur
- État
- Niveau
- MetadataIntegration
- DataCatalogConfig
- MaintenanceWindow
- MetadataManagementActivity
- MetadataExport
- État
- Restaurer
- État
- RestoreType
- ReleaseChannel
- EncryptionConfig
- DatabaseType
- TelemetryConfig
- LogFormat
- ScalingConfig
- InstanceSize
- AutoscalingConfig
- LimitConfig
- ScheduledBackup
- LatestBackup
- État
- Méthodes
Ressource: Service
Service de métastore géré qui répond aux requêtes de métadonnées.
Représentation JSON |
---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "network": string, "endpointUri": string, "port": integer, "state": enum ( |
Champs | |
---|---|
name |
Immuable. Nom de ressource relatif du service de métadisque, au format suivant:
|
createTime |
Uniquement en sortie. Heure à laquelle le service de metastore a été créé. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
updateTime |
Uniquement en sortie. Heure de la dernière mise à jour du service Metastore. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
labels |
Étiquettes définies par l'utilisateur pour le service de metastore. Objet contenant une liste de paires |
network |
Immuable. Nom de ressource relatif du réseau VPC sur lequel l'instance est accessible. Il se présente sous la forme suivante:
|
endpointUri |
Uniquement en sortie. URI du point de terminaison utilisé pour accéder au service Metastore. |
port |
Port TCP sur lequel le service Metastore est accessible. Par défaut : 9083. |
state |
Uniquement en sortie. État actuel du service de metastore. |
stateMessage |
Uniquement en sortie. Informations supplémentaires sur l'état actuel du service de metastore, si disponibles. |
artifactGcsUri |
Uniquement en sortie. URI Cloud Storage (commençant par |
tier |
Niveau du service. |
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. |
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 |
Uniquement en sortie. Identifiant de ressource unique au niveau mondial du service de métastore. |
metadataManagementActivity |
Uniquement en sortie. Activités de gestion des métadonnées du service de metastore. |
releaseChannel |
Immuable. Version disponible du service. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de |
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é. |
networkConfig |
Configuration spécifiant les paramètres réseau du service Dataproc Metastore. |
databaseType |
Immuable. Type de base de données dans laquelle le service Metastore stocke ses données. |
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 |
scalingConfig |
Configuration de scaling du service de metastore. |
scheduledBackup |
Facultatif. Configuration de la sauvegarde planifiée pour le service Metastore. |
deletionProtection |
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 : |
|
hiveMetastoreConfig |
Informations de configuration spécifiques à l'exécution du logiciel de métastore Hive en tant que service de métastore. |
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.
Représentation JSON |
---|
{ "version": string, "configOverrides": { string: string, ... }, "kerberosConfig": { object ( |
Champs | |
---|---|
version |
Immuable. Version du schéma du métastore Hive. |
configOverrides |
Mappage des paires clé-valeur de configuration du metastore Hive à appliquer au metastore Hive (configuré dans Objet contenant une liste de paires |
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 |
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 |
auxiliaryVersions |
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. Objet contenant une liste de paires |
KerberosConfig
Informations de configuration pour un principal Kerberos.
Représentation JSON |
---|
{
"keytab": {
object ( |
Champs | |
---|---|
keytab |
Fichier keytab Kerberos pouvant être utilisé pour authentifier un compte principal de service avec un centre de distribution de clés (KDC) Kerberos. |
principal |
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 |
krb5ConfigGcsUri |
URI Cloud Storage qui spécifie le chemin d'accès à un fichier krb5.conf Il se présente sous la forme |
Secret
Valeur stockée de manière sécurisée.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union
|
|
cloudSecret |
Nom de ressource relatif d'une version de secret Secret Manager, au format suivant:
|
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. |
AuxiliaryVersionConfig
Informations de configuration pour les versions auxiliaires du service.
Représentation JSON |
---|
{
"version": string,
"configOverrides": {
string: string,
...
},
"networkConfig": {
object ( |
Champs | |
---|---|
version |
Version du métastore Hive du service auxiliaire. Elle doit être inférieure à la version du service de métastore Hive principal. |
configOverrides |
Mappage des paires clé-valeur de configuration du métastore Hive à appliquer au métastore Hive auxiliaire (configuré dans Objet contenant une liste de paires |
networkConfig |
Uniquement en sortie. La configuration réseau contient les URI de point de terminaison du service de métastore Hive auxiliaire. |
NetworkConfig
Configuration réseau du service Dataproc Metastore.
Représentation JSON |
---|
{
"consumers": [
{
object ( |
Champs | |
---|---|
consumers[] |
Immuable. Configuration réseau côté client de l'instance Dataproc Metastore. |
Consommateur
Inclut des informations sur les configurations réseau du client.
Représentation JSON |
---|
{ "endpointUri": string, "endpointLocation": string, // Union field |
Champs | |
---|---|
endpointUri |
Uniquement en sortie. URI du point de terminaison utilisé pour accéder au service Metastore. |
endpointLocation |
Uniquement en sortie. Emplacement de l'URI du point de terminaison. Format : |
Champ d'union
|
|
subnetwork |
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:
|
É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. |
MetadataIntegration
Spécifie comment les métadonnées de métastore doivent être intégrées aux services externes.
Représentation JSON |
---|
{
"dataCatalogConfig": {
object ( |
Champs | |
---|---|
dataCatalogConfig |
Facultatif. Configuration d'intégration du service Data Catalog. |
DataCatalogConfig
Spécifie comment les métadonnées Metastore doivent être intégrées au service Data Catalog.
Représentation JSON |
---|
{ "enabled": boolean } |
Champs | |
---|---|
enabled |
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. |
MaintenanceWindow
Intervalle de maintenance. Ce paramètre spécifie quand Dataproc Metastore peut effectuer une opération de maintenance système sur le service.
Représentation JSON |
---|
{
"hourOfDay": integer,
"dayOfWeek": enum ( |
Champs | |
---|---|
hourOfDay |
Heure de début de la période (0-23). |
dayOfWeek |
Jour de la semaine au début de la période. |
MetadataManagementActivity
Activités de gestion des métadonnées du service de metastore.
Représentation JSON |
---|
{ "metadataExports": [ { object ( |
Champs | |
---|---|
metadataExports[] |
Uniquement en sortie. Dernières exportations de métadonnées du service Metastore. |
restores[] |
Uniquement en sortie. Dernières restaurations du service de métastore. |
MetadataExport
Détails d'une opération d'exportation de métadonnées.
Représentation JSON |
---|
{ "startTime": string, "endTime": string, "state": enum ( |
Champs | |
---|---|
startTime |
Uniquement en sortie. Heure de début de l'exportation. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
endTime |
Uniquement en sortie. Heure de fin de l'exportation. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
state |
Uniquement en sortie. État actuel de l'exportation. |
databaseDumpType |
Uniquement en sortie. Type du vidage de base de données. |
Champ d'union
|
|
destinationGcsUri |
Uniquement en sortie. URI Cloud Storage d'un dossier vers lequel les métadonnées sont exportées, au format |
É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. |
Restaurer
Détails d'une opération de restauration des métadonnées.
Représentation JSON |
---|
{ "startTime": string, "endTime": string, "state": enum ( |
Champs | |
---|---|
startTime |
Uniquement en sortie. Heure à laquelle la restauration a commencé. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
endTime |
Uniquement en sortie. Heure de fin de la restauration. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
state |
Uniquement en sortie. État actuel de la restauration. |
backup |
Uniquement en sortie. Nom de ressource relatif de la sauvegarde du service Metastore à partir de laquelle effectuer la restauration, au format suivant:
|
type |
Uniquement en sortie. Type de restauration. |
details |
Uniquement en sortie. Informations de restauration contenant la révision du service à restaurer, au format JSON. |
backupLocation |
Facultatif. URI Cloud Storage spécifiant l'emplacement où les artefacts de sauvegarde sont stockés, au format |
É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. |
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. |
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. |
EncryptionConfig
Paramètres de chiffrement du service.
Représentation JSON |
---|
{ "kmsKey": string } |
Champs | |
---|---|
kmsKey |
Nom complet de la clé Cloud KMS fournie par le client à utiliser pour le chiffrement des données client, au format suivant:
|
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. |
TelemetryConfig
Configuration de la télémétrie pour le service Dataproc Metastore.
Représentation JSON |
---|
{
"logFormat": enum ( |
Champs | |
---|---|
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 . |
ScalingConfig
Représente la configuration de scaling d'un service de métastore.
Représentation JSON |
---|
{ "autoscalingConfig": { object ( |
Champs | |
---|---|
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 : |
|
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 = scalingFactor(0,1)) |
scalingFactor |
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. |
AutoscalingConfig
Représente la configuration d'autoscaling d'un service Metastore.
Représentation JSON |
---|
{
"autoscalingFactor": number,
"autoscalingEnabled": boolean,
"limitConfig": {
object ( |
Champs | |
---|---|
autoscalingFactor |
Uniquement en sortie. Facteur de scaling d'un service avec l'autoscaling activé. |
autoscalingEnabled |
Facultatif. Indique si l'autoscaling est activé pour ce service. |
limitConfig |
Facultatif. LimitConfig du service. |
LimitConfig
Représente la configuration de la limite d'autoscaling d'un service Metastore.
Représentation JSON |
---|
{ "maxScalingFactor": number, "minScalingFactor": number } |
Champs | |
---|---|
maxScalingFactor |
Facultatif. Facteur de scaling maximal auquel le service doit être mis à l'échelle automatiquement. |
minScalingFactor |
Facultatif. Facteur de scaling le plus bas auquel le service doit être mis à l'échelle automatiquement. |
ScheduledBackup
Il spécifie la configuration de la sauvegarde planifiée.
Représentation JSON |
---|
{
"enabled": boolean,
"cronSchedule": string,
"timeZone": string,
"nextScheduledTime": string,
"backupLocation": string,
"latestBackup": {
object ( |
Champs | |
---|---|
enabled |
Facultatif. Définit si la sauvegarde planifiée est activée. La valeur par défaut est false. |
cronSchedule |
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. |
timeZone |
Facultatif. Indique le fuseau horaire à utiliser lors de l'interprétation de cronSchedule. 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. |
nextScheduledTime |
Uniquement en sortie. Heure à laquelle l'exécution de la prochaine sauvegarde est planifiée. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
backupLocation |
Facultatif. URI Cloud Storage d'un dossier, au format |
latestBackup |
Uniquement en sortie. Détails de la dernière sauvegarde planifiée. |
LatestBackup
Détails de la dernière sauvegarde planifiée.
Représentation JSON |
---|
{
"backupId": string,
"startTime": string,
"state": enum ( |
Champs | |
---|---|
backupId |
Uniquement en sortie. ID d'une sauvegarde planifiée en cours. Vide si aucune sauvegarde n'est en cours. |
startTime |
Uniquement en sortie. Heure de début de la sauvegarde. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
state |
Uniquement en sortie. État actuel de la sauvegarde. |
duration |
Uniquement en sortie. Durée de la sauvegarde. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
É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é. |
Méthodes |
|
---|---|
|
Modifier l'emplacement de la ressource de métadonnées. |
|
Modifier les propriétés de la table de métadonnées |
|
Annule le processus de migration gérée en cours. |
|
Termine le processus de migration gérée. |
|
Crée un service de metastore dans un projet et un emplacement. |
|
Supprime un seul service. |
|
Exporte les métadonnées d'un service. |
|
Récupère les détails d'un seul service. |
|
Récupère la stratégie de contrôle d'accès d'une ressource. |
|
Répertorie les services d'un projet et d'un emplacement. |
|
Déplacer une table vers une autre base de données |
|
Met à jour les paramètres d'un seul service. |
|
Interrogez les métadonnées Dataproc Metastore. |
|
Restaure un service à partir d'une sauvegarde. |
|
Définit la stratégie de contrôle d'accès de la ressource spécifiée. |
|
Lance le processus de migration gérée. |
|
Renvoie les autorisations qu'un appelant a sur la ressource spécifiée. |