ORDER BY

SELECT ステートメントで ORDER BY を使用して、クエリ結果の順序を制御できます。クエリで ORDER BY 句を使用しない場合、結果の順序は保証されません。構文は次のとおりです。

1[ORDER BY fieldOrderByList {ASC|DESC} [NULLS {FIRST|LAST}] ]

たとえば、次のクエリは Account レコードの名前をアルファベットの降順で並び替え、名前が null の取引先を最後に並び替えたクエリ結果を返します。

1SELECT Name
2FROM Account
3ORDER BY Name DESC NULLS LAST

次の要素が ORDER BY を使用して返される結果に影響します。

• 並び替えは大文字と小文字を区別しません。
• ORDER BY はリレーションクエリの構文と互換性があります。
• 複数の fieldExpression 句を使用した複数列の並び替えがサポートされています。
• ORDER BY 句で外部キーの値を使用したリレーションクエリの動作は、Lightning Platform API のバージョンによって異なります。ORDER BY 句でレコードの外部キーの値が null の場合、バージョン 13.0 以降ではレコードが返され、13.0 より前のバージョンではレコードが返されません。
  1SELECT Id, CaseNumber, Account.Id, Account.Name
  2FROM Case
  3ORDER BY Account.Name

  AccountId が空のケースレコードはバージョン 13.0 以降では返されます。
• 並び替え順は現在のユーザロケールによって決定されます。英語ロケールの場合、Salesforce は文字データの UTF-8 値に基づく並び替えメカニズムを使用します。アジアロケールの場合、Salesforce は ISO 14651 標準と Unicode 3.2 標準に基づく言語的並び替えメカニズムを使用します。

ORDER BY を使用する場合、データ型に次の制限事項が適用されます。

• 複数選択リスト、リッチテキストエリア、ロングテキストエリア、暗号化 (有効な場合)、およびデータカテゴリグループの参照 (Salesforce ナレッジが有効な場合) のデータ型はサポートされていません。
• その他すべてのデータ型はサポートされていますが、次の点に注意してください。
  • マスタ通貨は、使用可能な場合は常にマスタ通貨値を使用して並び替えられます。
  • phone データの特殊な書式は並び替えに含まれません。たとえば、ダッシュや括弧などの数値以外の文字は並び替えには含まれません。
  • picklist の並び替えは、設定時に決定された選択リストの並び替えで定義されます。

SELECT ステートメントで ORDER BY を省略可能な LIMIT 修飾子と共に使用できます。

1SELECT Name
2FROM Account
3WHERE industry = 'media'
4ORDER BY BillingPostalCode ASC NULLS LAST LIMIT 125