Ir al contenido

고급 M 코드(Power Query)

OData V4 API의 안정적인 활용을 위한 M 언어 기반 결정적 추출 스크립트 및 패턴.

0조회

Power BI의 의미 모델로 우리의 내부 API(ELT)에서 데이터 추출을 관리하기 위해 그래픽 인터페이스를 피하고 Power Query 코드(언어 M)를 고급 편집기에서 직접 작성합니다.

이를 통해 우리는 기본 HTTP 요청의 각 매개변수를 제어하는 결정적이고 제어 가능한 개발에 한 걸음 더 가까워집니다.

우리의 핵심 수신은 함수 OData.Feed를 사용합니다. 자동 생성된 것이 아닌, 우리는 비즈니스 센트럴에서 모든 추출을 위한 이 스니펫 기반을 표준화합니다:

let
// 1. Definición de la URL absoluta apuntando a nuestro Endpoint AL (EntitySetName)
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/movimientos",
// 2. Invocación de la API con inyección de protecciones de red
Origen = OData.Feed(UrlBase, null, [
Implementation="2.0",
Timeout=#duration(0, 0, 10, 0)
])
in
Origen
  • Implementation="2.0": Power Query가 최신 OData 엔진 버전을 사용하도록 강제합니다. JSON을 이진 수준에서 최적화하고 메타데이터를 분석합니다.
  • Timeout=#duration(Días, Horas, Minutos, Segundos): 우리의 시스템 락 방지 수단입니다. 비즈니스 센트럴의 AL API는 약 30초로 최적화되어 있지만, 10분(0, 0, 10, 0)의 엄격한 제한을 적용합니다. Microsoft ERP가 중대한 성능 저하를 겪는 경우 Power BI는 메모리에 무기한 처리 중인 프로세스를 유지하지 않고 로드를 중단합니다.

이는 비즈니스 인텔리전스 모델에 데이터를 공급하기 위해 우리의 주요 데이터 세트에 통합된 정확한 스크립트입니다.

let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/movimientos",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen
let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/lineasCompra",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen
let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/lineasVenta",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen

우리의 아키텍처가 Pushdown Computation (ELT)에 기반하고 있기 때문에, 우리의 스크립트 M의 기본 규칙은 로컬 계산 부하를 0으로 유지하는 것입니다.

  1. M에 WHERE 없음: 모든 행 제외(예: 특정 창고 또는 날짜 건너뛰기)는 비즈니스 센트럴의 SQL 엔진에서 DataItemTableFilter 속성을 통해 이미 실행되었습니다.
  2. M에서 열 삭제 없음: 엔드포인트에 엄격하게 프로젝션된 열만 HTTP를 통해 네트워크를 통과합니다. Power Query에서 90개를 삭제하기 위해 100개의 열을 가져오지 말아야 합니다.
  3. 지역에서 수행하는 유일한 것은 최종 데이터 타입 지정 (Type Casting)입니다. Table.TransformColumnTypes를 통해 DAX 모델이 변경할 수 없는 데이터를 받도록 보장합니다 (예: Int64.Type, type date, type number).
  • ✓ 구현 M: 모든 쿼리에서 Implementation="2.0" 매개변수를 명시적으로 사용하여 데이터 로드 속도를 향상시킵니다.
  • ✓ 지연 시간 제어: Power BI Service의 업데이트 대기열 안정성을 보호하기 위해 10분 간격으로 Timeout를 사전 주입합니다.
  • ✓ ELT 최적화: Power Query 수준에서 로컬 필터를 적용하지 않고 SQL 백엔드에서 데이터 처리 로직을 모두 유지합니다.