REST Resource: projects.locations.services

Ressource: Dienst

Ein verwalteter Metadatenspeicherdienst, der Metadatenabfragen ausführt.

JSON-Darstellung 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "network": string,
  "endpointUri": string,
  "port": integer,
  "state": enum (State),
  "stateMessage": string,
  "artifactGcsUri": string,
  "tier": enum (Tier),
  "metadataIntegration": {
    object (MetadataIntegration)
  },
  "maintenanceWindow": {
    object (MaintenanceWindow)
  },
  "uid": string,
  "metadataManagementActivity": {
    object (MetadataManagementActivity)
  },
  "releaseChannel": enum (ReleaseChannel),
  "encryptionConfig": {
    object (EncryptionConfig)
  },
  "networkConfig": {
    object (NetworkConfig)
  },
  "databaseType": enum (DatabaseType),
  "telemetryConfig": {
    object (TelemetryConfig)
  },
  "scalingConfig": {
    object (ScalingConfig)
  },
  "multiRegionConfig": {
    object (MultiRegionConfig)
  },
  "scheduledBackup": {
    object (ScheduledBackup)
  },
  "deletionProtection": boolean,

  // Union field metastore_config can be only one of the following:
  "hiveMetastoreConfig": {
    object (HiveMetastoreConfig)
  }
  // End of list of possible types for union field metastore_config.
}
Felder
name

string

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

projects/{projectNumber}/locations/{locationId}/services/{serviceId}.
createTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Benutzerdefinierte Labels für den Metastore-Dienst.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
network

string

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

projects/{projectNumber}/global/networks/{network_id}.
endpointUri

string

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

integer

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

enum (State)

Nur Ausgabe. Der aktuelle Status des Metastore-Dienstes.
stateMessage

string

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

string

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

enum (Tier)

Die Stufe des Dienstes.
metadataIntegration

object (MetadataIntegration)

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

object (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.
metadataManagementActivity

object (MetadataManagementActivity)

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

enum (ReleaseChannel)

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

object (EncryptionConfig)

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

object (NetworkConfig)

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

enum (DatabaseType)

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

object (TelemetryConfig)

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

object (ScalingConfig)

Skalierungskonfiguration des Metastore-Dienstes
multiRegionConfig

object (MultiRegionConfig)

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

object (ScheduledBackup)

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

boolean

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

object (HiveMetastoreConfig)

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

HiveMetastoreConfig

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

JSON-Darstellung 
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "kerberosConfig": {
    object (KerberosConfig)
  },
  "endpointProtocol": enum (EndpointProtocol),
  "auxiliaryVersions": {
    string: {
      object (AuxiliaryVersionConfig)
    },
    ...
  }
}
Felder
version

string

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

map (key: string, value: 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.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
kerberosConfig

object (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 services.patch-Methode und geben Sie den Pfad dieses Felds (hiveMetastoreConfig.kerberos_config) in der updateMask der Anfrage an. Lassen Sie dieses Feld jedoch aus der service der Anfrage aus.
endpointProtocol

enum (EndpointProtocol)

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

map (key: string, value: object (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.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

KerberosConfig

Konfigurationsinformationen für einen Kerberos-Hauptbenutzer.

JSON-Darstellung 
{
  "keytab": {
    object (Secret)
  },
  "principal": string,
  "krb5ConfigGcsUri": string
}
Felder
keytab

object (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.
krb5ConfigGcsUri

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.

Secret

Ein sicher gespeicherter Wert.

JSON-Darstellung 
{

  // Union field value can be only one of the following:
  "cloudSecret": string
  // End of list of possible types for union field value.
}
Felder

Union-Feld value.

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

string

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

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

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.

AuxiliaryVersionConfig

Konfigurationsinformationen für die Zusatzversionen des Dienstes.

JSON-Darstellung 
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "networkConfig": {
    object (NetworkConfig)
  }
}
Felder
version

string

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

map (key: string, value: 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.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
networkConfig

object (NetworkConfig)

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

NetworkConfig

Netzwerkkonfiguration für den Dataproc Metastore-Dienst.

JSON-Darstellung 
{
  "consumers": [
    {
      object (Consumer)
    }
  ],
  "customRoutesEnabled": boolean
}
Felder
consumers[]

object (Consumer)

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

boolean

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.

JSON-Darstellung 
{
  "endpointUri": string,
  "endpointLocation": string,

  // Union field vpc_resource can be only one of the following:
  "subnetwork": string
  // End of list of possible types for union field vpc_resource.
}
Felder
endpointUri

string

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

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

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.

MetadataIntegration

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

JSON-Darstellung 
{
  "dataCatalogConfig": {
    object (DataCatalogConfig)
  },
  "dataplexConfig": {
    object (DataplexConfig)
  }
}
Felder
dataCatalogConfig

object (DataCatalogConfig)

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

object (DataplexConfig)

Die Integrationskonfiguration für den Dataplex-Dienst.

DataCatalogConfig

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

JSON-Darstellung 
{
  "enabled": boolean
}
Felder
enabled

boolean

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.

DataplexConfig

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

JSON-Darstellung 
{
  "lakeResources": {
    string: {
      object (Lake)
    },
    ...
  }
}
Felder
lakeResources

map (key: string, value: object (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/{projectNumber}/locations/{locationId}/lakes/{lake_id}.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Lake

Stellt eine Lake-Ressource dar

JSON-Darstellung 
{
  "name": string
}
Felder
name

string

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

MaintenanceWindow

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

JSON-Darstellung 
{
  "hourOfDay": integer,
  "dayOfWeek": enum (DayOfWeek)
}
Felder
hourOfDay

integer

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

enum (DayOfWeek)

Der Wochentag, an dem das Zeitfenster beginnt.

MetadataManagementActivity

Die Metadatenverwaltungsaktivitäten des Metastore-Dienstes.

JSON-Darstellung 
{
  "metadataExports": [
    {
      object (MetadataExport)
    }
  ],
  "restores": [
    {
      object (Restore)
    }
  ]
}
Felder
metadataExports[]

object (MetadataExport)

Nur Ausgabe. Die neuesten Metadatenexporte des Metastore-Dienstes.
restores[]

object (Restore)

Nur Ausgabe. Die letzten Wiederherstellungen des Metastore-Dienstes.

MetadataExport

Die Details eines Metadatenexportvorgangs.

JSON-Darstellung 
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "databaseDumpType": enum (Type),

  // Union field destination can be only one of the following:
  "destinationGcsUri": string
  // End of list of possible types for union field destination.
}
Felder
startTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
state

enum (State)

Nur Ausgabe. Der aktuelle Status des Exports.
databaseDumpType

enum (Type)

Nur Ausgabe. Der Typ des Datenbankdumps.

Union-Feld destination.

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

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.

Wiederherstellen

Die Details eines Metadatenwiederherstellungsvorgangs.

JSON-Darstellung 
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "backup": string,
  "type": enum (RestoreType),
  "details": string,
  "backupLocation": string
}
Felder
startTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
state

enum (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/{projectId}/locations/{locationId}/services/{serviceId}/backups/{backupId}.
type

enum (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.
backupLocation

string

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

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.

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.

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.

EncryptionConfig

Verschlüsselungseinstellungen für den Dienst.

JSON-Darstellung 
{
  "kmsKey": string
}
Felder
kmsKey

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/{projectNumber}/locations/{locationId}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}.

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.

TelemetryConfig

Telemetriekonfiguration für den Dataproc Metastore-Dienst.

JSON-Darstellung 
{
  "logFormat": enum (LogFormat)
}
Felder
logFormat

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

ScalingConfig

Stellt die Skalierungskonfiguration eines Metastore-Dienstes dar.

JSON-Darstellung 
{
  "autoscalingConfig": {
    object (AutoscalingConfig)
  },

  // Union field scaling_model can be only one of the following:
  "instanceSize": enum (InstanceSize),
  "scalingFactor": number
  // End of list of possible types for union field scaling_model.
}
Felder
autoscalingConfig

object (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:
instanceSize

enum (InstanceSize)

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

number

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.

AutoscalingConfig

Stellt die Autoscaling-Konfiguration eines Metastore-Dienstes dar.

JSON-Darstellung 
{
  "autoscalingFactor": number,
  "autoscalingEnabled": boolean,
  "limitConfig": {
    object (LimitConfig)
  }
}
Felder
autoscalingFactor

number

Nur Ausgabe. Der Skalierungsfaktor eines Dienstes mit aktiviertem Autoscaling.
autoscalingEnabled

boolean

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

object (LimitConfig)

Optional. Die LimitConfig des Dienstes.

LimitConfig

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

JSON-Darstellung 
{
  "maxScalingFactor": number,
  "minScalingFactor": number
}
Felder
maxScalingFactor

number

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

number

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

MultiRegionConfig

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

JSON-Darstellung 
{
  "certificates": [
    {
      object (RootCACertificate)
    }
  ],
  "customRegionConfig": {
    object (CustomRegionConfig)
  }
}
Felder
certificates[]
(deprecated)

object (RootCACertificate)

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

object (CustomRegionConfig)

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.

JSON-Darstellung 
{
  "certificate": string,
  "expirationTime": string
}
Felder
certificate
(deprecated)

string

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

string (Timestamp format)

Das Ablaufdatum des Zertifikats im Zeitstempelformat.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

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.

JSON-Darstellung 
{
  "readWriteRegions": [
    string
  ],
  "readOnlyRegions": [
    string
  ]
}
Felder
readWriteRegions[]

string

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

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.

ScheduledBackup

Hier wird die Konfiguration der geplanten Sicherung angegeben.

JSON-Darstellung 
{
  "enabled": boolean,
  "cronSchedule": string,
  "timeZone": string,
  "nextScheduledTime": string,
  "backupLocation": string,
  "latestBackup": {
    object (LatestBackup)
  }
}
Felder
enabled

boolean

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

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

string

Optional. Gibt die Zeitzone an, die bei der Interpretation von „cronSchedule“ 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.
nextScheduledTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
backupLocation

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

object (LatestBackup)

Nur Ausgabe. Details zur letzten geplanten Sicherung.

LatestBackup

Details zur letzten geplanten Sicherung.

JSON-Darstellung 
{
  "backupId": string,
  "startTime": string,
  "state": enum (State),
  "duration": string
}
Felder
backupId

string

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

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
state

enum (State)

Nur Ausgabe. Der aktuelle Status der Sicherung.
duration

string (Duration format)

Nur Ausgabe. Die Dauer der Sicherung.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

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.

Methoden

alterLocation

 Speicherort der Metadatenressource ändern

alterTableProperties

 Eigenschaften der Metadatentabelle ändern

cancelMigration

 Bricht den laufenden Prozess der verwalteten Migration ab.

completeMigration

 Schließt den verwalteten Migrationsprozess ab.

create

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

delete

 Löscht einen einzelnen Dienst.

exportMetadata

 Exportiert Metadaten aus einem Dienst.

get

 Ruft die Details eines einzelnen Dienstes ab.

getIamPolicy

 Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab.

list

 Listet Dienste in einem Projekt und an einem Standort auf.

moveTableToDatabase

 Eine Tabelle in eine andere Datenbank verschieben

patch

 Aktualisiert die Parameter eines einzelnen Dienstes.

queryMetadata

 Abfragen von Dataproc Metastore-Metadaten

removeIamPolicy

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

restore

 Stellt einen Dienst aus einer Sicherung wieder her.

setIamPolicy

 Legt die Zugriffskontrollrichtlinie für die angegebene Ressource fest.

startMigration

 Startet den Prozess der verwalteten Migration.

testIamPermissions

 Gibt die Berechtigungen des Aufrufers für die angegebene Ressource zurück.