REST Resource: deltasharing.v1.projects.catalogs

Ressource: DeltaSharingCatalog

Stellt einen Delta Sharing-Katalog dar.

JSON-Darstellung 
{
  "name": string,
  "location": string,
  "createTime": string,
  "updateTime": string,
  "serviceAccount": string,
  "refreshOptions": {
    object (RefreshOptions)
  },
  "refreshStatus": {
    object (RefreshStatus)
  },
  "federatedCatalogOptions": {
    object (FederatedCatalogOptions)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "sapConfig": {
    object (SapConfig)
  }
  // End of mutually exclusive fields.
  "encryptionConfig": {
    object (EncryptionConfig)
  }
}
Felder
name

string

ID. Der Ressourcenname. Format: projects/{project}/catalogs/{catalog}
location

string

Erforderlich. Nicht veränderbar. Der vom Nutzer angegebene GCP-Standort des Katalogs. Dieses Feld ist unveränderlich.
createTime

string (Timestamp format)

Nur Ausgabe. Der Erstellungszeitpunkt des Katalogs.

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"
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der letzten Änderung des Katalogs.

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"
serviceAccount

string

Nur Ausgabe. Das für die SAP-Registrierung verwendete Dienstkonto wird als Nebeneffekt der Erstellung der Delta Sharing-Katalogressource erstellt.
refreshOptions

object (RefreshOptions)

Optional. Konfiguriert Optionen zum Aktualisieren eines Delta Sharing-Katalogs.
refreshStatus

object (RefreshStatus)

Nur Ausgabe. Der Status der Aktualisierung des Hintergrundkatalogs.
federatedCatalogOptions

object (FederatedCatalogOptions)

Optional. Konfigurationsoptionen für föderierte Kataloge.
Konfiguration für den Katalog. Es muss genau ein Feld festgelegt werden, das den Typ des Katalogs bestimmt. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
sapConfig

object (SapConfig)

Optional. Konfiguration für einen Katalog, der mit SAP Business Data Cloud (BDC) verbunden ist.
Ende der sich gegenseitig ausschließenden Felder.
encryptionConfig

object (EncryptionConfig)

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

SapConfig

Konfiguration für SAP Business Data Cloud (BDC).

JSON-Darstellung 
{
  "sapBdcEnrollmentConfig": {
    object (SapBdcEnrollmentConfig)
  },
  "sapRegion": string
}
Felder
sapBdcEnrollmentConfig

object (SapBdcEnrollmentConfig)

Optional. So erstellen Sie eine Katalogressource, die eine Verbindung zu SAP BDC herstellt: Setzen Sie SapConfig auf „leer“. Dadurch wird eine Katalogressource mit einem GCP-Dienstkonto erstellt: serviceAccount. 2. Folgen Sie auf Ihrer SAP BDC-Instanz mit diesem serviceAccount dem Registrierungsprozess und erstellen Sie einen BDC-Connector. Sie erhalten connectorEndpoint und invitationCode von SAP. 3. Aktualisieren Sie die zuvor erstellte BigLake-Katalogressource mit den SapBdcEnrollmentConfig, die von SAP bereitgestellt werden. Sobald das SapBdcEnrollmentConfig festgelegt ist, kann es nicht mehr geändert werden.
sapRegion

string

Optional. Nicht veränderbar. Die GCP-Region, die für SAP BDC-APIs verwendet werden soll. Wenn die Metadaten des Katalogs in einer Multiregion (z.B. „us“) gespeichert sind, die physische SAP BDC-Instanz sich aber in einer einzelnen Region (z.B. „us-central1“) befindet, muss dieses Feld explizit auf diese einzelne Region festgelegt werden. Wenn nicht festgelegt, wird standardmäßig der beim Erstellen des Katalogs angegebene Standort verwendet.

SapBdcEnrollmentConfig

Enthält die von SAP empfangene Registrierungskonfiguration.

JSON-Darstellung 
{
  "connectorEndpoint": string,
  "invitationCode": string,
  "invitationUrl": string,
  "federatedIdentityIssuer": string
}
Felder
connectorEndpoint

string

Optional. Der eindeutige SAP BDC Connector-Endpunkt.
invitationCode

string

Optional. Ein Einladungscode von SAP.
invitationUrl

string

Optional. Die kombinierte Einladungs-URL, die sowohl den Endpunkt als auch den Code enthält.
federatedIdentityIssuer

string

Nur Ausgabe. Lakehouse unterstützt die gemeinsame Nutzung von Datenprodukten mit SAP BDC. Wenn die Freigabe aktiviert ist, greift SAP BDC über eine föderierte Identität auf die zugrunde liegenden Ressourcen zu. Dieses Feld gibt den Aussteller der föderierten Identität an.

Konkret sollten der Identitätspool und der Anbieter so erstellt werden:

$ gcloud iam workload-identity-pools create sap-bdc-pool \ --location="global" \ --display-name="SAP BDC Pool"

$ gcloud iam workload-identity-pools providers create-oidc sap-bdc-provider \ --location="global" \ --workload-identity-pool="sap-bdc-pool" \ --issuer-uri=""

Der Pool sollte dann der IAM-Richtlinie der freigegebenen Ressourcen hinzugefügt werden, damit SAP BDC darauf zugreifen kann:

$ gcloud projects add-iam-policy-binding PROJECT_ID \ --role="roles/biglake.viewer" \ --member="principal://iam.googleapis.com/projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/sap-bdc-pool/subject/{TENANT_UUID}"

… wobei die TENANT_UUID in der SAP BDC-Instanz zu finden ist.

RefreshOptions

Konfiguriert Optionen zum Aktualisieren eines Delta Sharing-Katalogs.

JSON-Darstellung 
{
  "refreshSchedule": {
    object (RefreshSchedule)
  }
}
Felder
refreshSchedule

object (RefreshSchedule)

Optional. Definiert, ob und wann eine Aktualisierung der Metadaten geplant werden soll.

RefreshSchedule

Definiert, ob und wann eine Aktualisierung der Metadaten geplant werden soll.

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

string (Duration format)

Optional. Das Intervall für die Aktualisierung von Metadaten aus dem Remote-Katalog. Wenn nicht festgelegt, aber eine Aktualisierung gewünscht ist, wird ein Systemstandardwert verwendet.

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

RefreshStatus

Status der Hintergrundaktualisierung des Remote-Katalogs.

JSON-Darstellung 
{
  "startTime": string,
  "endTime": string,
  "status": {
    object (Status)
  }
}
Felder
startTime

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"
endTime

string (Timestamp format)

Nur Ausgabe. Wenn die Katalogaktualisierung abgeschlossen ist, heben Sie die Einstellung für laufende Aktualisierungen auf.

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 Hintergrundaktualisierungsvorgangs. Bei Aktualisierungen, die gerade laufen, ist dieser Wert nicht festgelegt.

FederatedCatalogOptions

Konfigurationsoptionen für den föderierten Katalog.

JSON-Darstellung 
{
  "serviceDirectoryName": string,
  "crossCloudCacheOptions": {
    object (CrossCloudCacheOptions)
  }
}
Felder
serviceDirectoryName

string

Optional. Der Service Directory-Ressourcenname für das Traffic-Routing über eine private Netzwerkverbindung per Cross-Cloud Interconnect im Format projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}.
crossCloudCacheOptions

object (CrossCloudCacheOptions)

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

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 Lese- und Metadaten in einem Cache gespeichert. Das kann die Leistung steigern und die Kosten für ausgehenden Netzwerktraffic bei cloudübergreifenden Abfragen senken.

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

EncryptionConfig

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

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

string

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

Methoden

create

 Erstellt einen neuen Delta Sharing-Katalog.

delete

 Löscht einen vorhandenen Delta Sharing-Katalog, der durch den Ressourcennamen angegeben wird.

get

 Ruft den durch den Ressourcennamen angegebenen Katalog ab.

list

 Alle Delta Sharing-Kataloge in einem angegebenen Projekt auflisten.

patch

 Aktualisiert einen vorhandenen Delta Sharing-Katalog.