Cortex Framework v6 호환성

v6 호환성 콘텐츠는 Cortex Framework v7 아키텍처 내에서 Cortex Framework v6 워크로드에 스키마 호환 레이어를 제공합니다. 이를 통해 Looker 대시보드 또는 LookML 시맨틱 모델과 같은 기존 분석 애셋을 손상시키지 않고도 Cortex Framework v7로 마이그레이션할 수 있습니다.

지원되는 데이터 소스

프레임워크는 SAP ECC 및 SAP S/4HANA 데이터 소스에 v6 호환성 콘텐츠를 제공합니다.

작동 방식

v6 호환성 콘텐츠는 v7 데이터 모델과 기존 보고 애셋 간의 어댑터 역할을 합니다.

  • 스키마 호환 뷰: Cortex Framework (v6)에 표시된 대로 보고서 보기 이름, 열, 대소문자를 정확하게 노출합니다.
  • 대상 격리: 별도의 네임스페이스 (cortex_v6_compatibility) 및 전용 BigQuery 대상 데이터 세트 내에 호환성 뷰를 배포하여 핵심 Cortex Framework 테이블에서 호환성 뷰를 격리합니다.

호환성 콘텐츠 배포

Cortex Framework v6 호환성 콘텐츠를 배포하려면 다음 단계를 완료하세요.

  • 전용 BigQuery 대상 데이터 세트를 구성합니다.
  • config.yaml 파일에서 v6 호환성 모듈을 사용 설정합니다.
  • Google Cloud Cortex Framework 빌드 및 배포 스크립트를 실행합니다.
  • Dataform 파이프라인을 실행합니다.

전용 대상 데이터 세트

v6 호환성 콘텐츠를 별도의 BigQuery 데이터 세트에 배포해야 합니다. 호환성 콘텐츠에서 사용하는 많은 테이블이 Cortex Framework v7 핵심 테이블과 동일한 실제 이름 (예: cost_centers, profit_centers, billing, deliveries)을 공유하므로 네임스페이스 섀도잉 및 실제 테이블 충돌을 방지합니다.

전용 BigQuery 데이터 세트를 만들려면 config.yaml 파일에 cortex_v6_compatibility_target를 추가합니다.

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

Cortex Framework 구성

config.yaml 파일에서 호환성 레이어를 등록하고 활성화하려면 다음 작업을 완료해야 합니다.

  • 전용 대상 데이터 세트를 설정합니다.
  • 호환성 네임스페이스를 등록합니다.

  • 다음 모든 Cortex Framework v6 호환성 모듈에 대해 사용 설정된 속성을 true로 설정합니다.

  • 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

다음 예에서는 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`

운영 요구사항

모든 Cortex Framework v6 호환성 모듈을 동시에 사용 설정하는 것이 좋습니다. 호환성 콘텐츠에는 교차 모듈 종속 항목이 포함되어 있습니다 (예: 결제 뷰는 마스터 데이터 테이블에 종속되고 인벤토리 스냅샷 뷰는 캘린더 측정기준에 종속됨). 이러한 종속 항목을 함께 사용 설정하면 Dataform에서 종속 항목 오류를 방지할 수 있습니다.

인벤토리 스냅샷

인벤토리 스냅샷 테이블 (stock_weekly_snapshots 및 stock_monthly_snapshots)을 증분 테이블로 구성하고 실행해야 합니다. Cortex Framework v6에서 인벤토리 스냅샷은 재고 수량 및 값의 누계를 계산합니다.

  1. 초기 실행: 테이블은 이동 트랜잭션의 전체 기록을 처리하여 시작 재고 수준을 설정합니다.
  2. 후속 실행: Dataform은 마지막 스냅샷 실행 이후 게시된 이동만 처리하여 이전 기간의 누계에 추가합니다.

전체 새로고침 (비증분) 모드에서 이러한 테이블을 실행하면 실행할 때마다 전체 이동 기록을 처음부터 다시 계산합니다. 이 방법은 매우 비효율적이고 비용이 많이 들며 소스 테이블에 날짜 간격이 포함된 경우 누계 계산이 잘못될 수 있습니다. 이러한 테이블의 구체화 유형을 증분 (기본 구성)으로 설정합니다.

호환성 콘텐츠 빌드 및 배포

호환성 콘텐츠를 빌드하고 배포하려면 배포 및 배포 후 문서의 안내를 따르세요.