Package google.cloud.metastore.v1beta

Index

DataprocMetastore

Konfiguriert und verwaltet Metastore-Dienste. Metastore-Dienste sind vollständig verwaltete, hochverfügbare, automatisch skalierte, OSS-native Bereitstellungen von Software zur Verwaltung technischer Metadaten. Jeder Metadatenspeicherdienst stellt einen Netzwerkendpunkt bereit, über den Metadatenabfragen gesendet werden. Metadatenabfragen können aus verschiedenen Quellen stammen, darunter Apache Hive, Apache Presto und Apache Spark.

Die Dataproc Metastore API definiert das folgende Ressourcenmodell:

  • Der Dienst funktioniert mit einer Sammlung von Google Cloud-Projekten mit dem Namen /projects/*.
  • Jedes Projekt hat eine Sammlung verfügbarer Standorte mit dem Namen /locations/*. Ein Standort muss sich auf eine Google Cloud-region beziehen.
  • Jeder Standort hat eine Reihe von Diensten namens /services/*.
  • Dataproc Metastore-Dienste sind Ressourcen mit Namen vom folgenden Format:

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

AlterMetadataResourceLocation

rpc AlterMetadataResourceLocation(AlterMetadataResourceLocationRequest) returns (Operation)

Speicherort der Metadatenressource ändern Die Metadatenressource kann eine Datenbank, Tabelle oder Partition sein. Dabei wird nur das übergeordnete Verzeichnis für die jeweilige Metadatenressource aktualisiert. Vorhandene Daten werden nicht an den neuen Speicherort übertragen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

AlterTableProperties

rpc AlterTableProperties(AlterTablePropertiesRequest) returns (Operation)

Eigenschaften der Metadatentabelle ändern

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CancelMigration

rpc CancelMigration(CancelMigrationRequest) returns (Operation)

Bricht den laufenden Prozess der verwalteten Migration ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CompleteMigration

rpc CompleteMigration(CompleteMigrationRequest) returns (Operation)

Schließt den verwalteten Migrationsprozess ab. Der Dataproc Metastore-Dienst verwendet nach der erfolgreichen Migration eine eigene Backend-Datenbank.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateBackup

rpc CreateBackup(CreateBackupRequest) returns (Operation)

Erstellt eine neue Sicherung in einem bestimmten Projekt und an einem bestimmten Ort.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateMetadataImport

rpc CreateMetadataImport(CreateMetadataImportRequest) returns (Operation)

Erstellt einen neuen MetadataImport in einem bestimmten Projekt und an einem bestimmten Ort.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateService

rpc CreateService(CreateServiceRequest) returns (Operation)

Erstellt einen Metastore-Dienst in einem Projekt und an einem Standort.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteBackup

rpc DeleteBackup(DeleteBackupRequest) returns (Operation)

Löscht eine einzelne Sicherung.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteMigrationExecution

rpc DeleteMigrationExecution(DeleteMigrationExecutionRequest) returns (Operation)

Löscht eine einzelne Migrationsausführung.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteService

rpc DeleteService(DeleteServiceRequest) returns (Operation)

Löscht einen einzelnen Dienst.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ExportMetadata

rpc ExportMetadata(ExportMetadataRequest) returns (Operation)

Exportiert Metadaten aus einem Dienst.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetBackup

rpc GetBackup(GetBackupRequest) returns (Backup)

Ruft Details zu einer einzelnen Sicherung ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetMetadataImport

rpc GetMetadataImport(GetMetadataImportRequest) returns (MetadataImport)

Ruft Details zu einem einzelnen Import ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetMigrationExecution

rpc GetMigrationExecution(GetMigrationExecutionRequest) returns (MigrationExecution)

Ruft Details zu einer einzelnen Migrationsausführung ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetService

rpc GetService(GetServiceRequest) returns (Service)

Ruft die Details eines einzelnen Dienstes ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListBackups

rpc ListBackups(ListBackupsRequest) returns (ListBackupsResponse)

Listet Sicherungen in einem Dienst auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListMetadataImports

rpc ListMetadataImports(ListMetadataImportsRequest) returns (ListMetadataImportsResponse)

Listet Importe in einem Dienst auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListMigrationExecutions

rpc ListMigrationExecutions(ListMigrationExecutionsRequest) returns (ListMigrationExecutionsResponse)

Listet Migrationen für einen Dienst auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListServices

rpc ListServices(ListServicesRequest) returns (ListServicesResponse)

Listet Dienste in einem Projekt und an einem Standort auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

MoveTableToDatabase

rpc MoveTableToDatabase(MoveTableToDatabaseRequest) returns (Operation)

Eine Tabelle in eine andere Datenbank verschieben

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

QueryMetadata

rpc QueryMetadata(QueryMetadataRequest) returns (Operation)

Abfragen von Dataproc Metastore-Metadaten

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

RemoveIamPolicy

rpc RemoveIamPolicy(RemoveIamPolicyRequest) returns (RemoveIamPolicyResponse)

Entfernt die verknüpften IAM-Richtlinien für eine Ressource

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

RestoreService

rpc RestoreService(RestoreServiceRequest) returns (Operation)

Stellt einen Dienst aus einer Sicherung wieder her.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

StartMigration

rpc StartMigration(StartMigrationRequest) returns (Operation)

Startet den Prozess der verwalteten Migration.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateMetadataImport

rpc UpdateMetadataImport(UpdateMetadataImportRequest) returns (Operation)

Aktualisiert einen einzelnen Import. Es kann nur das Beschreibungsfeld von „MetadataImport“ aktualisiert werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateService

rpc UpdateService(UpdateServiceRequest) returns (Operation)

Aktualisiert die Parameter eines einzelnen Dienstes.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DataprocMetastoreFederation

Konfiguriert und verwaltet Metastore-Verknüpfungsdienste. Mit dem Dataproc Metastore Federation Service können Sie eine Sammlung von Backend-Metastores wie BigQuery, Dataplex Lakes und andere Dataproc Metastores zusammenführen. Der Federation-Dienst stellt eine gRPC-URL bereit, über die Metadaten aus den Metaspeichern des Backends bei der Abfrage bereitgestellt werden.

Die Dataproc Metastore Federation API definiert das folgende Ressourcenmodell: * Der Dienst funktioniert mit einer Sammlung von Google Cloud-Projekten. * Jedes Projekt hat eine Reihe verfügbarer Standorte. * Jeder Standort hat eine Reihe von Verbänden. * Dataproc Metastore-Föderationen sind Ressourcen mit Namen vom Typ projects/{project_number}/locations/{location_id}/federations/{federation_id}.

CreateFederation

rpc CreateFederation(CreateFederationRequest) returns (Operation)

Erstellt eine Metastore-Verknüpfung in einem Projekt und an einem Standort.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteFederation

rpc DeleteFederation(DeleteFederationRequest) returns (Operation)

Löscht eine einzelne Föderation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetFederation

rpc GetFederation(GetFederationRequest) returns (Federation)

Ruft die Details einer einzelnen Verknüpfung ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListFederations

rpc ListFederations(ListFederationsRequest) returns (ListFederationsResponse)

Listet Verbände in einem Projekt und an einem Standort auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateFederation

rpc UpdateFederation(UpdateFederationRequest) returns (Operation)

Aktualisiert die Felder einer Federation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

AlterMetadataResourceLocationRequest

Anfragenachricht für DataprocMetastore.AlterMetadataResourceLocation.

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, für den Metadaten mutiert werden sollen, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.services.mutateMetadata
resource_name

string

Pflichtangabe. Der relative Name der Metadatenressource im folgenden Format.

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

location_uri

string

Pflichtangabe. Der neue Speicherort-URI für die Metadatenressource.

AlterMetadataResourceLocationResponse

Dieser Typ hat keine Felder.

Antwortnachricht für DataprocMetastore.AlterMetadataResourceLocation.

AlterTablePropertiesRequest

Anfragenachricht für DataprocMetastore.AlterTableProperties.

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Dataproc Metastore-Dienstes, der zum Ändern der Eigenschaften der Metadatentabelle verwendet wird, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.services.mutateMetadata
table_name

string

Pflichtangabe. Der Name der Tabelle mit den zu ändernden Properties im folgenden Format.

databases/{database_id}/tables/{table_id}

update_mask

FieldMask

Eine Feldmaske, die die Eigenschaften der Metadatentabelle angibt, die durch die Aktualisierung überschrieben werden. Felder, die in update_mask angegeben sind, beziehen sich auf die Ressource und nicht auf die gesamte Anfrage. Ein Feld wird überschrieben, wenn es sich in der Maske befindet.

Angenommen, Sie haben folgende Ziel-Properties:

properties {
  a: 1
  b: 2
}

Und die Aktualisierungseigenschaften:

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

Wenn die Feldmaske folgendermaßen lautet:

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

ist das Ergebnis:

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

map<string, string>

Eine Map, die die gewünschten zu mutierenden Werte beschreibt. Wenn „update_mask“ leer ist, werden die Properties nicht aktualisiert. Andernfalls wird nur der Wert geändert, dessen zugehörige Pfade in der Aktualisierungsmaske vorhanden sind.

AlterTablePropertiesResponse

Dieser Typ hat keine Felder.

Antwortnachricht für DataprocMetastore.AlterTableProperties.

AutoscalingConfig

Stellt die Autoscaling-Konfiguration eines Metastore-Dienstes dar.

Felder
autoscaling_factor

float

Nur Ausgabe. Der Skalierungsfaktor eines Dienstes mit aktiviertem Autoscaling.

autoscaling_enabled

bool

Optional. Gibt an, ob das Autoscaling für diesen Dienst aktiviert ist.

limit_config

LimitConfig

Optional. Die LimitConfig des Dienstes.

AuxiliaryVersionConfig

Konfigurationsinformationen für die Zusatzversionen des Dienstes.

Felder
version

string

Die Hive-Metastore-Version des Zusatzdienstes. Sie muss niedriger als die Version des primären Hive-Metastore-Dienstes sein.

config_overrides

map<string, string>

Eine Zuordnung von Hive-Metastore-Konfigurations-Schlüssel/Wert-Paaren, die zusätzlich zu den Überschreibungen der primären Version auf den Hive-Metastore (in hive-site.xml konfiguriert) angewendet werden. Wenn Schlüssel sowohl in den Überschreibungen der Zusatzversion als auch in den Überschreibungen der primären Version vorhanden sind, hat der Wert aus den Überschreibungen der Zusatzversion Vorrang.

network_config

NetworkConfig

Nur Ausgabe. Die Netzwerkkonfiguration enthält die Endpunkt-URIs des Hilfs-Hive-Metastore-Dienstes.

BackendMetastore

Stellt einen Backend-Metastore für die Föderation dar.

Felder
name

string

Der relative Ressourcenname des Metastores, der zusammengeführt wird. Die Formate der relativen Ressourcennamen für die derzeit unterstützten Metastores sind unten aufgeführt:

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

MetastoreType

Der Typ des Metaspeichers des Backends.

MetastoreType

Der Typ des Metaspeichers des Backends.

Enums
METASTORE_TYPE_UNSPECIFIED Der Metadatenspeichertyp ist nicht festgelegt.
DATAPLEX Der Metastore für das Backend ist Dataplex.
BIGQUERY Der Metastore für das Backend ist BigQuery.
DATAPROC_METASTORE Der Metastore im Backend ist Dataproc Metastore.

Sicherung

Die Details einer Sicherungsressource.

Felder
name

string

Nicht veränderbar. Der relative Ressourcenname der Sicherung im folgenden Format:

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

create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Sicherung gestartet wurde.

end_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der die Sicherung erstellt wurde.

state

State

Nur Ausgabe. Der aktuelle Status der Sicherung.

service_revision

Service

Nur Ausgabe. Die Version des Dienstes zum Zeitpunkt der Sicherung.

description

string

Die Beschreibung der Sicherung.

restoring_services[]

string

Nur Ausgabe. Dienste, die aus der Sicherung wiederhergestellt werden.

Bundesland

Der aktuelle Status der Sicherung.

Enums
STATE_UNSPECIFIED Der Status der Sicherung ist unbekannt.
CREATING Die Sicherung wird erstellt.
DELETING Die Sicherung wird gelöscht.
ACTIVE Die Sicherung ist aktiv und einsatzbereit.
FAILED Die Sicherung ist fehlgeschlagen.
RESTORING Die Sicherung wird wiederhergestellt.

CancelMigrationRequest

Anfragenachricht für DataprocMetastore.CancelMigration.

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, für den die laufende Migration abgebrochen werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.migrations.cancel

CancelMigrationResponse

Antwortnachricht für DataprocMetastore.CancelMigration.

Felder
migration_execution

string

Der relative Ressourcenname der Migrationsausführung im folgenden Format:

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

CompleteMigrationRequest

Anfragenachricht für DataprocMetastore.CompleteMigration.

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, zu dem die Migration durchgeführt werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.migrations.complete

CompleteMigrationResponse

Antwortnachricht für DataprocMetastore.CompleteMigration.

Felder
migration_execution

string

Der relative Ressourcenname der Migrationsausführung im folgenden Format:

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

CreateBackupRequest

Anfragenachricht für DataprocMetastore.CreateBackup.

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Dienstes, in dem eine Sicherung im folgenden Format erstellt werden soll:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.backups.create
backup_id

string

Pflichtangabe. Die ID der Sicherung, die als letzte Komponente des Sicherungsnamens verwendet wird.

Dieser Wert muss zwischen 1 und 64 Zeichen lang sein, mit einem Buchstaben beginnen, mit einem Buchstaben oder einer Ziffer enden und aus alphanumerischen ASCII-Zeichen oder Bindestrichen bestehen.

backup

Backup

Pflichtangabe. Die zu erstellende Sicherung. Das Feld name wird ignoriert. Die ID der erstellten Sicherung muss im Feld backup_id der Anfrage angegeben werden.

request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

CreateFederationRequest

Anfragenachricht für CreateFederation

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Standorts, an dem ein Federationsdienst erstellt werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.federations.create
federation_id

string

Pflichtangabe. Die ID der Metastore-Föderation, die als letzte Komponente des Namens der Metastore-Föderation verwendet wird.

Dieser Wert muss zwischen 2 und 63 Zeichen lang sein, mit einem Buchstaben beginnen, mit einem Buchstaben oder einer Ziffer enden und aus alphanumerischen ASCII-Zeichen oder Bindestrichen bestehen.

federation

Federation

Pflichtangabe. Die zu erstellende Metastore-Föderation. Das Feld name wird ignoriert. Die ID der erstellten Metastore-Verknüpfung muss im Feld federation_id der Anfrage angegeben werden.

request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

CreateMetadataImportRequest

Anfragenachricht für DataprocMetastore.CreateMetadataImport.

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Dienstes, in dem ein Metastore-Import erstellt werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.imports.create
metadata_import_id

string

Pflichtangabe. Die ID des Metadatenimports, die als letzte Komponente des Namens des Metadatenimports verwendet wird.

Dieser Wert muss zwischen 1 und 64 Zeichen lang sein, mit einem Buchstaben beginnen, mit einem Buchstaben oder einer Ziffer enden und aus alphanumerischen ASCII-Zeichen oder Bindestrichen bestehen.

metadata_import

MetadataImport

Pflichtangabe. Der Metadatenimport, der erstellt werden soll. Das Feld name wird ignoriert. Die ID des erstellten Metadatenimports muss im Feld metadata_import_id der Anfrage angegeben werden.

request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

CreateServiceRequest

Anfragenachricht für DataprocMetastore.CreateService.

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Speicherorts, an dem ein Metastore-Dienst erstellt werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.services.create
service_id

string

Pflichtangabe. Die ID des Metastore-Dienstes, die als letzte Komponente des Namens des Metastore-Dienstes verwendet wird.

Dieser Wert muss zwischen 2 und 63 Zeichen lang sein, mit einem Buchstaben beginnen, mit einem Buchstaben oder einer Ziffer enden und aus alphanumerischen ASCII-Zeichen oder Bindestrichen bestehen.

service

Service

Pflichtangabe. Der Metastore-Dienst, der erstellt werden soll. Das Feld name wird ignoriert. Die ID des erstellten Metastore-Dienstes muss im Feld service_id der Anfrage angegeben werden.

request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

DataCatalogConfig

Gibt an, wie Metadaten des Metastores in den Data Catalog-Dienst eingebunden werden sollen.

Felder
enabled

bool

Optional. Hiermit wird festgelegt, ob die Metadaten des Metastores mit Data Catalog synchronisiert werden sollen. Standardmäßig ist die Synchronisierung von Metastore-Metadaten mit Data Catalog deaktiviert.

DatabaseDumpSpec

Dieser Typ hat keine Felder.

Die Angabe des Datenbankdumps, von dem aus importiert oder in den exportiert werden soll.

Typ

Der Typ des Datenbankdumps.

Enums
TYPE_UNSPECIFIED Der Typ des Datenbankdumps ist unbekannt.
MYSQL Ein Datenbankdump ist eine MySQL-Dumpdatei.
AVRO Der Datenbankdump enthält Avro-Dateien.

DataplexConfig

Gibt an, wie Metadaten des Metastores in den Dataplex-Dienst eingebunden werden sollen.

Felder
lake_resources

map<string, Lake>

Ein Verweis auf die Lake-Ressourcen, mit denen dieser Metastore-Dienst verknüpft ist. Der Schlüssel ist der Name der Seeressource. Beispiel: projects/{project_number}/locations/{location_id}/lakes/{lake_id}.

DeleteBackupRequest

Anfragenachricht für DataprocMetastore.DeleteBackup.

Felder
name

string

Pflichtangabe. Der relative Ressourcenname der Sicherung, die gelöscht werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.backups.delete
request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

DeleteFederationRequest

Anfragenachricht für DeleteFederation.

Felder
name

string

Pflichtangabe. Der relative Ressourcenname der zu löschenden Metastore-Verknüpfung im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.federations.delete
request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

DeleteMigrationExecutionRequest

Anfragenachricht für DataprocMetastore.DeleteMigrationExecution.

Felder
name

string

Pflichtangabe. Der relative Ressourcenname der zu löschenden Migrationsausführung im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.migrations.delete
request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

DeleteServiceRequest

Anfragenachricht für DataprocMetastore.DeleteService.

Felder
name

string

Pflichtangabe. Der relative Ressourcenname des zu löschenden Metadatenspeicher-Dienstes im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.services.delete
request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

EncryptionConfig

Verschlüsselungseinstellungen für den Dienst.

Felder
kms_key

string

Der voll qualifizierte Name des vom Kunden bereitgestellten Cloud KMS-Schlüssels, der für die Verschlüsselung von Kundendaten verwendet werden soll, im folgenden Format:

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

ErrorDetails

Fehlerdetails in der öffentlichen Fehlermeldung für DataprocMetastore.QueryMetadata.

Felder
details

map<string, string>

Zusätzliche strukturierte Details zu diesem Fehler.

Schlüssel definieren die Fehlerelemente. Der Wert beschreibt die Ausnahme oder die Details des Artikels.

ExportMetadataRequest

Anfragenachricht für DataprocMetastore.ExportMetadata.

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, für den der Export ausgeführt werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.services.export
request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

database_dump_type

Type

Optional. Der Typ des Datenbankdumps. Wenn nicht angegeben, lautet die Standardeinstellung MYSQL.

Union-Feld destination. Pflichtangabe. Ziel, an das die Metadaten exportiert werden. Für destination ist nur einer der folgenden Werte zulässig:
destination_gcs_folder

string

Einen Cloud Storage-URI eines Ordners im Format gs://<bucket_name>/<path_inside_bucket>. Darunter wird der Unterordner <export_folder> mit den exportierten Dateien erstellt.

Föderation

Stellt eine Föderation mehrerer Back-End-Metaspeicher dar.

Felder
name

string

Nicht veränderbar. Der relative Ressourcenname der Föderation im Format „projects/{project_number}/locations/{location_id}/federations/{federation_id}“.

create_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der die Metastore-Verknüpfung erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Metastore-Verknüpfung zuletzt aktualisiert wurde.

labels

map<string, string>

Benutzerdefinierte Labels für die Metastore-Verknüpfung.

version

string

Nicht veränderbar. Die Apache Hive-Metastore-Version der Federation. Alle Metastore-Versionen des Back-Ends müssen mit der Version der Verknüpfung kompatibel sein.

backend_metastores

map<int32, BackendMetastore>

Eine Zuordnung vom BackendMetastore-Rang zu BackendMetastores, über die der Federationsdienst Metadaten zum Zeitpunkt der Abfrage bereitstellt. Der Zuordnungsschlüssel gibt die Reihenfolge an, in der BackendMetastores ausgewertet werden sollen, um Datenbanknamen zur Abfragezeit aufzulösen. Er muss größer oder gleich null sein. Eine BackendMetastore mit einer niedrigeren Zahl wird vor einer BackendMetastore mit einer höheren Zahl ausgewertet.

endpoint_uri

string

Nur Ausgabe. Den Föderationsendpunkt.

state

State

Nur Ausgabe. Der aktuelle Status der Föderation.

state_message

string

Nur Ausgabe. Zusätzliche Informationen zum aktuellen Status der Metastore-Verknüpfung, falls verfügbar.

uid

string

Nur Ausgabe. Die global eindeutige Ressourcen-ID der Metastore-Verknüpfung.

Bundesland

Der aktuelle Status der Föderation.

Enums
STATE_UNSPECIFIED Der Status der Metastore-Verknüpfung ist unbekannt.
CREATING Die Metastore-Verknüpfung wird gerade erstellt.
ACTIVE Die Metastore-Verknüpfung ist aktiv und kann Abfragen verarbeiten.
UPDATING Die Metastore-Verknüpfung wird aktualisiert. Sie kann weiterhin verwendet werden, es können jedoch keine weiteren Aktualisierungsanfragen angenommen und sie kann derzeit nicht gelöscht werden.
DELETING Die Metastore-Föderation wird gelöscht. Sie kann nicht verwendet werden.
ERROR Bei der Metastore-Verknüpfung ist ein Fehler aufgetreten und sie kann nicht verwendet werden. Die Metastore-Föderation sollte gelöscht werden.

GetBackupRequest

Anfragenachricht für DataprocMetastore.GetBackup.

Felder
name

string

Pflichtangabe. Der relative Ressourcenname der abzurufenden Sicherung im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.backups.get

GetFederationRequest

Anfragenachricht für GetFederation

Felder
name

string

Pflichtangabe. Der relative Ressourcenname der abzurufenden Metastore-Verknüpfung im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.federations.get

GetMetadataImportRequest

Anfragenachricht für DataprocMetastore.GetMetadataImport.

Felder
name

string

Pflichtangabe. Der relative Ressourcenname des abzurufenden Metadatenimports im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.imports.get

GetMigrationExecutionRequest

Anfragenachricht für DataprocMetastore.GetMigrationExecution.

Felder
name

string

Pflichtangabe. Der relative Ressourcenname der abzurufenden Migrationsausführung im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.migrations.get

GetServiceRequest

Anfragenachricht für DataprocMetastore.GetService.

Felder
name

string

Pflichtangabe. Der relative Ressourcenname des abzurufenden Metastore-Dienstes im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • metastore.services.get

HiveMetastoreConfig

Hier werden Konfigurationsinformationen für die Ausführung der Hive-Metastore-Software als Metastore-Dienst angegeben.

Felder
version

string

Nicht veränderbar. Die Schemaversion des Hive-Metastores.

config_overrides

map<string, string>

Eine Zuordnung von Hive-Metastore-Konfigurations-Schlüssel/Wert-Paaren, die auf den Hive-Metastore angewendet werden soll (in hive-site.xml konfiguriert). Die Zuordnungen überschreiben die Standardeinstellungen des Systems. Einige Schlüssel können jedoch nicht überschrieben werden. Diese Überschreibungen werden auch auf Hilfsversionen angewendet und können in der AuxiliaryVersionConfig der Hilfsversion weiter angepasst werden.

kerberos_config

KerberosConfig

Informationen, mit denen der Hive-Metastore-Dienst als Dienstprinzipal in einem Kerberos-Bereich konfiguriert wird. Wenn Sie Kerberos deaktivieren möchten, verwenden Sie die UpdateService-Methode und geben Sie den Pfad dieses Felds (hive_metastore_config.kerberos_config) in der update_mask der Anfrage an. Lassen Sie dieses Feld jedoch aus der service der Anfrage aus.

endpoint_protocol

EndpointProtocol

Das Protokoll, das für den Metastore-Dienstendpunkt verwendet werden soll. Wenn nicht angegeben, lautet die Standardeinstellung THRIFT.

auxiliary_versions

map<string, AuxiliaryVersionConfig>

Eine Zuordnung der Hive-Metastore-Version zur Konfiguration der Zusatzversion. Wenn angegeben, wird ein sekundärer Hive-Metastore-Dienst zusammen mit dem primären Dienst erstellt. Alle Zusatzversionen müssen niedriger sein als die primäre Version des Dienstes. Der Schlüssel ist der Name des Hilfsdienstes und muss dem regulären Ausdruck a-z? entsprechen. Das erste Zeichen muss also ein Kleinbuchstabe und alle folgenden Zeichen müssen Bindestriche, Kleinbuchstaben oder Ziffern sein, mit Ausnahme des letzten Zeichens, das kein Bindestrich sein darf.

EndpointProtocol

Protokolle, die für die Bereitstellung des Metastore-Dienstendpunkts verfügbar sind.

Enums
ENDPOINT_PROTOCOL_UNSPECIFIED Das Protokoll ist nicht festgelegt.
THRIFT Verwenden Sie das Legacy-Apache-Thrift-Protokoll für den Metastore-Dienstendpunkt.
GRPC Verwenden Sie das modernisierte gRPC-Protokoll für den Metastore-Dienstendpunkt.

KerberosConfig

Konfigurationsinformationen für einen Kerberos-Hauptbenutzer.

Felder
keytab

Secret

Eine Kerberos-Keytab-Datei, die zum Authentifizieren eines Diensthauptkontos mit einem Kerberos-Key Distribution Center (KDC) verwendet werden kann.

principal

string

Ein Kerberos-Hauptkonto, das sowohl im Keytab als auch im KDC vorhanden ist, um sich damit zu authentifizieren. Ein typisches Hauptkonto hat das Format primary/instance@REALM, aber es gibt kein genaues Format.

krb5_config_gcs_uri

string

Ein Cloud Storage-URI, der den Pfad zu einer krb5.conf-Datei angibt. Sie hat das Format gs://{bucket_name}/path/to/krb5.conf, muss aber nicht explizit krb5.conf heißen.

Lake

Stellt eine Lake-Ressource dar

Felder
name

string

Der Name der Lake-Ressource. Beispiel: projects/{project_number}/locations/{location_id}/lakes/{lake_id}

LatestBackup

Details zur letzten geplanten Sicherung.

Felder
backup_id

string

Nur Ausgabe. Die ID einer laufenden geplanten Sicherung. Leer, wenn keine Sicherung läuft.

start_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Sicherung gestartet wurde.

state

State

Nur Ausgabe. Der aktuelle Status der Sicherung.

duration

Duration

Nur Ausgabe. Die Dauer der Sicherung.

Bundesland

Der aktuelle Status der Sicherung.

Enums
STATE_UNSPECIFIED Der Status der Sicherung ist unbekannt.
IN_PROGRESS Die Sicherung läuft.
SUCCEEDED Die Sicherung ist abgeschlossen.
FAILED Die Sicherung ist fehlgeschlagen.

LimitConfig

Stellt die Konfiguration des Autoscaling-Limits eines Metastore-Dienstes dar.

Felder
max_scaling_factor

float

Optional. Der höchste Skalierungsfaktor, auf den der Dienst automatisch skaliert werden soll.

min_scaling_factor

float

Optional. Der niedrigste Skalierungsfaktor, auf den der Dienst automatisch skaliert werden soll.

ListBackupsRequest

Anfragenachricht für DataprocMetastore.ListBackups.

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Dienstes, dessen Sicherungen aufgelistet werden sollen, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.backups.list
page_size

int32

Optional. Die maximale Anzahl der Sicherungen, die zurückgegeben werden sollen. Die Antwort enthält möglicherweise weniger als die maximale Anzahl. Wenn nicht angegeben, werden maximal 500 Sicherungen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden in 1.000 geändert.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen DataprocMetastore.ListBackups-Aufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.

Geben Sie ein leeres Seitentoken an, um die erste Seite abzurufen.

Beim Paginieren müssen andere für DataprocMetastore.ListBackups bereitgestellte Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Der Filter, der auf die Listenergebnisse angewendet werden soll.

order_by

string

Optional. Geben Sie die Reihenfolge der Ergebnisse wie unter Sortierreihenfolge beschrieben an. Wenn keine Angabe erfolgt, werden die Ergebnisse in der Standardreihenfolge sortiert.

ListBackupsResponse

Antwortnachricht für DataprocMetastore.ListBackups.

Felder
backups[]

Backup

Die Sicherungen des angegebenen Dienstes.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

unreachable[]

string

Standorte, die nicht erreicht werden konnten.

ListFederationsRequests

Anfragenachricht für ListFederations.

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Speicherorts der Metastore-Verbände, die aufgelistet werden sollen, im folgenden Format: projects/{project_number}/locations/{location_id}.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.federations.list
page_size

int32

Optional. Die maximale Anzahl der zu retournierenden Verbände. Die Antwort enthält möglicherweise weniger als die maximale Anzahl. Wenn nicht angegeben, werden maximal 500 Dienste zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden in 1.000 geändert.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListFederationServices-Aufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.

Geben Sie ein leeres Seitentoken an, um die erste Seite abzurufen.

Beim Paginieren müssen andere für ListFederationServices bereitgestellte Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Der Filter, der auf die Listenergebnisse angewendet werden soll.

order_by

string

Optional. Geben Sie die Reihenfolge der Ergebnisse wie unter Sortierreihenfolge beschrieben an. Wenn keine Angabe erfolgt, werden die Ergebnisse in der Standardreihenfolge sortiert.

ListFederationsResponse

Antwortnachricht für ListFederations

Felder
federations[]

Federation

Die Dienste am angegebenen Standort.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

unreachable[]

string

Standorte, die nicht erreicht werden konnten.

ListMetadataImportsRequest

Anfragenachricht für DataprocMetastore.ListMetadataImports.

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Dienstes, dessen Metadaten in die Liste importiert werden sollen, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.imports.list
page_size

int32

Optional. Die maximale Anzahl der Importe, die zurückgegeben werden sollen. Die Antwort enthält möglicherweise weniger als die maximale Anzahl. Wenn nicht angegeben, werden maximal 500 Importe zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden in 1.000 geändert.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen DataprocMetastore.ListServices-Aufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.

Geben Sie ein leeres Seitentoken an, um die erste Seite abzurufen.

Beim Paginieren müssen andere für DataprocMetastore.ListServices bereitgestellte Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Der Filter, der auf die Listenergebnisse angewendet werden soll.

order_by

string

Optional. Geben Sie die Reihenfolge der Ergebnisse wie unter Sortierreihenfolge beschrieben an. Wenn keine Angabe erfolgt, werden die Ergebnisse in der Standardreihenfolge sortiert.

ListMetadataImportsResponse

Antwortnachricht für DataprocMetastore.ListMetadataImports.

Felder
metadata_imports[]

MetadataImport

Die Importe im angegebenen Dienst.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

unreachable[]

string

Standorte, die nicht erreicht werden konnten.

ListMigrationExecutionsRequests

Anfragenachricht für DataprocMetastore.ListMigrationExecutions.

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Dienstes, dessen Migrationsausführungen aufgelistet werden sollen, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.migrations.list
page_size

int32

Optional. Die maximale Anzahl der Migrationsausführungen, die zurückgegeben werden sollen. Die Antwort enthält möglicherweise weniger als die maximale Anzahl. Wenn nicht angegeben, werden maximal 500 Migrationen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden in 1.000 geändert.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen DataprocMetastore.ListMigrationExecutions-Aufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.

Geben Sie ein leeres Seitentoken an, um die erste Seite abzurufen.

Beim Paginieren müssen andere für DataprocMetastore.ListMigrationExecutions bereitgestellte Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Der Filter, der auf die Listenergebnisse angewendet werden soll.

order_by

string

Optional. Geben Sie die Reihenfolge der Ergebnisse wie unter Sortierreihenfolge beschrieben an. Wenn keine Angabe erfolgt, werden die Ergebnisse in der Standardreihenfolge sortiert.

ListMigrationExecutionsResponse

Antwortnachricht für DataprocMetastore.ListMigrationExecutions.

Felder
migration_executions[]

MigrationExecution

Die Migrationsausführungen für den angegebenen Dienst.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

unreachable[]

string

Standorte, die nicht erreicht werden konnten.

ListServicesRequest

Anfragenachricht für DataprocMetastore.ListServices.

Felder
parent

string

Pflichtangabe. Der relative Ressourcenname des Speicherorts der Metastore-Dienste, die aufgeführt werden sollen, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • metastore.services.list
page_size

int32

Optional. Die maximale Anzahl der Dienste, die zurückgegeben werden sollen. Die Antwort enthält möglicherweise weniger als die maximale Anzahl. Wenn nicht angegeben, werden maximal 500 Dienste zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden in 1.000 geändert.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen DataprocMetastore.ListServices-Aufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.

Geben Sie ein leeres Seitentoken an, um die erste Seite abzurufen.

Beim Paginieren müssen andere für DataprocMetastore.ListServices bereitgestellte Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Der Filter, der auf die Listenergebnisse angewendet werden soll.

order_by

string

Optional. Geben Sie die Reihenfolge der Ergebnisse wie unter Sortierreihenfolge beschrieben an. Wenn keine Angabe erfolgt, werden die Ergebnisse in der Standardreihenfolge sortiert.

ListServicesResponse

Antwortnachricht für DataprocMetastore.ListServices.

Felder
services[]

Service

Die Dienste am angegebenen Standort.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

unreachable[]

string

Standorte, die nicht erreicht werden konnten.

LocationMetadata

Metadaten zum Dienst an einem Standort.

Felder
supported_hive_metastore_versions[]

HiveMetastoreVersion

Die Versionen des Hive-Metastores, die beim Erstellen eines neuen Metastore-Dienstes an diesem Speicherort verwendet werden können. Der Server garantiert, dass genau eine HiveMetastoreVersion in der Liste auf is_default festgelegt ist.

multi_region_metadata

MultiRegionMetadata

Die Multi-Region-Metadaten, wenn die aktuelle Region eine Multi-Region ist.

custom_region_metadata[]

CustomRegionMetadata

Mögliche Konfigurationen, die unterstützt werden, wenn die aktuelle Region eine benutzerdefinierte Region ist.

CustomRegionMetadata

Metadaten zu einer benutzerdefinierten Region. Dieses Feld wird nur ausgefüllt, wenn es sich um eine benutzerdefinierte Region handelt. Bei einzelnen oder mehreren Regionen ist das Feld leer.

Felder
required_read_write_regions[]

string

Die Lese-/Schreibregionen für diese benutzerdefinierte Region.

optional_read_only_regions[]

string

Die schreibgeschützten Regionen für diese benutzerdefinierte Region.

witness_region

string

Die Spanner-Zeugenregion für diese benutzerdefinierte Region.

HiveMetastoreVersion

Eine Spezifikation einer unterstützten Version der Hive Metastore-Software.

Felder
version

string

Die semantische Version der Hive Metastore-Software.

is_default

bool

Gibt an, ob version vom Server ausgewählt wird, wenn ein Metastore-Dienst mit einem HiveMetastoreConfig erstellt wird, das version nicht enthält.

MultiRegionMetadata

Die Metadaten für die Multiregion, die die zugehörigen Regionen enthält. Die Metadaten werden nur ausgefüllt, wenn es sich um eine multiregionale Region handelt. Bei einer einzelnen Region oder einer benutzerdefinierten biregionalen Konfiguration ist das Feld leer.

Felder
constituent_regions[]

string

Die Regionen, die die Multiregion bilden.

MaintenanceWindow

Wartungsfenster. Hier wird angegeben, wann Dataproc Metastore Systemwartung am Dienst ausführen kann.

Felder
hour_of_day

Int32Value

Die Stunde des Tages (0–23), zu der das Zeitfenster beginnt.

day_of_week

DayOfWeek

Der Wochentag, an dem das Zeitfenster beginnt.

MetadataExport

Die Details eines Metadatenexportvorgangs.

Felder
start_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Export gestartet wurde.

end_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Export abgeschlossen wurde.

state

State

Nur Ausgabe. Der aktuelle Status des Exports.

database_dump_type

Type

Nur Ausgabe. Der Typ des Datenbankdumps.

Union-Feld destination.

Für destination ist nur einer der folgenden Werte zulässig:

destination_gcs_uri

string

Nur Ausgabe. Ein Cloud Storage-URI eines Ordners, in den Metadaten exportiert werden, in der Form gs://<bucket_name>/<path_inside_bucket>/<export_folder>, wobei <export_folder> automatisch generiert wird.

Bundesland

Der aktuelle Status des Metadatenexports.

Enums
STATE_UNSPECIFIED Der Status des Metadatenexports ist unbekannt.
RUNNING Der Metadatenexport wird ausgeführt.
SUCCEEDED Der Metadatenexport wurde erfolgreich abgeschlossen.
FAILED Der Metadatenexport ist fehlgeschlagen.
CANCELLED Der Metadatenexport wird abgebrochen.

MetadataImport

Eine Metastore-Ressource, die Metadaten importiert.

Felder
name

string

Nicht veränderbar. Der relative Ressourcenname des Metadatenimports im folgenden Format:

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

description

string

Die Beschreibung des Metadatenimports.

create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Metadatenimport gestartet wurde.

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Metadatenimport zuletzt aktualisiert wurde.

end_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Metadatenimport abgeschlossen wurde.

state

State

Nur Ausgabe. Der aktuelle Status des Metadatenimports.

Union-Feld metadata. Die zu importierenden Metadaten. Für metadata ist nur einer der folgenden Werte zulässig:
database_dump

DatabaseDump

Nicht veränderbar. Ein Datenbankdump aus der Datenbank eines vorhandenen Metastores.

DatabaseDump

Eine Angabe des Speicherorts und der Metadaten eines Datenbankdumps aus einem relationalen Datenbankverwaltungssystem.

Felder
database_type
(deprecated)

DatabaseType

Der Typ der Datenbank.

gcs_uri

string

Ein Cloud Storage-Objekt- oder Ordner-URI, der die Quelle angibt, aus der Metadaten importiert werden sollen. Er muss mit gs:// beginnen.

source_database
(deprecated)

string

Der Name der Quelldatenbank.

type

Type

Optional. Der Typ des Datenbankdumps. Wenn nicht angegeben, lautet die Standardeinstellung MYSQL.

DatabaseType

Der Typ der Datenbank.

Enums
DATABASE_TYPE_UNSPECIFIED Der Typ der Quelldatenbank ist unbekannt.
MYSQL Die Quelldatenbank ist MySQL.

Bundesland

Der aktuelle Status des Metadatenimports.

Enums
STATE_UNSPECIFIED Der Status des Metadatenimports ist unbekannt.
RUNNING Der Metadatenimport wird ausgeführt.
SUCCEEDED Der Metadatenimport wurde erfolgreich abgeschlossen.
UPDATING Der Metadatenimport wird aktualisiert.
FAILED Der Metadatenimport ist fehlgeschlagen und die versuchten Metadatenänderungen wurden rückgängig gemacht.

MetadataIntegration

Gibt an, wie Metadaten des Metastores in externe Dienste eingebunden werden sollen.

Felder
data_catalog_config

DataCatalogConfig

Optional. Die Integrationskonfiguration für den Data Catalog-Dienst.

dataplex_config

DataplexConfig

Die Integrationskonfiguration für den Dataplex-Dienst.

MetadataManagementActivity

Die Metadatenverwaltungsaktivitäten des Metastore-Dienstes.

Felder
metadata_exports[]

MetadataExport

Nur Ausgabe. Die neuesten Metadatenexporte des Metastore-Dienstes.

restores[]

Restore

Nur Ausgabe. Die letzten Wiederherstellungen des Metastore-Dienstes.

MigrationExecution

Die Details einer Migrationsausführungsressource.

Felder
name

string

Nur Ausgabe. Der relative Ressourcenname der Migrationsausführung im folgenden Format: projects/{project_number}/locations/{location_id}/services/{service_id}/migrationExecutions/{migration_execution_id}

create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Migrationsausführung gestartet wurde.

end_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Migration abgeschlossen wurde.

state

State

Nur Ausgabe. Der aktuelle Status der Migrationsausführung.

phase

Phase

Nur Ausgabe. Die aktuelle Phase der Migrationsausführung.

state_message

string

Nur Ausgabe. Zusätzliche Informationen zum aktuellen Status der Migration.

Union-Feld migration_config. Die von Dataproc Metastore für den Start des Migrationsprozesses migration_config erforderlichen Konfigurationsinformationen können nur eine der folgenden Optionen sein:
cloud_sql_migration_config

CloudSQLMigrationConfig

Konfigurationsinformationen speziell für die Migration von einem selbstverwalteten Hive-Metastore in Google Cloud mit Cloud SQL als Back-End-Datenbank zu Dataproc Metastore.

CloudSQLMigrationConfig

Konfigurationsinformationen für die Migration von einem selbstverwalteten Hive-Metastore in Google Cloud mit Cloud SQL als Back-End-Datenbank zu Dataproc Metastore.

Felder
cdc_config

CdcConfig

Pflichtangabe. Konfigurationsinformationen zum Starten der CDC-Streams (Change Data Capture) von der Kundendatenbank zur Backend-Datenbank von Dataproc Metastore. Dataproc Metastore verwendet nach der Umstellungsphase der Migration eine eigene Backend-Datenbank.

cloud_sql_connection_config

CloudSQLConnectionConfig

Pflichtangabe. Konfigurationsinformationen für das Einrichten der Verbindung zur Kundendatenbank vor der Umstellungsphase der Migration

CdcConfig

Konfigurationsinformationen zum Starten der CDC-Streams (Change Data Capture) von der Kundendatenbank zur Backend-Datenbank von Dataproc Metastore.

Felder
vpc_network

string

Pflichtangabe. Vollständig qualifizierter Name des VPC-Netzwerks der Cloud SQL-Instanz oder des freigegebenen VPC-Netzwerks, zu dem Datastream eine Peering-Verbindung herstellen wird, im folgenden Format: projects/{project_id}/locations/global/networks/{network_id}. Weitere Informationen finden Sie unter https://cloud.google.com/datastream/docs/network-connectivity-options#privateconnectivity.

subnet_ip_range

string

Pflichtangabe. Ein /29‑CIDR-IP-Bereich für das Peering mit Datastream.

username

string

Pflichtangabe. Der Nutzername, den der Datastream-Dienst für die MySQL-Verbindung verwenden soll.

password

string

Pflichtangabe. Nur Eingabe. Das Passwort für den Nutzer, das der Datastream-Dienst für die MySQL-Verbindung verwenden soll. Dieses Feld wird auf Anfrage nicht zurückgegeben.

reverse_proxy_subnet

string

Pflichtangabe. Die URL der Subnetzwerkressource zum Erstellen der VM-Instanz, in der der Reverse-Proxy gehostet wird. Weitere Informationen finden Sie unter https://cloud.google.com/datastream/docs/private-connectivity#reverse-csql-proxy. Das Subnetzwerk sollte sich im in der Anfrage angegebenen Netzwerk befinden, zu dem Datastream eine Peering-Verbindung herstellen wird, sowie in derselben Region wie Datastream. projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id}

bucket

string

Optional. Der Bucket, in den die Ereignisdaten des Zwischenstreams geschrieben werden. Der Bucket-Name darf kein Präfix wie „gs://“ enthalten. Weitere Informationen finden Sie in den Anforderungen für Bucket-Namen. Dieses Feld ist optional. Wenn es leer ist, wird der Artifacts-Cloud Storage-Bucket verwendet.

root_path

string

Optional. Der Stammpfad im Cloud Storage-Bucket. Die Ereignisdaten des Streams werden in diesen Pfad geschrieben. Der Standardwert ist /migration.

CloudSQLConnectionConfig

Konfigurationsinformationen für das Einrichten der Verbindung zur Kundendatenbank vor der Umstellungsphase der Migration

Felder
instance_connection_name

string

Pflichtangabe. Name der Cloud SQL-Datenbankverbindung (project_id:region:instance_name)

ip_address

string

Pflichtangabe. Die private IP-Adresse der Cloud SQL-Instanz.

port

int32

Pflichtangabe. Der Netzwerkport der Datenbank.

hive_database_name

string

Pflichtangabe. Der Name der Hive-Datenbank.

username

string

Pflichtangabe. Der Nutzername, den der Dataproc Metastore-Dienst für das Herstellen einer Verbindung zur Datenbank verwendet.

password

string

Pflichtangabe. Nur Eingabe. Das Passwort für den Nutzer, das der Dataproc Metastore-Dienst für das Herstellen einer Verbindung zur Datenbank verwendet. Dieses Feld wird auf Anfrage nicht zurückgegeben.

proxy_subnet

string

Pflichtangabe. Der relative Ressourcenname des Subnetzwerks, in dem der SOCKS5-Proxy-Dienst bereitgestellt werden soll. Das Subnetzwerk sollte sich in einem Netzwerk befinden, über das die Cloud SQL-Instanz zugänglich ist. Der Ressourcenname muss das Format projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id} haben.

nat_subnet

string

Pflichtangabe. Der relative Ressourcenname des Subnetzwerks, das für Private Service Connect verwendet werden soll. Dies darf kein reguläres Subnetz sein; es wird nur für NAT genutzt. (https://cloud.google.com/vpc/docs/about-vpc-hosted-services#psc-subnets) Dieses Subnetz wird zum Veröffentlichen des SOCKS5-Proxy-Dienstes verwendet. Die Subnetzgröße muss mindestens /29 sein und sollte sich in einem Netzwerk befinden, über das die Cloud SQL-Instanz zugänglich ist. Der Ressourcenname muss das Format projects/{project_id}/regions/{region_id}/subnetworks/{subnetwork_id} haben.

Phase

Die aktuelle Phase der Migrationsausführung.

Enums
PHASE_UNSPECIFIED Die Phase der Migrationsausführung ist unbekannt.
REPLICATION Die Replikationsphase bezieht sich auf die Migrationsphase, in der Dataproc Metastore eine Pipeline ausführt, um Änderungen in der Kundendatenbank in der Backend-Datenbank zu replizieren. In dieser Phase verwendet Dataproc Metastore die Kundendatenbank als Hive-Metastore-Backenddatenbank.
CUTOVER Die Umstellungsphase bezieht sich auf die Migrationsphase, in der Dataproc Metastore auf die Verwendung einer eigenen Backend-Datenbank umstellt. Diese Phase beginnt, wenn der Kunde die Migration aller Cluster/Arbeitslasten zu Dataproc Metastore abgeschlossen hat und CompleteMigration auslöst.

Bundesland

Der aktuelle Status der Migrationsausführung.

Enums
STATE_UNSPECIFIED Der Status der Migrationsausführung ist unbekannt.
STARTING Die Migrationsausführung wird gestartet.
RUNNING Die Migrationsausführung läuft.
CANCELLING Die Migrationsausführung wird abgebrochen.
AWAITING_USER_ACTION Die Migrationsausführung wartet auf Nutzeraktion.
SUCCEEDED Die Migration wurde erfolgreich abgeschlossen.
FAILED Die Migrationsausführung ist fehlgeschlagen.
CANCELLED Die Migrationsausführung wird abgebrochen.
DELETING Die Migrationsausführung wird gelöscht.

MoveTableToDatabaseRequest

Anfragenachricht für DataprocMetastore.MoveTableToDatabase.

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, für den Metadaten mutiert werden sollen, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.services.mutateMetadata
table_name

string

Pflichtangabe. Der Name der zu verschiebenden Tabelle.

db_name

string

Pflichtangabe. Der Name der Datenbank, in der sich die Tabelle befindet.

destination_db_name

string

Pflichtangabe. Der Name der Datenbank, in die die Tabelle verschoben werden soll.

MoveTableToDatabaseResponse

Dieser Typ hat keine Felder.

Antwortnachricht für DataprocMetastore.MoveTableToDatabase.

MultiRegionConfig

Die Multi-Region-Konfiguration für den Dataproc Metastore-Dienst.

Felder
certificates[]
(deprecated)

RootCACertificate

Nur Ausgabe. Die Liste der Root-CA-Zertifikate, die ein gRPC-Client zum Herstellen einer Verbindung zu einem mehrregionalen Dataproc Metastore-Dienst verwendet.

custom_region_config

CustomRegionConfig

CustomRegionConfig

Benutzerdefinierte Konfiguration, mit der Regionen angegeben werden, in denen der Metastore-Dienst ausgeführt wird. Derzeit nur in der Multi-Region us unterstützt.

Felder
read_write_regions[]

string

Pflichtangabe. Die Liste der Lese-/Schreibregionen, in denen der Metastore-Dienst ausgeführt wird. Diese Regionen sollten Teil (oder Teilmenge) der Multiregion sein.

read_only_regions[]

string

Optional. Die Liste der schreibgeschützten Regionen, in denen der Metastore-Dienst ausgeführt wird. Diese Regionen sollten Teil (oder Teilmenge) der Multiregion sein.

RootCACertificate

Ein gRPC-Client muss alle Root-CA-Zertifikate installieren, um eine Verbindung zu einem mehrregionalen Dataproc Metastore-Dienst herzustellen und einen Failover zu erreichen.

Felder
certificate
(deprecated)

string

Das Zertifikat der Stamm-CA im PEM-Format. Die maximale Länge beträgt 65.536 Byte.

expiration_time
(deprecated)

Timestamp

Das Ablaufdatum des Zertifikats im Zeitstempelformat.

NetworkConfig

Netzwerkkonfiguration für den Dataproc Metastore-Dienst.

Felder
consumers[]

Consumer

Nicht veränderbar. Die verbraucherseitige Netzwerkkonfiguration für die Dataproc Metastore-Instanz.

custom_routes_enabled

bool

Ermöglicht den Import und Export benutzerdefinierter Routen für das Peering-VPC-Netzwerk des Dataproc Metastore-Dienstes.

Konsumgüter

Enthält Informationen zu den Netzwerkkonfigurationen des Kunden.

Felder
endpoint_uri

string

Nur Ausgabe. Der URI des Endpunkts, der für den Zugriff auf den Metastore-Dienst verwendet wird.

endpoint_location

string

Nur Ausgabe. Der Speicherort des Endpunkt-URIs. Format: projects/{project}/locations/{location}.

Union-Feld vpc_resource.

Für vpc_resource ist nur einer der folgenden Werte zulässig:

subnetwork

string

Nicht veränderbar. Das Subnetz des Kundenprojekts, aus dem eine IP-Adresse reserviert und als Endpunkt des Dataproc Metastore-Dienstes verwendet wird. Es ist für Hosts im Subnetz und für alle Hosts in einem Subnetz in derselben Region und im selben Netzwerk zugänglich. Im primären Bereich des Subnetzes muss mindestens eine IP-Adresse verfügbar sein. Das Subnetz wird im folgenden Format angegeben:

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

OperationMetadata

Stellt die Metadaten eines Vorgangs mit langer Ausführungszeit dar.

Felder
create_time

Timestamp

[Nur Ausgabe] Die Zeit, zu der die Vorgang erstellt wurde.

end_time

Timestamp

[Nur Ausgabe] Der Zeitpunkt, zu dem der Vorgang abgeschlossen wurde.

target

string

Nur Ausgabe. Serverdefinierter Ressourcenpfad für das Ziel des Vorgangs.

verb

string

Nur Ausgabe. Name des vom Vorgang ausgeführten Verbs.

status_message

string

Nur Ausgabe. Lesbarer Status des Vorgangs, falls vorhanden.

requested_cancellation

bool

Nur Ausgabe. Gibt an, ob der Aufrufer den Abbruch des Vorgangs angefordert hat. Vorgänge, die erfolgreich abgebrochen wurden, haben den Wert [Operation.error][] mit einem google.rpc.Status.code von 1, was Code.CANCELLED entspricht.

api_version

string

Nur Ausgabe. Zum Starten des Vorgangs verwendete API-Version.

QueryMetadataRequest

Anfragenachricht für DataprocMetastore.QueryMetadata.

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, für den Metadaten abgefragt werden sollen, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.services.queryMetadata
query

string

Pflichtangabe. Eine schreibgeschützte SQL-Abfrage, die für die Metadatendatenbank ausgeführt werden soll. Die Daten dürfen durch die Abfrage nicht geändert oder mutiert werden.

QueryMetadataResponse

Antwortnachricht für DataprocMetastore.QueryMetadata.

Felder
result_manifest_uri

string

Der Manifest-URI ist mit einer JSON-Instanz in Cloud Storage verknüpft. Diese Instanz wird sofort zusammen mit QueryMetadataResponse angezeigt. Der Inhalt des URI kann erst abgerufen werden, wenn die Abfrage des langen laufenden Vorgangs auf die Metadaten abgeschlossen ist.

RemoveIamPolicyRequest

Anfragenachricht für DataprocMetastore.RemoveIamPolicy.

Felder
resource

string

Pflichtangabe. Der relative Ressourcenname der Dataplane-Ressource, für die die IAM-Richtlinie entfernt werden soll, im folgenden Format:

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

asynchronous

bool

Optional. Entfernt die an die Datenbank oder Tabelle angehängte IAM-Richtlinie asynchron, wenn sie festgelegt ist. Der Standardwert lautet „falsch“.

RemoveIamPolicyResponse

Antwortnachricht für DataprocMetastore.RemoveIamPolicy.

Felder
success

bool

„True“, wenn die Richtlinie erfolgreich entfernt wurde.

Wiederherstellen

Die Details eines Metadatenwiederherstellungsvorgangs.

Felder
start_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Wiederherstellung gestartet wurde.

end_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Wiederherstellung abgeschlossen wurde.

state

State

Nur Ausgabe. Der aktuelle Status der Wiederherstellung.

backup

string

Nur Ausgabe. Der relative Ressourcenname der Metastore-Dienstsicherung, aus der wiederhergestellt werden soll, im folgenden Format:

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

type

RestoreType

Nur Ausgabe. Die Art der Wiederherstellung.

details

string

Nur Ausgabe. Die Details zur Wiederherstellung, die die Version des Dienstes enthalten, zu der wiederhergestellt werden soll, im JSON-Format.

backup_location

string

Optional. Ein Cloud Storage-URI im Format gs://<bucket_name>/<path_inside_bucket>, der angibt, wo die Sicherungsartefakte gespeichert werden.

RestoreType

Die Art der Wiederherstellung. Wenn nicht angegeben, lautet die Standardeinstellung METADATA_ONLY.

Enums
RESTORE_TYPE_UNSPECIFIED Der Wiederherstellungstyp ist unbekannt.
FULL Die Metadaten und die Konfiguration des Dienstes werden wiederhergestellt.
METADATA_ONLY Es werden nur die Metadaten des Dienstes wiederhergestellt.

Bundesland

Der aktuelle Status der Wiederherstellung.

Enums
STATE_UNSPECIFIED Der Status der Metadatenwiederherstellung ist unbekannt.
RUNNING Die Metadatenwiederherstellung wird ausgeführt.
SUCCEEDED Die Wiederherstellung der Metadaten wurde erfolgreich abgeschlossen.
FAILED Die Metadatenwiederherstellung ist fehlgeschlagen.
CANCELLED Die Metadatenwiederherstellung wird abgebrochen.

RestoreServiceRequest

Anfragenachricht für [DataprocMetastore.Restore][]

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, für den die Wiederherstellung ausgeführt werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.services.restore
backup

string

Optional. Der relative Ressourcenname der Metastore-Dienstsicherung, aus der wiederhergestellt werden soll, im folgenden Format:

projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}. Schließt sich mit backup_location gegenseitig aus. Es muss genau eine der beiden Optionen festgelegt sein.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource backup erforderlich:

  • metastore.backups.use
backup_location

string

Optional. Ein Cloud Storage-URI, der den Speicherort der Sicherungsartefakte angibt, nämlich die Sicherungs-Avro-Dateien unter „avro/“, „backup_metastore.json“ und „service.json“, im folgenden Format:

gs://<path_to_backup>. Schließt sich mit backup gegenseitig aus. Es muss genau eine der beiden Optionen festgelegt sein.

restore_type

RestoreType

Optional. Die Art der Wiederherstellung. Wenn nicht angegeben, lautet die Standardeinstellung METADATA_ONLY.

request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

ScalingConfig

Stellt die Skalierungskonfiguration eines Metastore-Dienstes dar.

Felder
autoscaling_config

AutoscalingConfig

Optional. Die Autoscaling-Konfiguration.

Union-Feld scaling_model. Stellt entweder eine vordefinierte Instanzgröße oder einen numerischen Skalierungsfaktor dar. Für scaling_model ist nur einer der folgenden Werte zulässig:
instance_size

InstanceSize

Ein Enum mit lesbaren Instanzgrößen, wobei jeder Instanzgröße ein Float-Wert zugeordnet ist (z.B. InstanceSize.EXTRA_SMALL = scaling_factor(0.1))

scaling_factor

float

Skalierungsfaktor, in Schritten von 0,1 für Werte unter 1,0 und in Schritten von 1,0 für Werte über 1,0.

InstanceSize

Metastore-Instanzgrößen

Enums
INSTANCE_SIZE_UNSPECIFIED Nicht angegebene Instanzgröße
EXTRA_SMALL Extra kleine Instanzgröße, entspricht einem Skalierungsfaktor von 0,1.
SMALL Kleine Instanzgröße, entspricht einem Skalierungsfaktor von 0,5.
MEDIUM Mittlere Instanzgröße, entspricht einem Skalierungsfaktor von 1,0.
LARGE Große Instanzgröße, entspricht einem Skalierungsfaktor von 3,0.
EXTRA_LARGE Extra große Instanzgröße, entspricht einem Skalierungsfaktor von 6,0.

ScheduledBackup

Hier wird die Konfiguration der geplanten Sicherung angegeben.

Felder
enabled

bool

Optional. Gibt an, ob die geplante Sicherung aktiviert ist. Der Standardwert ist „false“.

cron_schedule

string

Optional. Das geplante Intervall im Cron-Format, siehe https://de.wikipedia.org/wiki/Cron. Standardmäßig ist das Feld leer, d. h. die geplante Sicherung ist nicht aktiviert. Muss angegeben werden, um geplante Sicherungen zu aktivieren.

time_zone

string

Optional. Gibt die Zeitzone an, die bei der Interpretation von „cron_schedule“ verwendet werden soll. Muss der Name einer Zeitzone aus der Zeitzonendatenbank (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) sein, z.B. „America/Los_Angeles“ oder „Africa/Abidjan“. Wenn nichts angegeben wird, ist UTC die Standardzeitzone.

next_scheduled_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der die nächste Sicherung geplant ist.

backup_location

string

Optional. Einen Cloud Storage-URI eines Ordners im Format gs://<bucket_name>/<path_inside_bucket>. Darunter wird ein Unterordner <backup_folder> mit Sicherungsdateien gespeichert.

latest_backup

LatestBackup

Nur Ausgabe. Details zur letzten geplanten Sicherung.

Secret

Ein sicher gespeicherter Wert.

Felder

Union-Feld value.

Für value ist nur einer der folgenden Werte zulässig:

cloud_secret

string

Der relative Ressourcenname einer Secret-Version von Secret Manager im folgenden Format:

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

Dienst

Ein verwalteter Metadatenspeicherdienst, der Metadatenabfragen ausführt.

Felder
name

string

Nicht veränderbar. Der relative Ressourcenname des Metastore-Dienstes im folgenden Format:

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

create_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der der Metastore-Dienst erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Metastore-Dienst zuletzt aktualisiert wurde.

labels

map<string, string>

Benutzerdefinierte Labels für den Metastore-Dienst.

network

string

Nicht veränderbar. Der relative Ressourcenname des VPC-Netzwerks, auf das die Instanz zugreifen kann. Sie hat folgendes Format:

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

endpoint_uri

string

Nur Ausgabe. Der URI des Endpunkts, der für den Zugriff auf den Metastore-Dienst verwendet wird.

port

int32

Der TCP-Port, über den der Metastore-Dienst erreicht wird. Standard: 9083.

state

State

Nur Ausgabe. Der aktuelle Status des Metastore-Dienstes.

state_message

string

Nur Ausgabe. Zusätzliche Informationen zum aktuellen Status des Metastore-Dienstes, falls verfügbar.

artifact_gcs_uri

string

Nur Ausgabe. Ein Cloud Storage-URI (beginnend mit gs://), der angibt, wo Artefakte im Zusammenhang mit dem Metastore-Dienst gespeichert werden.

tier

Tier

Die Stufe des Dienstes.

metadata_integration

MetadataIntegration

Optional. Die Einstellung, die festlegt, wie Metadaten des Metastores in externe Dienste und Systeme eingebunden werden sollen.

maintenance_window

MaintenanceWindow

Das einstündige Wartungsfenster des Metastore-Dienstes. Hier wird angegeben, wann der Dienst zu Wartungszwecken in UTC-Zeit neu gestartet werden kann. Für Dienste mit dem Datenbanktyp SPANNER ist kein Wartungsfenster erforderlich.

uid

string

Nur Ausgabe. Die global eindeutige Ressourcen-ID des Metastore-Dienstes.

metadata_management_activity

MetadataManagementActivity

Nur Ausgabe. Die Metadatenverwaltungsaktivitäten des Metastore-Dienstes.

release_channel

ReleaseChannel

Nicht veränderbar. Die Release-Version des Dienstes. Wenn nicht angegeben, lautet die Standardeinstellung STABLE.

encryption_config

EncryptionConfig

Nicht veränderbar. Informationen, mit denen der Dataproc Metastore-Dienst zum Verschlüsseln inaktiver Kundendaten konfiguriert wird. Aktualisierung nicht möglich.

network_config

NetworkConfig

Die Konfiguration mit den Netzwerkeinstellungen für den Dataproc Metastore-Dienst.

database_type

DatabaseType

Nicht veränderbar. Der Datenbanktyp, in dem der Metastore-Dienst seine Daten speichert.

telemetry_config

TelemetryConfig

Die Konfiguration mit den Telemetrieeinstellungen für den Dataproc Metastore-Dienst. Wenn nicht angegeben, lautet die Standardeinstellung JSON.

scaling_config

ScalingConfig

Skalierungskonfiguration des Metastore-Dienstes

multi_region_config

MultiRegionConfig

Optional. Gibt die multiregionalen Konfigurationsinformationen für den Hive-Metastore-Dienst an.

scheduled_backup

ScheduledBackup

Optional. Die Konfiguration der geplanten Sicherung für den Metastore-Dienst.

deletion_protection

bool

Optional. Gibt an, ob der Dataproc Metastore vor versehentlichem Löschen geschützt werden soll.

Union-Feld metastore_config. Konfigurationseigenschaften, die für die zugrunde liegende Metastore-Diensttechnologie spezifisch sind (die Software, die Metastore-Abfragen ausführt). Für metastore_config ist nur einer der folgenden Werte zulässig:
hive_metastore_config

HiveMetastoreConfig

Konfigurationsinformationen für die Ausführung der Hive-Metastore-Software als Metastore-Dienst.

DatabaseType

Der Datenbanktyp des Backends für den Metastore-Dienst.

Enums
DATABASE_TYPE_UNSPECIFIED DATABASE_TYPE ist nicht festgelegt.
MYSQL MySQL wird zum Speichern der Metastore-Daten verwendet.
SPANNER Spanner wird verwendet, um die Metastore-Daten zu speichern.

ReleaseChannel

Releasekanäle bündeln Funktionen mit unterschiedlicher Stabilität. Neuere Funktionen können zuerst in weniger stabilen Release-Kanälen eingeführt und automatisch in stabilere Release-Kanäle hochgestuft werden.

Enums
RELEASE_CHANNEL_UNSPECIFIED Der Release-Kanal ist nicht angegeben.
CANARY Der CANARY-Release-Channel enthält die neuesten Funktionen, die möglicherweise instabil sind und ungelöste Probleme ohne bekannte Abhilfemaßnahmen haben. Für Dienste, die den Releasekanal CANARY verwenden, gelten keine SLAs.
STABLE Der Releasekanal STABLE enthält Funktionen, die als stabil gelten und für Produktionsumgebungen validiert wurden.

Bundesland

Der aktuelle Status des Metastore-Dienstes.

Enums
STATE_UNSPECIFIED Der Status des Metastore-Dienstes ist unbekannt.
CREATING Der Metastore-Dienst wird gerade erstellt.
ACTIVE Der Metastore-Dienst wird ausgeführt und ist bereit, Abfragen zu verarbeiten.
SUSPENDING Der Metastore-Dienst wird gesperrt. Die Verfügbarkeit für die Abfrageauslieferung kann unerwartet enden.
SUSPENDED Der Metastore-Dienst ist gesperrt und kann keine Abfragen bearbeiten.
UPDATING Der Metastore-Dienst wird aktualisiert. Sie kann weiterhin verwendet werden, es können jedoch keine weiteren Aktualisierungsanfragen angenommen und sie kann derzeit nicht gelöscht werden.
DELETING Der Metastore-Dienst wird gelöscht. Sie kann nicht verwendet werden.
ERROR Beim Metastore-Dienst ist ein Fehler aufgetreten und er kann nicht verwendet werden. Der Metastore-Dienst sollte gelöscht werden.
AUTOSCALING Der Dataproc Metastore-Dienst 2 wird hoch- oder herunterskaliert.
MIGRATING Der Metastore-Dienst verarbeitet eine verwaltete Migration.

Stufe

Verfügbare Dienststufen

Enums
TIER_UNSPECIFIED Die Stufe ist nicht festgelegt.
DEVELOPER Die Entwicklerstufe bietet begrenzte Skalierbarkeit und keine Fehlertoleranz. Geeignet für einen kostengünstigen Proof of Concept.
ENTERPRISE Die Enterprise-Stufe bietet Hochverfügbarkeit mit mehreren Zonen und ausreichende Skalierbarkeit für Dataproc Metastore-Arbeitslasten auf Unternehmensebene.

StartMigrationRequest

Anfragenachricht für DataprocMetastore.StartMigration.

Felder
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, zu dem die Migration gestartet werden soll, im folgenden Format:

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.migrations.start
migration_execution

MigrationExecution

Pflichtangabe. Die Konfigurationsdetails für die Migration.

request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

TelemetryConfig

Telemetriekonfiguration für den Dataproc Metastore-Dienst.

Felder
log_format

LogFormat

Das Ausgabeformat der Protokolle des Dataproc Metastore-Dienstes.

LogFormat

Enums
LOG_FORMAT_UNSPECIFIED LOG_FORMAT ist nicht festgelegt.
LEGACY Für die Protokollausgabe wird das alte textPayload-Format verwendet.
JSON Die Protokollausgabe verwendet das jsonPayload-Format.

UpdateFederationRequest

Anfragenachricht für UpdateFederation.

Felder
update_mask

FieldMask

Pflichtangabe. Eine Feldmaske, mit der die Felder angegeben werden, die durch die Aktualisierung in der Metastore-Verknüpfungsressource überschrieben werden sollen. Felder, die in update_mask angegeben sind, beziehen sich auf die Ressource und nicht auf die gesamte Anfrage. Ein Feld wird überschrieben, wenn es sich in der Maske befindet.

federation

Federation

Pflichtangabe. Die zu aktualisierende Metastore-Verknüpfung. Der Server führt nur dann ein Zusammenführen von Feldern im Dienst durch, wenn sie in update_mask angegeben sind.

Das Feld name der Metastore-Verknüpfung dient zur Identifizierung des zu aktualisierenden Metastore-Dienstes.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource federation erforderlich:

  • metastore.federations.update
request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

UpdateMetadataImportRequest

Anfragenachricht für DataprocMetastore.UpdateMetadataImport.

Felder
update_mask

FieldMask

Pflichtangabe. Eine Feldmaske, mit der die Felder angegeben werden, die durch die Aktualisierung in der Metadatenimportressource überschrieben werden sollen. Felder, die in update_mask angegeben sind, beziehen sich auf die Ressource und nicht auf die gesamte Anfrage. Ein Feld wird überschrieben, wenn es sich in der Maske befindet.

metadata_import

MetadataImport

Pflichtangabe. Der zu aktualisierende Metadatenimport. Der Server führt nur dann ein Zusammenführen von Feldern im Import durch, wenn sie in update_mask angegeben sind.

Das Feld name des Metadatenimports wird verwendet, um den zu aktualisierenden Metastore-Import zu identifizieren.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource metadataImport erforderlich:

  • metastore.imports.update
request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

UpdateServiceRequest

Anfragenachricht für DataprocMetastore.UpdateService.

Felder
update_mask

FieldMask

Pflichtangabe. Eine Feldmaske, mit der die Felder angegeben werden, die durch die Aktualisierung in der Metastore-Dienstressource überschrieben werden sollen. Felder, die in update_mask angegeben sind, beziehen sich auf die Ressource und nicht auf die gesamte Anfrage. Ein Feld wird überschrieben, wenn es sich in der Maske befindet.

service

Service

Pflichtangabe. Der Metastore-Dienst, der aktualisiert werden soll. Der Server führt nur dann ein Zusammenführen von Feldern im Dienst durch, wenn sie in update_mask angegeben sind.

Das Feld name des Metastore-Dienstes dient zur Identifizierung des zu aktualisierenden Metastore-Dienstes.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.services.update
request_id

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.