Database クラス

使用方法

insert は SQL の INSERT ステートメントに類似しています。

項目に割り当てた文字列値が長すぎる場合、API バージョン 15.0 以降を使用して保存 (コンパイル) した Apex クラスとトリガにはランタイムエラーが発生します。

実行された各 insert メソッドは、DML ステートメントのガバナ制限にカウントされます。

insert(sObject [], Boolean)

個別の取引先や取引先責任者など、1 つ以上の sObject を組織のデータに追加します。

署名

public static Database.SaveResult[] insert(sObject [] recordsToInsert, Boolean opt_allOrNone)

パラメータ

recordsToInsert: 型: sObject[]
opt_allOrNone: 型: Boolean; (省略可能) opt_allOrNone パラメータは、操作で部分的な完了を許可するかどうかを指定します。このパラメータを false に設定した場合、レコードが失敗しても、残りの DML 操作を正常に完了できます。このメソッドは、どのレコードが成功または失敗したか、およびその理由の確認に使用できる結果オブジェクトを返します。

戻り値

型: Database.SaveResult[]

使用方法

insert は SQL の INSERT ステートメントに類似しています。

実行された各 insert メソッドは、DML ステートメントのガバナ制限にカウントされます。

例

例:

次の例では 2 つの取引先が挿入されます。

1Account a = 
2  new Account(name = 'Acme1');
3Database.SaveResult[] lsr = 
4  Database.insert(
5  new Account[]{a, 
6    new Account(Name = 'Acme2')},
7  false);

insert(sObject, Database.DMLOptions)

個別の取引先や取引先責任者など、sObject を組織のデータに追加します。

署名

public static Database.SaveResult insert(sObject recordToInsert, Database.DMLOptions options)

パラメータ

recordToInsert: 型: sObject
options: 型: Database.DMLOptions; (省略可能) opt_DMLOptions パラメータは、レコード挿入時にエラーが発生した場合の割り当てルールの情報やロールバック動作など、トランザクションの追加データを指定します。

戻り値

使用方法

insert は SQL の INSERT ステートメントに類似しています。

実行された各 insert メソッドは、DML ステートメントのガバナ制限にカウントされます。

insert(sObject[], Database.DMLOptions)

個別の取引先や取引先責任者など、sObject を組織のデータに追加します。

署名

public static Database.SaveResult insert(sObject[] recordToInsert, Database.DMLOptions options)

パラメータ

recordToInsert: 型: sObject[]
options: 型: Database.DMLOptions; (省略可能) opt_DMLOptions パラメータは、レコード挿入時にエラーが発生した場合の割り当てルールの情報やロールバック動作など、トランザクションの追加データを指定します。

戻り値

使用方法

insert は SQL の INSERT ステートメントに類似しています。

実行された各 insert メソッドは、DML ステートメントのガバナ制限にカウントされます。

merge(sObject, Id)

指定の重複レコードを同じ型のマスタ sObject レコードにマージし、重複を削除して関連レコードの親を変更します。取引先、取引先責任者、またはリードのみをマージします。

署名

public static Database.MergeResult merge(sObject master, Id duplicate)

パラメータ

master: 型: sObject; 重複レコードをマージするマスタ sObject レコードです。
duplicate: 型: ID; マスタとマージするレコードの ID です。このレコードは、マスタと同じ sObject 型である必要があります。

戻り値

使用方法

実行された各 merge メソッドは、DML ステートメントのガバナ制限にカウントされます。

merge(sObject, sObject)

指定された重複する sObject レコードを同じ型のマスタ sObject レコードにマージし、重複を削除して関連レコードの親を変更します。

署名

public static Database.MergeResult merge(sObject master, sObject duplicate)

パラメータ

master: 型: sObject; 重複レコードをマージするマスタ sObject レコードです。
duplicate: 型: sObject; マスタとマージする sObject レコードです。この sObject は、マスタと同じ型である必要があります。

戻り値

使用方法

実行された各 merge メソッドは、DML ステートメントのガバナ制限にカウントされます。

merge(sObject, List<Id>)

同じ sObject 型のレコードを 2 つまでマスタ sObject レコードにマージし、その他のレコードを削除して関連レコードの親を変更します。

署名

public static List<Database.MergeResult> merge(sObject master, List<Id> duplicates)

パラメータ

master: 型: SObject; その他のレコードをマージするマスタ sObject レコードです。
duplicates: 型: List<Id>; マスタとマージする最大 2 つのレコードの ID のリストです。これらのレコードは、マスタと同じ sObject 型である必要があります。

戻り値

使用方法

実行された各 merge メソッドは、DML ステートメントのガバナ制限にカウントされます。

merge(sObject, List<SObject>)

同じオブジェクト種別のレコードを 2 つまでマスタ sObject レコードにマージし、その他のレコードを削除して関連レコードの親を変更します。

署名

public static List<Database.MergeResult> merge(sObject master, List<SObject> duplicates)

パラメータ

master: 型: SObject; その他の sObject をマージするマスタ sObject レコードです。
duplicates: 型: List<SObject>; マスタとマージする最大 2 つの sObject レコードのリストです。これらの sObject は、マスタと同じ型である必要があります。

戻り値

使用方法

実行された各 merge メソッドは、DML ステートメントのガバナ制限にカウントされます。

merge(sObject, Id, Boolean)

指定された重複するレコードを同じ型のマスタ sObject レコードにマージし、必要に応じて、エラーがある場合は返し、重複を削除して関連レコードの親を変更します。取引先、取引先責任者、またはリードのみをマージします。

署名

public static Database.MergeResult merge(sObject master, Id duplicate, Boolean allOrNothing)

パラメータ

master: 型: sObject; 重複レコードをマージするマスタ sObject レコードです。
duplicate: 型: ID; マスタとマージするレコードの ID です。このレコードは、マスタと同じ sObject 型である必要があります。
allOrNone: 型: Boolean; 返される結果の一部として、この操作で発生したエラーを返すには、false を設定します。true に設定すると、操作に失敗したときにこのメソッドで例外が発生します。デフォルトは true です。

戻り値

使用方法

実行された各 merge メソッドは、DML ステートメントのガバナ制限にカウントされます。

merge(sObject, sObject, Boolean)

指定された重複する sObject レコードを同じ型のマスタ sObject レコードにマージし、必要に応じて、エラーがある場合は返し、重複を削除して関連レコードの親を変更します。

署名

public static Database.MergeResult merge(sObject master, sObject duplicate, Boolean allOrNone)

パラメータ

master: 型: sObject; 重複レコードをマージするマスタ sObject レコードです。
duplicate: 型: sObject; マスタとマージする sObject レコードです。この sObject は、マスタと同じ型である必要があります。
allOrNone: 型: Boolean; 返される結果の一部として、この操作で発生したエラーを返すには、false を設定します。true に設定すると、操作に失敗したときにこのメソッドで例外が発生します。デフォルトは true です。

戻り値

使用方法

実行された各 merge メソッドは、DML ステートメントのガバナ制限にカウントされます。

merge(sObject, List<Id>, Boolean)

同じ sObject 型のレコードを 2 つまでマスタ sObject レコードにマージし、必要に応じて、エラーがある場合は返し、重複を削除して、その他のレコードを削除して関連レコードの親を変更します。

署名

public static List<Database.MergeResult> merge(sObject master, List<Id> duplicates, Boolean allOrNone)

パラメータ

master: 型: SObject; その他のレコードをマージするマスタ sObject レコードです。
duplicates: 型: List<Id>; マスタとマージする最大 2 つのレコードの ID のリストです。これらのレコードは、マスタと同じ sObject 型である必要があります。
allOrNone: 型: Boolean; 返される結果の一部として、この操作で発生したエラーを返すには、false を設定します。true に設定すると、操作に失敗したときにこのメソッドで例外が発生します。デフォルトは true です。

戻り値

使用方法

実行された各 merge メソッドは、DML ステートメントのガバナ制限にカウントされます。

merge(sObject, List<SObject>, Boolean)

同じオブジェクト種別のレコードを 2 つまでマスタ sObject レコードにマージし、必要に応じて、エラーがある場合は返し、重複を削除して、その他のレコードを削除して関連レコードの親を変更します。

署名

public static List<Database.MergeResult> merge(sObject master, List<SObject> duplicates, Boolean allOrNone)

パラメータ

master: 型: sObject; その他の sObject をマージするマスタ sObject レコードです。
duplicates: 型: List<SObject>; マスタとマージする最大 2 つの sObject レコードのリストです。これらの sObject は、マスタと同じ型である必要があります。
allOrNone: 型: Boolean; 返される結果の一部として、この操作で発生したエラーを返すには、false を設定します。true に設定すると、操作に失敗したときにこのメソッドで例外が発生します。デフォルトは true です。

戻り値

使用方法

実行された各 merge メソッドは、DML ステートメントのガバナ制限にカウントされます。

query(String)

実行時に動的 SOQL クエリを作成します。

署名

public static sObject[] query(String query)

パラメータ

query: 型: String

戻り値

型: sObject[]

使用方法

このメソッドは、通常の割り当てステートメントや for ループなど、静的 SOQL クエリが使用可能な場合に使用できます。インライン SOQL 項目の場合とは異なり、バインド変数はサポートされていません。

詳細は、「動的 SOQL」を参照してください。

実行された各 query メソッドは、SOQL クエリのガバナ制限にカウントされます。

rollback(System.Savepoint)

データベースを、savepoint 変数で指定された状態に復元します。最後の savepoint 後に送信されたメールもロールバックされ、送信されません。

署名

public static Void rollback(System.Savepoint sp)

パラメータ

sp: 型: System.Savepoint

戻り値

型: Void

使用方法

次の点に注意してください。

ロールバック中、静的変数は戻されません。トリガの実行を再試行する場合、静的変数には最初の実行から得た値が維持されます。
各ロールバックは、DML ステートメントのガバナ制限にカウントされます。データベースをそれ以上の回数ロールバックしようとすると、ランタイムエラーが発生します。
savepoint の設定後に挿入された sObject の ID は、ロールバック後にクリアされません。ロールバック後に挿入するには、新しい sObject を作成します。ロールバック前に作成した変数を使用して sObject を挿入しようとすると、その sObject 変数には ID があるため失敗します。同じ変数を使用して sObject を更新または更新/挿入しようとした場合も、sObject はデータベース内に存在せず、更新できないため失敗します。

「トランザクションの制御」の例を参照してください。

setSavepoint()

ローカル変数として保存でき、rollback メソッドで使用してデータベースをその時点に復元できる savepoint 変数を返します。

署名

public static System.Savepoint setSavepoint()

戻り値

型: System.Savepoint

使用方法

次の点に注意してください。

複数の savepoint を設定し、生成した最新 savepoint ではない savepoint にロールバックすると、ロールバックされた savepoint 変数は無効になります。たとえば、最初に savepoint SP1 を生成し、次に savepoint SP2 を生成した場合、SP1 にロールバックすると、変数 SP2 は無効になります。その変数を使用しようとすると、ランタイムエラーが発生します。
各トリガ呼び出しが新しいトリガコンテキストであるため、savepoints への参照は、トリガ呼び出しを通過することはできません。静的変数として savepoint を宣言し、トリガコンテキスト全体で使用しようとすると、ランタイムエラーが発生します。
設定した各セーブポイントは、DML ステートメントのガバナ制限にカウントされます。

「トランザクションの制御」の例を参照してください。

undelete(sObject, Boolean)

個別の取引先や取引先責任者など、既存の sObject レコードを組織のごみ箱から復元します。

署名

public static Database.UndeleteResult undelete(sObject recordToUndelete, Boolean opt_allOrNone)

パラメータ

recordToUndelete: 型: sObject
opt_allOrNone: 型: Boolean; (省略可能) opt_allOrNone パラメータは、操作で部分的な完了を許可するかどうかを指定します。このパラメータを false に設定した場合、レコードが失敗しても、残りの DML 操作を正常に完了できます。このメソッドは、どのレコードが成功または失敗したか、およびその理由の確認に使用できる結果オブジェクトを返します。

戻り値

型: Database.UndeleteResult

使用方法

undelete は SQL の UNDELETE ステートメントに類似しています。

実行された各 undelete メソッドは、DML ステートメントのガバナ制限にカウントされます。

undelete(sObject [], Boolean)

個別の取引先や取引先責任者など、1 つ以上の既存の sObject レコードを組織のごみ箱から復元します。

署名

public static Database.UndeleteResult[] undelete(sObject [] recordsToUndelete, Boolean opt_allOrNone)

パラメータ

recordsToUndelete: 型: sObject[]
opt_allOrNone: 型: Boolean; (省略可能) opt_allOrNone パラメータは、操作で部分的な完了を許可するかどうかを指定します。このパラメータを false に設定した場合、レコードが失敗しても、残りの DML 操作を正常に完了できます。このメソッドは、どのレコードが成功または失敗したか、およびその理由の確認に使用できる結果オブジェクトを返します。

戻り値

型: Database.UndeleteResult[]

使用方法

undelete は SQL の UNDELETE ステートメントに類似しています。

実行された各 undelete メソッドは、DML ステートメントのガバナ制限にカウントされます。

例

次の例では、「Trump」という名前のすべての取引先が復元されます。ALL ROWS キーワードは、削除されたレコードやアーカイブ済みの活動を含め、最上位リレーションと集計リレーションの両方にあるすべての行をクエリします。

1Account[] SavedAccts = 
2  [SELECT Id, Name 
3   FROM Account 
4   WHERE Name = 'Trump' ALL ROWS];
5Database.UndeleteResult[] UDR_Dels =
6  Database.undelete(SavedAccts);

undelete(ID, Boolean)

個別の取引先や取引先責任者など、既存の sObject レコードを組織のごみ箱から復元します。

署名

public static Database.UndeleteResult undelete(ID recordID, Boolean opt_allOrNone)

パラメータ

recordID: 型: ID
opt_allOrNone: 型: Boolean; (省略可能) opt_allOrNone パラメータは、操作で部分的な完了を許可するかどうかを指定します。このパラメータを false に設定した場合、レコードが失敗しても、残りの DML 操作を正常に完了できます。このメソッドは、どのレコードが成功または失敗したか、およびその理由の確認に使用できる結果オブジェクトを返します。

戻り値

型: Database.UndeleteResult

使用方法

undelete は SQL の UNDELETE ステートメントに類似しています。

実行された各 undelete メソッドは、DML ステートメントのガバナ制限にカウントされます。

undelete(ID[], Boolean)

個別の取引先や取引先責任者など、1 つ以上の既存の sObject レコードを組織のごみ箱から復元します。

署名

public static Database.UndeleteResult[] undelete(ID[] recordIDs, Boolean opt_allOrNone)

パラメータ

RecordIDs: 型: ID[]
opt_allOrNone: 型: Boolean; (省略可能) opt_allOrNone パラメータは、操作で部分的な完了を許可するかどうかを指定します。このパラメータを false に設定した場合、レコードが失敗しても、残りの DML 操作を正常に完了できます。このメソッドは、どのレコードが成功または失敗したか、およびその理由の確認に使用できる結果オブジェクトを返します。

戻り値

型: Database.UndeleteResult[]

使用方法

undelete は SQL の UNDELETE ステートメントに類似しています。

実行された各 undelete メソッドは、DML ステートメントのガバナ制限にカウントされます。

update(sObject, Boolean)

個別の取引先または取引先責任者など、組織のデータ内の既存の sObject レコードを更新します。

署名

public static Database.SaveResult update(sObject recordToUpdate, Boolean opt_allOrNone)

パラメータ

recordToUpdate: 型: sObject
opt_allOrNone: 型: Boolean; (省略可能) opt_allOrNone パラメータは、操作で部分的な完了を許可するかどうかを指定します。このパラメータを false に設定した場合、レコードが失敗しても、残りの DML 操作を正常に完了できます。このメソッドは、どのレコードが成功または失敗したか、およびその理由の確認に使用できる結果オブジェクトを返します。

戻り値

使用方法

update は SQL の UPDATE ステートメントに類似しています。

実行された各 update メソッドは、DML ステートメントのガバナ制限にカウントされます。

例

次の例では、1 つの取引先の BillingCity 項目が更新されます。

1Account a = new Account(Name='SFDC');
2insert(a);
3
4Account myAcct =
5  [SELECT Id, Name, BillingCity
6   FROM Account WHERE Id = :a.Id];
7myAcct.BillingCity = 'San Francisco';
8
9Database.SaveResult SR =
10  Database.update(myAcct);

update(sObject [], Boolean)

個別の取引先や取引先責任者、請求書の明細など、組織のデータ内の 1 つ以上の既存の sObject レコードを更新します。

署名

public static Database.SaveResult[] update(sObject[] recordsToUpdate, Boolean opt_allOrNone)

パラメータ

recordsToUpdate: 型: sObject[]
opt_allOrNone: 型: Boolean; (省略可能) opt_allOrNone パラメータは、操作で部分的な完了を許可するかどうかを指定します。このパラメータを false に設定した場合、レコードが失敗しても、残りの DML 操作を正常に完了できます。このメソッドは、どのレコードが成功または失敗したか、およびその理由の確認に使用できる結果オブジェクトを返します。

戻り値

型: Database.SaveResult[]

使用方法

update は SQL の UPDATE ステートメントに類似しています。

実行された各 update メソッドは、DML ステートメントのガバナ制限にカウントされます。

update(sObject, Database.DmlOptions)

個別の取引先または取引先責任者など、組織のデータ内の既存の sObject レコードを更新します。

署名

public static Database.SaveResult update(sObject recordToUpdate, Database.DmlOptions options)

パラメータ

recordToUpdate: 型: sObject
options: 型: Database.DMLOptions; (省略可能) opt_DMLOptions パラメータは、レコード挿入時にエラーが発生した場合の割り当てルールの情報やロールバック動作など、トランザクションの追加データを指定します。

戻り値