Salesforce
SOQL クエリーの結果から GCS にファイル作成
概要
このブロックは、Salesforce の SOQL クエリーを実行して、その結果を Google Cloud Storage（GCS）上にファイル出力します。出力するファイルの形式は、CSV です。
このブロックを利用すると、「SOQL クエリーの実行」ブロックでは、処理できない大量なデータの取得が可能です。
プロパティ
| プロパティ名 | 説明 |
|---|---|
| ブロック名 | ブロックの名前を指定します。ブロックに表示されます。 |
| アカウント |
Salesforce アカウントを選択します。 info_outline Salesforce アカウントは、あらかじめフローデザイナーの設定の Salesforce アカウントで設定を済ませておく必要があります。 |
| SOQL クエリー |
Salesforce の SOQL クエリーを指定します。 ［変数展開の指定が可能］［% 形式の文字列書式の指定が可能］
|
| Sandbox | SOQL クエリーの実行先となる Salesforce が Sandbox 環境かどうかを指定します。 |
| CSV ファイルのカラム区切り文字 |
CSV ファイルのカラムごとの区切り文字を以下から選択します。
|
| CSV ファイルの行末区切り文字 |
CSV ファイルの行ごとの区切り文字を以下から選択します。
|
| GCP サービスアカウント |
出力先の GCS へアクセス可能な GCP サービスアカウントを選択します。 |
| コピー先の GCS の URL |
SOQL クエリー結果を出力する GCS 上の CSV ファイルへの GCS URL を指定します。 指定した GCS URL にフィルが既に存在する場合は、ファイルの出力に失敗します。ファイルを上書きしたい場合は、［GCS にファイルが存在する場合に上書き］プロパティのチェックボックスにチェックを付けてください。 ［変数展開の指定が可能］［% 形式の文字列書式の指定が可能］
|
| GCS にファイルが存在する場合に上書き | ［コピー先の GCS の URL］上のファイルを上書きしたい場合は、チェックボックスにチェックを付けます。 |
| ブロックメモ | ブロックに対するコメントを指定します。 |
| Salesforce のジョブのタイムアウト時間 |
SOQL クエリーを実行して応答が返ってくるまでの待ち時間を指定します。 指定可能な値は、60 以上の整数です。 |
| Salesforce から 1 回で取得する結果の最大レコード数 |
このプロパティでは、SOQL クエリー結果を何回に分けて取得するかを指定します。SOQL クエリー結果を複数回に分けて取得することで、メモリー使用量を抑えて大量のレコードが扱えるようになります。 指定可能な値は、1 以上 1000000 以下です。 |
| Salesforce の結果取得の最大リトライ回数 |
SOQL クエリーの取得の際にエラーとなった場合、最大何回までリトライするかを指定します。 ［Salesforce から 1 回で取得する結果の最大レコード数］によって複数回に分けてクエリーを発行する場合、そのクエリーごとの最大リトライ回数となります。 指定可能な値は、0 以上の整数です。 |
| GCS へのアップロードの最大リトライ回数 |
SOQL クエリー取得結果から GCS 上のファイルへ出力する際にエラーとなった場合、最大何回までリトライするかを指定します。 ［Salesforce から 1 回で取得する結果の最大レコード数］によって複数回に分けてクエリーを発行する場合、そのクエリーごとの最大リトライ回数となります（クエリー単位でファイル出力しています）。 指定可能な値は、0 以上の整数です。 |
| API バージョン |
このブロックで使用する API のバージョンを 47.0 以降で指定します（このブロックでは、Salesforce が提供する API 経由で SOQL クエリーを実行しています）。 API のバージョンによって、使用できるクエリーの文法や関数が異なる可能性があります。 自身の環境で使用できる API バージョンについては、Salesforce の Edition および API バージョンを確認する方法 open_in_new を参照してください。 |