DataWorks:Salesforce データソース

データ型

コードエディターでのデータ型

address

STRING

anyType

STRING

base64

BYTES

boolean

BOOL

combobox

STRING

complexvalue

STRING

currency

DOUBLE

date

DATE

datetime

DATE

double

DOUBLE

email

STRING

encryptedstring

STRING

id

STRING

int

LONG

json

STRING

long

LONG

multipicklist

STRING

percent

DOUBLE

phone

STRING

picklist

STRING

reference

STRING

string

STRING

textarea

STRING

time

DATE

url

STRING

geolocation

STRING

パラメーター

必須

説明

デフォルト値

datasource

はい

データソースの名前。追加されたデータソースの名前と同じである必要があります。コードエディターを使用してデータソースを追加できます。

デフォルト値なし

serviceType

いいえ

同期モード。有効な値:

• sobject: Salesforce オブジェクトをクエリします。

• query: SOQL ステートメントを実行してデータをクエリします。

• bulk1: Salesforce Bulk API 1.0 を使用して Salesforce オブジェクトをクエリします。

• bulk2: Salesforce Bulk API 2.0 を使用して Salesforce オブジェクトをクエリします。

  重要

  • bulk1 モードと bulk2 モードは、住所や地理位置情報データ型などの複合データ型の列をサポートしていません。

  • bulk2 モードは、分散タスクをサポートしていません。

  • 場合によっては、bulk1 はクエリのパフォーマンスで bulk2 よりも優れています。Salesforce オブジェクトに基づいてクエリのパフォーマンスをテストし、ビジネス要件に基づいて同期モードを選択できます。

sobject

table

はい

Salesforce オブジェクト (Account、Case、Group など)。オブジェクトはテーブルに相当します。 serviceType パラメーターを sobject、bulk1、または bulk2 に設定した場合、このパラメーターは必須です。

デフォルト値なし

beginDateTime

いいえ

• データ消費の開始時刻と終了時刻。 serviceType パラメーターを sobject、bulk1、または bulk2 に設定した場合、これらのパラメーターは必須です。

• Salesforce オブジェクトの最終変更時刻に基づいてデータをフィルタリングする場合、オブジェクトの変更に関連する時刻フィールドは、SystemModstamp > LastModifiedDate > CreatedDate の順序でクエリされます。

• 時間範囲は左閉区間、右開区間です。

• 時刻の形式は yyyymmddhhmmss です。DataWorks のスケジューリングパラメーターと一緒にこれらのパラメーターを使用して、増分データを読み取ることができます。

デフォルト値なし

endDateTime

いいえ

デフォルト値なし

splitPk

いいえ

• データシャーディングに使用されるフィールド。 serviceType パラメーターを sobject に設定した場合、このパラメーターは必須です。

• このパラメーターを設定すると、ソースオブジェクトはこのパラメーターの値に基づいてシャーディングされます。データ統合は並列スレッドを実行してデータを読み取ります。これにより、データの同期をより効率的に行うことができます。

• このパラメーターは、datetime、int、または long データ型のフィールドに設定できます。他の型のフィールドの場合は、エラーが報告されます。

デフォルト値なし

blockCompoundColumn

いいえ

複合データ型のカラムをサポートするかどうかを指定します。 serviceType パラメーターを bulk1 または bulk2 に設定した場合、このパラメーターは必須です。有効な値:

• true: 複合データ型のカラムが存在する場合、タスクは失敗し、複合データ型のカラムマッピングを削除した後に再実行する必要があります。

• false: 複合データ型のカラムのデータは NULL 値として読み取られます。

true

bulkQueryJobTimeoutSeconds

いいえ

• バッチデータを準備するためのタイムアウト期間。単位: 秒。 serviceType パラメーターを bulk1 または bulk2 に設定した場合、このパラメーターは必須です。

• Salesforce Reader がデータの読み取りを開始する前に、Salesforce サーバーはバッチデータを準備するためのタスクを実行します。タスクの実行時間が指定されたタイムアウト期間を超えると、タスクはタイムアウトして失敗します。

86400

batchSize

いいえ

• 一度にダウンロードするデータレコードの数。 serviceType パラメーターを bulk1 または bulk2 に設定した場合、このパラメーターは必須です。

• 最適なダウンロードパフォーマンスを実現するには、このパラメーターを Salesforce のバッチデータ準備タスクの自動シャーディングの値よりわずかに大きい値に設定します。

• データはストリーミングモードでダウンロードされます。したがって、このパラメーターの値を大きくしても、より多くのメモリを占有することはありません。

• このパラメーターは高度なパラメーターであり、コードエディターでのみ使用できます。

300000

where

いいえ

• WHERE 句。 serviceType パラメーターを sobject、bulk1、または bulk2 に設定した場合、このパラメーターは必須です。

• 実際のビジネスシナリオでは、WHERE 句を指定してデータをフィルタリングできます (例: Name != 'Aliyun')。

• where パラメーターが指定されていないか空の場合、Salesforce Reader はすべてのデータを読み取ります。

• where パラメーターを limit 10 に設定しないでください。これは、SOQL WHERE 句に対する Salesforce の制約に適合しません。

デフォルト値なし

query

いいえ

• 絞り込んだデータフィルタリングに使用するクエリステートメント。 serviceType パラメーターを query に設定した場合、このパラメーターは必須です。

• このパラメーターを設定すると、データ統合はこのパラメーターの値に基づいてデータをフィルタリングします。さらに、Salesforce Reader は、設定した table、column、beginDateTime、endDateTime、where、および splitPk パラメーターを無視します。例: select Id, Name, IsDeleted from Account where Name! ='Aliyun'。

• このパラメーターは高度なパラメーターであり、コードエディターでのみ使用できます。

デフォルト値なし

queryAll

いいえ

• すべてのデータをクエリするために使用される SQL ステートメント。 serviceType パラメーターを sobject または query に設定した場合、このパラメーターは必須です。

• このパラメーターを true に設定すると、削除されたデータを含むすべてのデータがクエリされます。 IsDeleted フィールドを使用して、データレコードが削除されているかどうかを判断できます。

false

column

はい

同期するカラムの名前。JSON 配列で名前を指定します。

• すべてまたは一部のカラムからデータを読み取ることができます。

• カラムの順序を変更できます。これは、ソーステーブルのスキーマで指定された順序とは異なる順序でカラムを指定できることを意味します。

• 定数がサポートされています。例:

  [
    {
      "name": "Id",
      "type": "STRING"
    },
    {
      "name": "Name",
      "type": "STRING"
    },
    {
      "name": "'123'",
      "type": "LONG"
    },
    {
      "name": "'abc'",
      "type": "STRING"
    }
  ]

  説明

  • Id と Name: カラム名。

  • '123': 整数定数。シングルクォーテーション (') で囲みます。

  • 'abc': 文字列定数。シングルクォーテーション (') で囲みます。

• column パラメーターでは、データを読み取るすべてのカラムを明示的に指定する必要があります。このパラメーターを空にすることはできません。

デフォルト値なし

connectTimeoutSeconds

いいえ

• HTTPリクエストのタイムアウト期間。単位: 秒。指定されたタイムアウト期間を超えると、タスクは失敗します。

• このパラメーターは高度なパラメーターであり、コードエディターでのみ使用できます。

30

socketTimeoutSeconds

いいえ

• HTTP レスポンスのタイムアウト期間。単位: 秒。2 つのパケットの間隔が指定されたタイムアウト期間より大きい場合、タスクは失敗します。

• このパラメーターは高度なパラメーターであり、コードエディターでのみ使用できます。

600

retryIntervalSeconds

いいえ

• 再試行間隔。単位: 秒。

• このパラメーターは高度なパラメーターであり、コードエディターでのみ使用できます。

60

retryTimes

いいえ

• 再試行回数。

• このパラメーターは高度なパラメーターであり、コードエディターでのみ使用できます。

3