マッピングおよびマッピングタスクのルールとガイドライン

一般的なルールとガイドライン

• - 既存のマッピングでMicrosoft Azure Synapse SQL接続のストレージタイプを変更する場合は、そのマッピングを更新するか、新しいマッピングを作成して、更新されたストレージタイプのソースおよびターゲットプロパティを表示する必要があります。
• - Microsoft Azure Data Lake Storage Gen2またはMicrosoft Azure Blob Storageを使用して、Microsoft Azure Synapse SQLマッピングでファイルをステージングする場合は、次のガイドラインを考慮してください。
• ▪ Microsoft Azure Synapse SQL接続を使用するすべてのマッピングの接続レベルで、Microsoft Azure Data Lake Storage Gen2のファイルシステム名とMicrosoft Azure Blob Storageのコンテナ名を指定できます。接続で指定されたファイルシステム名とコンテナ名は、ソースまたはターゲットの詳細プロパティから上書きできます。
• ▪ ファイルシステム名とコンテナ名は、接続か、ソースまたはターゲットの詳細プロパティで指定する必要があります。両方の場所で指定した場合、Secure Agentでは詳細プロパティで指定した値が考慮されます。
• - Microsoft Azure Data Lake Storage Gen2を使用して、Microsoft Azure Synapse SQLマッピングでファイルをステージングする場合は、次のガイドラインを考慮してください。
• ▪ Microsoft Azure Data Lake Storage Gen2のマネージドID認証を使用してファイルをステージングできるのは、マッピングを実行してMicrosoft Azure Synapse SQLソースまたはMicrosoft Azure Data Lake Storage Gen2ソースからデータを読み取る場合のみです。
• ▪ システム割り当てIDのオブジェクトIDがAzure portalでリセットされた場合は、ユーザーを削除して再作成する必要があります。
• - ロールベースのアクセス制御またはアクセス制御リストを使用して、Microsoft Azure Data Lake Storage Gen2のストレージアカウントへのアクセスを認証できます。ロールベースのアクセス制御またはアクセス制御リストとマネージドID認証を併用する場合は、次のルールとガイドラインを考慮してください。
• ▪ 同じストレージアカウントに対して、ロールベースのアクセス制御とアクセス制御リストの両方を使用することはできません。
• ▪ アクセス制御リストを使用する場合は、ファイルシステムにアクセスするために、Microsoft Azure Synapse SQLに読み取り、書き込み、および実行の権限を割り当てます。
• ▪ ファイルシステムにアクセスするために、Microsoft SQL Serverに読み取り、書き込み、および実行の権限を割り当てます。
• ▪ システム割り当てIDを有効にする場合は、マッピングとタスクを実行するために必要なロールまたは権限をAzure仮想マシンに割り当てます。
ユーザー割り当てIDを有効にする場合は、マッピングとタスクを実行するために必要なロールまたは権限をAzure仮想マシンとユーザー割り当てIDに割り当てます。
• - 大文字と小文字が区別されるMicrosoft Azure Synapse SQLのデータベースへの接続時に、マッピングで複数のソースまたはターゲットを使用している場合、それらのソースとターゲットが同じ名前ではないことを確認します。
• - 外部データソースを指定すると、外部データソースが使用するコンテナまたはファイルシステムがデータのステージングに使用されます。接続プロパティまたは詳細プロパティで指定されたコンテナまたはファイルシステムは、データのステージング用とは見なされません。
• - セッションログ内のセッションロード要約が各コミット間隔でキャプチャされません。
• - ODBC接続を使用してMicrosoft Azure Synapse SQLに接続する場合は、実行前SQLクエリまたは実行後SQLクエリでMERGEステートメントを使用しないでください。使用すると、マッピングタスクは失敗します。
• - ソースフィールドが空の場合、Secure Agentは空の値をターゲットにNULLとして書き込みます。
• - $$$SESSSTARTTIME変数をSQLクエリで使用すると、変数はセッションの開始時刻を文字列値として返します。
次の構文を使用して、文字列値を日時に変換します。
SELECT CAST(CONVERT(VARCHAR,SUBSTRING('$$$SESSSTARTTIME',0,20),113) as datetime)
次の構文を使用して、文字列値を日付に変換します。
SELECT CAST(CONVERT(VARCHAR,SUBSTRING('$$$SESSSTARTTIME',0,20),113) as date)
• - Uniqueidentifierフィールドに対してカスタムクエリ、SQLオーバーライド、または更新オーバーライドを使用する場合は、Uniqueidentifierデータ型を文字列データ型に変換する必要があります。そうしないと、マッピングが失敗します。
例えば、Select * from uid.NEWID_TEST2;を使用すると、マッピングは失敗します。
次のSQLクエリを使用してください。
Select CONVERT(CHAR(36),ID) AS ID, TESTCOLUMN from uid.NEWID_TEST2;
• - 時刻フィールドにカスタムクエリを使用し、ステージングファイル形式として［Parquet］を選択している場合は、Timeデータ型をncharデータ型に変換する必要があります。そうしないと、マッピングが失敗します。
例えば、CONVERT(nchar(16),[TIME]) AS [TIME] FROM [AzureDW_DIatScale].[TimeNUUID];を選択します。
• - floatまたはrealデータ型を書き込むマッピングを実行した場合、ソースデータとターゲットデータが一致しないことがあります。ターゲットに書き込まれる値は近似値であり、ソースの値と同一ではありません。正確な値が書き込まれるようにするには、numericデータ型またはdecimalデータ型を使用してrealデータ型とfloatデータ型をマッピングします。
• - ソースフィルタまたはキャッシュを使用しないルックアップでIS NULL演算子とIS NOT NULL演算子を使用するには、Secure AgentのプロパティのDTMタイプで次のプロパティをJVMオプションとして設定します:
-DENABLE_NULL_FLAG_FOR_UNCACHED_LOOKUP=true
• - IS NULLまたはIS NOT NULL演算子を使用してフィルタ条件［パラメータを使用しません］を定義すると、マッピングは次のエラーで失敗します:
• ▪ Operation failed: Invalid expression string for filter condition
IS NULLまたはIS NOT NULL演算子を使用してNULL値を含む行をフィルタリングするには、詳細フィルタ条件を定義する必要があります。
• - Microsoft Azure Synapse SQLマッピングでPre-SQLクエリとPost-SQLクエリを使用し、ランタイムエラーが発生した場合、Secure AgentのJVMオプションで次のプロパティを設定していると、マッピングが失敗します:
• ▪ -DAzureSynapseFailOnPrePostSQLError=true
このプロパティが設定されていない場合、マッピングではエラーが表示されず、正常に実行されます。
• - Microsoft Azure Synapse SQLでデータベースを作成する場合は、UTF8以外の照合のみを使用してください。

ソーストランスフォーメーション

• - マッピング内のMicrosoft Azure Synapse SQLオブジェクトのBinaryまたはVarbinaryカラムのデータをプレビューすることはできません。
• - Microsoft Azure Data Lake Storage Gen2ソースからJSONファイルを読み取って、実行時に作成されたMicrosoft Azure Synapse SQLターゲットに書き込む場合、ソースデータにNULL値が含まれていないことを確認します。
• - 複数のMicrosoft Azure Synapse SQLソースからデータを読み取る場合は、名前が大文字であるか小文字であるかに関わりなく、ソースオブジェクトのテーブル名と関連オブジェクトのテーブル名が同一でないことを確認します。
• - 1つ以上のテーブルで同じカラム名を持つ複数のオブジェクトから読み取るように結合を設定すると、マッピングは失敗します。
• - 外部テーブルを読み取る場合、2つ以上のテーブルがMicrosoft Azure Blob StorageまたはMicrosoft Azure Data Lake Storage Gen2の同じ場所に存在しないことを確認します。
• - Varbinaryカラムを含むソースからデータを読み取った場合、Secure AgentはVarbinaryカラムから空の値をNULLとして読み取ります。
• - ソースとしてのカスタムクエリ
• ▪ マッピングでクエリソースタイプを使用して複数のテーブルから読み取る場合、同じカラム名を持つ1つ以上のテーブルに対して結合を設定すると、マッピングは失敗します。
例えば、SALES.PUBLICスキーマの一部である2つのテーブル、EMPLOYEEとDEPARTMENTの間の完全な外部結合を含む次のSQLクエリを見てみます。2つのカラムは同じCITYという名前です。
SELECT EMP_ID, NAME, CITY, DEPT_ID, DEPT_NAME, CITY
FROM SALES.PUBLIC.EMPLOYEE
FULL OUTER JOIN SALES.PUBLIC.DEPARTMENT ON EMP_ID = DEPT_ID
競合するカラム名を区別するには、テーブルを結合するときにデータベースが参照できるエイリアスを追加します。
SELECT e.EMP_ID, e.NAME, e.CITY as ecity, d.DEPT_ID, d.DEPT_NAME, d.CITY as dcity
FROM SALES.PUBLIC.EMPLOYEE e
FULL OUTER JOIN SALES.PUBLIC.DEPARTMENT d ON e.EMP_ID = d.DEPT_ID
• ▪ クエリがWITH句で始まる場合は、WITHの前にセミコロン（;）がないことを確認してください。
例えば、;With TEMP_OBJ AS (Select 'abc' AS FIELD1,123 AS Field2) Select Field1,Field2 from Temp_OBJは有効なクエリではありません。
• ▪ ソースカスタムクエリではDECLAREステートメントを使用しないでください。
• ▪ クエリのパラメータには、実行時にオーバーライドされるデフォルト値が必要です。
• ▪ カスタムクエリを使用してカラム名が類似した複数のテーブルからデータを読み取る場合、テーブルを結合するには、それらのカラム名に対してエイリアスを使用する必要があります。
• ▪ Microsoft Azure Synapse SQLからデータを読み取る場合は、Secure AgentのJVMオプションで次のプロパティを設定する必要があります。
-DAzureSynapseDisableStagingForSort=true
• ▪ Microsoft Azure Synapse SQLにデータを書き込む場合、ORDER BY句は使用できません。
• ▪ ルックアップトランスフォーメーションでカスタムクエリを使用する場合は、次のタスクを実行する必要があります。
• ▪ Secure AgentのJVMオプションで-DAzureSynapseDisableStagingForSort=trueプロパティを設定します。
• ▪ 詳細ルックアッププロパティで［ソート済み入力］オプションを有効にします。
• ▪ クエリには、ルックアップ条件に昇順で含まれる条件フィールドのORDER BY句が最初に含まれ、次に他のフィールドが任意の順序で含まれている必要があります。
• ▪ 複数の行を返すようにルックアップトランスフォーメーションを設定した場合、［すべての行を返す］オプションを使用すると、値が適切な順序で返されません。

ターゲットトランスフォーメーション

• - ターゲット操作の動作

［操作］プロパティ	［ソース行の取り扱い］プロパティ	動作
挿入、削除、または更新	なしまたはデータドリブン	［操作］プロパティの値が優先されます。
更新/挿入	なしまたはデータドリブン	更新操作を実行します。この場合、更新/挿入操作を実行するには、［操作］プロパティと［ソース行の扱い］プロパティを［更新/挿入］に設定する必要があります。
挿入、削除、更新、または更新/挿入	挿入、削除、更新、または更新/挿入	［ソース行の扱い］プロパティの値が優先されます。

• - Copyコマンドを使用するときは、次のルールに従ってください:
• ▪ Microsoft Azure Data Lake Gen2でファイルをステージングする場合、Copyコマンドはサービスプリンシパル認証でのみ使用できます。
• ▪ パラメータファイルを使用して、複数行のCopyコマンドを完全にパラメータ化することはできません。
• - 実行時にMicrosoft Azure Synapse SQLターゲットを作成する場合は、ソースのフィールド名に特殊文字が含まれていないことを確認してください。
• - 実行時にターゲットを作成すると、ソースにあるUniqueidentifierデータ型のフィールドは、ターゲットでNvarcharデータ型に変換されます。
Uniqueidentifierデータ型を保持するには、ターゲットフィールドのメタデータを編集し、フィールドのネイティブ型をUniqueidentifierに変更します。
• - Microsoft Azure Synapse SQLターゲットにデータを書き込む場合にソーステーブルにDatetimeまたはDatetime2データ型のカラムが含まれていると、秒の値は最も近い値で四捨五入されます。
• - Microsoft Azure Synapse SQLにデータを書き込み、デフォルトの更新SQLステートメントをオーバーライドする場合は、パラメータクエリが600文字を超えないようにしてください。
• - データをMicrosoft Azure Synapse SQLターゲットに更新/挿入または更新し、ソーステーブルの複数の行で、プライマリキーが定義されているカラムに同じ値が含まれている場合、その値を持つ最初の行は正しく更新されますが、同じ値を持つ後続の行はターゲットで正しく更新されません。
• - Microsoft Azure Synapse SQLに接続するためにODBC接続を使用しており、ターゲットテーブルにIDENTITYカラムがある場合、ターゲットのデータを更新することはできません。
• - 複数の非NULLのカラムを含むデータを読み取るMicrosoft Azure Synapse SQLマッピングを実行し、ソース内のすべての非NULLのカラムがターゲットにマッピングされていない場合、マッピングが次のエラーで失敗する。
［致命的］例外: com.informatica.adapter.azuredw.metadata.adapter.InfaSynapseException: 非NULLのフィールドが投影されていません
ソース内のすべての非NULLカラムがターゲットにマッピングされていることを確認してください。
• - Snappy圧縮形式を使用してMicrosoft Azure Synapse SQLにデータを書き込んだ場合、正常に実行された後に、マッピングによってエージェントマシンの一時ディレクトリに［snappy-1.1.8****-libsnappyjava.so］ファイルが保持されます。
• - データ依存条件にDD_REJECT操作のみが含まれている場合、マッピングはクエリを生成せずに実行されます。
• - 実行時にターゲットを作成し、ソースオブジェクトの実データ型がターゲットのfloatデータ型にマッピングされると、特定のジャンク文字がターゲットの値に追加されます。
例えば、9.999999E19は、ターゲットでは9.999999320799471E19と表記されます。

ルックアップトランスフォーメーション

• - キャッシュされていないルックアップを使用した場合、Unicode文字でデータをルックアップすることはできません。
• - SQLオーバーライドを指定してMicrosoft Azure Synapse SQLソースのデフォルトのルックアップクエリをオーバーライドする場合は、ルックアップオブジェクトの詳細プロパティで［ルックアップキャッシュの有効化］を選択していることを確認してください。
• - ルックアップオブジェクトをキャッシュを使用しないルックアップに対するクエリとして使用することはできません。
• - 動的ルックアップキャッシュのガイドライン
• ▪ Lookupトランスフォーメーションは、コネクトされたトランスフォーメーションでなければなりません。
• ▪ ルックアップ条件では、イコール演算子のみを指定できます。
• ▪ SQL ELTの最適化で動的ルックアップキャッシュを使用することはできません。