Cum să accelerezi macrocomenzile LibreOffice Calc cu seturi de date mari

Macrocomenzile LibreOffice Calc devin adesea lente pe foile de calcul mari dintr-un motiv simplu: macrocomanda petrece mai mult timp traversând limita obiectului UNO decât efectuând calculul propriu-zis. Citirea unei celule, modificarea ei și scrierea ei de mii de ori poate fi mult mai costisitoare decât mutarea acelorași date în blocuri mai mari.

Scopul nu este de a face fiecare macrocomandă „rapidă” în abstract. O optimizare utilă ar trebui să producă același rezultat, să se termine în mai puțin timp pe același set de date, să mențină Calc suficient de receptiv pentru fluxul de lucru și să evite crearea de noi probleme de corectitudine sau memorie. Tehnicile de mai jos se concentrează pe acele rezultate măsurabile.

Începând cu octombrie 2026, documentația actuală a SDK-ului LibreOffice identifică interfețele pentru foi de calcul utilizate aici, în referința API LibreOffice 26.8. Metodele principale sunt interfețe UNO de lungă durată, mai degrabă decât o funcție de performanță nou introdusă.

1. Măsurați macrocomanda înainte de a o modifica

Începeți cu o linie de bază repetabilă. LibreOffice Basic oferă GetSystemTicks(), pe care Ajutorul oficial îl descrie ca o modalitate de a măsura ciclurile de funcționare ale sistemului și de a optimiza procesele. Încadrați partea macrocomenzii în partea pe care doriți cu adevărat să o îmbunătățiți, în loc să cronometrați deschiderea registrului de lucru, solicitările utilizatorului sau configurarea fără legătură.

Dim t0 As Long, elapsed As Long

t0 = GetSystemTicks()

' Run the work you want to measure here.

elapsed = GetSystemTicks() - t0
MsgBox "Elapsed ticks: " & elapsed

Executați aceeași operațiune de mai multe ori pe aceeași copie a fișierului. Prima executare poate diferi din cauza memoriei cache a sistemului de fișiere, a stării formulei sau a altor lucrări unice. Înregistrați dimensiunea setului de date, intervalul procesat și dacă a fost activat calculul automat, astfel încât comparațiile să rămână semnificative.

Un rezultat bun nu este doar un număr de timp mai mic. Confirmați că numărul de rânduri, totalurile, formulele, valorile text, datele și orice intervale de ieșire corespund în continuare cu valoarea de referință.

Referință oficială: Ajutor LibreOffice: Funcția GetSystemTicks .

2. Eliminați mai întâi citirile și scrierile celulă cu celulă

Dacă o macrocomandă parcurge un interval mare și apelează în mod repetat metode precum getCellByPosition(), acel model este de obicei primul loc în care trebuie căutat. API-ul UNO expune XCellRangeData.getDataArray()și setDataArray()în mod specific pentru mutarea unui interval complet de celule ca matrice.

API-ul oficial precizează că getDataArray()returnează o secvență de rânduri, fiecare rând conținând coloane. Valorile sunt returnate ca șiruri de caractere sau duble. setDataArray()scrie un tablou înapoi într-un interval, iar dimensiunile tabloului trebuie să corespundă acelui interval.

De exemplu, să presupunem că coloanele de la A la E conțin intrarea pe care o transformă macrocomanda. În loc să citiți fiecare celulă individual, selectați intervalul exact o singură dată:

Dim doc As Object
Dim sheet As Object
Dim sourceRange As Object
Dim data As Variant

doc = ThisComponent
sheet = doc.Sheets.getByName("Data")

' Example only: A2:E50001.
sourceRange = sheet.getCellRangeByPosition(0, 1, 4, 50000)
data = sourceRange.getDataArray()

Procesează dataîn memoria Basic, apoi scrie o matrice de rezultate într-un interval de destinație corespunzător într-o singură operație. Aceasta reduce dramatic numărul de apeluri UNO în comparație cu miile de citiri și scrieri individuale.

Referințe oficiale: LibreOffice SDK: XCellRangeData și LibreOffice SDK: XCellRange .

3. Procesați doar intervalul de care aveți nevoie

Accesul în bloc la matrice este util, dar transformarea unei foi de calcul inutil de mari într-o matrice poate pur și simplu muta blocajul în memorie. Evitați codificarea fixă ​​a coloanelor întregi sau a întregii grile Calc atunci când sarcina atinge doar un tabel definit.

Determinați ultimul rând semnificativ folosind informațiile pe care registrul de lucru le cunoaște deja: un număr de rânduri de import, o dimensiune a rezultatului bazei de date, o coloană cheie desemnată sau un interval creat de aplicație. Apoi, solicitați doar rândurile și coloanele necesare macrocomenzii.

Acest lucru este important mai ales atunci când foaia de lucru conține o formatare mult sub datele reale sau când conținutul vechi a extins zona aparent utilizată. Matricele mari în memorie consumă RAM, iar o alocare supradimensionată poate fi mai rea decât procesarea blocurilor moderate.

Când să treceți la segmentare

Dacă o singură matrice face ca utilizarea memoriei să crească brusc, provoacă pauze lungi înainte de începerea procesării sau se apropie de limitele practice ale mașinii, procesați datele în blocuri. De exemplu, gestionați câteva mii de rânduri, scrieți rezultatele, apoi continuați cu următorul bloc. Nu există o dimensiune ideală universală a blocului; testați cu registrul de lucru și hardware-ul real.

4. Suspendați notificările de actualizare a ecranului în timpul muncii intense

XModelUn document Calc implementează interfața LibreOffice . lockControllers()Metoda sa suspendă unele notificări ale controlerului folosite pentru actualizările afișajului, în timp ce unlockControllers()le reia. Acest lucru poate reduce munca vizuală inutilă în timp ce o macrocomandă efectuează multe modificări.

Dim doc As Object
doc = ThisComponent

doc.lockControllers()

' Perform bulk changes here.

doc.unlockControllers()

API-ul oficial spune explicit că blocările și deblocările controlerelor trebuie să fie asociate. Aceasta înseamnă că macrocomenzile de producție ar trebui să includă gestionarea erorilor care garantează unlockControllers()că se atinge chiar dacă procesarea eșuează. Lăsarea documentului blocat nu reprezintă o optimizare a performanței; este o cale de curățare defectă.

Referință oficială: LibreOffice SDK: XModel .

5. Controlează recalcularea automată atunci când formulele domină timpul de execuție

Dacă macrocomanda modifică în mod repetat celulele care alimentează multe formule, Calc poate petrece mult timp recalculând în timp ce macrocomanda încă actualizează valorile intermediare. Documentul foii de calcul expune interfața XCalculatable, inclusiv isAutomaticCalculationEnabled(), enableAutomaticCalculation(), calculate()și calculateAll().

Un model mai sigur este să rețineți modul de calcul curent al utilizatorului, să dezactivați calculul automat doar în timpul actualizării și să restaurați starea inițială ulterior:

Dim doc As Object
Dim wasAutoCalc As Boolean

doc = ThisComponent
wasAutoCalc = doc.isAutomaticCalculationEnabled()

doc.enableAutomaticCalculation(False)

' Perform bulk updates.

doc.enableAutomaticCalculation(wasAutoCalc)

If wasAutoCalc Then
    doc.calculate()
End If

calculate()recalculează celulele murdare. calculateAll()recalculează fiecare celulă, ceea ce poate fi costisitor în sine, așa că nu apelați automat funcția doar pentru că o macrocomandă s-a terminat. Folosiți recalcularea completă numai atunci când logica registrului de lucru o impune.

Ca și în cazul blocării controlerului, restaurați starea de calcul într-o cale de curățare a erorilor. O macrocomandă nu ar trebui să părăsească în mod silențios registrul de lucru al unui utilizator în modul de calcul manual.

Referință oficială: LibreOffice SDK: XCalculatable .

6. Combinați optimizările în siguranță

Cea mai eficientă structură este de obicei: determinarea unui interval precis, citirea lui o singură dată, procesarea valorilor în memorie, scrierea rezultatelor în bloc și suprimarea interfeței utilizator sau a lucrărilor de recalculare evitabile doar pe durata operației respective.

Un model practic de curățare în LibreOffice Basic arată astfel:

Sub ProcessLargeData
    Dim doc As Object
    Dim sheet As Object
    Dim dataRange As Object
    Dim data As Variant
    Dim wasAutoCalc As Boolean

    On Error GoTo CleanUp

    doc = ThisComponent
    sheet = doc.Sheets.getByName("Data")
    dataRange = sheet.getCellRangeByPosition(0, 1, 4, 50000)

    wasAutoCalc = doc.isAutomaticCalculationEnabled()

    doc.lockControllers()
    doc.enableAutomaticCalculation(False)

    data = dataRange.getDataArray()

    ' Transform data in memory here.
    ' Build an output array with dimensions matching its target range.

CleanUp:
    doc.enableAutomaticCalculation(wasAutoCalc)

    If doc.hasControllersLocked() Then
        doc.unlockControllers()
    End If

    If wasAutoCalc Then
        doc.calculate()
    End If
End Sub

Exemplul lasă intenționat nespecificată logica de transformare, deoarece acea parte depinde de registrul de lucru. Optimizarea importantă este forma fluxului de lucru, nu un calcul de afaceri inventat.

7. Luați în considerare funcțiile încorporate ale Calc înainte de a le reimplementa

LibreOffice Basic poate apela funcții Calc prin intermediul com.sun.star.sheet.FunctionAccessserviciului. Dacă macrocomanda implementează manual o căutare, o agregare sau o altă operațiune pe care Calc o oferă deja, utilizarea funcției încorporate poate simplifica codul și poate reduce buclarea personalizată.

Aceasta nu garantează că fiecare funcție încorporată va depăși performanța fiecărui algoritm personalizat. Faceți o comparație cu volumul de lucru real. Ajutorul oficial arată cum se apelează funcțiile Calc din Basic și menționează că numele funcțiilor sunt furnizate în limba engleză.

Referință oficială: Ajutor LibreOffice: Utilizarea funcțiilor Calc în macrocomenzi .

Cum să evaluezi dacă optimizarea este suficient de bună

Greșeli frecvente care anulează beneficiul

• Citirea unei foi de calcul întregi în memorie atunci când sunt necesare doar câteva coloane.
• Folosind, getDataArray()dar scriind în continuare fiecare rezultat celulă cu celulă.
• Dezactivarea calculului automat și uitarea restaurării setărilor anterioare.
• Blocarea controlerelor fără o cale de curățare fiabilă.
• Apelare calculateAll()după fiecare lot mic, chiar și atunci când doar celulele murdare necesită recalculare.
• Evaluarea vitezei dintr-o singură rulare în loc de măsurători repetate pe aceleași date.
• Optimizarea performanței fără a verifica dacă rezultatul rămâne identic.

Unde aceste tehnici nu mai ajută

Transferurile de matrice reduc în principal costul de acces la obiectele foii de calcul. Nu vor remedia un algoritm intrinsec costisitor. O comparație imbricată a fiecărui rând cu fiecare rând, de exemplu, poate rămâne lentă chiar și atunci când toate valorile sunt în memorie. În acest caz, schimbați algoritmul: utilizați dicționare sau indexuri, sortați o singură dată în loc de repetat, reduceți munca duplicată sau mutați volumul de lucru către un instrument de procesare a datelor mai potrivit atunci când foaia de calcul nu mai este mediul de execuție potrivit.

Același lucru este valabil și pentru macrocomenzile dominate de apeluri de rețea, interogări de baze de date, I/O de fișiere sau servicii externe. Măsurați mai întâi pentru a optimiza blocajul real, mai degrabă decât bucla vizibilă a foii de calcul.

Ordinea de optimizare recomandată

1. Măsoară macrocomanda curentă cu un set de date repetabil.
2. Înlocuiți citirile și scrierile repetate ale celulelor cu matrice de intervale.
3. Restricționați procesarea la rândurile și coloanele exacte necesare.
4. Folosește segmentarea dacă matricea în bloc este prea mare pentru o utilizare confortabilă a memoriei.
5. Blocați controlerele în timpul loturilor mari, cu curățare garantată.
6. Suspendați temporar calculul automat atunci când recalcularea repetată a formulei reprezintă un blocaj demonstrat.
7. Recalculați doar atât cât este necesar, restaurați starea aplicației și verificați ieșirea.
8. Reevaluează. Dacă timpul de execuție este încă dominat de calcul și nu de accesul UNO, îmbunătățește algoritmul în schimb.

Pentru seturi de date Calc mari, reducerea numărului de apeluri între obiectele Basic și cele din foile de calcul este de obicei cea mai importantă îmbunătățire structurală. Tratați fiecare optimizare suplimentară ca pe ceva de măsurat, nu ca pe un ritual. O macrocomandă mai rapidă este utilă numai atunci când rămâne corectă, previzibilă și ușor de întreținut.