Bulkデータ読み取り(QUERY)処理(旧)

オペレーション名

Bulkデータ読み取り(QUERY)

機能概要

Bulk APIを使用したQUERY処理を行い、CSVファイルを作成します。

ジョブ作成、バッチ作成、バッチ結果の取得、ジョブのクローズまで一括で行います。

 

= 備考 =

本オペレーションが使用するAPI仕様については、コネクションリソースで選択したバージョンのAPIドキュメントを以下のリンク先ページより参照してください。

  • 「Salesforce Developer Documentation」-(https://developer.salesforce.com/docs)

    • Bulk API Developer's Guide

プロパティ

= 備考 =

変数の使用については、「変数」を参照してください。

基本設定

項目名

必須/省略可

変数の使用

説明

備考

名前

必須

使用不可

スクリプトキャンバス上での名前を入力します。

 

必須設定

項目名

必須/省略可

変数の使用

説明

備考

接続先

必須

使用不可

コネクションリソースを選択します。

[追加]

新規にコネクションリソースを追加します。

[一覧の編集]

> HULFT INTEGRATE > コネクションで、コネクションリソースの設定を編集することができます。

  • API 29.0以降のコネクションリソースが選択可能です。

SOQL

必須

使用可

実行するSOQL文を入力します。

  • Bulk API クエリでは、次のSOQLはサポートされていません。

    • COUNT

    • ROLLUP

    • SUM

    • GROUP BY CUBE

    • OFFSET

    • ネストされたSOQLクエリ

    • リレーション項目

    • Base64項目

ファイル

必須

使用可

CSV形式のファイルパスを入力します。

[参照]ボタンをクリックするとファイルチューザーが起動し、ファイルの選択ができます。

注意

エンコード

必須

使用可

書き込むファイルのエンコードを選択または入力します。

入力する場合は、Java SE Runtime Environment 8でサポートされているエンコードを指定します。

= 備考 =

詳細については、「Supported Encodings」(http://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html)を参照してください。

  • デフォルト値は「UTF-8」です。

改行コード

必須

使用不可

改行コードを選択します。

[CR]
[LF]
[CR+LF]

(デフォルト)

 

プロパティアクション

項目名

説明

備考

プレビュー

プレビューアを起動して、[ファイル]で指定したファイルの内容を表示します。

  • 指定したファイルが存在しない場合、または[ファイル]に変数が設定されている場合は無効になります。

  • [エンコード]で指定したエンコードで表示されます。

  • ファイル内容の編集はできません。

  • プレビューアで表示できるファイルのサイズは最大1MBです。ファイルサイズが1MBを超える場合、ファイルの先頭から1MB分が表示されます。

オプション設定

項目名

必須/省略可

変数の使用

説明

備考

同時実行モード

必須

使用不可

ジョブの同時実行モードを選択します。

[並列]

(デフォルト)

並列モードでジョブを作成します。

[順次]

順次モードでジョブを作成します。

注意

並列処理を行うと、データベースの競合が生じる可能性があります。競合が激しいと、読み込みが失敗することがあります。

順次モードを使用すれば、バッチは1つずつ確実に処理されます。ただし、このオプションを使用すると、読み込みの処理時間が大幅に増える場合があります。

監視開始までの待機時間(秒)

省略可

使用可

バッチ状況の監視を開始するまでの待機時間を、秒で入力します。

  • デフォルト値は「3」です。

  • [処理完了を待ちバッチ結果を取得する]にチェックを入れた場合のみ有効になります。

  • 3以上10800以下が指定可能です。範囲以外の値が指定された場合、エラーが発生します。

バッチ状況監視間隔(秒)

省略可

使用可

バッチ情報を取得し処理が完了しているか判断する間隔を、秒で入力します。

  • デフォルト値は「10」です。

  • [処理完了を待ちバッチ結果を取得する]にチェックを入れた場合のみ有効になります。

  • 10以上600以下が指定可能です。範囲以外の値が指定された場合、エラーが発生します。

最大監視時間(秒)

必須

使用不可

バッチ状況の最大監視時間を、秒で入力します。

  • デフォルト値は「14400」です。

  • [処理完了を待ちバッチ結果を取得する]にチェックを入れた場合のみ有効になります。

  • 1以上が指定可能です。範囲以外の値が指定された場合、エラーが発生します。

コメント

項目名

必須/省略可

変数の使用

説明

備考

コメント

省略可

使用不可

このコネクターの簡単な説明を記述することができます。

 

スキーマ

入力スキーマ

ありません。

出力スキーマ

ありません。

大容量データ処理

大容量データ処理に対応していません。

トランザクション

トランザクションをサポートしています。

 

[トランザクション][トランザクション処理を行う]にチェックを入れた場合のみトランザクションは有効になります。

PSPでの使用について

PSPでは使用できません。

使用できるコンポーネント変数

コンポーネント変数名

説明

備考

job_id

作成したジョブのIDが格納されます。

  • デフォルト値はnullです。

batch_id

作成したバッチのIDが格納されます。

  • デフォルト値はnullです。

number_records_processed

バッチの処理済みレコード件数が格納されます。

  • デフォルト値はnullです。

number_records_failed

バッチで正常に処理されなかったレコード件数が格納されます。

  • デフォルト値はnullです。

created_date

バッチの開始時刻が格納されます。

  • デフォルト値はnullです。

state

バッチの状況が格納されます。

  • デフォルト値はnullです。

state_message

バッチの状態メッセージが格納されます。

  • デフォルト値はnullです。

apex_processing_time

バッチに関連するトリガおよび他のプロセスの処理時間(ミリ秒)が格納されます。

  • デフォルト値はnullです。

api_active_processing_time

バッチの処理時間(ミリ秒)が格納されます。

バッチがキューで処理を待機している時間や、逐次化および並列化に要する時間は含まれません。

  • デフォルト値はnullです。

total_processing_time

バッチの合計処理時間(ミリ秒)が格納されます。

バッチがキューで処理を待機している時間は含まれません。

  • デフォルト値はnullです。

system_modstamp

バッチのシステム時刻が格納されます。

  • デフォルト値はnullです。

queryResultCount

サーバーに作成されたファイルの件数が格納されます。

  • デフォルト値はnullです。

server_url

ログイン後のエンドポイントURLが格納されます。

  • デフォルト値はnullです。

session_id

セッションIDが格納されます。

  • デフォルト値はnullです。

message_category

エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。

  • デフォルト値はnullです。

message_code

エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。

  • デフォルト値はnullです。

message_level

エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。

  • デフォルト値はnullです。

operation_api_exception_code

APIエラー発生時、発生したエラーのExceptionCodeが格納されます。

  • デフォルト値はnullです。

  • APIエラー以外のエラー発生時は、値が格納されません。

operation_error_message

エラー発生時、発生したエラーのメッセージが格納されます。

  • デフォルト値はnullです。

operation_error_trace

エラー発生時、発生したエラーのトレース情報が格納されます。

  • デフォルト値はnullです。

メッセージコード、例外メッセージ、制限事項

コネクター

メッセージコード

エラーメッセージ

制限事項

Salesforce(旧) コネクターのメッセージおよび制限事項

check

check

check