Demobereitstellung

Die Demobereitstellung bietet eine optimierte Erfahrung mit einem vordefinierten Beispieldataset. Sie bietet einen End-to-End-Workflow zum Bereitstellen der Dataform-Pipelines des Cortex Framework für die Orchestrierung und zum Initialisieren der entsprechenden BigQuery-Datasets mit Beispieldaten.

Hinweis

Prüfen Sie, ob die Voraussetzungen auf der Seite Voraussetzungen erfüllt sind, bevor Sie mit der Demobereitstellung fortfahren.

Erforderliche IAM-Rollen und ‑Berechtigungen abrufen

Rufen Sie die erforderlichen IAM-Berechtigungen (Identity and Access Management) ab, um Cortex Framework -Inhalte im Ziel Google Cloud projekt bereitzustellen.

Rollen für das Zielprojekt

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Zielprojekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Bereitstellen des Cortex Framework benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Optional: Erforderliche IAM-Rollen für eine Demobereitstellung mit einem Dienstkonto abrufen

Die folgenden Rollen sind nur bei einer Demobereitstellung mit dem optionalen Parameter --service_account erforderlich. Wenn Sie bei der Demobereitstellung ein Dienstkonto angeben, wird die Ausführung der Datenpipelines nach der Bereitstellung vereinfacht, da eine Konfiguration für die Ausführungsplanung von Workflows erstellt wird. Diese Rollen sind für Bereitstellungen ohne die --service_account-Konfiguration nicht erforderlich.

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Service Account Token Creator (roles/iam.serviceAccountTokenCreator) für Ihr Quell- und Zielprojekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Bereitstellen der Demo des Cortex Framework benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Bereitstellung

Führen Sie die folgenden Schritte aus, um eine virtuelle Python-Umgebung zu erstellen, die Abhängigkeiten zu synchronisieren und die Datenpipelines auszulösen. Verwenden Sie die uvSkripts des Cortex Framework, um Ihre Daten assets zu erstellen und in Ihr Google Cloud Projekt zu übertragen. So wandeln Sie Ihre lokalen Konfigurationen in eine aktive, skalierbare Datenarchitektur um. Weitere Informationen finden Sie unter uv installieren im Abschnitt Voraussetzungen.

Demobereitstellung ausführen

Führen Sie den folgenden Befehl aus, um die Bereitstellung auszulösen. Bei diesem Vorgang werden die folgenden Aktionen ausgeführt:

  • Prüfen, ob alle Voraussetzungen erfüllt sind.
  • Beispieldaten in ein BigQuery-Dataset laden, das zu Demozwecken als Rohdatenebene dient.
  • Dataform-Pipelines zum Verarbeiten der Beispieldaten über die Datenebenen des Cortex Framework erstellen.
  • Dataform-Repository und ‑Arbeitsbereich erstellen und dann die kompilierten Artefakte mit dem Repository synchronisieren.
  • Workflowplanung erstellen und die erste Dataform-Workflowausführung auslösen.

Führen Sie für die Demobereitstellung ohne Dienstkonto den folgenden Befehl aus:

uv run cortex-demo --project_id=PROJECT_ID

Führen Sie für die Demobereitstellung mit einem Dienstkonto den folgenden Befehl aus:

uv run cortex-demo --project_id=PROJECT_ID \
    --service_account="SA_DF_RUN@PROJECT_ID.iam.gserviceaccount.com"

Weitere Informationen finden Sie unter Unterstützte BigQuery-Standorte und Unterstützte Dataform-Regionen.

CLI-Demobereitstellung: Optional können Sie eine Liste der möglichen Parameter aufrufen indem Sie den uv run cortex-demo -h Befehl ausführen. Weitere Informationen finden Sie unter CLI-Demobereitstellung des Cortex Framework.

Überprüfung

Nach Abschluss der Bereitstellung:

  1. Öffnen Sie Dataform, um den neuen Code im Repository zu prüfen:

    1. Dataform-Repository erstellt.
    2. Dataform-Entwicklungsarbeitsbereich erstellt.
    3. Code kompiliert und synchronisiert.

  2. Dataform-Aktionen ausführen:

    1. Öffnen Sie den Dataform-Arbeitsbereich.
    2. Klicken Sie auf Ausführung starten.
    3. Klicken Sie auf Aktionen ausführen.
    4. Klicken Sie auf Alle Aktionen.

    5. Klicken Sie auf Ausführung starten.

    6. Beobachten Sie die erfolgreiche Ausführung aller Aktionen in Ihrem Dataform-Repository.

  3. Rufen Sie die BigQuery-Konsole auf, um die erstellten Datasets anzusehen und das Schema und die Daten zu prüfen. Erstellte Datasets:

    • cortex_demo_sap_ecc_raw: Dieses Dataset enthält die Rohdaten aus dem Quellsystem (in diesem Beispiel SAP S/4HANA).
    • cortex_demo_sap_ecc_data_foundation: Dieses Dataset stellt die Datengrundlagenebene dar, auf der Rohdaten aus der Rohdatenebene mit CDC verarbeitet werden.
    • cortex_demo_data_product: Dieses Dataset enthält die Demodatenprodukte – verfeinerte, leistungsstarke Ansichten oder Tabellen, die für Endnutzer konzipiert sind.