オブジェクトに対する SOQL の制限

1SELECT fieldList [...]
2FROM objectType
3    [USING SCOPE filterScope]
4[WHERE conditionExpression]
5[ORDER BY field {ASC|DESC} [NULLS {FIRST|LAST}] ]

• fieldList および conditionExpression にメタデータリレーション項目を使用できます。
• FROM に追加できるのは 1 つのオブジェクトのみです。
• 次の演算子を使用できます。
  • IN および NOT IN
  • =、>、>=、<、<=、および !=
  • LIKE (ワイルドカードを含む)
  • AND
• リレーション以外の項目にのみ ORDER BY を使用できます。
• リレーション以外の複数の項目で ORDER BY、ASC、および DESC を使用できます。
• ORDER BY は、並び替えられる項目が選択済みの項目の場合にのみ使用できます。
• メタデータリレーション項目では、すべての標準リレーションクエリがサポートされています。

• SOQL クエリは、Big Object のインデックスに定義された順序で欠落のない項目でのみ絞り込むことができます。
• クエリの最後の項目では次の演算子のみを使用できます。
  • =、<、>、<=、>=、および IN
  • クエリのそれより前の項目では = 演算子のみを使用できます。
• Big Object では、次の演算子はサポートされていません。
  • !=、LIKE、NOT IN、EXCLUDES、および INCLUDES

• 外部オブジェクトが含まれるサブクエリが取得できるデータは、最大 1,000 行です。
• 各 SOQL クエリ内の結合は、外部オブジェクトとその他の種別のオブジェクト全体で最大 4 個です。

  クエリの実行時、結合ごとに外部システムへの往復処理が必要です。クエリ内の各結合に対して長めの応答時間を想定してください。

• 外部オブジェクトでは、次の集計関数と句をサポートしていません。
  • AVG() 関数
  • COUNT(fieldName) 関数 (ただし、COUNT() はサポートされている)
  • HAVING 句
  • GROUP BY 句
  • MAX() 関数
  • MIN() 関数
  • SUM() 関数
• 外部オブジェクトでは、以下もサポートしていません。
  • EXCLUDES 演算子
  • FOR VIEW 句
  • FOR REFERENCE 句
  • INCLUDES 演算子
  • LIKE 演算子
  • toLabel() 関数
  • TYPEOF 句
  • WITH 句

次の制限は、SecureAgent を使用する SharePoint 2010/2013 の外部のデータソースに関連付けられている外部オブジェクトにのみ適用されます。

• 外部オブジェクトの SOQL クエリでは、IN 句で ID が約 15 個よりも多いと、エラー「この操作はセキュアエージェントには複雑すぎます」が返されます。IN 句の正確な制限は、SharePoint ID の長さに応じて異なります。

• 最良の結果を得るには、PublishStatus の 1 つの値で絞り込みます。各記事のすべてのバージョンを検索するには、PublishStatus フィルタを省略し、1 つ以上のプライマリキー ID で絞り込みます。特定の記事のすべてのアーカイブバージョンを取得するには、SOQL フィルタで IsLatestVersion を false に設定します。
• API バージョン 46.0 以前の場合、デフォルトでは、クエリの実行時に PublishStatus で絞り込まないと、公開記事が返されます。API バージョン 47.0 以降の場合、Lightning Knowledge が有効のときは、ドラフト記事、公開記事、およびアーカイブ済み記事が返されます。
• セキュリティをサポートするために、PublishStatus 値が Draft の記事は「ドラフト記事の表示」権限を持つユーザにのみ表示されます。同様に、PublishStatus 値が Archived の記事は「アーカイブ済み記事の表示」権限を持つユーザにのみ表示されます。
• アーカイブ済み記事のバージョン���、Knowledge__kav オブジェクトに保存されます。アーカイブ済み記事のバージョンを照会するには、記事の Id を指定し、IsLatestVersion='0' を設定します。
• KnowledgeArticleVersion オブジェクトでは、Apex SOQL ステートメントでバインド変数を使用できません。たとえば、次の SOQL ステートメントでは、コンパイルエラーが発生します。
  1final String PUBLISH_STATUS_ONLINE = 'Online';
  2List<Knowledge__kav> articles = [ 
  3SELECT Id FROM Knowledge__kav 
  4WHERE PublishStatus = :PUBLISH_STATUS_ONLINE 
  5];

  代わりに、次の動的 SOQL を使用します。『Apex 開発者ガイド』の「動的 SOQL」を参照してください。

  1final String PUBLISH_STATUS_ONLINE = 'Online'; 
  2final String q = 'SELECT Id, PublishStatus FROM Knowledge__kav 
  3WHERE PublishStatus = :PUBLISH_STATUS_ONLINE';
  4List<Knowledge__kav> articles = Database.query(q);

• ログインしたユーザに「すべてのデータの参照」権限がある場合、SOQL の制限はありません。この権限がない場合は、LIMIT 句に 1,000 レコード以下を指定してください。
• リレーションを使用する項目に対して SOQL ORDER BY は使用できません。SOQL クエリでは、ORDER BY はルートオブジェクトの項目に対して使用してください。

• 必ず『SOAP API 開発者ガイド』で指定されたクエリ形式を使用してください。
• ORDER BY 句を含めることができます。SELECT HasAccess の場合は ORDER BY HasAccess、SELECT MaxAccessLevel の場合は ORDER BY MaxAccessLevel を使用する必要があります。
• クエリ可能な最大レコード数は 200 件です。

• ログインしたユーザに「すべてのデータの参照」権限がある場合、SOQL の制限はありません。この権限がない場合は、LIMIT 句に 1,000 レコード以下を指定してください。
• リレーションを使用する項目に対して SOQL ORDER BY は使用できません。SOQL クエリでは、ORDER BY はルートオブジェクトの項目に対して使用してください。

また、SOQL クエリには WITH UserId = {userId] を含める必要があります。

• ParentId = [単一の ID]
• Parent.Type = [単一型]
• Id = [単一の ID]
• Id IN = [ID のリスト]