API 및 데이터 문제 해결
대량 추출 오류, OData 네트워크 지연 및 Business Central의 아키텍처 제약 상황에 대응하는 프로토콜.
데이터 파이프라인의 무결성을 보장하는 DevSecOps 업무에서 Business Central과 비즈니스 인텔리전스 플랫폼 간의 통합은 병목 현상과 네트워크 장애를 일으킬 수 있습니다.
본 문서는 발견된 가장 심각한 오류의 근본 원인과 구현된 아키텍처 기반의 확정적 솔루션을 상세히 설명합니다.
사건 1: “원격 호스트가 연결을 강제로 끊음” (OData 타임아웃)
Sección titulada «Incidente 1: “Host remoto forzó la interrupción” (Timeout OData)»Power Query, Power BI Desktop 또는 Python 스크립트를 통해 200,000개 이상의 행을 가진 이력 데이터 집합을 업데이트하려고 시도할 때, 연결이 수분간 로드된 후 갑자기 중단되어 La conexión subyacente se cerró: El host remoto forzó la interrupción de la conexión. (OData 타임아웃) 오류가 반환됩니다.
이 오류는 NST(Navision Server Tier)의 리소스 고갈로 인해 발생합니다. 대상 엔드포인트가 최적화된 API(Query)가 아닌 웹 서비스로 게시된 표준 페이지(예: 페이지 38)일 때 발생합니다. 웹 페이지에서 수천 개의 행을 요청하면 Business Central 서버는 각 행에 대해 시각적 구성 요소를 렌더링하고 트리거를 실행하며 복잡한 하위 쿼리(FlowFields)를 RAM에서 계산하려고 합니다. 처리 시간이 일반적인 제한 시간(보통 10분 또는 15분)을 초과하면 Azure 부하 분산 장치가 ERP 다운을 방지하기 위해 보안상 HTTP 연결을 차단합니다.
DevSecOps 솔루션 (구현됨)
Sección titulada «Solución DevSecOps (Implementada)»- 페이지 기반 웹 서비스 포기: 아키텍처에서 페이지 유형 웹 서비스를 통한 대량 데이터 소비를 제거하십시오.
- 네이티브(쿼리) API 개발: 요청을 AL의
query개체로 이전하십시오. 이렇게 하면 인터페이스 계층을 건너뛰고 순수한 SQL 문으로 실행되어 응답 시간을 15분에서 30초 미만으로 줄입니다. - 페이지 나누기(외부 스크립트): ETL에 Python과 같은 언어를 사용하는 경우, 서버가 반환하는 토큰
@odata.nextLink을 존중하고 추적하는 프로그램을 작성해야 합니다. 왜냐하면 Business Central은 반환되는 JSON 페이지당 최대 행 수를 제한하기 때문입니다.
사건 2: API 경로에 하위 폴더를 생성할 수 없음
Sección titulada «Incidente 2: Imposibilidad de Crear Subcarpetas en Rutas API»증상 (명명법 및 라우팅)
Sección titulada «Síntoma (Nomenclatura y Enrutamiento)»AL에서 새 API 개발 중, 부서의 논리적 계층 구축을 시도하면서 슬래시 문자를 API 속성에 입력하면 Visual Studio Code 컴파일러가 치명적인 오류를 발생시키고 파일 생성을 중단합니다.
결함 있는 코드 예시:
// ERROR FATAL DE COMPILACIÓN: Microsoft prohíbe las barras en metadatos de enrutamientoAPIGroup = 'portelcore/departamentos/finanzas';Microsoft Business Central의 OData V4 생성기는 공장에서 엄격하게 하드코딩된 구조적 경로를 가지고 있습니다.
서버는 항상 그리고 오직 불변의 3계층 모델만을 기대합니다:
{APIPublisher} / {APIGroup} / {APIVersion}
커스텀 API URL에 추가 세그먼트나 “하위 폴더”를 추가하기 위해 HTTP 오케스트레이터를 변경할 수 있는 기술적 기능이나 컨테이너 수준 권한은 존재하지 않습니다.
솔루션 / 아키텍처 우회 방안
Sección titulada «Solución / Workaround Arquitectónico»엄격한 명명 규칙을 채택하십시오 (Naming Conventions).
/로 물리적 경로를 생성할 수 없으므로, APIGroup 또는 APIPublisher 내부에서 언더스코어(스네이크 케이스)를 사용하여 계층 구조를 시뮬레이션합니다.
-
올바른 구현 (논리 그룹):
APIPublisher = 'portelcore';APIGroup = 'api_portelcore_finanzas_1';APIVersion = 'v1.0';OData 결과:
.../api/portelcore/api_portelcore_finanzas_1/v1.0/ -
대체 구현 (논리적 출판자):
APIPublisher = 'portelcore_finanzas';APIGroup = 'analitica';APIVersion = 'v1.0';OData 결과:
.../api/portelcore_finanzas/analitica/v1.0/
3. API 및 데이터 진단 체크리스트
Sección titulada «3. Checklist de Diagnóstico de API y Datos»- ✓ 성능: NST에서 RAM 오버플로우로 인한 타임아웃을 방지하기 위해 페이지 유형 서비스를 개체로 완전히 대체합니다
Query API - ✓ 경로 형식: AL 컴파일러가 요구하는 3단계 스키마를 엄격히 준수하며, 논리적 계층 구조에 Snake_Case를 사용합니다.
- ✓ 동기화: 재구성 후 스키마 재발견을 강제하기 위해 클라이언트 로컬 캐시를 사전에 정리합니다.

