この記事の目次
SalesforceにおけるQueryとは？
SalesforceにおけるQueryは、指定のオブジェクトに対して、クエリを実行し、指定の条件に一致するデータを返すものです。
「query() コール」を使うことで、オブジェクトからデータを取得することができます。
クライアントアプリケーションが「query() コール」を呼び出す際に、照会するオブジェクトを指定する「クエリ式」、「取得する項目」、「特定のオブジェクトが該当するかどうかを判断する条件」を渡すようになっています。
例）
QueryResult = connection.query(string queryString);使用方法について
Queryは呼び出し時、クエリレスポンスオブジェクトをクライアントアプリケーションに返します。 「query() コール」で呼び出すと、APIは特定のオブジェクトに対してクエリを実行、API上のクエリ結果をキャッシュします。そして、クエリレスポンスオブジェクトをクライアントアプリケーションに返すのです。 クライアントアプリケーションはクエリレスポンスの行を通して繰り返し実行し、情報を取得することを目的とし、クエリレスポンスオブジェクト上のメソッドを使うことができます。 「Enterprise WSDL」を使っているときは、選択リストへのデータ入力について、「describe」を使ってはいけません。 実行後にシステム管理者が、SObjectに項目を追加する場合、「describe コール」は項目をプルダウンしますが、ツールキットではシリアライズを処理できませんので、インテグレーションは失敗します。Queryとアーカイブ
アーカイブされているかどうかに関係なく、全てのToDoと行動のレコード上において、「queryAll()」でクエリを実行することができます。 アーカイブ済みのオブジェクトだけを検索する方法は、「isArchived 項目」を絞り込みに利用することです。query() は「isArchived」が「true」に設定されているとき、全レコードを自動的に除外します。そのため、query()が使えません。 クエリ結果のオブジェクトについては、デフォルトで500行までのデータが含まれます。 クエリ結果が500行を超えた場合、クライアントアプリケーションは「queryMore() コール」とサーバ側のカーソルを使うことで、追加の行を500行のチャンクで取得することができ、「QueryOptions ヘッダー」のデフォルトサイズを2,000行まで増やせます。タイムアウト
処理が2分以上経過したQueryはタイムアウトします。 タイムアウトしたQueryについては、APIは「InvalidQueryLocatorFault」の「API 失敗エラー要素」を返してきます。タイムアウトが発生した場合、より少量のデータをスキャン、もしくはクエリを再構成します。 型が「Base64」の項目について照会する際、クエリレスポンスオブジェクトは、一度で1つのレコードだけしか返しません。「query() コール」のバッチサイズを変更したとしても変更することはできません。動的SOQLでのQueryの使用
Salesforceにおける動的SOQLでのQueryの使用方法について説明します。 動的SOQLは、「Apex コード」を使って、実行時にSOQL文字列の作成を参照しています。動的SOQLがあることで、柔軟なアプリケーションの作成ができるのです。たとえば、エンドユーザの入力に基づいた検索の作成や、さまざまな項目名のレコードの更新といったことができます。 動的SOQL結果は、「Account」や「MyCustomObject__c」、「汎用 sObject データ型」などのように、具体的な「sObject」として指定することができます。クエリが正しい「sObject データ型」を返さなかった場合は、ランタイムエラーが発生します。 例）sObject s = Database.query(string_limit_1);
List sobjList = Database.query(string); 
