Version 2.0: BigQuery-Connector für SAP auf einer Compute Engine-VM installieren und konfigurieren

In dieser Anleitung wird beschrieben, wie Sie Version 2.0 oder 2.1 von BigQuery-Connector für SAP auf einem SAP LT Replication Server installieren und konfigurieren, der auf einer virtuellen Compute Engine-Maschine (VM) in Google Cloud ausgeführt wird.

In dieser Anleitung wird beschrieben, wie Sie BigQuery, SAP Landscape Transformation Replication Server (SAP LT Replication Server) und BigQuery Connector für SAP vorbereiten, um SAP-Daten in Echtzeit direkt und sicher aus SAP-Anwendungen in BigQuery zu replizieren.

Diese Anleitung richtet sich an SAP-Administratoren, Google Cloud-Administratoren sowie andere SAP- und Google Cloud-Sicherheits- und -Datenexperten.

Vorbereitung

Prüfen Sie vor der Installation von BigQuery-Connector für SAP, ob die folgenden Voraussetzungen erfüllt sind:

  • Sie haben den Planungsleitfaden für BigQuery-Connector für SAP gelesen. Im Planungsleitfaden werden BigQuery Connector für SAP-Optionen, Leistungsaspekte, Feldzuordnung und andere Informationen erläutert, die Sie für die optimale Konfiguration von BigQuery Connector für SAP benötigen.
  • Wenn Sie noch kein Google Cloud-Projekt haben, erstellen Sie eines:

    Zur Projektauswahl

  • Die Abrechnung ist für Ihr Projekt aktiviert. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist. Für die BigQuery Streaming API, BigQuery sowie für das Herunterladen von BigQuery Connector für SAP ist ein Rechnungskonto erforderlich.

  • Die Wartung der installierten SAP-Software ist aktuell und die Versionen der SAP-Software sind miteinander kompatibel, wie in der SAP-Produktverfügbarkeitsmatrix dokumentiert.

  • Die von Ihnen verwendeten Versionen der SAP-Software werden vom BigQuery-Connector für SAP unterstützt, wie unter Softwareanforderungen beschrieben.

  • Sie haben die richtigen SAP-Lizenzen, die zum Replizieren von Daten zu einem beliebigen Ziel über das SAP LT Replication Server SDK erforderlich sind. Weitere Informationen zur SAP-Lizenzierung finden Sie im SAP-Hinweis 2707835.

  • SAP LT Replication Server ist installiert. Informationen zur Installation von SAP LT Replication Server finden Sie in der SAP-Dokumentation.

  • Die RFC- oder Datenbankverbindung zwischen SAP LT Replication Server und dem Quellsystem ist konfiguriert. Testen Sie ggf. die RFC-Verbindungen über die SAP-Transaktion SM59. Testen Sie die Datenbankverbindungen über die SAP-Transaktion DBACOCKPIT.

Übersicht über den Installations- und Konfigurationsvorgang

Die folgende Tabelle zeigt die in diesem Leitfaden behandelten Verfahren und die entsprechenden typischen Rollen.

Vorgehensweise Rolle
Folgen Sie bei Bedarf der SAP-Anleitung zur Installation eines SAP Landscape Transformation Replication Servers, nachdem Sie alle entsprechenden Lizenzen von SAP überprüft haben. SAP-Administrator.
UI-Add-on (User Interface, Benutzeroberfläche) für SAP NetWeaver. Weitere Informationen finden Sie unter Anforderungen an die Version der SAP-Software. SAP-Administrator.
Aktivieren Sie die erforderlichen Google Cloud APIs. Google Cloud-Administrator.
Installieren Sie bei Bedarf die gcloud CLI auf dem SAP LT Replication Server-Host. SAP-Administrator.
Erstellen Sie ein BigQuery-Dataset. Google Cloud-Administrator oder Data Engineer.
Richten Sie die Google Cloud-Authentifizierung und -Autorisierung ein. Google Cloud-Sicherheitsadministrator.
Fordern Sie das Installationspaket für BigQuery-Connector für SAP an. Google Cloud-Rechnungskontoinhaber.
Installieren Sie BigQuery-Connector für SAP. SAP-Administrator.
Erstellen Sie SAP-Rollen und -Berechtigungen für BigQuery-Connector für SAP. SAP-Administrator.
Konfigurieren Sie die Replikation. Data Engineers oder Administratoren.
Testen Sie die Replikation. Data Engineers oder Administratoren.
Validieren Sie die Replikation. Data Engineers oder Administratoren.

Erforderliche Google Cloud APIs aktivieren

Damit BigQuery-Connector für SAP auf BigQuery zugreifen kann, müssen Sie die folgenden Google Cloud APIs aktivieren:

  • Die BigQuery API
  • Die IAM Service Account Credentials API

Informationen zum Aktivieren von Google Cloud APIs finden Sie unter APIs aktivieren.

gcloud-CLI installieren

Für die Replikation in BigQuery muss das Nutzerkonto sidadm Zugriff auf die Google Cloud-CLI (gcloud-CLI) auf dem SAP LT Replication Server-Host haben.

Die gcloud CLI ist standardmäßig auf den meisten Compute Engine-VMs installiert. Sie können die Installation mit dem Befehl gcloud components list bestätigen. Wenn der Befehl nicht erkannt wird, müssen Sie die gcloud CLI installieren.

Ein SAP-Administrator kann die gcloud CLI installieren.

Führen Sie die folgenden Schritte aus, um die gcloud CLI zu installieren:

  1. Folgen Sie der Installationsanleitung für die gcloud CLI.

  2. Autorisieren Sie das sidadm-Nutzerkonto, um auf das Installationsverzeichnis der gcloud CLI zuzugreifen.

  3. Legen Sie optional als sidadm das Standardprojekt für die gcloud-CLI fest:

    gcloud config set project PROJECT_ID

    Ersetzen Sie PROJECT_ID durch die ID des Projekts, das Ihr BigQuery-Dataset enthält. Beispiel: example-project-123456

    Wenn Sie kein Standardprojekt für die gcloud-CLI festlegen, muss das Attribut --project in jedem ausgegebenen gcloud-Befehl angegeben werden.

Weitere Informationen zur Anforderung des BigQuery-Connectors für SAP für die gcloud CLI finden Sie unter Anforderung der gcloud CLI.

BigQuery-Dataset erstellen

Bevor Sie die Google Cloud-Authentifizierung und -Autorisierung für BigQuery testen oder BigQuery-Zieltabellen erstellen können, müssen Sie oder ein Data Engineer oder Administrator ein BigQuery-Dataset erstellen.

Zum Erstellen eines BigQuery-Datasets muss Ihr Nutzerkonto die richtigen IAM-Berechtigungen für BigQuery haben. Weitere Informationen finden Sie unter Erforderliche Berechtigungen.

  1. Öffnen Sie in der Google Cloud Console die Seite "BigQuery":

    BigQuery aufrufen

  2. Klicken Sie neben Ihrer Projekt-ID auf das Symbol Aktionen ansehen und dann auf Dataset erstellen.

    Das Diagramm wird im vorhergehenden Text beschrieben.

  3. Geben Sie im Feld Dataset-ID einen eindeutigen Namen ein. Weitere Informationen finden Sie unter Datasets benennen.

Nachdem Sie die Google Cloud-Authentifizierung und -Autorisierung eingerichtet haben, testen Sie den Zugriff auf Google Cloud, indem Sie Informationen zu diesem Dataset abrufen.

Weitere Informationen zum Erstellen von BigQuery-Datasets finden Sie unter Datasets erstellen.

Google Cloud-Authentifizierung und -Autorisierung einrichten

Für die Authentifizierung bei Google Cloud und die Autorisierung für den Zugriff auf BigQuery müssen Google Cloud-Sicherheitsadministratoren und SAP-Administratoren folgende Schritte ausführen:

  • Ein Dienstkonto für BigQuery-Connector für SAP erstellen.
  • Dem Dienstkonto die IAM-Rollen gewähren, die für den Zugriff auf BigQuery erforderlich sind.
  • Das Dienstkonto von BigQuery-Connector für SAP als Hauptkonto zum BigQuery-Projekt hinzufügen.
  • Sicherheitseinstellungen für Google Cloud auf dem SAP LT Replication Server-Host konfigurieren:
    • Der Host-VM die Berechtigung gewähren, Zugriffstokens abzurufen.
    • Bei Bedarf die API-Zugriffsbereiche der Host-VM ändern.

Dienstkonto erstellen

BigQuery-Connector für SAP benötigt ein IAM-Dienstkonto für die Authentifizierung und Autorisierung für den Zugriff auf BigQuery.

Dieses Dienstkonto muss ein Hauptkonto in dem Google Cloud-Projekt sein, das Ihr BigQuery-Dataset enthält. Wenn Sie das Dienstkonto im selben Projekt wie das BigQuery-Dataset erstellen, wird das Dienstkonto dem Projekt automatisch als Hauptkonto hinzugefügt.

Wenn Sie das Dienstkonto in einem anderen Projekt als dem Projekt erstellen, in dem das BigQuery-Dataset enthalten ist, müssen Sie das Dienstkonto in einem zusätzlichen Schritt zum BigQuery-Dataset-Projekt hinzufügen.

So erstellen Sie ein Dienstkonto:

  1. Rufen Sie in der Google Cloud Console die IAM und Verwaltung-Seite Dienstkonten auf.

    Zur Seite „Dienstkonten“

  2. Wählen Sie bei entsprechender Aufforderung Ihr Google Cloud-Projekt aus.

  3. Klicken Sie auf Dienstkonto erstellen.

  4. Geben Sie einen Namen für das Dienstkonto und optional eine Beschreibung an.

  5. Klicken Sie auf Erstellen und fortfahren.

  6. Wenn Sie das Dienstkonto im selben Projekt wie das BigQuery-Dataset erstellen, wählen Sie im Bereich Diesem Dienstkonto Zugriff auf das Projekt erteilen die folgenden Rollen aus:

    • BigQuery-Dateneditor
    • BigQuery-Jobnutzer

    Wenn Sie das Dienstkonto in einem anderen Projekt als dem BigQuery-Dataset erstellen, weisen Sie dem Dienstkonto keine Rollen zu.

  7. Klicken Sie auf Weiter.

  8. Gewähren Sie Nutzern gegebenenfalls Zugriff auf das Dienstkonto.

  9. Klicken Sie auf Fertig. Das Dienstkonto wird in der Liste der Dienstkonten für das Projekt angezeigt.

  10. Wenn Sie das Dienstkonto in einem anderen Projekt als dem Projekt erstellt haben, das das BigQuery-Dataset enthält, notieren Sie sich den Namen des Dienstkontos. Sie geben den Namen an, wenn Sie das Dienstkonto dem BigQuery-Projekt hinzufügen. Weitere Informationen finden Sie unter Dienstkonto zum BigQuery-Projekt hinzufügen.

Das Dienstkonto wird jetzt als Hauptkonto auf der Seite IAM-Berechtigungen des Google Cloud-Projekts aufgeführt, in dem das Dienstkonto erstellt wurde.

Dienstkonto zum BigQuery-Projekt hinzufügen

Wenn Sie das Dienstkonto für BigQuery-Connector für SAP nicht in dem Projekt mit dem BigQuery-Ziel-Dataset erstellt haben, müssen Sie das Dienstkonto zum BigQuery-Dataset-Projekt hinzufügen.

Wenn Sie das Dienstkonto im selben Projekt wie das BigQuery-Dataset erstellt haben, können Sie diesen Schritt überspringen.

Führen Sie die folgenden Schritte aus, um dem BigQuery-Dataset-Projekt ein vorhandenes Dienstkonto hinzuzufügen:

  1. Öffnen Sie in der Google Cloud Console die Seite „IAM-Berechtigungen“.

    Zu "IAM-Berechtigungen"

  2. Prüfen Sie, ob der Name des Projekts, in dem das BigQuery-Ziel-Dataset enthalten ist, oben auf der Seite angezeigt wird. Beispiel:

    Berechtigungen für das Projekt "PROJECT_NAME"

    Ist das nicht der Fall, wechseln Sie zwischen Projekten.

  3. Klicken Sie auf der IAM-Seite auf Hinzufügen. Das Dialogfeld Hauptkonten zu "PROJECT_NAME" hinzufügen wird geöffnet.

  4. Führen Sie im Dialogfeld Hauptkonten zu "PROJECT_NAME" hinzufügen die folgenden Schritte aus:

    1. Geben Sie im Feld Neue Hauptkonten den Namen des Dienstkontos an.
    2. Geben Sie im Feld Rolle auswählen den BigQuery-Dateneditor ein.
    3. Klicken Sie auf WEITERE ROLLE HINZUFÜGEN. Das Feld Rolle auswählen wird noch einmal angezeigt.
    4. Geben Sie im Feld Rolle auswählen den BigQuery-Jobnutzer an.
    5. Klicken Sie auf Speichern. Das Dienstkonto wird in der Liste der Projekthauptkonten auf der Seite IAM angezeigt.

Das Dienstkonto kann jetzt für den Zugriff auf das BigQuery-Dataset in diesem Projekt verwendet werden.

Sicherheit auf der Host-VM konfigurieren

Für BigQuery-Connector für SAP muss die Compute Engine-VM, auf der SAP LT Replication Server gehostet wird, mit den folgenden Sicherheitsoptionen konfiguriert werden:

  • Die Zugriffsbereiche der Host-VM müssen festgelegt werden, um vollständigen Zugriff auf die Cloud APIs zu ermöglichen.
  • Das Dienstkonto der Host-VM muss die IAM-Rolle Ersteller von Dienstkonto-Tokens enthalten.

Wenn diese Optionen nicht auf der Host-VM konfiguriert sind, müssen Sie sie konfigurieren.

Um die Zugriffsbereiche einer VM zu ändern, müssen Sie die VM anhalten.

API-Zugriffsbereiche der Host-VM prüfen

Prüfen Sie die aktuelle Einstellung des Zugriffsbereichs der Host-VM des SAP LT Replication Server. Wenn die VM bereits uneingeschränkten Zugriff auf alle Cloud APIs hat, müssen Sie die Zugriffsbereiche nicht ändern.

Führen Sie die folgenden Schritte aus, um den Zugriffsbereich einer Host-VM zu prüfen:

Google Cloud Console

  1. Öffnen Sie in der Google Cloud Console die Seite „VM-Instanzen“:

    Zu Seite „VM-Instanzen“

  2. Wählen Sie bei Bedarf das Google Cloud-Projekt aus, das den SAP LT Replication Server-Host enthält.

  3. Klicken Sie auf der Seite "VM-Instanzen" auf den Namen der Host-VM. Die Seite mit den VM-Details wird geöffnet.

  4. Prüfen Sie unter API und Identitätsverwaltung auf der Detailseite der Host-VM die aktuelle Einstellung für Cloud API-Zugriffsbereiche:

    • Wenn die Einstellung Uneingeschränkten Zugriff auf alle Cloud APIs zulassen lautet, ist die Einstellung richtig und muss nicht geändert werden.
    • Wenn die Einstellung nicht Uneingeschränkten Zugriff auf alle Cloud-APIs zulassen lautet, müssen Sie die VM beenden und die Einstellung ändern. Eine Anleitung finden Sie im nächsten Abschnitt.

gcloud-CLI

  1. Rufen Sie die aktuellen Zugriffsbereiche der Host-VM auf:

    gcloud compute instances describe VM_NAME --zone=VM_ZONE --format="yaml(serviceAccounts)"

    Wenn https://www.googleapis.com/auth/cloud-platform in den Zugriffsbereichen nicht enthalten ist, müssen Sie die Zugriffsbereiche der Host-VM ändern. Wenn Sie beispielsweise eine VM-Instanz mit einem Compute Engine-Standarddienstkonto erstellen, müssen Sie die folgenden Standardzugriffsbereiche ändern:

    serviceAccounts:
    - email: 600915385160-compute@developer.gserviceaccount.com
      scopes:
      - https://www.googleapis.com/auth/devstorage.read_only
      - https://www.googleapis.com/auth/logging.write
      - https://www.googleapis.com/auth/monitoring.write
      - https://www.googleapis.com/auth/servicecontrol
      - https://www.googleapis.com/auth/service.management.readonly
      - https://www.googleapis.com/auth/trace.append

    Wenn unter scopes lediglich der Bereich https://www.googleapis.com/auth/cloud-platform aufgeführt ist, wie im folgenden Beispiel gezeigt, müssen Sie die Bereiche nicht ändern:

    serviceAccounts:
    - email: 600915385160-compute@developer.gserviceaccount.com
      scopes:
      - https://www.googleapis.com/auth/cloud-platform

API-Zugriffsbereiche der Host-VM ändern

Wenn die Host-VM von SAP LT Replication Server keinen vollständigen Zugriff auf die Google Cloud APIs hat, ändern Sie die Zugriffsbereiche, um vollständigen Zugriff auf alle Cloud APIs zu gewähren.

Führen Sie die folgenden Schritte aus, um die Einstellung Zugriffsbereiche für Cloud API für eine Host-VM zu ändern:

Google Cloud Console

  1. Beschränken Sie bei Bedarf die Rollen, die dem Sicherheitskonto der Host-VM zugewiesen sind.

    Sie finden den Sicherheitskontonamen auf der Detailseite der Host-VM unter API und Identitätsverwaltung. Sie können die Rollen ändern, die einem Dienstkonto in der Google Cloud Console auf der IAM-Seite unter Hauptkonten zugewiesen sind.

  2. Beenden Sie bei Bedarf alle Arbeitslasten, die auf der Host-VM ausgeführt werden.

  3. Öffnen Sie in der Google Cloud Console die Seite „VM-Instanzen“:

    Zu Seite „VM-Instanzen“

  4. Klicken Sie auf der Seite "VM-Instanzen" auf den Namen der Host-VM, um die Seite "VM-Details" zu öffnen.

  5. Klicken Sie auf BEENDEN, um oben auf der Host-VM-Detailseite die Host-VM zu beenden.

  6. Klicken Sie nach dem Beenden der VM auf Bearbeiten.

  7. Wählen Sie unter Sicherheit und Zugriff > Zugriffsbereiche die Option Uneingeschränkten Zugriff auf alle Cloud APIs zulassen aus.

  8. Klicken Sie auf Speichern.

  9. Starten Sie oben auf der Seite der Host-VM-Details die Host-VM. Klicken Sie dazu auf STARTEN/FORTSETZEN.

  10. Starten Sie gegebenenfalls alle Arbeitslasten neu, die auf der Host-VM beendet wurden.

gcloud-CLI

  1. Passen Sie bei Bedarf die dem VM-Dienstkonto zugewiesenen IAM-Rollen an, um dafür zu sorgen, dass der Zugriff auf Google Cloud-Dienste von der Host-VM entsprechend eingeschränkt ist.

    Informationen zum Ändern der Rollen, die einem Dienstkonto zugewiesen sind, finden Sie unter Dienstkonto aktualisieren.

  2. Beenden Sie falls nötig jede SAP-Software, die auf der Host-VM ausgeführt wird.

  3. Beenden Sie die VM:

    gcloud compute instances stop VM_NAME --zone=VM_ZONE
  4. Ändern Sie die Zugriffsbereiche der VM:

    gcloud compute instances set-service-account VM_NAME --scopes=cloud-platform --zone=VM_ZONE
  5. Starten Sie die VM:

    gcloud compute instances start VM_NAME --zone=VM_ZONE
  6. Starten Sie, falls erforderlich, die SAP-Software, die auf der Host-VM ausgeführt wird.

Host-VM zum Abrufen von Zugriffstokens berechtigen

Sie müssen dem Dienstkonto der Host-VM die Berechtigung erteilen, die Zugriffstokens abzurufen, die BigQuery Connector für SAP für den Zugriff auf BigQuery benötigt.

Führen Sie die folgenden Schritte aus, um die Berechtigung zum Erstellen von Zugriffstokens zu gewähren:

  1. Öffnen Sie in der Google Cloud Console die Seite „VM-Instanzen“:

    Zu Seite „VM-Instanzen“

  2. Klicken Sie auf der Seite "VM-Instanzen" auf den Namen der Host-VM, um die Seite "VM-Details" zu öffnen.

  3. Notieren Sie sich auf der VM-Detailseite den Namen des Dienstkontos unter API und Identitätsverwaltung. Der folgende Beispielname bezieht sich auf ein Standard-Compute Engine-Dienstkonto:

    SVC-ACCT-NUMBER-compute@developer.gserviceaccount.com
  4. Öffnen Sie in der Google Cloud Console die Seite „IAM“.

    Zu "IAM-Berechtigungen"

  5. Suchen Sie in der Liste der Projekthauptkonten nach dem Dienstkontonamen und klicken Sie auf Hauptkonto bearbeiten. Das Dialogfeld Berechtigungen bearbeiten wird geöffnet.

  6. Klicken Sie im Dialogfeld Berechtigungen bearbeiten auf WEITERE ROLLE HINZUFÜGEN. Das Feld Rolle auswählen wird angezeigt.

  7. Geben Sie im Feld Rolle auswählen die Rolle Ersteller von Dienstkonto-Tokens an.

  8. Klicken Sie auf Speichern. Sie werden zur Seite IAM-Berechtigungen zurückgeleitet.

Die Host-VM ist jetzt zum Erstellen von Zugriffstokens berechtigt.

SSL-Zertifikate und HTTPS einrichten

Die Kommunikation zwischen BigQuery-Connector für SAP und der BigQuery API wird mithilfe von SSL und HTTPS gesichert.

  1. Laden Sie die folgenden Zertifikate aus dem Repository von Google Trust Services herunter:

    • GTS Root R1
    • GTS CA 1C3
  2. Verwenden Sie in der SAP-GUI die Transaktion STRUST, um sowohl das Root- als auch das untergeordnete Zertifikat in den PSE-Ordner SSL client SSL Client (Standard) zu importieren.

    Weitere Informationen von SAP finden Sie unter SAP-Hilfe – Liste der PSE-Zertifizierungen pflegen.

  3. Prüfen Sie auf dem SAP LT Replication Server-Host, ob alle Firewallregeln oder Proxys so konfiguriert sind, dass sie ausgehenden Traffic vom HTTPS-Port zur BigQuery API zulassen.

    Insbesondere muss SAP LT Replication Server auf die folgenden Google Cloud APIs zugreifen können:

    • https://bigquery.googleapis.com
    • https://iamcredentials.googleapis.com

Weitere Informationen von SAP zum Einrichten von SSL finden Sie im SAP-Hinweis 510007 – Weitere Überlegungen zum Einrichten von SSL für Anwendungsserver-ABAP.

Google Cloud-Authentifizierung und -Autorisierung testen

Prüfen Sie, ob Sie die Google Cloud-Authentifizierung korrekt konfiguriert haben. Fordern Sie dazu ein Zugriffstoken an und rufen Sie Informationen zu Ihrem BigQuery-Dataset ab.

Testen Sie mit den folgenden Schritten Ihre Google Cloud-Authentifizierung und -Autorisierung von der SAP LT Replication Server-Host-VM:

  1. Öffnen Sie auf der SAP LT Replication Server-Host-VM eine Befehlszeilen-Shell.

  2. Wechseln Sie zum sidadm-Nutzer.

  3. Fordern Sie das erste Zugriffstoken vom Metadatenserver der Host-VM an:

    curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token" -H "Metadata-Flavor: Google"

    Der Metadatenserver gibt ein Zugriffstoken zurück, das dem folgenden Beispiel ähnelt. Dabei ist ACCESS_TOKEN_STRING_1 ein Zugriffstokenstring, den Sie im folgenden Schritt in den Befehl kopieren:

    {"access_token":"ACCESS_TOKEN_STRING_1",
    "expires_in":3599,"token_type":"Bearer"}
  4. Fordern Sie das zweite Zugriffstoken aus der IAM API an. Führen Sie dazu den folgenden Befehl aus, nachdem Sie die Platzhalterwerte ersetzt haben:

    curl --request POST \
     'https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT:generateAccessToken' \
    --header 'Authorization: Bearer ACCESS_TOKEN_STRING_1' \
      --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --data '{"scope":["https://www.googleapis.com/auth/bigquery"],"lifetime":"300s"}' \
      --compressed
    

    Dabei gilt:

    • SERVICE_ACCOUNT: das Dienstkonto, das Sie in einem früheren Schritt für BigQuery-Connector für SAP erstellt haben.
    • ACCESS_TOKEN_STRING_1: der erste Zugriffstokenstring aus dem vorherigen Schritt.

    Die IAM API gibt ein zweites Zugriffstoken, ACCESS_TOKEN_STRING_2, zurück, das dem folgenden Beispiel ähnelt. Im nächsten Schritt kopieren Sie diesen zweiten Tokenstring in eine Anfrage an die BigQuery API.

    {"access_token":"ACCESS_TOKEN_STRING_2","expires_in":3599,"token_type":"Bearer"}
  5. Rufen Sie Informationen zu Ihrem BigQuery-Dataset aus der BigQuery API ab. Führen Sie dazu den folgenden Befehl aus, nachdem Sie die Platzhalterwerte ersetzt haben:

    curl "https://bigquery.googleapis.com/bigquery/v2/projects/PROJECT_ID/datasets/DATASET_NAME" \
     -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN_STRING_2"
    

    Dabei gilt:

    • PROJECT_ID: die ID des Projekts, das Ihr BigQuery-Dataset enthält.
    • DATASET_NAME: der Name des Ziel-Datasets, wie in BigQuery definiert.
    • ACCESS_TOKEN_STRING_2: der Zugriffstokenstring, der von der IAM API im vorherigen Schritt zurückgegeben wurde.

    Wenn Ihre Google Cloud-Authentifizierung ordnungsgemäß konfiguriert ist, werden Informationen zum Dataset zurückgegeben.

    Wenn sie nicht richtig konfiguriert ist, finden Sie weitere Informationen unter Fehlerbehebung für BigQuery-Connector für SAP.

Installationspaket herunterladen

Laden Sie das Installationspaket für BigQuery-Connector für SAP vom BigQuery-Connector für SAP-Downloadportal herunter.

Sie benötigen Ihre Cloud Billing-Nummer, um den Download abzuschließen. Informationen zu Rechnungskonten finden Sie unter Cloud Billing und Zahlungsprofil.

Das Installationspaket enthält Transportdateien, die Sie in das entsprechende Transportverzeichnis für SAP LT Replication Server kopieren.

BigQuery-Connector für SAP installieren

Nachdem Sie das Installationspaket mit den BigQuery-Connector für SAP-Transportdateien erhalten haben, kann Ihr SAP-Administrator BigQuery-Connector für SAP installieren. Dazu importiert er die Transportdateien in SAP LT Replication Server.

Der SAP-Transport für BigQuery-Connector für SAP enthält alle Objekte, die für BigQuery-Connector für SAP erforderlich sind, einschließlich des /GOOG/-Namespace, der DDIC-Objekte, der SLT SDK-BADI-Implementierung und -Klassen, der Berichtsprogramme und mehr.

Prüfen Sie vor dem Importieren der Transportdateien in SAP LT Replication Server, ob Ihr SAP LT Replication Server von BigQuery-Connector für SAP unterstützt wird, wie in Softwareanforderungen beschrieben.

Auch wenn Sie eine unterstützte Version von SAP LT Replication Server verwenden, wird in manchen Fällen beim Importieren der Transportdateien möglicherweise die Fehlermeldung Requests do not match the component version of the target system angezeigt. In solchen Fällen müssen Sie die Transportdateien noch einmal in SAP LT Replication Server importieren. Klicken Sie auf dem Bildschirm „Transportanfrage importieren” > „Optionen” das Kästchen Ungültige Komponentenversion ignorieren.

Das folgende Verfahren ist ein allgemeines Verfahren. Jedes SAP-System ist anders. Wenden Sie sich daher an Ihren SAP-Administrator, um Änderungen an dem Verfahren zu ermitteln, die für Ihr SAP-System erforderlich sein könnten:

  1. Kopieren Sie BigQuery-Connector für SAP-Transportdateien in die folgenden Importverzeichnisse für den SAP LT Replication Server-Transport:

    • /usr/sap/trans/cofiles/KXXXXXX.ED1
    • /usr/sap/trans/data/RXXXXXX.ED1

    In den vorherigen Beispielen steht XXXXXX für den nummerierten Dateinamen.

  2. Verwenden Sie in der SAP-GUI den Transaktionscode STMS_IMPORT oder STMS, um die Dateien in das SAP-System zu importieren.

  3. Prüfen Sie, ob alle Objekte im Paket /GOOG/SLT_SDK aktiv und konsistent sind:

    1. Geben Sie in der SAP-Oberfläche den Transaktionscode SE80 ein.
    2. Wählen Sie in der Paketauswahl /GOOG/SLT_SDK aus.
    3. Klicken Sie im Feld Objektname mit der rechten Maustaste auf das Paket /GOOG/SLT_SDK und wählen Sie Prüfen > Paketprüfung > Objekte des Pakets aus.

      Ein grünes Häkchen in der Spalte Ergebnis gibt an, dass alle Objekte die Paketprüfung bestanden haben.

Prüfen, ob BigQuery-Connector für SAP konfiguriert werden kann

Wenn Sie prüfen möchten, ob die Transportdateien korrekt importiert wurden und BigQuery-Connector für SAP konfiguriert werden kann, prüfen Sie, ob die Implementierung des BigQuery-Connector für SAP-Business-Add-in (BAdI) aktiv ist und ob BigQuery-Connector für SAP-Replikationsanwendungen Einträge in der Tabelle IUUC_REPL_APPL haben.

  1. Prüfen Sie die BAdI-Implementierung:
    1. Verwenden Sie die Transaktion SE80, um den Optimierungsobjektordner /GOOG/EI_IUUC_REPL_RUNTIME_BQ zu finden und auszuwählen.
    2. Wählen Sie rechts auf der Seite die Option Optimierungsimplementierungselemente aus.
    3. Prüfen Sie unter Laufzeitverhalten, ob die Option Implementierung ist aktiv aktiviert ist.
  2. Prüfen Sie die Replikationsanwendungen:
    1. Rufen Sie über den SAP-Datenbrowser oder die Transaktion SE16 die Tabelle IUUC_REPL_APPL auf.
    2. Prüfen Sie, ob die folgenden Anwendungen in der Tabelle IUUC_REPL_APPL angezeigt werden:
      • /GOOG/SLT_BQ
      • ZGOOG_SLT_BQ, was verwendet wird, wenn der Namespace /GOOG/ nicht registriert ist

SAP-Rollen und -Autorisierungen für BigQuery-Connector für SAP erstellen

Um mit BigQuery-Connector für SAP zu arbeiten, benötigen Nutzer zusätzlich zu den standardmäßigen SAP LT Replication Server-Autorisierungen Zugriff auf die benutzerdefinierten Transaktionen, die mit BigQuery-Connector für SAP bereitgestellt werden: /GOOG/SLT_SETTINGS und /GOOG/REPLIC_VALID.

Standardmäßig können Nutzer, die Zugriff auf die benutzerdefinierten Transaktionen haben, die Einstellungen jeder Konfiguration ändern. Bei Bedarf können Sie also den Zugriff auf bestimmte Konfigurationen einschränken.

Die BigQuery-Connector für SAP-Transportdateien enthalten das Google BigQuery Settings Authorization-Objekt ZGOOG_MTID für Autorisierungen, die für BigQuery-Connector für SAP spezifisch sind.

So gewähren Sie Zugriff auf die benutzerdefinierten Transaktionen und beschränken den Zugriff auf bestimmte Konfigurationen:

  1. Definieren Sie mit dem SAP-Transaktionscode PFCG eine Rolle für BigQuery-Connector für SAP.

  2. Gewähren Sie der Rolle Zugriff auf die benutzerdefinierten Transaktionen /GOOG/SLT_SETTINGS und /GOOG/REPLIC_VALID.

  3. Um den Zugriff einer Rolle einzuschränken, geben Sie über das Autorisierungsobjekt ZGOOG_MTID die Autorisierungsgruppe jeder Konfiguration an, auf die die Rolle zugreifen kann. Beispiel:

    • Autorisierungsobjekt für BigQuery-Connector für SAP (ZGOOG_MTID):
      • Activity 01
      • Authorization Group AUTH_GROUP_1,AUTH_GROUP_N

    AUTH_GROUP_01 und AUTH_GROUP_N sind Werte, die in der SAP LT Replication Server-Konfiguration definiert sind.

    Die für ZGOOG_MTID angegebenen Autorisierungsgruppen müssen mit den Autorisierungsgruppen übereinstimmen, die für die Rolle im SAP-Autorisierungsobjekt S_DMIS_SLT angegeben sind.

Replikation konfigurieren

Zum Konfigurieren der Replikation geben Sie die Einstellungen sowohl für BigQuery-Connector für SAP als auch für SAP LT Replication Server an.

Zugriffseinstellungen in /GOOG/CLIENT_KEY angeben

Verwenden Sie die Transaktion SM30, um die Einstellungen für den Zugriff auf BigQuery anzugeben. BigQuery-Connector für SAP speichert die Einstellungen als Datensatz in der benutzerdefinierten Konfigurationstabelle /GOOG/CLIENT_KEY.

So legen Sie die Zugriffseinstellungen fest:

  1. Geben Sie in der SAP-GUI den Transaktionscode SM30 ein.

  2. Wählen Sie die Konfigurationstabelle /GOOG/CLIENT_KEY aus.

  3. Geben Sie Werte für die folgenden Tabellenfelder ein:

    Feld Datentyp Beschreibung
    Name String Der Name dieser CLIENT_KEY-Konfiguration.
    Name des Dienstkontos String

    Der Name des Dienstkontos (im E-Mail-Adressformat), das für BigQuery-Connector für SAP im Schritt Dienstkonto erstellen erstellt wurde. Beispiel: sap-example-svc-acct@example-project-123456.iam.gserviceaccount.com.

    Umfang String

    Geben Sie den https://www.googleapis.com/auth/cloud-platform-API-Zugriffsbereich an, wie von Compute Engine empfohlen. Dieser Zugriffsbereich entspricht der Einstellung Allow full access to all Cloud APIs auf der Host-VM. Weitere Informationen finden Sie unter Zugriffsbereiche auf der Host-VM festlegen.

    Projekt-ID String Die ID des Projekts, das Ihr BigQuery-Ziel-Dataset enthält.
    Befehlsname String

    Lassen Sie dieses Feld leer.

    Autorisierungsklasse String Die Autorisierungsklasse für die Replikation.

    Geben Sie /GOOG/CL_GCP_AUTH_GOOGLE an.

    Autorisierungsfeld Nicht zutreffend Lassen Sie dieses Feld leer.
    Sekunden bis Tokenaktualisierung Ganzzahl

    Gibt die Zeit in Sekunden an, bis ein Zugriffstoken abläuft und aktualisiert werden muss. Die Standardeinstellung ist 3600 (eine Stunde).

    Wenn Sie einen Wert im Bereich von 1 bis 3599 angeben, wird die Standardablaufzeit von 3600 Sekunden überschrieben. Wenn Sie 0 angeben, verwendet BigQuery-Connector für SAP den Standardwert 3600.

SAP LT Replication Server-Replikationskonfiguration erstellen

Verwenden Sie die SAP-Transaktion LTRC, um eine SAP LT Replication Server-Replikationskonfiguration zu erstellen.

Wenn SAP LT Replication Server auf einem anderen Server als dem SAP-Quellsystem ausgeführt wird, prüfen Sie vor dem Erstellen einer Replikationskonfiguration, ob Sie eine RFC-Verbindung zwischen den beiden Systemen haben.

Einige Einstellungen in der Replikationskonfiguration wirken sich auf die Leistung aus. Geeignete Einstellungswerte für die Installation finden Sie im Leitfaden zur Leistungsoptimierung für Ihre Version von SAP LT Replication Server im SAP-Hilfeportal.

Die Benutzer-Oberfläche und Konfigurationsoptionen für SAP LT Replication Server können je nach verwendeter Version geringfügig variieren.

Verwenden Sie zum Konfigurieren der Replikation das Verfahren für Ihre Version von SAP LT Replication Server:

Replikation in DMIS 2011 SP17, DMIS 2018 SP02 oder höher konfigurieren

In den folgenden Schritten wird die Replikation in höheren Versionen von SAP LT Replication Server konfiguriert. Wenn Sie eine ältere Version verwenden, finden Sie weitere Informationen unter Replikation in DMIS 2011 SP16, DMIS 2018 SP01 oder älter konfigurieren.

  1. Geben Sie in der SAP-GUI den Transaktionscode LTRC ein.

  2. Klicken Sie auf das Symbol Konfiguration erstellen. Der Assistent Konfiguration erstellen wird geöffnet.

  3. Geben Sie in die Felder Konfigurationsname und Beschreibung einen Namen und eine Beschreibung für die Konfiguration ein und klicken Sie dann auf Weiter.

    Sie können jetzt die Autorisierungsgruppe angeben, um den Zugriff jetzt auf eine bestimmte Autorisierungsgruppe zu beschränken, oder können dies später tun.

  4. Im Bereich Quellsystem-Verbindungsdetails:

    • Wählen Sie das Optionsfeld RFC-Verbindung aus.
    • Geben Sie im Feld RFC-Ziel den Namen der RFC-Verbindung zum Quellsystem an.
    • Aktivieren Sie die Kästchen Mehrfachverwendung zulassen und Von einzelnem Client lesen nach Bedarf. Weitere Informationen finden Sie in der Dokumentation zu SAP LT Replication Server.
    • Klicken Sie auf Weiter.

    Diese Schritte gelten für eine RFC-Verbindung. Wenn Ihre Quelle jedoch eine Datenbank ist, können Sie DB-Verbindung auswählen, wenn Sie bereits eine Verbindung mit der Transaktion DBACOCKPIT definiert haben.

  5. Im Bereich Zielsystem-Verbindungsdetails:

    • Wählen Sie das Optionsfeld für Andere aus.
    • Wählen Sie im Feld Szenario die Option SLT SDK aus dem Drop-down-Menü aus.
    • Klicken Sie auf Weiter.
  6. Gehen Sie im Bereich Übertragungseinstellungen angeben so vor:

    1. Geben Sie im Feld Anwendung des Abschnitts Datenübertragungseinstellungen /GOOG/SLT_BQ oder ZGOOG_SLT_BQ ein.

    2. Geben Sie im Abschnitt Joboptionen Startwerte in jedes der folgenden Felder ein:

      • Anzahl der Datenübertragungsjobs
      • Anzahl der anfänglichen Ladejobs
      • Anzahl der Berechnungsjobs
    3. Wählen Sie im Abschnitt Replikationsoptionen das Optionsfeld Echtzeit aus.

    4. Klicken Sie auf Weiter.

  7. Nachdem Sie die Konfiguration überprüft haben, klicken Sie auf Speichern.

  8. Notieren Sie sich die dreistellige ID in der Spalte Massenübertragung. Sie benötigen sie in einem späteren Schritt.

Weitere Informationen finden Sie im PDF-Anhang zum SAP-Hinweis 2652704: Daten mit SLT SDK replizieren – DMIS 2011 SP17, DMIS 2018 SP02.pdf.

Replikation in DMIS 2011 SP16, DMIS 2018 SP01 oder älter konfigurieren

In den folgenden Schritten wird die Replikation in früheren Versionen von SAP LT Replication Server konfiguriert. Wenn Sie eine höhere Version verwenden, lesen Sie die Informationen unter Replikation in DMIS 2011 SP17, DMIS 2018 SP02 oder höher konfigurieren.

  1. Geben Sie in der SAP-GUI den Transaktionscode LTRC ein.
  2. Klicken Sie auf Neu. Ein Dialogfeld zum Angeben einer neuen Konfiguration wird geöffnet.
  3. Im Schritt Quellsystem angeben:
    • Wählen Sie RFC-Verbindung als Verbindungstyp aus.
    • Geben Sie den Namen der RFC-Verbindung ein.
    • Achten Sie darauf, dass das Feld Mehrfachverwendung zulassen ausgewählt ist.
  4. Im Schritt Zielsystem angeben:
    • Geben Sie die Verbindungsdaten zum Zielsystem ein.
    • Wählen Sie RFC-Verbindung als Verbindungstyp aus.
    • Wählen Sie im Feld Szenario für RFC-Kommunikation den Wert Daten mit BAdI in das Ziel schreiben aus der Drop-down-Liste aus. Die RFC-Verbindung wird automatisch auf KEINE eingestellt.
  5. Drücken Sie im Schritt Übertragungseinstellungen festlegen die F4-Hilfe. Die zuvor definierte Anwendung wird im Feld Anwendung angezeigt.
  6. Notieren Sie sich die dreistellige ID in der Spalte Massenübertragung. Sie benötigen sie in einem späteren Schritt.

Weitere Informationen finden Sie im PDF-Anhang zum SAP-Hinweis 2652704: Daten mit SLT SDK replizieren – DMIS 2011 SP15, SP16, DMIS 2018 SP00, SP01.pdf.

Massenübertragungskonfiguration für BigQuery erstellen

Verwenden Sie die benutzerdefinierte /GOOG/SLT_SETTINGS-Transaktion, um eine Massenübertragung für BigQuery zu konfigurieren und die Tabellen- und Feldzuordnungen anzugeben.

Anfängliche Massenübertragungsoptionen auswählen

Wenn Sie zum ersten Mal die Transaktion /GOOG/SLT_SETTINGS eingeben, wählen Sie aus, welchen Teil der BigQuery-Massenübertragungskonfiguration Sie bearbeiten müssen.

So wählen Sie den Teil der Massenübertragungskonfiguration aus:

  1. Geben Sie in der SAP-GUI die Transaktion /GOOG/SLT_SETTINGS, der /n vorangestellt ist:

    /n/GOOG/SLT_SETTINGS
  2. Wählen Sie im Drop-down-Menü Einstellungentabelle im Startbildschirm für die Transaktion /GOOG/SLT_SETTINGS die Option Massenübertragungen aus.

    Lassen Sie für eine neue Massenübertragungskonfiguration das Feld Massübertragungsschlüssel leer.

  3. Klicken Sie auf das Symbol Ausführen. Der Bildschirm Wartung der BigQuery-Einstellungen wird angezeigt.

Tabellenerstellung und andere allgemeine Attribute angeben

Im ersten Abschnitt einer BigQuery-Massenübertragungskonfiguration identifizieren Sie die Massenübertragungskonfiguration und geben den zugehörigen Clientschlüssel sowie bestimmte Attribute an, die sich auf die Erstellung der BigQuery-Zieltabelle beziehen.

SAP LT Replication Server speichert die Massenübertragungskonfiguration als Eintrag in der benutzerdefinierten Konfigurationstabelle /GOOG/BQ_MASTR.

Die in den folgenden Schritten angegebenen Felder sind erforderlich.

  1. Klicken Sie auf der Seite Wartung der BigQuery-Einstellungen auf das Symbol Zeile anhängen.

  2. Geben Sie in der angezeigten Zeile die folgenden Einstellungen an:

    1. Geben Sie im Feld Massenübertragungsschlüssel einen Namen für diese Übertragung an. Dieser Name wird zum Primärschlüssel der Massenübertragung.
    2. Geben Sie im Feld Massenübertragungs-ID die dreistellige ID ein, die beim Erstellen der entsprechenden SAP LT Replication Server-Replikationskonfiguration generiert wurde.
    3. Wenn Sie die Labels oder kurze Beschreibungen der Quellfelder als Namen für die Zielfelder in BigQuery verwenden möchten, klicken Sie das Kästchen Flag „Benutzerdefinierten Namen“ verwenden an. Weitere Informationen zu Feldnamen finden Sie unter Standardoptionen zur Benennung von Feldern.
    4. Um den Typ der Änderung, der ein Einfügen ausgelöst hat zu speichern und die Validierung der Anzahl der Datensätze zwischen der Quelltabelle, den SAP LT Replication Server-Statistiken und der BigQuery-Tabelle zu aktivieren, wählen Sie das Kästchen Flag „Zusätzliche Felder” aus.

      Wenn dieses Flag festgelegt ist, fügt BigQuery-Connector für SAP dem BigQuery-Tabellenschema Spalten hinzu. Weitere Informationen finden Sie unter Zusätzliche Felder für Datensatzänderungen und Anzahlabfragen.

    5. Wenn Sie das Senden von Daten beenden möchten, wenn ein Datensatz mit einem Datenfehler gefunden wird, klicken Sie auf das Kästchen Flag „Beim ersten Fehler unterbrechen“. Dies wird empfohlen. Weitere Informationen finden Sie unter Das BREAK-Flag.

    6. Wenn ein Datensatz mit einem Datenfehler gefunden wird, klicken Sie auf das Kästchen Flag „Ungültige Datensätze überspringen“, um den Datensatz zu überspringen und weiter Datensätze in die BigQuery-Tabelle einzufügen. Wir empfehlen, diese Option deaktiviert zu lassen. Weitere Informationen finden Sie unter Das SKIP-Flag.

    7. Geben Sie im Feld Google Cloud-Schlüsselname den Namen der entsprechenden /GOOG/CLIENT_KEY-Konfiguration ein.

      BigQuery-Connector für SAP ruft die Google Cloud-Projekt-ID automatisch aus der /GOOG/CLIENT_KEY-Konfiguration ab.

    8. Geben Sie im Feld BigQuery-Dataset den Namen des BigQuery-Ziel-Datasets ein, das Sie zuvor in diesem Verfahren erstellt haben.

    9. Aktivieren Sie im Feld Flag „Ist Einstellung aktiv“ die Konfiguration der Massenübertragung. Klicken Sie dazu auf das Kästchen.

    10. Klicken Sie auf Speichern.

      Ein Massenübertragungsdatensatz wird in der Tabelle /GOOG/BQ_MASTR angehängt und die Felder Geändert von, Geändert am und Geändert um werden automatisch ausgefüllt.

    11. Klicken Sie auf Tabelle anzeigen.

      Der neue Massenübertragungsdatensatz wird angezeigt, gefolgt vom Eintragsbereich für das Tabellenattribut.

Tabellenattribute angeben

Im zweiten Abschnitt der Transaktion /GOOG/SLT_SETTINGS können Sie Tabellenattribute wie den Tabellennamen und die Tabellenpartitionierung sowie die Anzahl der Datensätze angeben, die in jede Übertragung oder jeden Block aufgenommen werden sollen, der an BigQuery gesendet wird.

Die von Ihnen angegebenen Einstellungen werden als Datensatz in der Konfigurationstabelle /GOOG/BQ_TABLE gespeichert.

Diese Einstellungen sind optional.

So geben Sie Tabellenattribute an:

  1. Klicken Sie auf das Symbol Zeile anhängen.

  2. Geben Sie im Feld SAP-Tabellenname den Namen der SAP-Quelltabelle ein.

  3. Geben Sie im Feld Name der externen Tabelle den Namen der BigQuery-Zieltabelle ein. Wenn die Zieltabelle noch nicht vorhanden ist, erstellt BigQuery-Connector für SAP die Tabelle mit diesem Namen. Die BigQuery-Namenskonventionen für Tabellen finden Sie unter Tabellennamen.

  4. Im Feld Flag „Unkomprimiert senden“ wird die Datensatzkomprimierung deaktiviert. Geben Sie dieses Flag nur an, wenn Sie BigQuery Connector für SAP benötigen, um leere Felder in den Quelldatensätzen mit den Werten zu replizieren, mit denen die Felder in der Quelltabelle initialisiert wurden. Geben Sie dieses Flag nicht an, um eine bessere Leistung zu erzielen. Weitere Informationen finden Sie unter Datensatzkomprimierung.

  5. Geben Sie optional im Feld Blockgröße die maximale Anzahl der Datensätze an, die in jedem Block enthalten sein sollen, der an BigQuery gesendet wird. Verwenden Sie, wenn möglich, die maximale Blockgröße, die BigQuery-Connector für SAP zulässt – derzeit der Standardwert von 10.000 Datensätzen. Wenn die Quelldatensätze eine große Anzahl von Feldern enthalten, kann die Anzahl der Felder die Bytegröße der Blöcke insgesamt erhöhen, was zu Blockfehlern führen kann. Versuchen Sie in diesem Fall, die Blockgröße zu reduzieren, um die Bytegröße zu reduzieren. Weitere Informationen finden Sie unter Blockgröße in BigQuery-Connector für SAP.

  6. Geben Sie optional im Feld Partitionstyp ein Zeitinkrement für die Partitionierung an. Gültige Werte sind HOUR, DAY, MONTH oder YEAR. Weitere Informationen finden Sie unter Tabellenpartitionierung.

  7. Optional können Sie im Feld Partitionsfeld den Namen eines Felds in der BigQuery-Zieltabelle angeben, das einen Zeitstempel für die Partitionierung enthält. Wenn Sie das Partitionsfeld angeben, müssen Sie auch den Partitionstyp festlegen. Weitere Informationen finden Sie unter Tabellenpartitionierung.

  8. Aktivieren Sie im Feld Flag „Ist Einstellung aktiv“ die Tabellenattribute, indem Sie das Kästchen anklicken. Wenn das Kästchen Flag „Ist Einstellung aktiv“ nicht ausgewählt ist, erstellt BigQuery-Connector für SAP die BigQuery-Tabelle mit dem Namen der SAP-Quelltabelle, der standardmäßigen Blockgröße und ohne Partitionierung.

  9. Klicken Sie auf Speichern.

    Ihre Attribute werden als Datensatz in der Konfigurationstabelle /GOOG/BQ_TABLE gespeichert und die Felder Geändert von, Geändert am und Geändert um werden automatisch ausgefüllt.

  10. Klicken Sie auf Felder anzeigen.

    Der neue Tabellenattributdatensatz wird angezeigt, gefolgt vom Eintragsbereich für die Feldzuordnung.

Standardfeldzuordnung anpassen

Wenn die SAP-Quelltabelle Zeitstempelfelder oder boolesche Werte enthält, ändern Sie die Standardzuordnung des Datentyps so, dass sie genau den Datentyp in der BigQuery-Zieltabelle widerspiegelt.

Sie können auch andere Datentypen sowie die Namen ändern, die für Zielfelder verwendet werden.

Sie können die Standardzuordnung direkt in der SAP GUI bearbeiten oder in eine Tabelle oder Textdatei exportieren, damit die Werte von anderen Nutzern bearbeitet werden können, ohne Zugriff auf SAP LT Replication Server zu benötigen.

Weitere Informationen zur Standardfeldzuordnung und den möglichen Änderungen finden Sie unter Feldzuordnung.

So passen Sie die Standardzuordnung für die BigQuery-Zielfelder an:

  1. Zeigen Sie auf der Seite Wartung der BigQuery-Einstellungen – Felder der Transaktion /GOOG/SLT_SETTINGS die Standardfeldzuordnungen für die Massenübertragung an, die Sie derzeit konfigurieren.

  2. Bearbeiten Sie die Standardzieldatentypen in der Spalte Externes Datenelement nach Bedarf. Ändern Sie insbesondere den Zieldatentyp für die folgenden Datentypen:

    • Zeitstempel. Ändern Sie den Standardzieldatentyp von NUMERIC in TIMESTAMP oder TIMESTAMP (LONG).
    • Boolesche Werte. Ändern Sie den Standardzieldatentyp von STRING in BOOLEAN.
    • Hexadezimalzahlen. Ändern Sie den Standardzieldatentyp von STRING in BYTES.

    So bearbeiten Sie die Standarddatentypzuordnung:

    1. Klicken Sie in der Zeile des Felds, das Sie bearbeiten müssen, auf das Feld Externes Datenelement.
    2. Wählen Sie im Dialogfeld für Datentypen den benötigten BigQuery-Datentyp aus.
    3. Bestätigen Sie Ihre Änderungen und klicken Sie dann auf Speichern.
  3. Wenn Sie das Flag Benutzerdefinierte Namen auf der Seite Wartung der BigQuery-Einstellungen angegeben haben, bearbeiten Sie die Standardzielfeldnamen in der Spalte Temporärer Feldname nach Bedarf.

    Die von Ihnen angegebenen Werte überschreiben die Standardnamen, die in der Spalte Name des externen Felds angezeigt werden.

  4. Bearbeiten Sie nach Bedarf die Standardbeschreibungen des Zielfelds in der Spalte Feldbeschreibung.

  5. Exportieren Sie optional die Feldzuordnung zur externen Bearbeitung. Eine Anleitung finden Sie unter BigQuery-Feldzuordnung in einer CSV-Datei bearbeiten.

  6. Nachdem alle Änderungen vorgenommen und alle extern bearbeiteten Werte hochgeladen wurden, prüfen Sie, ob das Kästchen Flag „Ist Einstellung aktiv“ ausgewählt ist. Wenn Flag „Ist Einstellung aktiv“ nicht ausgewählt ist, erstellt BigQuery-Connector für SAP Zieltabellen mit den Standardwerten.

  7. Klicken Sie auf Speichern.

    Die Änderungen werden in der Konfigurationstabelle /GOOG/BQ_FIELD gespeichert und die Felder Geändert von, Geändert am und Geändert um werden automatisch ausgefüllt.

Replikation testen

Testen Sie die Replikationskonfiguration durch Starten der Datenbereitstellung:

  1. Öffnen Sie das SAP LT Replication Server-Cockpit (Transaktion LTRC) in der SAP-GUI.

  2. Klicken Sie auf die Massenübertragungskonfiguration für die zu testende Tabellenreplikation.

  3. Klicken Sie auf Datenbereitstellung.

  4. Starten Sie im Bereich Datenbereitstellung die Datenbereitstellung:

    1. Geben Sie den Namen der Quelltabelle ein.
    2. Klicken Sie auf das Optionsfeld für die Art der Datenbereitstellung, die Sie testen möchten. Beispiel: Laden starten.
    3. Klicken Sie auf das Symbol Ausführen. Die Datenübertragung beginnt und der Fortschritt wird auf dem Bildschirm Teilnehmende Objekte angezeigt.

      Wenn die Tabelle nicht in BigQuery vorhanden ist, erstellt BigQuery-Connector für SAP die Tabelle aus einem Schema, das aus den Tabellen- und Feldattributen erstellt wird, die Sie zuvor mit der Transaktion /GOOG/SLT_SETTINGS definiert haben.

      Wie lange das erstmalige Laden einer Tabelle dauert, hängt von der Größe der Tabelle und ihren Datensätzen ab.

      Nachrichten werden in den Abschnitt Anwendungslogs von SAP LT Replication Server in der Transaktion LTRC geschrieben.

Replikation validieren

Sie können die Replikation mit den folgenden Methoden validieren:

  • In SAP LT Replication Server:
    • Überwachen Sie die Replikation auf dem Bildschirm Datenbereitstellung.
    • Suchen Sie auf dem Bildschirm Anwendungslogs nach Fehlermeldungen.
  • Auf dem Tab mit Tabelleninformationen in BigQuery:
    • Prüfen Sie auf dem Tab Schema, ob das Schema korrekt aussieht.
    • Auf dem Tab Vorschau können Sie sich eine Vorschau der eingefügten Zeilen ansehen.
    • Auf dem Tab Details finden Sie die Anzahl der eingefügten Zeilen, die Größe der Tabelle und weitere Informationen.
  • Wenn das Kästchen Flag „Zusätzliche Felder” bei der Konfiguration der BigQuery-Tabelle aktiviert wurde, führen Sie das Replikations-Validierungstool aus, indem Sie die benutzerdefinierte /GOOG/REPLIC_VALID-Transaktion eingeben.

Replikation in SAP LT Replication Server prüfen

Verwenden Sie die Transaktion LTRC, um den Fortschritt der anfänglichen Lade- oder Replikationsjobs nach ihrem Start zu sehen und auf Fehlermeldungen zu prüfen.

Sie können den Status des Ladevorgangs auf dem Tab Ladestatistiken und den Fortschritt des Jobs auf dem Tab Datenübertragungsmonitor in SAP LT Replication Server sehen.

Auf dem Bildschirm Anwendungslogs der Transaktion LTRC können Sie alle Nachrichten sehen, die von BigQuery, BigQuery-Connector für SAP und SAP LT Replication Server zurückgegeben wurden.

Nachrichten, die von BigQuery-Connector für SAP-Code in SAP LT Replication Server ausgegeben werden, beginnen mit dem Präfix /GOOG/SLT. Von der BigQuery API zurückgegebene Nachrichten beginnen mit dem Präfix /GOOG/MSG.

Nachrichten, die von SAP LT Replication Server zurückgegeben werden, beginnen nicht mit dem Präfix /GOOG/.

Replikation in BigQuery prüfen

Prüfen Sie in der Google Cloud Console, ob die Tabelle erstellt wurde und ob BigQuery Daten in sie einfügt.

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Geben Sie im Suchfeld des Abschnitts Explorer den Namen der BigQuery-Zieltabelle ein und drücken Sie Enter.

    Die Tabelleninformationen werden auf einem Tab im Inhaltsbereich rechts auf der Seite angezeigt.

  3. Klicken Sie im Abschnitt "Tabelleninformationen" auf die folgenden Überschriften, um die Tabelle und das Einfügen von Zeilen zu prüfen:

    • Vorschau: Zeigt die Zeilen und Felder an, die in die BigQuery-Tabelle eingefügt werden.
    • Schema: Zeigt die Feldnamen und Datentypen an.
    • Details: Zeigt die Tabellengröße, die Gesamtzahl der Zeilen und andere Details an.

Replikationsvalidierungstool ausführen

Wenn das Flag „Zusätzliche Felder” bei der Konfiguration der BigQuery-Tabelle ausgewählt wurde, können Sie mit dem Tool zur Replikationsprüfung Berichte erstellen, die die Anzahl der Datensätze in der BigQuery-Tabelle mit der Anzahl der Datensätze in SAP LT Replication Server oder der Quelltabelle vergleichen.

So führen Sie das Replikationsvalidierungstool aus:

  1. Geben Sie in der SAP-GUI die Transaktion /GOOG/REPLIC_VALID ein, der /n vorangestellt ist:

    /n/GOOG/REPLIC_VALID
  2. Klicken Sie im Abschnitt Verarbeitungsoptionen auf das Optionsfeld Validierung ausführen.

  3. Geben Sie im Abschnitt Auswahloptionen die folgenden Spezifikationen ein:

    • Wählen Sie im Drop-down-Menü im Feld GCP-Partner-ID die Option BigQuery aus.
    • Wählen Sie im Drop-down-Menü im Feld Diagnosetyp den gewünschte Berichttyp aus:
      • Anzahl der anfänglichen Ladevorgänge
      • Anzahl der Replikationen
      • Aktuelle Anzahl
    • Wenn das Feld Diagnosedatum angezeigt wird, geben Sie das Datum an, für das Sie die Anzahl benötigen.
    • Geben Sie im Feld Massenübertragungsschlüssel den Namen der Massenübertragungskonfiguration ein.
  4. Führen Sie das Replikationsvalidierungstool aus, indem Sie auf das Symbol Ausführen klicken.

  5. Rufen Sie nach Abschluss der Validierungsprüfung im Abschnitt Verarbeitungsoptionen den Bericht auf, indem Sie auf das Optionsfeld Bericht anzeigen und dann auf die Schaltfläche Ausführen klicken.

Weitere Informationen finden Sie unter Tool zur Replikationsvalidierung.

Fehlerbehebung

Informationen zum Diagnostizieren und Beheben von Problemen, die beim Konfigurieren und Ausführen von Ladevorgängen oder Replikationen zwischen SAP und BigQuery mit BigQuery-Connector für SAP auftreten können, finden Sie unter Leitfaden zur Fehlerbehebung für BigQuery-Connector für SAP.

Support anfordern

Wenn Sie Hilfe bei der Behebung von Problemen mit der Replikation und mit BigQuery-Connector für SAP benötigen, erfassen Sie alle verfügbaren Diagnoseinformationen und wenden Sie sich an Cloud Customer Care. Informationen zur Kontaktaufnahme mit Customer Care finden Sie unter Support für SAP in Google Cloud.