Kompatibilitas Cortex Framework v6

Konten kompatibilitas v6 menyediakan lapisan yang kompatibel dengan skema untuk workload Cortex Framework v6 dalam arsitektur Cortex Framework v7. Hal ini memungkinkan Anda bermigrasi ke Cortex Framework v7 tanpa merusak aset analisis yang ada, seperti dasbor Looker atau model semantik LookML.

Sumber data yang didukung

Framework ini menyediakan konten kompatibilitas v6 untuk sumber data SAP ECC dan SAP S/4HANA.

Cara kerjanya

Konten kompatibilitas v6 bertindak sebagai adaptor antara model data v7 dan aset pelaporan lama Anda:

• Tampilan yang kompatibel dengan skema: Menampilkan nama tampilan pelaporan, kolom, dan huruf besar/kecil persis seperti yang muncul di Cortex Framework (v6).
• Isolasi target: Mengisolasi tampilan kompatibilitas dari tabel inti Cortex Framework dengan men-deploy-nya dalam namespace terpisah (cortex_v6_compatibility) dan set data target BigQuery khusus.

Men-deploy konten kompatibilitas

Untuk men-deploy konten kompatibilitas Cortex Framework v6, selesaikan langkah-langkah berikut:

• Mengonfigurasi set data target BigQuery khusus.
• Mengaktifkan modul kompatibilitas v6 dalam file config.yaml.
• Menjalankan skrip build dan deployment Google Cloud Cortex Framework.
• Menjalankan pipeline Dataform.

Set data target khusus

Anda harus men-deploy konten kompatibilitas v6 ke set data BigQuery terpisah. Hal ini mencegah bayangan namespace dan tabrakan tabel fisik, karena banyak tabel yang digunakan oleh konten kompatibilitas memiliki nama fisik yang sama (seperti cost_centers, profit_centers, billing, dan deliveries) dengan tabel inti Cortex Framework v7.

Untuk membuat set data BigQuery khusus, tambahkan cortex_v6_compatibility_target ke 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

Mengonfigurasi Cortex Framework

Untuk mendaftarkan dan mengaktifkan lapisan kompatibilitas dalam file config.yaml, Anda harus menyelesaikan tugas berikut:

• Menyiapkan set data target khusus.
• Mendaftarkan namespace kompatibilitas.

• Menetapkan atribut yang diaktifkan ke true untuk semua modul kompatibilitas Cortex Framework v6 berikut:

• 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

Contoh berikut menunjukkan perubahan konfigurasi yang diperlukan untuk mengaktifkan 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`

Persyaratan operasional

Sebaiknya aktifkan semua modul kompatibilitas Cortex Framework v6 secara bersamaan. Konten kompatibilitas berisi dependensi lintas modul (misalnya, tampilan penagihan bergantung pada tabel data master, dan tampilan snapshot inventaris bergantung pada dimensi kalender). Mengaktifkannya bersama-sama akan mencegah error dependensi di Dataform.

Snapshot inventaris

Anda harus mengonfigurasi dan menjalankan tabel snapshot inventaris (stock_weekly_snapshots dan stock_monthly_snapshots) sebagai tabel inkremental. Di Cortex Framework v6, snapshot inventaris menghitung total kumulatif berjalan dari kuantitas dan nilai stok:

1. Run Awal: Tabel memproses seluruh histori transaksi pergerakan untuk menetapkan tingkat stok awal.
2. Run Berikutnya: Dataform hanya memproses pergerakan yang diposting sejak eksekusi snapshot terakhir, dan menambahkannya ke total kumulatif periode sebelumnya.

Jika Anda menjalankan tabel ini dalam mode refresh penuh (non-inkremental), tabel akan menghitung ulang seluruh histori pergerakan dari awal pada setiap run. Pendekatan ini sangat tidak efisien, mahal, dan dapat menyebabkan perhitungan kumulatif yang salah jika tabel sumber berisi celah tanggal. Tetapkan jenis materialisasi untuk tabel ini ke inkremental (konfigurasi default).

Membuat dan men-deploy konten kompatibilitas

Untuk membuat dan men-deploy konten kompatibilitas, ikuti petunjuk dalam dokumentasi Deployment dan Pasca-deployment.