Schritt 5: Bereitstellung konfigurieren
Auf dieser Seite wird der fünfte Schritt zum Bereitstellen der Cortex Framework Data Foundation, dem Kern von Cortex Framework, beschrieben. In diesem Schritt passen Sie die Konfigurationsdatei im Repository „Cortex Framework Data Foundation“ an Ihre Anforderungen an.
Konfigurationsdatei
Das Verhalten des Deployments wird durch die Konfigurationsdatei config.json in der Cortex Framework Data Foundation gesteuert. Diese Datei enthält die globale Konfiguration und die spezifische Konfiguration für jede Arbeitslast.
Bearbeiten Sie die Datei config.json nach Bedarf. Gehen Sie dazu so vor:
- Öffnen Sie die Datei
config.jsonin Cloud Shell. Bearbeiten Sie die Datei
config.jsonanhand der folgenden Parameter:Parameter Bedeutung Standardwert Beschreibung testDataTestdaten bereitstellen trueDas Projekt, in dem sich das Quelldataset befindet und in dem der Build ausgeführt wird. Hinweis: Die Bereitstellung von Testdaten wird nur ausgeführt, wenn das Rohdatenset leer ist und keine Tabellen enthält. deploySAPSAP bereitstellen trueFühren Sie die Bereitstellung für die SAP-Arbeitslast (ECC oder S/4HANA) aus. deploySFDCSalesforce bereitstellen trueFühren Sie die Bereitstellung für die Salesforce-Arbeitslast aus. deployMarketingMarketing bereitstellen trueFühren Sie die Bereitstellung für Marketingquellen (Google Ads, CM360 und TikTok) aus. deployOracleEBSOracle EBS bereitstellen trueFühren Sie die Bereitstellung für die Oracle EBS-Arbeitslast aus. deployDataMeshData Mesh bereitstellen trueFühren Sie die Bereitstellung für Data Mesh aus. Weitere Informationen finden Sie im Data Mesh-Nutzerhandbuch. enableTaskDependenciesAufgabenabhängige DAGs falseAktivieren Sie aufgabenabhängige DAGs, damit unterstützte SQL-Tabellen in einzelnen DAGs in der Reihenfolge ihrer Abhängigkeiten ausgeführt werden. Weitere Informationen finden Sie unter Aufgabenabhängige DAGs. turboModeStellen Sie die Funktion im Turbomodus bereit. trueAlle Ansichts-Builds als Schritt im selben Cloud Build-Prozess parallel ausführen, um die Bereitstellung zu beschleunigen. Wenn der Wert auf falsefestgelegt ist, wird jede Berichtsansicht in einem eigenen sequenziellen Build-Schritt generiert. Wir empfehlen, den Wert nur auftruezu setzen, wenn Sie Testdaten verwenden oder nachdem alle Abweichungen zwischen den Berichtsspalten und den Quelldaten behoben wurden.projectIdSourceQuellprojekt-ID - Das Projekt, in dem sich das Quelldataset befindet und in dem der Build ausgeführt wird. projectIdTargetZielprojekt-ID - Zielprojekt für nutzerorientierte Datasets. targetBucketZiel-Bucket zum Speichern generierter DAG-Skripts - Bucket, der zuvor erstellt wurde und in dem DAGs (und temporäre Dataflow-Dateien) generiert werden. Verwenden Sie nicht den tatsächlichen Airflow-Bucket. locationStandort oder Region "US"Standort des BigQuery-Datasets und der Cloud Storage-Buckets. Die Einschränkungen finden Sie unter BigQuery-Dataset-Standorte.
testDataProjectQuelle für Test-Harnisch kittycorn-publicQuelle der Testdaten für Demobereitstellungen. Gilt, wenn testDatatrueist.Ändern Sie diesen Wert nur, wenn Sie einen eigenen Testharness haben.
k9.datasets.processingK9-Datasets – Verarbeitung "K9_PROCESSING"Führen Sie arbeitslastübergreifende Vorlagen (z. B. Datumsdimension) aus, wie in der K9-Konfigurationsdatei definiert. Diese Vorlagen sind normalerweise für die nachgelagerten Arbeitslasten erforderlich. k9.datasets.reportingK9-Datasets – Berichterstellung "K9_REPORTING"Führen Sie arbeitslastübergreifende Vorlagen und externe Datenquellen (z. B. Wetter) aus, wie in der K9-Konfigurationsdatei definiert. Standardmäßig auskommentiert. DataMesh.deployDescriptionsData Mesh – Asset-Beschreibungen trueBigQuery-Asset-Schemabeschreibungen bereitstellen. DataMesh.deployLakesData Mesh – Lakes und Zonen falseFür die Bereitstellung von Dataplex Universal Catalog-Lakes und ‑Zonen, in denen Tabellen nach Verarbeitungsebene organisiert werden, ist eine Konfiguration erforderlich, bevor sie aktiviert werden können. DataMesh.deployCatalogData Mesh – Katalog-Tags und ‑Vorlagen falseWenn Sie Data Catalog-Tags bereitstellen möchten, mit denen benutzerdefinierte Metadaten für BigQuery-Assets oder -Felder möglich sind, ist eine Konfiguration erforderlich, bevor Sie die Tags aktivieren können. DataMesh.deployACLsData Mesh – Zugriffssteuerung falseWenn Sie die Zugriffssteuerung auf Asset-, Zeilen- oder Spaltenebene für BigQuery-Assets bereitstellen möchten, ist eine Konfiguration vor der Aktivierung erforderlich. Konfigurieren Sie die erforderlichen Arbeitslasten nach Bedarf. Sie müssen sie nicht konfigurieren, wenn der Bereitstellungsparameter (z. B.
deploySAPoderdeployMarketing) für die Arbeitslast aufFalsefestgelegt ist. Weitere Informationen finden Sie unter Schritt 3: Integrationsmechanismus festlegen.
Weitere Informationen zum Anpassen des Deployments finden Sie in den folgenden optionalen Schritten:
Leistungsoptimierung für Berichtsansichten
Berichtsobjekte können als Ansichten oder als Tabellen erstellt werden, die regelmäßig über DAGs aktualisiert werden. Einerseits werden die Daten in Ansichten bei jeder Ausführung einer Abfrage berechnet, sodass die Ergebnisse immer aktuell sind. Bei der Tabelle werden die Berechnungen nur einmal ausgeführt. Die Ergebnisse können mehrmals abgefragt werden, ohne dass höhere Rechenkosten anfallen. Außerdem ist die Laufzeit kürzer. Jeder Kunde erstellt seine eigene Konfiguration entsprechend seinen Anforderungen.
Materialisierte Ergebnisse werden in einer Tabelle aktualisiert. Diese Tabellen können weiter optimiert werden, indem Sie Partitionierung und Clustering hinzufügen.
Die Konfigurationsdateien für die einzelnen Arbeitslasten befinden sich in den folgenden Pfaden im Cortex Framework Data Foundation-Repository:
| Datenquelle | Einstellungsdateien |
| Betriebsbereit – SAP | src/SAP/SAP_REPORTING/reporting_settings_ecc.yaml
|
| Betrieblich – Salesforce Sales Cloud | src/SFDC/config/reporting_settings.yaml
|
| Betrieblich – Oracle EBS | src/oracleEBS/config/reporting_settings.yaml
|
| Marketing – Google Ads | src/marketing/src/GoogleAds/config/reporting_settings.yaml
|
| Marketing – CM360 | src/marketing/src/CM360/config/reporting_settings.yaml
|
| Marketing – Meta | src/marketing/src/Meta/config/reporting_settings.yaml
|
| Marketing – Salesforce Marketing Cloud | src/marketing/src/SFMC/config/reporting_settings.yaml
|
| Marketing – TikTok | src/marketing/src/TikTok/config/reporting_settings.yaml
|
| Marketing – YouTube (mit DV360) | src/marketing/src/DV360/config/reporting_settings.yaml
|
| Marketing – Google Analytics 4 | src/marketing/src/GA4/config/reporting_settings.yaml
|
| Marketing – Cross-Media- und produktbezogene Statistiken | src/marketing/src/CrossMedia/config/reporting_settings.yaml
|
Datei mit Berichtseinstellungen anpassen
Die reporting_settings-Dateien steuern, wie die BigQuery-Objekte (Tabellen oder Ansichten) für Berichtsdatasets erstellt werden. Passen Sie Ihre Datei mit den folgenden Parameterbeschreibungen an. Diese Datei enthält zwei Abschnitte:
bq_independent_objects: Alle BigQuery-Objekte, die unabhängig und ohne andere Abhängigkeiten erstellt werden können. WennTurbo modeaktiviert ist, werden diese BigQuery-Objekte parallel während der Bereitstellungszeit erstellt, was den Bereitstellungsprozess beschleunigt.bq_dependent_objects: Alle BigQuery-Objekte, die aufgrund von Abhängigkeiten von anderen BigQuery-Objekten in einer bestimmten Reihenfolge erstellt werden müssen.Turbo modegilt nicht für diesen Abschnitt.
Der Deployer erstellt zuerst alle in bq_independent_objects aufgeführten BigQuery-Objekte und dann alle in bq_dependent_objects aufgeführten Objekte. Definieren Sie die folgenden Attribute für jedes Objekt:
sql_file: Name der SQL-Datei, mit der ein bestimmtes Objekt erstellt wird.type: Typ des BigQuery-Objekts. Mögliche Werte:view: Wenn das Objekt eine BigQuery-Ansicht sein soll.table: Wenn das Objekt eine BigQuery-Tabelle sein soll.script: Damit können Sie andere Arten von Objekten erstellen, z. B. BigQuery-Funktionen und gespeicherte Prozesse.
- Wenn
typeauftablefestgelegt ist, können die folgenden optionalen Attribute definiert werden:load_frequency: Häufigkeit, mit der eine Composer-DAG ausgeführt wird, um diese Tabelle zu aktualisieren. Weitere Informationen zu möglichen Werten finden Sie in der Airflow-Dokumentation.partition_details: Wie die Tabelle partitioniert werden soll. Dieser Wert ist optional. Weitere Informationen finden Sie im Abschnitt Tabellenpartition.cluster_details: Gibt an, wie die Tabelle gruppiert werden soll. Dieser Wert ist optional. Weitere Informationen finden Sie im Abschnitt Clustereinstellungen.
Tabellenpartition
Mit bestimmten Einstellungsdateien können Sie materialisierte Tabellen mit benutzerdefinierten Clustering- und Partitionierungsoptionen konfigurieren. Dies kann die Abfrageleistung für große Datasets erheblich verbessern. Diese Option gilt nur für SAP cdc_settings.yaml- und alle reporting_settings.yaml-Dateien.
Die Tabellenpartitionierung kann durch Angabe der folgendenpartition_detailsaktiviert werden:
- base_table: vbap
load_frequency: "@daily"
partition_details: {
column: "erdat", partition_type: "time", time_grain: "day" }
Mit den folgenden Parametern können Sie die Partitionierungsdetails für eine bestimmte Tabelle festlegen:
| Attribut | Beschreibung | Wert |
column
|
Spalte, nach der die CDC-Tabelle partitioniert wird. | Spaltenname. |
partition_type
|
Typ der Partition. | "time" für die zeitbasierte Partitionierung. Weitere Informationen finden Sie unter Nach Zeitstempel partitionierte Tabellen.
"integer_range" für die Partitionierung nach Ganzzahl. Weitere Informationen finden Sie in der Dokumentation zu Ganzzahlbereichen.
|
time_grain
|
Uhrzeitangabe für die Partitionierung
Erforderlich, wenn partition_type = "time".
|
"hour", "day", "month" oder "year".
|
integer_range_bucket
|
Bucket-Bereich
Erforderlich, wenn partition_type = "integer_range"
|
"start" = Startwert, "end" = Endwert und "interval = Intervall des Bereichs.
|
Weitere Informationen zu Optionen und zugehörigen Einschränkungen finden Sie unter BigQuery-Tabellenpartition.
Clustereinstellungen
Tabellen-Clustering kann durch Angabe von cluster_details aktiviert werden:
- base_table: vbak
load_frequency: "@daily"
cluster_details: {columns: ["vkorg"]}
Mit den folgenden Parametern können Sie Clusterdetails für eine bestimmte Tabelle festlegen:
| Attribut | Beschreibung | Wert |
columns
|
Spalten, nach denen eine Tabelle geclustert wird. | Liste der Spaltennamen. Beispiel: "mjahr" und "matnr".
|
Weitere Informationen zu Optionen und zugehörigen Einschränkungen finden Sie in der Dokumentation zu Tabellenclustern.
Nächste Schritte
Fahren Sie nach Abschluss dieses Schritts mit dem folgenden Bereitstellungsschritt fort:
- Arbeitslasten einrichten:
- Repository klonen
- Integrationsmechanismus festlegen:
- Komponenten einrichten
- Bereitstellung konfigurieren (diese Seite).
- Bereitstellung ausführen