データの読み書きをバッチ処理で行うことで、Calcマクロの処理速度を向上させる

Calc マクロの速度を最も確実に向上させる最初の方法は、セルごとの読み書きを繰り返す処理を、範囲の読み取り、メモリ内ループ、範囲の書き込みをそれぞれ 1 回ずつ行う処理に置き換えることです。これにより Basic と Calc 間の呼び出しが削減されますが、数式、書式設定、ファイルサイズ、マクロロジックなども実行時間に影響を与える可能性があるため、必ずしも一定の速度向上を保証するものではありません。以下の例ではステータス列を変更し、速度と正確性の両方を測定する方法を示しています。API の詳細は、2026 年 10 月 9 日に LibreOffice 26.8 のドキュメントに基づいて確認済みです。

改善すべき点は何ですか？また、それをどのように測定しますか？

現在のマクロをワークブックのコピーで実行し、経過時間を記録してください。古いマクロと改訂版マクロの両方で、同じ開始データを持つ新しいコピーを使用するか、実行の間に入力データを復元してください。そうしないと、2回目の実行で処理が不十分になる可能性があります。行数、計算設定、出力条件は同じに保ってください。各実行を繰り返し、異常に速い実行結果に頼るのではなく、通常の実行時間を比較してください。結果が想定されるルールと一致することを確認してください。完了時間が短くても、間違った行を変更するマクロは改善とは言えません。

LibreOffice Basic のTimer関数は、午前0時からの秒数を返します。この関数をLong変数に代入して、数値の秒数を取得します。短い実行の場合は、開始値と終了値を記録し、それらを減算します。終了値が低い場合は、実行が午前0時を過ぎたことを意味するため、差に 86,400 秒を加算します。タイマーは整数秒を返します。ミリ秒単位の精度が必要な場合は、タイマーサービスを使用してください。LibreOffice Basic のタイマーに関するドキュメントとScriptForge のタイマーサービスに関するドキュメントScriptForgeを参照してください。ワークブックのオープン、保存、手動による確認は、実際のタスクの一部でない限り、測定間隔外に行ってください。

ID、地域、ステータス列と選択されたデータ範囲を含む計算ワークシート — タイミング実行のたびに、同じ連続したデータ範囲とワークブックの条件から始めてください。

大きなCalcマクロはなぜ動作が遅くなるのでしょうか？

個々のセルプロパティを繰り返し呼び出したり、読み書きしたりするループでは、getCellByPosition()各操作ごとにCalcに対してBasic-to-Calcインターフェースを介した呼び出しが行われます。行と列が多い場合、変換自体が単純な場合でも、これらの呼び出し回数は累積します。メモリ内の配列をループ処理する場合も各行は処理されますが、値ごとに個別のセルAPI呼び出しを行う必要がなくなります。

まず、結果に影響を与えない操作を削除してください。ループ内でセルを選択またはアクティブ化することは避け、最終的な範囲操作が1回で済む場合はセルの再計算や書式設定を繰り返し行わないでください。また、境界付きデータブロックのみが必要な場合は、列全体を処理しないでください。これらの変更により、コントロールを追加する前に実際のボトルネックを特定できます。

範囲を配列として処理するにはどうすればよいですか？

マクロが変更する値のみを含む矩形範囲を使用します。サンプルでは、という名前のシートData、1行目のヘッダー行、列Cのステータス値を想定しています。シート名と範囲をワークブックに合わせて変更してください。APIは、getDataArray()値を含む行として範囲を返し、setDataArray()同じサイズの配列をその範囲に書き込みます。

LibreOffice Basicエディタで、選択したCalc範囲をgetDataArrayを使用してaDataに読み込む — メモリ内ループの前に、必要な矩形範囲を一度読み込む。

Sub UpdateStatuses
    Dim oSheet As Object
    Dim oRange As Object
    Dim aData As Variant
    Dim i As Long

    oSheet = ThisComponent.Sheets.getByName("Data")
    oRange = oSheet.getCellRangeByName("A2:C10001")
    aData = oRange.getDataArray()

    For i = LBound(aData) To UBound(aData)
        If aData(i)(2) = "pending" Then
            aData(i)(2) = "review"
        End If
    Next i

    oRange.setDataArray(aData)
End Sub

行配列はゼロベースです。aData(i)(2)各行の3番目の列を指定します。ここでは、選択範囲がAから始まるため、列Cになります。配列の外側のシーケンスは行を表し、内側のシーケンスは列を表します。渡される範囲はsetDataArray()配列と同じ次元である必要があります。一致しない場合はエラーが発生します。LibreOffice XCellRangeData APIリファレンスおよびLibreOffice ScriptForge配列ドキュメントを参照してください。

LibreOffice Basic マクロで、メモリ内の配列内の保留中の値をレビュー対象に変更し、配列を書き戻す — メモリ上でルールを適用し、完成した配列を1回の呼び出しでCalcに書き込む。

値のみの更新には数式セルを含めない

getDataArray()は、セルの値を数値または文字列として返し、元の数式テキストは返しません。数式を含む範囲を読み込み、その配列をで書き戻すとsetDataArray()、数式が現在の結果に置き換えられる可能性があります。値配列メソッドは、値を含む入力/出力セルに限定してください。マクロで数式を保持または変更する必要がある場合は、数式配列メソッドとを使用するgetFormulaArray()かsetFormulaArray()、数式のない範囲のみを操作してください。XCellRangeFormula API リファレンスには、この分離インターフェイスが説明されています。

計算設定や表示設定は、いつ変更すべきでしょうか？

配列のバージョンを測定した後でのみ、これらのオプションをテストしてください。数式の再計算が実行の大部分を占める場合は、クエリを実行して、isAutomaticCalculationEnabled()で自動計算を一時的に無効にしenableAutomaticCalculation(False)、元の設定に戻して、必要に応じてダーティセルを再計算できます。エラーが発生してもワークブックが手動計算モードのままにならないように、復元をクリーンアップパスに配置してください。マクロがステップ間で新しい数式結果を必要とする場合は、計算を無効にしないでください。LibreOffice のドキュメントでcalculate()は、ダーティセルの再計算として説明されています。calculateAll()は完全な再計算を強制し、それ自体がコストのかかる場合があります。XCalculatable API リファレンスを参照してください。

lockControllers()マクロが多数のセルを変更する間、表示更新に使用される通知の一部を一時停止できます。unlockControllers()マクロがエラーハンドラーを介して終了する場合も含め、すべてのロックをとペアにしてください。これにより、表示更新の処理が軽減されます。数式計算が無効になったり、セルごとのロジックが一括操作になったりすることはありません。範囲配列の代替としてではなく、測定された画面更新のボトルネックに対して使用してください。XModel API リファレンスを参照してください。

変更内容をどのように確認し、いつ方法を切り替えるべきかをどのように判断しますか？

修正したマクロをワークブックのコピーで実行し、ベースラインと同じ条件下で実行時間を記録します。影響を受ける行、影響を受けない行、数式、および主要な合計値を比較します。本番ワークフローに保存が含まれている場合は、コピーを保存、閉じ、再度開きます。これにより、簡単な目視確認では見逃される問題が明らかになる場合があります。出力チェックが引き続き合格する限り、繰り返し実行することで安定した改善が見られるはずです。

更新されたステータス値と空白のタイミング比較グリッドを表示する計算ワークシート — 変換後の値を確認し、事前に速度向上を想定せずに測定時間を記録してください。

マクロが複雑な数式、書式設定、ファイル入出力、またはソートにほとんどの時間を費やしている場合は、そのステージを個別にプロファイリングしてください。範囲配列は、繰り返しのセルアクセスを減らすだけです。非常に大きなシートの場合、完全なインメモリ配列でもかなりのメモリを消費する可能性があります。メモリ負荷が高まった場合は、一度に数列ずつ処理するか、行を計測ブロックに分割し、各ブロックが意図した行で開始および終了していることを確認してください。データが既にデータベースに存在し、タスクがレコードのフィルタリング、グループ化、または更新である場合は、すべてのレコードを Calc に読み込むよりも、その作業をデータベースクエリに移行する方が適している場合があります。