Cloud-Verbindung zu Google Cloud Storage
Google Cloud Storage ist eine Ergänzung zur dab Nexus-Lizenz. Diese muss in der dab Nexus-Lizenz enthalten sein, bevor eine Verbindung eingerichtet werden kann.
Überblick
Google Cloud ist eine Sammlung von Cloud-Diensten, die von Google bereitgestellt werden. Sie bietet Infrastruktur-, Plattform-, Speicher-, Daten- und Anwendungsdienste, die über die Google Cloud-Konsole verwaltet werden können. Google Cloud Storage ist ein verwalteter Objektspeicher-Service innerhalb von Google Cloud. Daten werden als Objekte in Containern, den sogenannten Buckets, gespeichert. In dab Nexus kann eine Verbindung zu Google Cloud Storage als Ziel für Datenextraktionen im CSV- oder Parquet-Format verwendet werden. Weitere Informationen finden Sie in der offiziellen Google-Dokumentation: Google Cloud
Voraussetzungen
Stellen Sie vor der Einrichtung von Google Cloud Storage in dab Nexus sicher, dass die folgenden Anforderungen erfüllt sind:
- Ein Google-Konto und ein aktives Google Cloud-Konto mit aktivierter Abrechnung.
- Ein Google Cloud-Projekt. Bei erstmaliger Nutzung von Google Cloud ist möglicherweise bereits ein Projekt wie My First Project verfügbar. Alternativ können Sie ein neues Projekt für die dab Nexus-Verbindung erstellen oder auswählen.
- Ein Google Cloud Storage-Bucket für die Datenextraktionen.
- Ein Google Cloud Service-Konto mit ausreichenden Berechtigungen zum Zugriff und Schreiben im Ziel-Bucket. Für einen Zugang mit minimalen Berechtigungen sollten nur die für die Cloud Storage-Vorgänge erforderlichen Berechtigungen gewährt werden. Eine Übersicht der benötigten Berechtigungen und verfügbaren IAM-Rollen finden Sie in der offiziellen Google Cloud Dokumentation:
- Eine Service-Konto-Schlüsseldatei zur Authentifizierung der Verbindung in dab Nexus. Das Service-Konto wird mit einem RSA-Schlüsselpaar identifiziert. Beim Erstellen der Schlüssel erhält der Benutzer von Google eine Service-Konto-Datei mit Informationen zum Konto.
Der Bucket muss bereits vorhanden sein, bevor die Verbindung in dab Nexus erstellt wird. Geben Sie den Bucket-Namen exakt so ein, wie er in Google Cloud Storage erscheint.
Eine Google Cloud Storage-Verbindung erstellen
Navigieren Sie zu: Einstellungen > Datenziele > Cloud-Verbindungen > Neue Verbindung > Google Cloud Storage Geben Sie einen Namen für die Cloud-Verbindung ein und konfigurieren Sie die folgenden Felder.
Bucket
Name des Ziel-Buckets. Der Wert muss exakt mit dem Bucket-Namen in Google Cloud Storage übereinstimmen.
Verzeichnisstrukturen
Flat
Extrahierte Dateien werden direkt im Zielverzeichnis ohne Unterverzeichnisse abgelegt. Wählen Sie Flat, wenn die exportierten Daten eine flache Verzeichnisstruktur verwenden sollen. Beispiel:
<target-directory>/
├── BKPF_S4H_100_Init.csv
└── MARA_S4H_100_Init.csv
Incremental
Extrahierte Dateien werden in einem separaten Verzeichnis für jede Tabelle gespeichert, wobei jeder Lauf eine Datei mit Zeitstempel erzeugt. Wählen Sie Incremental, wenn die exportierten Daten eine inkrementelle Verzeichnisstruktur nutzen sollen.
Die gewählte Verzeichnisstruktur bestimmt, wie dab Nexus die exportierten Dateien im konfigurierten Bucket und Basisordner organisiert.
<target-directory>/
└── <table-name>/
└── <timestamp>_<SID>_<CLIENT>_<type>.<format>
Bei der Incremental-Verzeichnisstruktur kombiniert Merge neue Daten nicht mit einer bestehenden Datei. Stattdessen wird bei jedem Lauf eine neue zeitgestempelte Datei im jeweiligen Tabellenverzeichnis erstellt, während vorhandene Dateien erhalten bleiben. Die Verzeichnisstruktur legt die unterstützte Replikationsstrategie fest:
- Flat → Überschreiben
- Incremental → Zusammenführen
Diese Kombinationen werden während der Aufgabenvalidierung erzwungen.
Dateiformat
Wählen Sie das Dateiformat für die extrahierten Daten:
- CSV
- Parquet
Basisordner
Optional können Sie ein Verzeichnis im Bucket angeben, in dem die extrahierten Daten gespeichert werden sollen. Falls kein benutzerdefinierter Basisordner festgelegt wird, wird standardmäßig sap-export verwendet.
Authentifizierung
Google Cloud Storage-Verbindungen verwenden die Authentifizierung mit Service-Konto-Schlüssel.
- Setzen Sie den Authentifizierungstyp auf Service-Konto-Schlüssel.
- Wählen Sie unter Service-Konto-Schlüssel die Option Auswählen.
- Wählen Sie die Service-Konto-Schlüsseldatei aus.
Das Service-Konto muss über ausreichende Berechtigungen für den konfigurierten Google Cloud Storage-Bucket und die erforderlichen Exportvorgänge verfügen.
Verbindung testen und erstellen
Wählen Sie Testverbindung, um die Konfiguration und den Zugriff auf den Ziel-Bucket zu überprüfen. Klicken Sie auf Erstellen, um die Cloud-Verbindung zu speichern.
Falls die Verbindung nicht erfolgreich getestet werden kann, überprüfen Sie folgende Werte:
- Der konfigurierte Bucket-Name stimmt exakt mit dem Google Cloud Storage-Bucket-Namen überein.
- Der ausgewählte Service-Konto-Schlüssel ist gültig.
- Das Service-Konto verfügt über ausreichenden Zugang zum Ziel-Bucket.
- Der optionale Basisordner ist wie gewünscht angegeben. Ist kein benutzerdefinierter Wert erforderlich, wird standardmäßig
sap-exportverwendet.