Openflow Connector for Salesforce Bulk API:Salesforce式フィールド¶

式ビューの仕組み¶

:ui:`Enable Views Creation`が``true``に設定されている場合、コネクタは数式フィールドを持つオブジェクトごとに以下を実行します。

1. Describe APIを介して、Salesforceオブジェクトのメタデータから数式を取得します。

2. 各数式を解析し、同等のSnowflake SQLに変換します。

3. ベーステーブルの非数式列と、計算列として変換された数式を組み合わせた``CREATE OR REPLACE VIEW``ステートメントを生成します。

4. Snowflakeに対してDDLを実行し、ビューを作成または更新します。

結果のビューの名前は``<Object Type>_FORMULA_VW``になります。たとえば、``Account``オブジェクトは``ACCOUNT_FORMULA_VW``という名前のビューを生成します。このビューをクエリして、複製されたデータと一緒に式フィールド値を取得できます。

ビューは、コネクタがソースオブジェクトのスキーマ変更を検出するたびに自動的に更新されるため、式の定義が確実にSalesforceと同期するようになります。

クロスオブジェクト式フィールド¶

Salesforceの式は、関係の走査を使用して関連オブジェクトのフィールドを参照できます（例: Account.Owner.Name）。コネクタは、ビュー定義に``LEFT JOIN``句を生成することで、これらのクロスオブジェクト参照をサポートします。各関係の走査は、Snowflakeの対応する関連テーブルへの結合を生成します。

クロスオブジェクト式を正しく動作させるには、関連するオブジェクトもコネクタによって複製される必要があります。コネクタは、変換時に参照テーブルがSnowflakeに存在するかどうかを確認しません。関連するオブジェクトが同期されていない場合、生成された``CREATE OR REPLACE VIEW``ステートメントはSnowflakeに存在しないテーブルを参照し、ビューの作成は失敗します。これを解決するには、式フィールドが参照するすべての関連オブジェクトが:ui:`Filter`パラメーターに含まれていることを確認してください。参照されるテーブルが存在するようになった後、次のコネクタの実行時にビューが自動的に再作成されます。

式ビューの列コメント¶

生成されたビューの各数式列には、SQL ``COMMENT``アノテーションが含まれます。

• 変換が成功した式の場合、コメントには元のSalesforce数式が含まれます。

• 変換できなかった式の場合、コメントには失敗理由コードが含まれます。

Snowflakeで``DESCRIBE VIEW <view_name>``を実行することで、これらのコメントを確認できます。

サポートされている式関数¶

次のSalesforce式関数は、同等のSnowflake SQLに変換されます。

関数に加えて、次の演算子がサポートされています。

• 算術: +、-、*、/、``^``（指数は``POWER``に変換）

• 比較: =、==、!=、<>、<、<=、>、>=

• 論理: AND、OR、&&、||

• 文字列の結合: ``&``（``COALESCE``のnull処理を使用して``||``に変換）

• 単項: -``（否定）、``NOT

サポートされていない式の構成要素¶

式における以下の構成要素はまだサポートされていません。関数と構成要素の追加サポートは、将来のリリースで追加される予定です。式がこれらのいずれかを使用する場合、ビューの対応する列は``NULL``を返し、列のコメントは失敗の理由を示します。