성능 및 필터링 기법
서버 극한 최적화, 복제본 읽기 및 원본 필터링(Pushdown)을 위한 AL 고급 전략.
우리가 15분에서 30초로 로드 시간을 줄인 것은 단지 Query 개체를 사용했기 때문이 아니라, 코드 AL 기반으로 설계한 푸시다운 계산(서버 필터링)의 공격적인 기법을 적용했기 때문입니다.
아래에서는 추출 API에 구현한 세 가지 주요 최적화 지침을 자세히 설명합니다.
1. 트래픽 분산: DataAccessIntent = ReadOnly
Sección titulada «1. Desvío del Tráfico: DataAccessIntent = ReadOnly»트랜잭션 ERP 시스템에서 쓰기 데이터베이스 노드(Primary Node)는 매우 중요합니다. 대규모 추출 작업이 회계 또는 창고 삽입을 차단하는 일은 용납할 수 없습니다.
query 50100 "Movs_Productos_API"{ QueryType = API; // La directiva mágica: DataAccessIntent = ReadOnly; // ...}Azure SQL에서 어떤 작업을 수행하나요? ReadOnly를 선언함으로써 서버 오케스트레이터에게 우리의 API가 데이터를 삽입하거나 수정하지 않을 것이라고 말하고 있습니다. 서버는 자동으로 데이터베이스의 읽기 전용 복제본 중 하나로 리디렉션합니다. 이렇게 하면 보고서가 복제본의 CPU를 과부하 시켜도 생산 환경 사용자의 성능에 전혀 영향을 주지 않습니다.
2. 조기 필터링: DataItemTableFilter
Sección titulada «2. Filtrado Temprano: DataItemTableFilter»ELT의 목표는 불필요한 데이터가 네트워크 케이블을 통해 전송되지 않도록 하는 것입니다. 모든 데이터를 Power BI에 다운로드한 다음 필터링하는 대신, API에서 필터를 인코딩합니다.
elements { dataitem(itemLedgerEntry; "Item Ledger Entry") { // Filtro rígido a nivel de servidor SQL DataItemTableFilter = "Entry Type" = filter(Purchase | Sale | "Positive Adjmt." | "Negative Adjmt."), "Global Dimension 1 Code" = filter(<> '20');이점:
DataItemTableFilter는WHERE문장으로 직접 컴파일됩니다.SELECT.- 불필요한 입금 유형을 제외하고 특정 차원의 레코드를 밀리초 단위로 생략합니다.
- 페이로드(반환된 JSON의 크기)가 크게 줄어들어 HTTP 네트워크 포화로 인한 타임아웃이 제거됩니다.
3. FlowFields 처리: ColumnFilter
Sección titulada «3. El Manejo de FlowFields: ColumnFilter»이것은 우리 API에서 가장 복잡한 엔지니어링 포인트일 수 있습니다. 시스템 아키텍처에서 보았듯이, Business Central의 일부 필드는 공식(FlowFields)입니다.
일반 DataItemTableFilter 내부의 FlowField를 필터링하려 하면 AL 컴파일러가 오류를 발생시킬 것입니다. 왜냐하면 SQL Server는 아직 처리되지 않은 계산된 하위 쿼리에 대해 WHERE를 수행할 수 없기 때문입니다.
이러한 필드(예: 'PROVEEDOR_DEMO' 공급업체를 제외하는 것)를 필터링하려면, 프로젝션된 열 내부에서 특별히 ColumnFilter 속성을 사용해야 합니다.
// Campo de tabla normal column(Cantidad; Quantity) { }
// Filtrado Nivel Pro: Aplicado sobre un FlowField o campo especial column(Nombre_Proveedor; "Nombre proveedor") { ColumnFilter = Nombre_Proveedor = filter(<> 'PROVEEDOR_DEMO'); }이렇게 하면 서버가 먼저 테이블을 해결하고, 필요한 FlowFields를 계산하고, 열 사후 필터를 적용한 후, 마지막으로 깨끗하고 매우 컴팩트한 데이터 블록을 보냅니다.
4. 쿼리 최적화 체크리스트
Sección titulada «4. Checklist de Optimización de Consultas»- ✓ 제로 블록:
DataAccessIntent속성은 Azure SQL의 비활성 복제본으로 부하를 전달하도록ReadOnly로 설정되었습니다. - ✓ SQL 필터링:
DataItemTableFilter구현을 통해 HTTP 전송 전 전송할 행 수를 줄였습니다. - ✓ 플로우 필드 처리: 동적 컬럼에서
ColumnFilter사용으로 쿼리 엔진의 컴파일 오류를 방지했습니다.

