オブジェクトに対する 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 は、並び替えられる項目が選択済みの項目の場合にのみ使用できます。
• メタデータリレーション項目では、すべての標準リレーションクエリがサポートされています。

• 外部オブジェクトが含まれるサブクエリが取得できるデータは、最大 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 のリスト]