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

• fieldList および conditionExpression にメタデータリレーション項目を使用できます。
• FROM に追加できるのは 1 つのオブジェクトのみです。
• 次の演算子を使用できます。
  • IN および NOT IN
  • =、>、>=、<、<=、および !=
  • LIKE (ワイルドカードを含む)
  • AND
  • LIKE 演算子および = 演算子がある同じ列にある場合は OR

    子検索条件が異なる 2 つの列にある場合、OR を複合検索条件として使用することはできません。

    メモ

• リレーション以外の項目にのみ ORDER BY を使用できます。
• リレーション以外の複数の項目で ORDER BY、ASC、および DESC を使用できます。
• メタデータリレーション項目では、すべての標準リレーションクエリがサポートされています。

• 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 句

• 最良の結果を得るには、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 ステートメントでは、コンパイルエラーが発生します。

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

• ログインしたユーザに「すべてのデータの参照」権限がある場合、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 のリスト]