実行ガバナと制限

トランザクション単位の Apex 制限

これらの制限は、Apex トランザクション単位で適用されます。Apex 一括処理の場合、これらの制限は execute メソッドでレコードのバッチの実行ごとにリセットされます。

次の表では、同期 Apex と非同期 Apex (Apex 一括処理と future メソッド) が異なる場合、それぞれの制限を記載しています。制限が同じ場合、表には、同期および非同期 Apex の両方に適用される 1 つの制限のみが記載されます。

スケジュール済み Apex は非同期の機能ですが、スケジュール済み Apex ジョブには同期の制限が適用されます。
Bulk API および Bulk API 2.0 トランザクションの場合、有効な制限は、同期の制限と非同期の制限のどちらか大きい方です。たとえば、System.enqueueJob によってキューに追加される Bulk Apex ジョブの最大数は、非同期の制限 (1) より大きい同期の制限 (50) です。

メモ

説明	同期制限	非同期制限
発行される SOQL クエリの合計数¹	100	200
SOQL クエリによって取得されるレコードの合計数	50,000	50,000
`Database.getQueryLocator` によって取得されるレコードの合計数	10,000	10,000
発行される SOSL クエリの合計数	20	20
1 つの SOSL クエリによって取得されるレコードの合計数	2,000	2,000
発行される DML ステートメントの合計数²	150	150
DML ステートメント、`Approval.process` または `database.emptyRecycleBin` の結果として処理されるレコードの合計数	10000	10,000
`insert`、`update`、または `delete` ステートメントによって繰り返しトリガーする Apex 呼び出しのスタックの深さの合計数 ³	16	16
トランザクション内のコールアウト (HTTP 要求または Web サービスコール) の合計数	100	100
トランザクション内のすべてのコールアウト (HTTP 要求または Web サービスコール) のタイムアウトの最大累積値	120 秒	120 秒
Apex 呼び出し 1 回につき許可される `future` アノテーションを持つメソッドの最大数	50	batch および future のコンテキストの場合 0、queueable コンテキストの場合 50
`System.enqueueJob` によってキューに追加される Apex ジョブの最大数	50	1
許可される `sendEmail` メソッドの合計数	10	10
ヒープの合計サイズ ⁴	6 MB	12 MB
Salesforce サーバーの最大 CPU 時間⁵	10,000 ミリ秒	60,000 ミリ秒
Apex トランザクションごとの最大実行時間	10 分	10 分
Apex トランザクションごとに許容されるプッシュ通知メソッドコールの最大数	10	10
各プッシュ通知メソッドコールで送信できるプッシュ通知の最大数	2,000	2,000
直ちに公開するように設定されているプラットフォームイベントに対する `EventBus.publish` コールの最大数	150	150

¹ 親-子リレーションのサブクエリを使用する SOQL クエリでは、各親-子リレーションは 1 つの追加クエリと見なされます。これらのクエリタイプは、最上位クエリ数の 3 倍に制限されています。サブクエリの制限は、Limits.getLimitAggregateQueries() が返す値に対応します。これらのリレーションクエリの行数は、全体のコード実行の行数に加算されます。この制限はカスタムメタデータ型には適用されません。1 つの Apex トランザクション内で、カスタムメタデータレコードの SOQL クエリは無制限です。静的 SOQL ステートメントの他、次のメソッドへのコールは、要求内で発行された SOQL ステートメント数に含まれます。

Database.countQuery、Database.countQueryWithBinds
Database.getQueryLocator、Database.getQueryLocatorWithBinds
Database.query、Database.queryWithBinds

² 次のメソッドへのコールは、要求内で発行された DML ステートメント数に含まれます。

Approval.process
Database.convertLead
Database.emptyRecycleBin
Database.rollback
Database.setSavePoint
delete と Database.delete
insert と Database.insert
merge および Database.merge
undelete と Database.undelete
update と Database.update
upsert と Database.upsert
コミット後に公開するように設定されたプラットフォームイベントに対する EventBus.publish
System.runAs

³ insert、update、または delete ステートメントによってトリガーを実行しない繰り返し Apex 処理は、1 つのスタックを使用する 1 つの呼び出し内に存在します。それに対し、トリガーを実行した繰り返し Apex では、新しい Apex 呼び出しでトリガーが発生します。この新しい呼び出しは、コードを実行した呼び出しとは独立しています。Apex の新しい呼び出しの実行は、1 つの呼び出しでの繰り返しコールよりも手間のかかる操作です。したがって、これらの種類の繰り返しコールのスタックの深さには、より厳しいトリガー制限があります。

⁴ メールサービスのヒープサイズは 50 MB です。

⁵ CPU 時間は、1 つの Apex トランザクションで発生する Salesforce アプリケーションサーバー上でのすべての実行に対して計算されます。CPU 時間は、Apex コードや、このコードからコールされるすべてのプロセス (パッケージコードやワークフローなど) の実行に対して計算されます。CPU 時間は、1 つのトランザクション専用であり、他のトランザクションからは独立しています。アプリケーションサーバーの CPU 時間を消費しない操作は、CPU 時間には含まれません。たとえば、実行時間のうち DML、SOQL、および SOSL 用のデータベースに費やされた時間や、Apex コールアウトの待ち時間は含まれません。DML 操作にかかるアプリケーションサーバーの CPU 時間は、Apex CPU の制限に含まれますが、大きな影響はないと考えられます。Bulk API および Bulk API 2.0 では、Salesforce サーバーの CPU 時間の固有のガバナ制限 (最大値: 60,000 ミリ秒) が消費されます。

制限は、各 testMethod に対して個別に適用されます。
実行中にコードのコード実行制限を決定するには、Limits メソッドを使用します。たとえば、プログラムによってすでにコールされた DML ステートメント数を決定するには、getDMLStatements メソッドを使用できます。または、コードに使用できる DML ステートメントの合計数を決定するには、getLimitDMLStatements メソッドを使用できます。

メモ

トランザクション単位の認定管理パッケージの制限

認定管理パッケージ (AppExchange のセキュリティレビューに合格した管理パッケージ) には、ほとんどのトランザクション単位の制限に対して独自の制限セットが設けられます。AppExchange から組織にインストールされ、固有の名前空間を持つ認定管理パッケージを開発するのは、Salesforce ISV パートナーです。

ここでは、DML ステートメントについて、認定管理パッケージに別個に設定される制限の例を説明します。認定管理パッケージをインストールすると、そのパッケージ内のすべての Apex コードには、独自に 150 個の DML ステートメントの制限が設定されます。これらの DML ステートメントは、組織のネイティブコードが実行できる 150 個の DML ステートメントに追加されます。この制限の緩和によって、管理パッケージのコードとネイティブの組織のコードの両方が実行されると、1 つのトランザクションで 150 個を超える DML ステートメントが実行される可能性があります。同様に、同期 Apex については、認定管理パッケージには組織のネイティブコードの 100 個の SOQL クエリ制限に加え、独自に 100 個の SOQL クエリ制限が設定されます。

1 つのトランザクションで呼び出せる認定名前空間の数は無制限です。ただし、各名前空間で実行できる操作の数は、トランザクションあたりの制限を超えることはできません。トランザクション内の全名前空間で実行できる累積操作数にも制限があります。この累積制限は、名前空間あたりの制限の 11 倍です。たとえば、SOQL クエリの名前空間あたりの制限が 100 だとすると、1 つのトランザクションで実行できる SOQL クエリは最大 1,100 個です。この場合、累積制限は名前空間あたりの制限 100 の 11 倍です。これらのクエリは、いずれかの名前空間のクエリが 100 を超えない限り、無制限の数の名前空間で実行できます。累積制限は、すべての名前空間で共有される制限 (最大 CPU 時間の制限など) に影響しません。

これらのクロス名前空間制限は、認定管理パッケージの名前空間にのみ適用されます。
認定されていないパッケージの名前空間には、別個に独自のガバナ制限がありません。使用するリソースは、組織のカスタムコードで使用されるのと同じガバナ制限に含まれます。

メモ

次の表では、累積クロス名前空間制限について説明します。

説明	累積クロス名前空間制限
発行される SOQL クエリの合計数	1,100
`Database.getQueryLocator` によって取得されるレコードの合計数	110,000
発行される SOSL クエリの合計数	220
発行される DML ステートメントの合計数	1,650
トランザクション内のコールアウト (HTTP 要求または Web サービスコール) の合計数	1,100
許可される `sendEmail` メソッドの合計数	110

認定管理パッケージでは、次を除くすべてのトランザクション単位の制限は別個に計算されます。

ヒープの合計サイズ
最大 CPU 時間
最大トランザクション実行時間
固有の名前空間の最大数

これらの制限は、同じトランザクションで実行されている認定管理パッケージの数に関係なく、トランザクション全体に適用されます。

AppExchange で提供されるパッケージのコードのうち、Salesforce ISV パートナー以外が作成した未認定のコードには、個別のガバナ制限はありません。パッケージで使用されるリソースはすべて、組織の合計ガバナ制限数に含まれます。累積リソースメッセージと警告メールも、管理パッケージの名前空間に基づいて生成されます。

Salesforce ISV パートナーパッケージの詳細は、「Salesforce パートナープログラム」を参照してください。

Lightning Platform フォームの Apex 制限

次の表の制限は、Apex トランザクションに固有ではなく、Lightning プラットフォームによって適用されます。

説明	制限
24 時間あたりの非同期 Apex メソッド実行 (Apex 一括処理、future メソッド、キュー可能 Apex、およびスケジュール済み Apex) の最大数¹^,⁶	250,000 か、組織内のユーザーライセンス数 × 200 の大きい方の値
組織ごとの、5 秒を超える長時間のトランザクションに対する同期同時トランザクション数 ²	10
同時にスケジュールされる Apex クラスの最大数	100。Developer Edition 組織の制限は 5 です。
Apex Flex キューに入っている `Holding` 状況の Apex 一括処理ジョブの最大数	100
同時にキューに入っているか有効な Apex 一括処理ジョブの最大数³	5
Apex 一括処理ジョブの `start` メソッドの最大同時実行数⁴	1
1 つのテストの実行で送信可能な一括処理ジョブの最大数	5
24 時間あたりのキュー可能なテストクラスの最大数 (Developer Edition 以外の本番組織)⁵^,⁶	500 または組織のテストクラス数の 10 倍の大きい方
24 時間あたりのキュー可能なテストクラスの最大数 (Sandbox 組織および Developer Edition 組織)⁵^,⁶	500 または組織のテストクラス数の 20 倍の大きい方

¹ Apex 一括処理の場合、メソッド実行には、start、execute、および finish メソッドの実行が含まれます。これは組織全体の制限で、他のすべての非同期 Apex (Apex 一括処理、キュー可能 Apex、スケジュール済み Apex、および future メソッド) と共有されます。この制限に反映されるライセンスの種類は、Salesforce フルユーザーライセンス、Salesforce Platform ユーザーライセンス、アプリケーションサブスクリプションのユーザーライセンス、Chatter Only ユーザー、Identity ユーザー、Company Community ユーザーです。

² 10 個の長時間のトランザクションが実行されている間に追加のトランザクションが開始されると、追加のトランザクションは拒否されます。この制限を計算する場合、HTTP コールアウトの処理時間は含まれません。

³ 一括処理ジョブが送信されると、処理用にシステムキューに移動されるまで、Flex キューに保持されます。

⁴ キュー内のまだ開始されていない一括処理ジョブは、開始されるまで保持されます。複数のジョブが実行されている場合は、この制限により一括処理ジョブが失敗することはありません。Apex の一括処理ジョブの execute メソッドは、依然として並行して実行されます。

⁵ この制限は、テストの非同期実行に適用されます。このテストグループには、開発者コンソールを含め、Salesforce ユーザーインターフェースから開始するテストが含まれます。

⁶使用可能な非同期 Apex 実行の数を確認するには、REST API limits リソースに対して要求を実行するか、Apex メソッドの OrgLimits.getAll() または OrgLimits.getMap() を使用します。『REST API 開発者ガイド』の「組織の制限をリストする」、および『Apex リファレンスガイド』の「OrgLimits クラス」を参照してください。

静的 Apex の制限

説明	制限
トランザクション内のコールアウト (HTTP 要求または Web サービスコール) のデフォルトのタイムアウト値	10 秒
コールアウト要求または応答 (HTTP 要求または Web サービスコール) の最大サイズ ¹	同期 Apex の場合は 6 MB、非同期 Apex の場合は 12 MB
SOQL クエリの最大実行時間。この時間を超えると、Salesforce によってトランザクションがキャンセルされます。	120 秒
Apex リリース内のクラスとトリガーの最大コードユニット数	7500
Apex トリガーのバッチサイズ²	200
ループリストのバッチサイズ用	200
`Database.QueryLocator` の 1 回の Apex 一括処理のクエリで返される最大レコード数	5000 万

¹ HTTP 要求のサイズおよび応答のサイズは、ヒープサイズの合計に含まれます。

² プラットフォームイベントと変更データキャプチャイベントの Apex トリガーバッチサイズは 2,000 です。

サイズ固有の Apex 制限

説明	制限
クラスの最大文字数	100 万
トリガーの最大文字数	100 万
組織内のすべての Apex コードで使用されるコードの最大量¹	6 MB
メソッドのサイズ制限²	コンパイル形式で 65,535 バイトコード命令

¹ この制限は、第一世代 (1GP) または第二世代 (2GP) 管理パッケージの Apex コードには適用されません。これらのパッケージタイプのコードは、組織のコードとは異なる独自の名前空間に属しています。この制限は、@isTest アノテーションで定義されたクラスに含まれるコードにも適用されません。

² 制限を超える大規模なメソッドはコードの実行中に例外が発生する場合があります。

その他の Apex の制限

Apex の Connect: ConnectApi 名前空間内のクラスの場合、各書き込み操作が Apex ガバナ制限で 1 回の DML 操作としてカウントされます。ConnectApi メソッドコールも、レート制限の対象となります。ConnectApi レート制限は、Connect REST API レート制限と同じです。どちらにも、ユーザーごと、名前空間ごと、時間ごとのレート制限があります。レート制限を超えると、ConnectApi.RateLimitException が発生します。Apex コードで、この例外をキャッチして処理する必要があります。
Data.com Clean: Data.com Clean 製品とその自動ジョブを使用する場合は、Apex トリガーの使用方法を検討してください。取引先、取引先責任者、またはリードレコードで SOQL クエリを実行する Apex トリガーを使用する場合、それらのオブジェクトで SOQL クエリがクリーンアップジョブに干渉する可能性があります。Apex トリガー (合計) は、バッチあたり 200 個以下の SOQL クエリにしてください。この制限を超えると、そのオブジェクトに対するクリーンアップジョブが失敗します。また、トリガーが future メソッドをコールする場合は、バッチあたり 10 個の future コールに制限されます。
イベントレポート: システム管理者以外のユーザーの場合、イベントレポートが返すレコードの最大数は 20,000 件です。システム管理者の場合、100,000 件です。
Apex テストでの MAX_DML_ROWS の制限: 1 つの同期 Apex テストの実行コンテキストで挿入、更新、または削除できる行の最大数は 450,000 に制限されています。たとえば、Apex クラスでは 10,000 行を挿入するメソッドを 45 個使用できます。この制限に達すると、[Your runallTests is consuming too many DB resources (runallTests が消費する DB リソースが多すぎます)] のエラーが表示されます。
SOQL クエリのパフォーマンス: 最高のパフ��ーマンスを得るためには、特にトリガー内のクエリに対しては、セレクティブ SOQL クエリを使用する必要があります。実行時間が長くなるのを避けるために、システムはセレクティブ以外の SOQL クエリを終了できます。200,000 件を超えるレコードを含むオブジェクトに対してトリガーでセレクティブではないクエリを使用すると、エラーメッセージが表示されます。このエラーを回避するには、必ずセレクティブクエリを使用します。「より効率的な SOQL クエリ」を参照してください。

メール制限

受信メール制限

メールサービス: 処理するメールメッセージの最大数 (オンデマンドメール-to-ケースの制限を含む)	ユーザーライセンス数 × 1,000、最大数 1,000,000
メールサービス: メールメッセージの最大サイズ (本文および添付ファイル)	25 MB¹
オンデマンドメール-to-ケース: メールの添付ファイルの最大サイズ	25 MB
オンデマンドメール-to-ケース: 処理されるメールメッセージの最大数 (メールサービスの制限に含まれる)	ユーザーライセンス数 × 1,000、最大数 1,000,000

¹ メールサービスのメールメッセージの最大数は、本文パートの文字セットと転送文字コードによって異なります。メールメッセージのサイズには、メールヘッダー、本文、添付ファイル、エンコードが含まれます。そのため、添付ファイルが 25 MB のメールは、ヘッダー、本文、エンコードを考慮すると、メールメッセージのサイズ制限 35 MB を超える可能性があります。

メールサービスを定義するときには、次の点に注意してください。

メールサービスは、そのアドレスの 1 つが受信したメッセージを処理するだけです。
Salesforce は、[オンデマンドメール-to-ケース] など、すべてのメールサービスを合計した 1 日に処理できるメッセージの総数を制限します。この制限を超えたメッセージは、各メールサービスの失敗時のレスポンス設定に基づいて、戻されるか、破棄されるか、または翌日の処理のキューに入れられます。Salesforce では、制限値は、ユーザーライセンス数 x 1,000 で算出され、最大値は 1,000,000 です。たとえば、ライセンス数が 10 の場合、1 日最大 10,000 件のメールメッセージを処理できます。
Sandbox 内に作成したメールサービスアドレスは、本番組織にコピーできません。
メールサービスごとに Salesforce に通知して、送信者のメールアドレスではなく、特定のアドレスにエラーメールメッセージを送信できます。
メールが (本文テキスト、本文 HTML および添付ファイルを合わせて) 約 25 MB を超える場合 (言語や文字セットに応じて異なる)、メールサービスはメールメッセージを拒否し、送信者に通知します。

送信メール: Apex を使用して送信する単一メールおよび一括メールの制限

グリニッジ標準時 (GMT) に基づき、各ライセンス組織は 1 日に最大 5,000 個の外部メールアドレスに単一メールを送信できます。Spring '19 よりも前に作成された組織では、この日次制限は、Apex と Salesforce API (REST API を除く) を介して送信されたメールに対してのみ適用されます。Spring '19 以降に作成された組織では、この日次制限はメールアラート、単純なメールアクション、フロー内の [メールを送信] アクション、および REST API にも適用されます。組織がこの制限に達したため新しく計数されたいずれかのメールを送信できない場合、通知のメールがユーザーに送信され、エントリがデバッグログに追加されます。Salesforce の Email Author やコンポーザーを使用して送信した単一メールは、この制限に含まれません。取引先、取引先責任者、リード、商談、ケース、キャンペーン、カスタムオブジェクトの各ページから、組織の取引先責任者、リード、個人取引先、ユーザーに単一メールを直接送信する場合は、制限はありません。Developer Edition 組織とトライアル期間中に Salesforce を評価している組織では、1 日あたり最大 50 人の受信者にメールを送信でき、個々のメールには最大 15 人の受信者を含めることができます。

メールを送信するときの考慮事項は、次のとおりです。

単一メールを送信する場合、各 SingleEmailMessage では、To、CC、および BCC の各項目全体で最大 150 人の受信者を指定できます。また、各項目は、4,000 バイトに制限されています。
SingleEmailMessage を使用して組織の内部ユーザーにメールを送信するときに setTargetObjectId でユーザー ID を指定すると、メールが 1 日あたりの制限に含まれません。ただし、setToAddresses で内部ユーザーのメールアドレスを指定すると、制限に含まれます。

ライセンス許可を受けた 1 Salesforce 組織あたり 1 日に最大 5,000 個の外部メールアドレスに一括メールとリストメールを送信できます。日はグリニッジ標準時 (GMT) に基づいて計算されます。
単一メール、一括メール、およびリストメールの制限には、重複するメールアドレスが含まれます。たとえば、メールに johndoe@example.com が 10 回含まれている場合、制限には 10 が反映されます。
1 日に最大 5,000 個の外部メールアドレスに API または Apex 単一メールを送信できます。
ポータルユーザーを含め、組織の内部ユーザーに UI から送信できるメールには制限はありません。
一括メールとリストメールは、取引先責任者、個人取引先、リード、および組織の内部ユーザーにのみ送信できます。
Developer Edition 組織、およびトライアルで Salesforce を評価中の組織では、一括メールおよびリストメールを使用して、1 日に 1 組織あたり 10 人までの外部メール受信者にメールを送信できます。
Visualforce メールテンプレートを使用して一括メールを送信することはできません。

プッシュ通知の制限

1 時間 (たとえば、4:00 ～ 4:59 UTC) あたりに組織が送信できるプッシュ通知は、iOS で最大 20,000 件、Android で最大 10,000 件です。

配信可能な通知のみがこの制限に含まれます。たとえば、通知が会社の 1,000 名の従業員に送信されるが、100 名の従業員はまだモバイルアプリケーションをインストールしていない場合を考えます。モバイルアプリケーションをインストールしている 900 名の従業員に送信された通知のみがこの制限に含まれます。

[プッシュ通知をテスト] ページで生成された各テストプッシュ通知の受信者は 1 名に制限されています。テストプッシュ通知は、組織の 1 時間のプッシュ通知制限に含まれます。

組織の 1 時間のプッシュ通知制限に達しても、アプリケーション内表示および REST API を介した取得の通知は引き続き作成されます。

Apex 開発者ガイド