オブジェクトに対する 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 の長さに応じて異なります。

• クエリで 1 つ以上の主キー ID を指定する場合を除き、必ず PublishStatus の値は 1 つだけ指定します。セキュリティをサポートするために、PublishStatus の値が Draft の記事は「記事の管理」権限を持つユーザにのみ表示されます。
• アーカイブ済み記事のバージョンは、articletype_kav オブジェクトに保存されます。アーカイブ済み記事のバージョンを照会するには、記事の Id を指定し、IsLatestVersion='0' を設定します。
• 必ず Language の値は 1 つだけ指定します。ただし、SOQL では、Id または KnowledgeArticleId に対する条件がある場合、複数の Language を指定できます。

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