データ統合コネクタの新機能 > 2024年10月 > アップグレード

アップグレード

以下のトピックでは、データ統合コネクタのアップグレードの前後に実行が必要になる可能性のあるタスクに関する情報を説明します。以前にアップグレードを行った後にこれらのタスクを実行していない場合に備えて、以前の月次リリースのアップグレード後のタスクも含まれています。

2024年10月リリースのアップグレード後のタスク

組織の環境を2024年10月リリースにアップグレードした後に、次のタスクを実行します。

Google Analyticsコネクタ

Informaticaは、次のGoogle Analytics APIのサポートを終了しました。

•Analytics Reporting API v4
•Core Reporting API v3

接続プロパティの［APIバージョン］のデフォルト値が、Core Reporting API v3からGoogle Analytics 4に変更されました。

アップグレード後、既存のマッピングでAnalytics Reporting API v4またはCore Reporting API v3がAPIバージョンとして設定されている場合、テスト接続とマッピングは失敗します。

この問題を解決するには、次の手順を実行します。

1Universal AnalyticsアカウントをGoogle AnalyticsでGoogle Analytics 4に移行します。
2Google Analytics接続で、［APIバージョン］接続プロパティをGoogle Analytics 4に設定します。
3マッピングメタデータを同期し、マッピングを再実行します。

Google BigQuery V2

Google BigQuery V2コネクタには、次のようなアップグレードの影響が含まれています。

•アップグレード後、次のすべての条件が当てはまる場合、既存のマッピングが失敗する。

- Google BigQuery V2接続では、簡易接続モードが使用されます。
- ソースの詳細プロパティで、［EXPORT DATAステートメントをステージングに使用］が有効になります。
- トランスフォーメーションに、ソーステーブルのデータ型がRecordまたはRepeatであるフィールドが含まれる。

この問題を解決するには、トランスフォーメーションからRecordまたはRepeatデータ型のフィールドを削除し、マッピングを再実行します。

•アップグレード後、引数にByteデータ型、戻り値のデータ型にStringデータ型を持つ式トランスフォーメーションまたはアグリゲータトランスフォーメーションでREGEXP_EXTRACT関数を使用すると、SQL ELTモードの既存のマッピングが失敗する。

この問題を解決するには、REGEXP_EXTRACT関数の引数と戻り値の型のデータ型を互換性のある形式に更新して、マッピングを再実行します。

IBM MQコネクタ

アップグレード後に、IBM MQに接続するために必要なIBM MQ JARファイルをコピーするディレクトリを変更することが重要です。

IBM MQ JARファイルのディレクトリを変更する場合、IBM MQコネクタパッケージの新規バージョンがデプロイされるたびに、Secure Agentインストールディレクトリ内のJARファイルをコピーする必要はありません。

新規または既存のIBM MQマッピングを実行する前に、次の手順を実行してください。

1必要なIBM MQ JARファイルをIBM MQクライアントからコピーします。

コピーする必要があるIBM MQ JARファイルについての詳細は、IBM MQコネクタのマニュアルを参照してください。

2ibmmqフォルダを作成し、コピーしたJARファイルを次のディレクトリに貼り付けます。

<Informatica Secure Agent installation directory>/ext/connectors/thirdparty/ibmmq

3新しいデータ統合サーバーを生成します。

以前は、IBM MQ JARファイルは次のディレクトリーにコピーしていました。

<Informatica Secure Agentインストールディレクトリ>/downloads/package-ibmmq.<バージョン番号>/package/ibmmq/thirdparty/informatica.ibmmq

Microsoft Fabric Data Warehouseコネクタ

アップグレード後に、FileNameポートを含むソースデータの書き込みを行った場合、またはマッピング内のFileNameがターゲットの入力フィールドから除外されていない場合、マッピングは正常に実行されます。ただし、ターゲットのFileNameカラムに空の文字列が挿入されます。以前は、FileNameポートを持つソースデータはMicrosoft Fabric Data Warehouseターゲットに書き込まれていました。

空の文字列が書き込まれないようにするには、次の手順を実行します。

•実行時に新しいターゲットを作成するときは、FileNameポートを除外します。
•既存のターゲットオブジェクトを使用する場合は、FileNameポートカラムを使用しないようにしてください。
•FileNameポート値をソースから別のポートに接続します。

Microsoft Fabric Lakehouseコネクタ

アップグレード後に、FileNameポートを含むソースデータの書き込みを行った場合、またはマッピング内のFileNameがターゲットの入力フィールドから除外されていない場合、マッピングは失敗します。この問題は、既存のターゲットオブジェクトおよび実行時に作成された新しいターゲットオブジェクトで発生します。以前は、FileNameポートを持つソースデータはMicrosoft Fabric Lakehouseターゲットに書き込まれていました。

既存または新規のマッピングでこの問題を解決するには、次の手順を実行します。

•実行時に新しいターゲットを作成するときは、FileNameポートを除外します。
•既存のターゲットオブジェクトを使用する場合は、FileNameポートカラムを使用しないようにしてください。
•既存のターゲットオブジェクトにFileNameポートカラムが含まれていない場合は、ソースからFileNameポート値を別のポートに接続します。

MySQLコネクタ

アップグレード後に、MySQLコネクタがODBCドライババージョン8.0.28以前のWindowsで設定されている場合、既存のマッピングは失敗します。

この問題を解決するには、ODBCドライバをバージョン8.0.29以降にアップグレードし、マッピングを再実行します。