SOQL FAQ ​

SOQLは、Salesforceデータから特定のレコードを検索するために使用されるクエリ言語です。 SQLに似ていますが、Salesforceデータのクエリ用に特別に設計されており、Salesforceオブジェクトに保存されているデータをユーザーが選択、フィルタリング、並べ替えできます。

SOQLクエリの基本構文には、フィールドを指定するSELECTステートメント、オブジェクトを定義するFROMステートメント、およびフィルタリング条件と並べ替えのための任意のWHEREステートメントが含まれます。

SOQLでは、WHERE句を使用して、特定の条件に基づいてレコードをフィルタリングします。 構文はfieldExpression形式に従います。例:

<fieldName> <comparisonOperator> <value>

SOQLには、次のような比較演算子が含まれます。

• =
• !=
• <
• <=
• >
• >=
• LIKE
• IN
• NOT IN
• INCLUDES
• EXCLUDES

各演算子は、フィールド値をさまざまな方法で比較するために使用されます。

AND、OR、NOTなどの論理演算子を使用して、SOQLクエリ内の複数のフィールド式を結合できます。 これらの演算子は、WHERE句で複数の条件を組み合わせるために役立ちます。

LIMIT句は、クエリで返されるレコード数を制限します。一方、OFFSETは、結果の返却を開始する前に指定した数のレコードをスキップします。 両方の句の最大値は2,000です。

SOQLの日付クエリは、YYYY-MM-DD形式にする必要があります。 dateTimeフィールドでは、YYYY-MM-DDThh:mm:ss+hh:mm、YYYY-MM-DDThh:mm:ss-hh:mm、YYYY-MM-DDThh:mm:ssZなどの形式が使用されます。 日付またはdateTime値を囲む一重引用符は不要です。

SOQLはSalesforceのトリガーとアクションで使用でき、Workato UIで指定されたフィールドに基づいてクエリを設定できます。 Workatoでは、スケジュール済みレコード検索やレコード検索アクションで一般的に使用されます。

Workatoで完全なSOQLクエリを使用するには、トリガーまたはアクションを設定するときに、SOQL Queryフィールドに完全なSOQLクエリを入力し、正しい構文と形式に従っていることを確認します。

SOQLクエリの最大長は16,000文字です。

Salesforceアクションで2,000件のレコード制限を管理するには、ページネーションを実装する必要があります。 ページネーションにより、データを管理しやすいチャンクに分割できます。 これは、ループ内でLIMITおよびOFFSETフィールドを使用することで実現できます。

• 各バッチで取得するレコード数を定義するには、LIMITを使用します。
• 各バッチの開始位置を指定するには、OFFSETを使用します。

詳細については、Salesforceドキュメントのページネーションを参照してください。

Workatoでアーカイブ済みまたは削除済みのレコードを取得するには、SOQLクエリでIsDeleted = trueを設定します。

SELECT IsDeleted, Name, Id FROM Contact WHERE IsDeleted = true

"Include deleted"オプションが"Yes"に設定されていることを確認してください。

アーカイブ済みまたは削除済みのレコードを取得