Part 12: ガバナ制限 (Governor Limits) の超過を防ぐエラーハンドリング

前回は プラットフォームイベントとスケジュールバッチのエラーハンドリング を解説しました。
今回は Salesforce のガバナ制限 (Governor Limits) に関するエラーを防ぐ方法 について詳しく解説します。

1. ガバナ制限とは？

Salesforce は マルチテナント環境 で動作するため、1 つの組織がシステムリソースを独占しないように 「ガバナ制限 (Governor Limits)」 を設定しています。

例えば：

SOQL クエリ制限 → 1 トランザクションで 100 件まで
DML ステートメント制限 → 1 トランザクションで 150 件まで
CPU タイム制限 → 同期処理は最大 10 秒、非同期処理は最大 60 秒まで
ヒープサイズ制限 → 6MB (標準)、非同期処理は 12MB
コールアウト制限 → 1 回のトランザクションで最大 120 秒

これらの制限を超えると LimitException が発生し、処理が中断されます。

2. LimitException の発生を防ぐ方法

2.1. SOQL クエリ制限 (System.QueryException)

SOQL クエリの実行回数が 1 トランザクションあたり 100 件 を超えると QueryException が発生します。

❌ NG 例: ループ内で SOQL クエリを実行

for (Account acc : Trigger.new) {
    Contact c = [SELECT Id FROM Contact WHERE AccountId = :acc.Id LIMIT 1];
}

→ ガバナ制限エラー (System.LimitException: Too many SOQL queries: 101) が発生！

✅ OK 例: SOQL を 1 回だけ実行

Map<Id, Contact> contactMap = new Map<Id, Contact>();
for (Contact c : [SELECT Id, AccountId FROM Contact WHERE AccountId IN :Trigger.newMap.keySet()]) {
    contactMap.put(c.AccountId, c);
}

// ループ内で SOQL を実行しない
for (Account acc : Trigger.new) {
    Contact c = contactMap.get(acc.Id);
}

→ SOQL クエリを 1 回だけ実行し、マップを活用することで制限を回避！

適用ケース:
トリガー (Trigger) やバッチ処理で SOQL を実行する際、クエリ回数を削減したい場合

2.2. DML 制限 (System.DmlException)

DML (insert, update, delete, upsert) の実行回数が 1 トランザクションあたり 150 件 を超えると DmlException が発生します。

❌ NG 例: ループ内で DML を実行

for (Account acc : accounts) {
    update acc;
}

→ ガバナ制限エラー (System.LimitException: Too many DML statements: 151) が発生！

✅ OK 例: DML を 1 回だけ実行

update accounts;

→ DML を 1 回でまとめて実行 (バルク処理) することで制限を回避！

適用ケース:
多数のレコードを更新する際に DML 制限を回避したい場合

2.3. CPU タイム制限 (System.LimitException)

同期処理では 最大 10 秒、非同期処理では 最大 60 秒 を超えると LimitException が発生します。

❌ NG 例: 非効率な処理

for (Integer i = 0; i < 1000000; i++) {
    System.debug('処理中: ' + i);
}

→ 不要なループが多すぎると、CPU タイム制限に引っかかる！

✅ OK 例: 必要な処理だけ実行

for (Integer i = 0; i < 1000000; i+=100000) { // 10万ごとにログ出力
    System.debug('処理中: ' + i);
}

→ 不要な処理を削減し、CPU タイムを節約！

適用ケース:
大量データ処理を行う場合に CPU タイム制限を回避したい場合

2.4. ヒープサイズ制限 (System.LimitException)

ヒープサイズの制限は 同期処理で 6MB、非同期処理で 12MB。
大量データを扱う場合、ヒープサイズを超えると LimitException が発生します。

❌ NG 例: 大量データをすべてメモリに保持

List<Account> allAccounts = [SELECT Id, Name FROM Account];

→ 全レコードを取得すると、ヒープサイズ制限を超える可能性あり！

✅ OK 例: バッチ処理を活用

Database.QueryLocator query = Database.getQueryLocator(
    'SELECT Id, Name FROM Account'
);

→ Database.QueryLocator を使うと、レコードを一括取得せずに処理できる！

適用ケース:
大量のレコードを扱う際にヒープサイズ制限を回避したい場合

2.5. コールアウト制限 (System.CalloutException)

コールアウト (外部 API 呼び出し) の制限は 1 トランザクションあたり 120 秒。

❌ NG 例: ループ内で API を呼び出す

for (Account acc : accounts) {
    HttpRequest req = new HttpRequest();
    req.setEndpoint('https://api.example.com/data');
    req.setMethod('GET');
    HttpResponse res = new Http().send(req);
}

→ ガバナ制限エラー (System.CalloutException: Callout loop detected) が発生！

✅ OK 例: コールアウトをバッチ処理に分割

// コールアウトをバッチ処理で実行
public class CalloutBatch implements Database.Batchable<SObject>, Database.AllowsCallouts {
    public Iterable<SObject> start(Database.BatchableContext bc) {
        return [SELECT Id FROM Account LIMIT 100];
    }

    public void execute(Database.BatchableContext bc, List<SObject> scope) {
        HttpRequest req = new HttpRequest();
        req.setEndpoint('https://api.example.com/data');
        req.setMethod('GET');
        HttpResponse res = new Http().send(req);
    }

    public void finish(Database.BatchableContext bc) {}
}

→ Database.AllowsCallouts を使ってバッチ処理でコールアウト！

適用ケース:
API コールアウトを効率的に処理し、制限を回避したい場合

まとめ

今回は ガバナ制限 (Governor Limits) を超えないためのエラーハンドリング を解説しました。

✅ SOQL クエリ制限

ループ内で SOQL を実行せず、マップを活用する

✅ DML 制限

DML を 1 回だけ実行 (バルク処理)

✅ CPU タイム制限

不要なループや処理を減らす

✅ ヒープサイズ制限

バッチ処理 (Database.QueryLocator) を活用

✅ コールアウト制限

バッチ処理 (Database.AllowsCallouts) を使う

次の Part 13 では、例外をトラブルシューティングする方法 (デバッグ手法) について解説します！