Compatibilità di Cortex Framework v6

I contenuti di compatibilità v6 forniscono un livello compatibile con lo schema per i workload di Cortex Framework v6 all'interno dell'architettura di Cortex Framework v7. In questo modo, puoi eseguire la migrazione a Cortex Framework v7 senza interrompere le risorse di analisi esistenti, come le dashboard di Looker o i modelli semantici LookML.

Origini dati supportate

Il framework fornisce contenuti di compatibilità v6 per le origini dati SAP ECC e SAP S/4HANA.

Come funziona

I contenuti di compatibilità v6 fungono da adattatore tra i modelli di dati v7 e le risorse di reporting legacy:

  • Visualizzazioni compatibili con lo schema: espongono i nomi delle visualizzazioni di reporting, le colonne e le maiuscole/minuscole esattamente come apparivano in Cortex Framework (v6).
  • Isolamento della destinazione: isola le visualizzazioni di compatibilità dalle tabelle principali di Cortex Framework eseguendo il deployment all'interno di uno spazio dei nomi separato (cortex_v6_compatibility) e di un set di dati di destinazione BigQuery dedicato.

Eseguire il deployment dei contenuti di compatibilità

Per eseguire il deployment dei contenuti di compatibilità di Cortex Framework v6, completa i seguenti passaggi:

  • Configura un set di dati di destinazione BigQuery dedicato.
  • Attiva i moduli di compatibilità v6 nel file config.yaml.
  • Esegui gli script di creazione e deployment di Google Cloud Cortex Framework.
  • Esegui le pipeline di Dataform.

Set di dati di destinazione dedicato

Devi eseguire il deployment dei contenuti di compatibilità v6 in un set di dati BigQuery separato. In questo modo si evitano l'ombreggiatura dello spazio dei nomi e i conflitti tra le tabelle fisiche, perché molte tabelle utilizzate dai contenuti di compatibilità condividono nomi fisici identici (ad esempio cost_centers, profit_centers, billing e deliveries) con le tabelle principali di Cortex Framework v7.

Per creare il set di dati BigQuery dedicato, aggiungi cortex_v6_compatibility_target al file config.yaml:

data:
  datasets:
    - id: product_target
      projectId: YOUR_TARGET_PROJECT_ID
      datasetId: prod_sap_dataproducts # Core v7 tables
    - id: cortex_v6_compatibility_target
      projectId: YOUR_TARGET_PROJECT_ID
      datasetId: prod_sap_cortex6 # Compatibility v6 tables

Configurare Cortex Framework

Per registrare e attivare il livello di compatibilità nel file config.yaml, devi completare le seguenti attività:

  • Configura il set di dati di destinazione dedicato.
  • Registra lo spazio dei nomi di compatibilità.

  • Imposta l'attributo enabled su true per tutti i seguenti moduli di compatibilità di Cortex Framework v6:

  • sap_cortex_v6_compatibility_master_data

  • sap_cortex_v6_compatibility_accounts_payable

  • sap_cortex_v6_compatibility_finance

  • sap_cortex_v6_compatibility_inventory

  • sap_cortex_v6_compatibility_purchasing

  • sap_cortex_v6_compatibility_sales

L'esempio seguente mostra le modifiche alla configurazione necessarie per attivare sap_cortex_v6_compatibility_inventory:

data:
  datasets:
    - id: cortex_v6_compatibility_target
      projectId: YOUR_TARGET_PROJECT_ID
      datasetId: prod_sap_cortex6

  namespaces:
    - name: cortex_v6_compatibility
      path: ../src/data_modules/cortex_v6_compatibility

  modules:
    products:
      - moduleId: sap_cortex_v6_compatibility_inventory
        modulePath: cortex_v6_compatibility.sap.products.inventory
        enabled: true # If using configuration file based on config.yaml.example, ensure the `enabled` flag is set to `true`
        syncToKc: false
        dependencyBindings:
          sapModule: erp
          sapMasterData: sap_cortex_v6_compatibility_master_data
          sapSales: sap_cortex_v6_compatibility_sales
        dataTargetId: cortex_v6_compatibility_target
        moduleSettings:
          targetCurrencies: ['USD']
          rateType: 'M'
          languages: ['E']

#    You must ensure the `enabled` flag is set to `true` for all of the listed dependent modules. In this example:
#   `sap_cortex_v6_compatibility_master_data`
#   `sap_cortex_v6_compatibility_sales`

Requisiti operativi

Ti consigliamo vivamente di attivare contemporaneamente tutti i moduli di compatibilità di Cortex Framework v6. I contenuti di compatibilità contengono dipendenze tra moduli (ad esempio, le visualizzazioni di fatturazione dipendono dalle tabelle dei dati master e le visualizzazioni di snapshot dell'inventario dipendono dalle dimensioni del calendario). L'attivazione simultanea impedisce errori di dipendenza in Dataform.

Snapshot dell'inventario

Devi configurare ed eseguire le tabelle di snapshot dell'inventario (stock_weekly_snapshots e stock_monthly_snapshots) come tabelle incrementali. In Cortex Framework v6, gli snapshot dell'inventario calcolano un totale cumulativo progressivo delle quantità e dei valori delle scorte:

  1. Esecuzione iniziale: le tabelle elaborano l'intera cronologia delle transazioni di movimento per stabilire i livelli di scorte iniziali.
  2. Esecuzioni successive: Dataform elabora solo i movimenti registrati dall'ultima esecuzione dello snapshot, aggiungendoli ai totali cumulativi del periodo precedente.

Se esegui queste tabelle in modalità di aggiornamento completo (non incrementale), la cronologia completa dei movimenti viene ricalcolata da zero a ogni esecuzione. Questo approccio è molto inefficiente, costoso e può causare calcoli cumulativi errati se le tabelle di origine contengono lacune di date. Mantieni il tipo di materializzazione di queste tabelle impostato su incrementale (la configurazione predefinita).

Creare ed eseguire il deployment dei contenuti di compatibilità

Per creare ed eseguire il deployment dei contenuti di compatibilità, segui le istruzioni riportate nella documentazione relativa al deployment e al post-deployment.