Rozwiązywanie problemów z API i danymi
Protokoły odpowiedzi na masowe błędy ekstrakcji, opóźnienia sieci OData i ograniczenia architektoniczne w Business Central.
W naszej pracy DevSecOps, zapewniając integralność kanałów danych (Data Pipelines), integracja między Business Central a platformami Business Intelligence może prezentować wąskie gardła i ograniczenia sieci.
Ten dokument szczegółowo opisuje przyczyny źródłowe najpoważniejszych błędów i ich ostateczne rozwiązania oparte na zaimplementowanej architekturze.
Incydent 1: „Host zdalny wymusił przerwanie” (Timeout OData)
Sección titulada «Incidente 1: “Host remoto forzó la interrupción” (Timeout OData)»Podczas próby aktualizacji zbioru danych historycznych (np. ponad 200 000 wierszy) z Power Query, Power BI Desktop lub za pomocą skryptu Python, połączenie jest ładowane przez kilka minut, a następnie nagle przerywane i zwraca błąd: La conexión subyacente se cerró: El host remoto forzó la interrupción de la conexión. (Limit czasu OData)
Diagnoza pierwotna
Sección titulada «Diagnóstico Raíz»To jest błąd spowodowany wyczerpaniem zasobów NST (Navision Server Tier). Występuje, gdy docelowy punkt końcowy nie jest zoptymalizowanym interfejsem API (zapytanie), lecz standardową stroną opublikowaną jako usługa internetowa (np. strona 38). Podczas żądania tysięcy wierszy strona internetowa Business Central próbuje renderować komponenty wizualne, wykonywać wyzwalacze i obliczać złożone podzapytania (FlowFields) w pamięci RAM dla każdego wiersza. Gdy przetwarzanie przekracza limity czasowe (zwykle 10 lub 15 minut), balansator Azure odcina połączenie HTTP z powodu bezpieczeństwa, aby zapobiec awarii systemu ERP.
Rozwiązanie DevSecOps (wdrążone)
Sección titulada «Solución DevSecOps (Implementada)»- Oporzucenie usług internetowych opartych na stronach: Usunięcie z architektury jakiegokolwiek spożycia dużych ilości danych za pośrednictwem usług internetowych typu strona.
- Opracowanie natywnych interfejsów API (zapytania): Przeniesienie żądania do obiektu
queryAL. Dzięki temu wykonanie pomija warstwę interfejsu i staje się czystą instrukcją SQL, redukując czas odpowiedzi z 15 minut do mniej niż 30 sekund. - Paginacja (skrypty zewnętrzne): Jeśli używamy języka takiego jak Python do ETL, musimy upewnić się, że szanujemy i programujemy śledzenie tokenu
@odata.nextLinkzwracanego przez serwer, ponieważ Business Central nakłada maksymalny limit wierszy na stronę JSON zwracaną.
Incydent 2: Niemożność utworzenia podfolderów w ścieżkach API
Sección titulada «Incidente 2: Imposibilidad de Crear Subcarpetas en Rutas API»Objaw (nomenklatura i trasowanie)
Sección titulada «Síntoma (Nomenclatura y Enrutamiento)»Podczas tworzenia nowego interfejsu API w AL, podczas próby utworzenia hierarchii logicznej departamentów, wprowadzając ukośnik (/) w właściwościach interfejsu API, kompilator Visual Studio Code generuje błąd krytyczny i blokuje generowanie pliku .app.
Przykład wadliwego kodu:
// ERROR FATAL DE COMPILACIÓN: Microsoft prohíbe las barras en metadatos de enrutamientoAPIGroup = 'portelcore/departamentos/finanzas';Diagnoza pierwotna
Sección titulada «Diagnóstico Raíz»Silnik generowania OData V4 Microsoft Business Central ma ścisłe, zakodowane fabrycznie (hardcoded) strukturalne ścieżki.
Serwer oczekuje zawsze i tylko na niezmienny model 3-poziomowy:
{APIPublisher} / {APIGroup} / {APIVersion}
Nie ma możliwości technicznej ani uprawnień na poziomie kontenera do zmiany orkiestratora HTTP i dodawania segmentów lub dodatkowych „podfolderów” w adresach URL niestandardowych API.
Rozwiązanie / obejście architektoniczne
Sección titulada «Solución / Workaround Arquitectónico»Przyjęcie ścisłych konwencji nazewniczych (konwencje nazewnicze).
Ponieważ nie możemy tworzyć oddzielnych fizycznych ścieżek rozdzielonych przez /, symulujemy hierarchię za pomocą podkreśleń (Snake_case) wewnątrz APIGroup lub APIPublisher.
-
Wdrożenie poprawne (Grupa Logiczna):
APIPublisher = 'portelcore';APIGroup = 'api_portelcore_finanzas_1';APIVersion = 'v1.0';Wynik OData:
.../api/portelcore/api_portelcore_finanzas_1/v1.0/ -
Wdrożenie alternatywne (Wydawca Logiczny):
APIPublisher = 'portelcore_finanzas';APIGroup = 'analitica';APIVersion = 'v1.0';Wynik OData:
.../api/portelcore_finanzas/analitica/v1.0/
3. Lista kontrolna diagnostyki API i danych
Sección titulada «3. Checklist de Diagnóstico de API y Datos»- ✓ Wydajność: Całkowita zamiana usług typu strona na obiekty
Query APIw celu uniknięcia limitów czasowych z powodu przepełnienia pamięci RAM w NST. - ✓ Format trasowania: Ścisłe przestrzeganie schematu 3-poziomowego wymaganego przez kompilator AL, z użyciem Snake_Case dla hierarchii logicznych.
- ✓ Synchronizacja: Wstępne czyszczenie lokalnych pamięci podręcznych klienta w celu wymuszenia ponownego odkrycia schematów po ponownej konfiguracji.

