REST Resource: iceberg.v1.restcatalog.extensions.projects.catalogs

Ressource: IcebergCatalog

Die Informationen zum Iceberg-REST-Katalog.

JSON-Darstellung
{
  "name": string,
  "credential-mode": enum (CredentialMode),
  "biglake-service-account": string,
  "biglake-service-account-id": string,
  "catalog-type": enum (CatalogType),
  "default-location": string,
  "storage-regions": [
    string
  ],
  "create-time": string,
  "update-time": string,
  "replicas": [
    {
      object (Replica)
    }
  ],
  "description": string,
  "restricted-locations-config": {
    object (RestrictedLocationsConfig)
  },
  "federated-catalog-options": {
    object (FederatedCatalogOptions)
  },
  "cross-cloud-cache-options": {
    object (CrossCloudCacheOptions)
  },
  "encryption-config": {
    object (EncryptionConfig)
  }
}
Felder
name

string

ID. Der Katalogname, projects/my-project/catalogs/my-catalog. Dieses Feld ist unveränderlich. Dieses Feld wird für „catalogs.create“ ignoriert.

credential-mode

enum (CredentialMode)

Optional. Der Anmeldedatenmodus für den Katalog.

biglake-service-account

string

Nur Ausgabe. Das Dienstkonto, das für die Bereitstellung von Anmeldedaten verwendet wird (nur Ausgabe). Kann leer sein, wenn die Bereitstellung von Anmeldedaten für den Katalog nie aktiviert wurde.

Bei föderierten Katalogen wird das Dienstkonto immer bereitgestellt und für den Zugriff auf den Remote-Katalog zur Hintergrundaktualisierung von Metadaten verwendet. Wenn google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.IdentityMode auf IDENTITY_MODE_SERVICE_IDENTITY festgelegt ist, wird sie auch für Abfragen verwendet.

biglake-service-account-id

string

Nur Ausgabe. Die eindeutige ID des Dienstkontos. Dies wird für Föderationsszenarien verwendet.

catalog-type

enum (CatalogType)

Erforderlich. Der Katalogtyp. Erforderlich für catalogs.create. Der Katalogtyp ist unveränderlich, außer bei der Konvertierung von CATALOG_TYPE_GCS_BUCKET in CATALOG_TYPE_BIGLAKE.

default-location

string

Optional. Der Standardspeicherort für den Katalog, z.B. gs://my-bucket. Bei Google Cloud Storage-Bucket-Katalogen ist dies ein reiner Ausgabewert.

Bei BigLake-Katalogen muss dieses Feld angegeben werden und auf einen Google Cloud Storage-Bucket oder einen Pfad in diesem Bucket verweisen. Dieser Pfad dient als Basisverzeichnis für die Erstellung des vollständigen Pfads zu den Daten- und Metadatenverzeichnissen einer Tabelle, wenn kein Speicherort auf Namespace- oder Tabellenebene angegeben ist. Der vollständige Pfad wird gebildet, indem die Namespace- und Tabellenkennungen an den Standardstandort angehängt werden.

storage-regions[]

string

Nur Ausgabe. Die Google Cloud-Regionen des Buckets am Standardstandort, z.B. us-central1, nam4 oder us. Dieser enthält einen Wert für alle Standorte, mit Ausnahme der Kataloge, die für die Verwendung benutzerdefinierter Dual-Region-Buckets konfiguriert sind. In diesem Fall enthält er die beiden Regionen des Buckets. Die Regionen dieses Felds sollten sich im Zuständigkeitsbereich des primären Standorts des Katalogs oder in der Nähe davon befinden.

create-time

string (Timestamp format)

Nur Ausgabe. Wann der Katalog erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

update-time

string (Timestamp format)

Nur Ausgabe. Wann der Katalog zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

replicas[]

object (Replica)

Nur Ausgabe. Die Replikate für die Katalogmetadaten.

description

string

Optional. Eine vom Nutzer angegebene Beschreibung des Katalogs. Die Beschreibung muss ein UTF-8-String mit maximal 1.024 Zeichen sein.

restricted-locations-config

object (RestrictedLocationsConfig)

Optional. Konfiguration für eingeschränkte Standorte. Dieses Feld wird derzeit nur für BigLake-Kataloge verwendet.

Wenn dieses Feld nicht festgelegt ist oder restrictedLocationsConfig.restricted_locations leer ist, sind alle zugänglichen Standorte zulässig. Wenn restrictedLocationsConfig.restricted_locations nicht leer ist, sind nur Standorte in defaultLocation und restrictedLocationsConfig.restricted_locations zulässig.

federated-catalog-options

object (FederatedCatalogOptions)

Optional. Konfigurationsoptionen für föderierte Kataloge.

cross-cloud-cache-options

object (CrossCloudCacheOptions)

Optional. Konfigurationsoptionen für das cloudübergreifende Caching von Daten- und Metadatendateien.

encryption-config

object (EncryptionConfig)

Optional. Benutzerdefinierte Verschlüsselungskonfiguration (z.B. Cloud KMS-Schlüssel).

CredentialMode

Der für den Katalog verwendete Anmeldedatenmodus.

Enums
CREDENTIAL_MODE_UNSPECIFIED Standardwert/nicht festgelegter Wert. Dieser Wert wird nicht verwendet.
CREDENTIAL_MODE_END_USER Modus für Anmeldedaten von Endnutzern, Standard. Der authentifizierende Nutzer muss Zugriff auf die Katalogressourcen und die zugrunde liegenden Google Cloud Storage-Objekte haben.
CREDENTIAL_MODE_VENDED_CREDENTIALS

Modus für Bereitstellung von Anmeldedaten. Der authentifizierende Nutzer benötigt nur Zugriff auf die Katalogressourcen. Das System stellt dem Aufrufer eingeschränkte Anmeldedaten für den Zugriff auf die Google Cloud Storage-Objekte zur Verfügung. Für alle Tabellenvorgänge in diesem Modus muss der Header X-Iceberg-Access-Delegation auf vended-credentials gesetzt sein. Das System generiert ein Dienstkonto in google.cloud.biglake.v1main.IcebergCatalog.biglake_service_account, für das der Katalogadministrator Zugriff auf Google Cloud Storage-Objekte gewähren muss.

Weitere Informationen finden Sie unter https://docs.cloud.google.com/lakehouse/docs/credential-vending.

CatalogType

Bestimmt den Katalogtyp.

Enums
CATALOG_TYPE_UNSPECIFIED Standardwert/nicht festgelegter Wert. Dieser Wert wird nicht verwendet.
CATALOG_TYPE_GCS_BUCKET Google Cloud Storage-Bucket-Katalogtyp.
CATALOG_TYPE_BIGLAKE BigLake-Katalogtyp.
CATALOG_TYPE_FEDERATED Typ des föderierten Katalogs.
CATALOG_TYPE_ALLOYDB_AGENT_MODE Katalog zum Abfragen von AlloyDB-Tabellen im Agentenmodus.

Replikat

Das Replikat des Katalogs.

JSON-Darstellung
{
  "region": string,
  "state": enum (State)
}
Felder
region

string

Nur Ausgabe. Die Region des Replikats. Beispiel: „us-east1“

state

enum (State)

Nur Ausgabe. Der aktuelle Status des Replikats.

Bundesland

Wenn der Katalog in mehrere Regionen repliziert wird, beschreibt dieser Enum den aktuellen Status des Replikats.

Enums
STATE_UNKNOWN Standardwert/nicht festgelegter Wert. Dieser Wert wird nicht verwendet.
STATE_PRIMARY Das Replikat ist die beschreibbare primäre Instanz.
STATE_PRIMARY_IN_PROGRESS Das Replikat wurde vor Kurzem als primäres Replikat zugewiesen, aber noch nicht alle Namespaces sind beschreibbar.
STATE_SECONDARY Das Replikat ist ein sekundäres Replikat mit Lesezugriff.

RestrictedLocationsConfig

Konfiguration von Standortbeschränkungen.

JSON-Darstellung
{
  "restricted-locations": [
    string
  ]
}
Felder
restricted-locations[]

string

Optional. Zusätzliche Google Cloud Storage-Buckets und -Standorte (z.B. gs://my-other-bucket/...), die von Ressourcen in einem Katalog verwendet werden dürfen. Dieses Feld wird derzeit nur für BigLake-Kataloge verwendet.

Wenn restrictedLocations leer ist und die uneingeschränkte Katalogerstellung aktiviert ist, sind alle zugänglichen Standorte zulässig. Andernfalls sind nur defaultLocation und Standorte in dieser Liste zulässig.

EncryptionConfig

Benutzerdefinierte Verschlüsselungskonfiguration (z.B. Cloud KMS-Schlüssel).

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

string

Optional. Cloud KMS-Schlüsselname, der zum Verschlüsseln der aus dem Katalog abgerufenen im Cache gespeicherten Daten verwendet wird. Format: projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}

FederatedCatalogOptions

Konfigurationsoptionen für einen föderierten Katalog.

JSON-Darstellung
{
  "identity-mode": enum (IdentityMode),
  "refresh-options": {
    object (RefreshOptions)
  },
  "refresh-status": {
    object (RefreshStatus)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "identity-federation-organization-service-account": {
    object (IdentityFederationOrganizationServiceAccount)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "unity-catalog-info": {
    object (UnityCatalogInfo)
  },
  "glue-catalog-info": {
    object (GlueCatalogInfo)
  },
  "snowflake-catalog-info": {
    object (SnowflakeCatalogInfo)
  },
  "workday-catalog-info": {
    object (WorkdayCatalogInfo)
  }
  // End of mutually exclusive fields.
  "secret-name": string,
  "service-directory-name": string,
  "metadata-service-directory-name": string,
  "user-identity-federation-oidc-claims": {
    object (UserIdentityFederationOidcClaims)
  },
  "user-identity-federation-oidc": {
    object (UserIdentityFederationOidc)
  }
}
Felder
identity-mode

enum (IdentityMode)

Optional. Der Identitätsmodus für den föderierten Katalog.

refresh-options

object (RefreshOptions)

Optional. Konfiguration aktualisieren.

refresh-status

object (RefreshStatus)

Nur Ausgabe. Der Status der Hintergrundvorgänge zur Metadatenaktualisierung.

Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
identity-federation-organization-service-account

object (IdentityFederationOrganizationServiceAccount)

Nur Ausgabe. Das Dienstkonto auf Organisationsebene, das für die Identitätsföderation verwendet wird.

Ende der sich gegenseitig ausschließenden Felder.
Informationen zum Remote-Iceberg-REST-Katalog. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
unity-catalog-info

object (UnityCatalogInfo)

Optional. Informationen speziell zu Databricks Unity Catalog.

glue-catalog-info

object (GlueCatalogInfo)

Optional. Spezifische Informationen zu AWS Glue Data Catalog.

snowflake-catalog-info

object (SnowflakeCatalogInfo)

Optional. Informationen speziell zu Snowflake Horizon Catalog.

workday-catalog-info

object (WorkdayCatalogInfo)

Optional. Spezifische Informationen zu Workday Data Lake.

Ende der sich gegenseitig ausschließenden Felder.
secret-name

string

Optional. Der Name der Secret-Ressource in Secret Manager im Format projects/{projectId}/locations/{location}/secrets/{secret_id} oder projects/{projectId}/locations/{location}/secrets/{secret_id}/versions/{version_id}.

Die Projekt-ID muss mit dem Projekt des Katalogs und der Standort mit dem Standort des Katalogs übereinstimmen. Wenn keine Version angegeben ist, wird die aktuelle Version verwendet.

Dieses Feld wird nicht verwendet, wenn google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.UnityCatalogInfo.service_principal_application_id, google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.SnowflakeCatalogInfo.snowflake_role oder google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.WorkdayCatalogInfo.api_client_client_id festgelegt ist.

service-directory-name

string

Optional. Der Name der Service Directory-Ressource, die zum Weiterleiten des Transportschicht-Traffics mit dem Remote-Katalog (z. B. Zugriff auf Datendateien in Storage-Buckets) über eine private Netzwerkverbindung verwendet wird.

Format: projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}

Wird von BigQuery-Abfragen verwendet, um private Endpunkte zum Abrufen von Datendateien (z.B. Iceberg-Daten in S3 oder Azure Data Lake Storage) über eine private Netzwerkverbindung wie Cross-Cloud Interconnect aufzulösen.

metadata-service-directory-name

string

Optional. Der Name der Service Directory-Ressource, die zum Weiterleiten des Traffics der Metadatenebene mit dem Remote-Katalog über eine private Netzwerkverbindung verwendet wird.

Format: projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}

Wird verwendet, um Katalogmetadaten (z. B. Iceberg-Konfigurationen, Namespaces und Tabellen) über eine private Netzwerkverbindung wie Cross-Cloud Interconnect abzurufen. Wird auch zum Abrufen von OAuth-Tokens verwendet, wenn oauth2ServerUrl nicht festgelegt ist. Wenn dieses Feld nicht festgelegt ist, werden Anfragen über das öffentliche Internet gesendet.

user-identity-federation-oidc-claims
(deprecated)

object (UserIdentityFederationOidcClaims)

Nur Ausgabe. Nicht mehr unterstützt: Verwenden Sie stattdessen google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.user_identity_federation_oidc.

Die OIDC-Anforderungen, die im ID-Token für die Nutzeridentitätsföderation ausgegeben werden.

user-identity-federation-oidc

object (UserIdentityFederationOidc)

Nur Ausgabe. Die OIDC-Konfiguration für die Nutzeridentitätsföderation.

IdentityFederationOrganizationServiceAccount

Das Dienstkonto auf Organisationsebene, das für die Identitätsföderation verwendet wird (nur Ausgabe). Kann leer sein, wenn die Identitätsföderation für den Katalog nie aktiviert wurde.

JSON-Darstellung
{
  "service-account": string,
  "service-account-unique-id": string
}
Felder
service-account

string

Nur Ausgabe. E-Mail-Adresse des Dienstkontos auf Organisationsebene.

service-account-unique-id

string

Nur Ausgabe. Die eindeutige ID des Dienstkontos auf Organisationsebene.

UnityCatalogInfo

Informationen speziell zu Databricks Unity Catalog. Der Iceberg-REST-Katalogendpunkt hat das folgende Format: https://<instanceName>/api/2.1/unity-catalog/iceberg-rest/v1/config?warehouse=<catalogName>.

JSON-Darstellung
{
  "instance-name": string,
  "catalog-name": string,
  "service-principal-application-id": string
}
Felder
instance-name

string

Erforderlich. Nicht veränderbar. Der Instanzname des Databricks-Arbeitsbereichs. Lautet die URL des Databricks-Arbeitsbereichs beispielsweise https://1.1.gcp.databricks.com, so ist der Instanzname 1.1.gcp.databricks.com.

catalog-name

string

Erforderlich. Nicht veränderbar. Der Name des Katalogs in Databricks Unity Catalog.

service-principal-application-id

string

Optional. Die Anwendungs-ID des Databricks-Dienstprinzipals, der für den Zugriff auf Databricks Unity Catalog im OIDC-Authentifizierungsablauf verwendet wird.

GlueCatalogInfo

Spezifische Informationen zu AWS Glue Data Catalog. Der Iceberg-REST-Katalogendpunkt hat das folgende Format: https://glue.<awsRegion>.amazonaws.com/iceberg/v1/config?warehouse=<warehouse>.

JSON-Darstellung
{
  "warehouse": string,
  "aws-region": string,
  "aws-role-arn": string
}
Felder
warehouse

string

Erforderlich. Nicht veränderbar. Der Warehouse-Standort in AWS Glue Data Catalog.

Verwenden Sie für den Katalog des Standardkontos die 12-stellige AWS-Konto-ID (z. B. 111222333444). Verwenden Sie für einen Amazon S3-Tabellen-Bucket das Format <account_id>:s3tablescatalog/<table_bucket_name> (z. B. 111222333444:s3tablescatalog/my-table-bucket).

aws-region

string

Erforderlich. Nicht veränderbar. Die AWS-Region des AWS Glue Data Catalog (z. B. us-east-1). Die Region des föderierten Katalogs sollte sich zwecks optimaler Leistung am selben geografischen Standort und in derselben Gerichtsbarkeit wie die AWS-Region befinden.

aws-role-arn

string

Erforderlich. Der Amazon Resource Name (ARN) der AWS-IAM-Rolle, die der föderierte Katalog für den Zugriff auf AWS Glue Data Catalog übernimmt.

SnowflakeCatalogInfo

Informationen speziell zu Snowflake Horizon Catalog. Der Iceberg-REST-Katalogendpunkt hat das folgende Format: https://<accountIdentifier>.snowflakecomputing.com/polaris/api/catalog/v1/config?warehouse=<warehouse>.

JSON-Darstellung
{
  "account-identifier": string,
  "warehouse": string,
  "snowflake-role": string
}
Felder
account-identifier

string

Erforderlich. Nicht veränderbar. Die Konto-ID in Snowflake. Lautet die URL der Snowflake-Bereitstellung beispielsweise https://myorg-myaccount.snowflakecomputing.com, so ist die Konto-ID myorg-myaccount.

Die Konto-ID kann Buchstaben, Ziffern und Unterstriche enthalten, wobei die Segmente durch Bindestriche (-) oder Punkte (.) getrennt sind. Es werden das Format für Organisationskonten (z. B. myorg-myaccount), das alte Format für Konto-Locators (z. B. xy12345.us-east-1) und Formate für private Konnektivität (PrivateLink) (z. B. myorg-myaccount.privatelink oder xy12345.us-east-1.privatelink) unterstützt. Weitere Informationen finden Sie unter https://docs.snowflake.com/en/user-guide/admin-account-identifier.

warehouse

string

Erforderlich. Nicht veränderbar. Der Datenbankname in Snowflake Horizon Catalog.

snowflake-role

string

Optional. Die Snowflake-Rolle, die im Authentifizierungsablauf der Workload Identity-Föderation (OIDC) verwendet wird, um den Zugriff auf Snowflake Horizon Catalog einzuschränken.

WorkdayCatalogInfo

Spezifische Informationen zu Workday Data Lake. Der Iceberg-REST-Katalogendpunkt hat das folgende Format: https://<baseUrl>/datalake/api/catalog/v1/config?warehouse=workday.

JSON-Darstellung
{
  "base-url": string,
  "tenant": string,
  "api-client-client-id": string
}
Felder
base-url

string

Erforderlich. Nicht veränderbar. Die Basis-URL der Workday-Instanz. Beispiel: impl-services1.wd12.myworkday.com oder wd501.myworkday.com.

tenant

string

Erforderlich. Nicht veränderbar. Der Name des Workday-Mandanten.

api-client-client-id

string

Optional. Die Client-ID des Workday API-Clients, der für den Zugriff auf Workday Data Lake im OIDC-Authentifizierungsablauf verwendet wird.

IdentityMode

Der Identitätsmodus, der vom Katalog für Abfragen verwendet wird.

Enums
IDENTITY_MODE_UNSPECIFIED Standardwert/nicht festgelegter Wert. Dieser Wert wird genauso behandelt wie IDENTITY_MODE_SERVICE_IDENTITY.
IDENTITY_MODE_SERVICE_IDENTITY Abfragen werden mit dem Dienstkonto in google.cloud.biglake.v1main.IcebergCatalog.biglake_service_account ausgeführt.
IDENTITY_MODE_USER_IDENTITY_FEDERATION

Abfragen werden mit der Identität des Endnutzers ausgeführt und an den Remote-Katalog weitergegeben. Die Identitätsföderation muss im Remote-Katalog konfiguriert sein.

Weitere Informationen finden Sie unter https://docs.cloud.google.com/lakehouse/docs/about-cross-cloud-data-access#identity-mode.

UserIdentityFederationOidcClaims

OIDC-Anforderungen, die im ID-Token ausgegeben werden, wenn IDENTITY_MODE_USER_IDENTITY_FEDERATION aktiviert ist.

Diese Werte identifizieren den Identitätsanbieter (Aussteller) und den vorgesehenen Empfänger (Zielgruppe) des Tokens. Um die Nutzeridentitätsföderation zu aktivieren, müssen Nutzer ihren Remote-Katalog so konfigurieren, dass er diesem Aussteller vertraut und diese Zielgruppe erwartet.

JSON-Darstellung
{
  "issuer-url": string,
  "audience": string
}
Felder
issuer-url

string

Nur Ausgabe. Die Aussteller-URL des Identitätsanbieters.

audience

string

Nur Ausgabe. Die Zielgruppe, die dieser Katalog im Token erwartet.

UserIdentityFederationOidc

OIDC-Konfiguration, die verwendet wird, wenn IDENTITY_MODE_USER_IDENTITY_FEDERATION aktiviert ist.

Um die Nutzeridentitätsföderation zu aktivieren, müssen Nutzer ihren Remote-Katalog so konfigurieren, dass Tokens mit diesen Parametern vertraut wird.

JSON-Darstellung
{
  "issuer-url": string,
  "audience": string,
  "jwks-url": string
}
Felder
issuer-url

string

Nur Ausgabe. Die Aussteller-URL des Identitätsanbieters.

audience

string

Nur Ausgabe. Die Zielgruppe, die dieser Katalog im Token erwartet.

jwks-url

string

Nur Ausgabe. Die JWKS-URL (JSON Web Key Set), die die öffentlichen Schlüssel bereitstellt, mit denen das Token verifiziert wird. Wird nur für föderierte Snowflake Horizon-Kataloge festgelegt, wobei es als EXTERNAL_OAUTH_JWS_KEYS_URL in der Snowflake-Sicherheitsintegration verwendet wird.

RefreshOptions

Konfiguration aktualisieren.

JSON-Darstellung
{
  "refresh-schedule": {
    object (RefreshSchedule)
  },
  "refresh-scope": {
    object (RefreshScope)
  }
}
Felder
refresh-schedule

object (RefreshSchedule)

Optional. Der Zeitplan definiert, ob und wann die Metadatenaktualisierung geplant werden soll.

refresh-scope

object (RefreshScope)

Optional. Bereichskonfigurationen aktualisieren.

RefreshSchedule

Der Zeitplan definiert, ob und wann die Metadatenaktualisierung geplant werden soll.

JSON-Darstellung
{
  "refresh-interval": string
}
Felder
refresh-interval

string (Duration format)

Optional. Das Intervall für die Aktualisierung von Metadaten aus dem Remote-Katalog. Wenn der Wert nicht festgelegt oder <= 0 ist, wird die Hintergrundaktualisierung der Metadaten deaktiviert. Wenn dieses Feld für einen vorhandenen föderierten Katalog aktualisiert wird, muss die vorherige Aktualisierung der Hintergrundmetadaten abgeschlossen sein, bevor das neue Aktualisierungsintervall wirksam wird.

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

RefreshScope

Der Bereich definiert eine Teilmenge von Namespaces, die aktualisiert werden sollen.

JSON-Darstellung
{
  "namespace-filters": [
    string
  ]
}
Felder
namespace-filters[]

string

Optional. Filter, mit denen festgelegt wird, welche Namespaces in den Aktualisierungsprozess einbezogen werden. – Eine leere Liste bedeutet, dass alle Namespaces eingeschlossen werden. – „[namespaces]“ bedeutet, dass die angegebenen Namespaces eingeschlossen werden sollen. ['ns1', 'ns2'] : Nur die Namespaces „ns1“ und „ns2“ werden erkannt.

RefreshStatus

Status der Metadatenaktualisierung im Hintergrund für den Remote-Katalog.

JSON-Darstellung
{
  "start-time": string,
  "end-time": string,
  "status": {
    object (Status)
  }
}
Felder
start-time

string (Timestamp format)

Nur Ausgabe. Wenn die Katalogaktualisierung gestartet wurde, einschließlich laufender Aktualisierungen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

end-time

string (Timestamp format)

Nur Ausgabe. Wenn die Katalogaktualisierung abgeschlossen ist, wird die Einstellung für laufende Aktualisierungen aufgehoben.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

status

object (Status)

Nur Ausgabe. Der Status des letzten Vorgangs zur Aktualisierung von Metadaten im Hintergrund. Für laufende Aktualisierungen ist dieser Wert nicht festgelegt.

CrossCloudCacheOptions

Konfigurationsoptionen für das cloudübergreifende Caching von Daten- und Metadatendateien.

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

boolean

Optional. Gibt an, ob das cloudübergreifende Caching von Daten- und Metadatendateien aktiviert ist. Dies betrifft nur Abfragen über BigQuery.

Wenn dieser Wert true ist, werden gelesene Daten und Metadaten in einem Cache gespeichert. Dadurch kann die Leistung erhöht und die Kosten für ausgehenden Netzwerktraffic bei cloudübergreifenden Abfragen gesenkt werden.

Wenn dieser Wert false ist, ist das cloudübergreifende Caching deaktiviert.

Methoden

create

Erstellt den Iceberg-REST-Katalog.

delete

Löscht den Iceberg-REST-Katalog.

failover

Führen Sie ein Failover des Katalogs in eine neue primäre Replikatregion durch.

get

Gibt die Konfigurationsoptionen für den Iceberg-REST-Katalog zurück.

list

Listet die Iceberg-REST-Kataloge auf.

patch

Aktualisieren Sie die Konfigurationsoptionen für den Iceberg-REST-Katalog.