SOSL クエリの作成

SOSL クエリは簡単に Apex に追加できます。SOSL クエリを直接 Apex コードに埋め込むことができます。Apex に埋め込まれた SOSL は、インライン SOSL と呼ばれます。

次の SOSL クエリの例では、「SFDC」という語を含む項目を持つ取引先と取引先責任者を検索します。

List<List<SObject>> searchList = [FIND 'SFDC' IN ALL FIELDS 
                                      RETURNING Account(Name), Contact(FirstName,LastName)];

SOQL と SOSL の相違点と類似点

SOQL と同様、SOSL では組織のレコードから特定の情報を検索できます。一度に 1 つの標準またはカスタムオブジェクトしか照会できない SOQL とは異なり、1 つの SOSL クエリですべてのオブジェクトを検索できます。

もう 1 つの相違点として、SOSL が単語の一致に基づいて項目を検索するのに対し、SOQL はデフォルトで完全一致検索を実行します (ワイルドカードを使用しない場合)。たとえば、SOSL で「Digital」を検索すると、項目値が「Digital」や「The Digital Company」のレコードが返されますが、SOQL では項目値が「Digital」のレコードのみが返されます。

SOQL と SOSL は、2 つの別個の言語であり、構文が異なります。各言語で使用事例も異なります。

• 1 つのオブジェクトのレコードを取得する場合は、SOQL を使用します。
• 複数のオブジェクトを対象に項目を検索する場合は、SOSL を使用します。SOSL クエリは、オブジェクトのほとんどのテキスト項目を検索できます。

前提条件

この単元の一部のクエリでは、組織に取引先と取引先責任者があることを前提としています。SOQL の単元でサンプルデータを作成しなかった場合は、この単元でサンプルデータを作成します。すでに作成している場合は、このセクションのサンプルデータの作成をスキップできます。

1. 開発者コンソールの [Debug (デバッグ)] メニューから [Execute Anonymous (匿名実行)] ウィンドウを開きます。
2. ウィンドウに次のスニペットを入力し、[Execute (実行)] をクリックします。

// Add account and related contact
Account acct = new Account(
    Name='SFDC Computing',
    Phone='(415)555-1212',
    NumberOfEmployees=50,
    BillingCity='San Francisco');
insert acct;

// Once the account is inserted, the sObject will be 
// populated with an ID.
// Get this ID.
ID acctID = acct.ID;

// Add a contact to this account.
Contact con = new Contact(
    FirstName='Carol',
    LastName='Ruiz',
    Phone='(415)555-1212',
    Department='Wingo',
    AccountId=acctID);
insert con;

// Add account with no contact
Account acct2 = new Account(
    Name='The SFDC Query Man',
    Phone='(310)555-1213',
    NumberOfEmployees=50,
    BillingCity='Los Angeles',
    Description='Expert in wing technologies.');
insert acct2;

クエリエディタの使用

開発者コンソールのクエリエディタコンソールでは、SOSL クエリを実行して結果を表示できます。クエリエディタを使用して、すばやくデータベースを調査できます。そのため、SOSL クエリを Apex コードに追加する前にテストするのに適しています。クエリエディタを使用するときは、前後の Apex コードなしで SOSL ステートメントのみを入力する必要があります。

次の SOSL の例を実行してみましょう。

1. 開発者コンソールで [Query Editor (クエリエディタ)] タブをクリックします。
2. 次のコードをコピーしてクエリエディタの下の最初のボックスに貼り付け、[Execute (実行)] をクリックします。

FIND {Wingo} IN ALL FIELDS RETURNING Account(Name), Contact(FirstName,LastName,Department)

条件を満たす組織のすべての取引先レコードと取引先責任者レコードが [Query Results (クエリ結果)] セクションに項目のある行として表示されます。結果は、オブジェクト (取引先または取引先責任者) ごとにタブでグループ化されます。この SOSL クエリは、値が Wingo と一致する項目を持つレコードを返します。サンプルデータでは、値が Wingo の項目を持つのは 1 つの取引先責任者のみであるため、この取引先責任者が返されます。

メモ

クエリエディタと API の検索クエリは、中括弧で囲む必要があります ({Wingo})。これに対し、Apex では、検索クエリは単一引用符で囲みます ('Wingo')。

基本的な SOSL 構文

基本的な SOSL クエリの構文を次に示します。

FIND 'SearchQuery' [IN SearchGroup] [RETURNING ObjectsAndFields]

SearchQuery は、検索するテキスト (単語または語句) です。検索語は、論理演算子 (AND、OR) と括弧でグループ化できます。また、検索語にはワイルドカード文字 (*、?) を含めることができます。* ワイルドカードは検索語の途中または末尾にある 0 個以上の文字と一致します。? ワイルドカードは検索語の途中または末尾にある 1 文字のみと一致します。

テキスト検索は大文字と小文字を区別しません。たとえば、Customer、customer、CUSTOMER の検索はすべて同じ結果を返します。

SearchGroup は省略可能です。これは検索する項目範囲です。指定しない場合、デフォルトの検索範囲は全項目です。SearchGroup は、次のいずれか値を取ります。

• ALL FIELDS
• NAME FIELDS
• EMAIL FIELDS
• PHONE FIELDS
• SIDEBAR FIELDS

ObjectsAndFields は省略可能です。これは検索結果で返す情報です。1 つ以上の sObject のリストに加え、各 sObject 内の 1 つ以上の項目のリストと省略可能な絞り込み基準項目です。指定されていない場合、検索結果には見つかったすべてのオブジェクトの ID が含まれます。

単語と語句

SearchQuery には、2 種類のテキストが含まれます。

• 単語 — test や hello などの 1 語。SearchQuery 内の単語は、スペース、句読点、および文字から数字 (またはその逆) への変更によって区切られます。単語では常に大文字と小文字は区別されません。
• 語句 — 二重引用符で囲まれた単語とスペースのコレクション ("john smith" など)。複数の単語を論理演算子およびグルーピング演算子と組み合わせて、より複雑なクエリを作成できます。

検索の例

SOSL の検索のしくみを知るために、さまざまな検索文字列を試し、サンプルデータに応じて出力がどのように変わるかを確認してみましょう。次の表は、さまざまな検索文字列の例とその SOSL 検索結果の一覧です。

SOSL Apex の例

次の例は、Apex で SOSL クエリを実行する方法を示します。この SOSL クエリでは、OR 論理演算子を使用して 2 つの検索語を組み合わせ、任意の項目内の Wingo または SFDC を検索します。サンプルのすべての取引先にいずれかの語が含まれる項目があるため、この例ではすべてのサンプル取引先が返されます。SOSL 検索結果はリストのリストで返されます。各リストには、返されたレコードの配列が含まれます。この場合、リストには 2 つの要素があります。インデックス 0 のリストには取引先の配列が含まれます。インデックス 1 のリストには取引先責任者の配列が含まれます。

開発者コンソールの [Execute Anonymous (匿名実行)] ウィンドウで、次のスニペットを実行します。次に、デバッグログを調査してすべてのレコードが返されたことを確認します。

List<List<sObject>> searchList = [FIND 'Wingo OR SFDC' IN ALL FIELDS 
                   RETURNING Account(Name),Contact(FirstName,LastName,Department)];
Account[] searchAccounts = (Account[])searchList[0];
Contact[] searchContacts = (Contact[])searchList[1];

System.debug('Found the following accounts.');
for (Account a : searchAccounts) {
    System.debug(a.Name);
}

System.debug('Found the following contacts.');
for (Contact c : searchContacts) {
    System.debug(c.LastName + ', ' + c.FirstName);
}

もうひとこと...

SOSL クエリで返された結果の絞り込み、並び替え、および制限ができます。SOSL クエリでは複数の sObject を返せるため、検索条件は RETURNING 句内部の各 sObject 内で適用されます。

オブジェクトの WHERE 句に条件を追加して、SOSL の結果を絞り込むことができます。たとえば、RETURNING Account(Name, Industry WHERE Industry='Apparel') では、業種が Apparel の取引先のみが返されます。

同様に、オブジェクトの ORDER BY 句を追加することで、1 つの sObject について結果の並び替えがサポートされます。たとえば、RETURNING Account(Name, Industry ORDER BY Name) 句では、返された取引先が名前項目で並び替えられます。

返されるレコード数をレコードのサブセットに制限できます。たとえば、RETURNING Account(Name, Industry LIMIT 10) では、返される取引先を 10 件のみに制限します。