【Cloud Integration Hub】CIHでファイル取り込みタスクによるパブリケーションを試してみた

【Cloud Integration Hub】CIHでファイル取り込みタスクによるパブリケーションを試してみた

Clock Icon2024.09.09

データ事業本部の川中子(かわなご)です。

今回はInformaticaで提供されている Cloud Integration Hub (以降CIHと略します)について見ていきます。
本記事の執筆では、こちらのドキュメントを参考にしてます。

https://docs.informatica.com/ja_jp/integration-cloud/integration-hub/current-version/_cloud-integration-hub_cloud-integration-hub_current-version_ditamap/GUID-7FFB2A2A-A6A1-44A5-917F-F44F7648E8F7.html

また、CIHの概要については以下を公式紹介ページをご参照下さい。

https://www.informatica.com/jp/products/cloud-integration/cloud-data-integration/cloud-integration-hub.html

はじめに

今回はCIHにおいてパブリケーション/サブスクリプションを開発する際の選択肢である、
パブリケーション方法 について見ていきます。

スクリーンショット 2024-09-09 13.54.52

各パブリケーション方法の概要は以下になります。

  • データ統合タスクによってデータをパブリッシュ: データ統合タスクを起動してトピックへのデータ転送や、トピックからのデータ取得する方法。1タスクで複数トピックとデータ連携する複合パブリケーション/サブスクリプションを使用する事もできる。
  • ファイル取り込みタスクでファイルをパブリッシュ: 事前に設定したSecureAgent上のディレクトリを介してデータを連携できる方法。テーブルへのインサートなどはなく、ファイルそのものをファイル取り込みタスクで移動させる。
  • APIを使用してデータをパブリッシュ: 発行されるURLへのPOSTをトリガにして起動する方法。テーブルへ格納するデータをbodyに入れてPOSTすることでパブリッシュができる。

https://docs.informatica.com/ja_jp/integration-cloud/integration-hub/current-version/_cloud-integration-hub_cloud-integration-hub_current-version_ditamap/GUID-AB8969FF-D7D6-4F7B-A8C5-E84F1963A8E7/GUID-8758AC3B-B502-4DA9-A793-7F17075D327A.html

今回は上記のうち、ファイル取り込みタスクを利用した方法について見ていきます。
他2つの方法については以下の記事でそれぞれ解説されています。

https://dev.classmethod.jp/articles/informatica-cih-overview-understanding/

https://dev.classmethod.jp/articles/cloud-integration-hub-cih-api/

検証

ファイルストアパブリケーションリポジトリの設定

https://docs.informatica.com/ja_jp/integration-cloud/integration-hub/current-version/_cloud-integration-hub_cloud-integration-hub_current-version_ditamap/GUID-1D73D863-6ADD-42C8-A0F3-065BFFB9DA40/GUID-76CE7046-2D12-4148-B908-57CDEB2A80DD/GUID-C656A55F-B7E7-46F3-A1EC-2D21CFA23BF6.html

まずはファイルの経由地となるファイルストアパブリケーションリポジトリを設定します。
CIH画面のホーム右上の「セットアップ」を開きます。

スクリーンショット 2024-09-06 18.18.35

「ファイルストアパブリケーションリポジトリの場所」にファイル経由地のパスを指定します。

スクリーンショット 2024-09-06 18.20.27

なおこのリポジトリに設定するディレクトリは、SecureAgentがアクセス権限を持っている必要があります。
この設定が正常に保存されると、指定したディレクトリ下に組織ID名のフォルダが作成されます。

スクリーンショット 2024-09-06 18.21.35

アクセス権限を持っていないディレクトリを指定した場合には、正常に保存することができません。

スクリーンショット 2024-09-06 18.22.26

アセットの準備

今回の検証用に作成したアセットの一覧はコチラになります。

スクリーンショット 2024-09-09 9.55.00

ファイル取り込みタスク

https://docs.informatica.com/ja_jp/integration-cloud/integration-hub/current-version/_cloud-integration-hub_cloud-integration-hub_current-version_ditamap/GUID-BE4C0254-D38A-43E4-BE7C-4491D4D16C5F/GUID-5A354CE9-2F47-4A85-BBFD-0DC7B51BF152.html

まずはCDIの画面で、ファイル取り込みタスクを2つ準備します。
CIHのトピックに接続する部分は、接続タイプで「Cloud Integration Hub」を選択します。

  • パブリケーション用タスク:ターゲットに「Cloud Integration Hub」を設定
  • サブスクリプション用タスク:ソースに「Cloud Integration Hub」を設定

スクリーンショット 2024-09-09 10.31.14

ちなみに今回作成したファイル取り込みタスクは、以下のS3フォルダ上で動くように設定されています。
sample.csvdone/にアーカイブしつつ、move_to/に移動するというタスクです。

スクリーンショット 2024-09-09 10.43.47

CIHアセット

CIH側で作成するアセットは以下の4つになります。

  • アプリケーション
  • トピック
  • パブリケーション
  • サブスクリプション

アプリケーションの作成方法は別記事(再掲)で解説があるので、本記事では割愛させて頂きます。

https://dev.classmethod.jp/articles/informatica-cih-overview-understanding/

まずはトピックを作成していきます。
パブリケーションリポジトリタイプで「ファイルストア」を設定し、あとは全てデフォルトです。

スクリーンショット 2024-09-09 10.51.57

次にパブリケーションを作成します。
パブリケーション方法に「ファイル取り込みタスクでファイルをパブリッシュ」を設定し、
タスクには上記で作成したパブリケーション用のファイル取り込みタスクを設定します。

スクリーンショット 2024-09-09 11.03.55

サブスクリプションの設定についても、パブリケーションとほぼ同じ設定方法です。

スクリーンショット 2024-09-09 11.08.14

実行

アセットが準備できたので、CIHの画面からパブリケーションを手動で実行してみます。

スクリーンショット 2024-09-09 11.12.44

イベント画面を見てみると、パブリケーション/サブスクリプションの正常終了が確認できます。

スクリーンショット 2024-09-09 11.16.28

ファイルストアパブリケーションリポジトリとして設定したディレクトリを確認すると、
設定時に自動で作成された組織ID名のフォルダ配下に、以下のように出力されます。
組織IDフォルダ > トピック名 > 日付 > イベントID > ファイル

スクリーンショット 2024-09-09 11.18.25

ファイル取り込みタスクが実行された後のS3フォルダ構成を見てみると、
ファイルストアパブリケーションリポジトリと同様なフォルダ構成になっています。

スクリーンショット 2024-09-09 11.35.47

まとめ

今回はCIHのパブリケーション/サブスクリプションの方法から、
ファイル取り込みタスクを用いた方法について仕様の確認を行いました。

以下に検証して分かった内容をまとめてみます。

  • データではなく ファイル単位で連携したい場合 にはファイル取り込みタスクを利用する

  • 事前に ファイルストアパブリケーションリポジトリの設定が必要 になる

    • 指定するディレクトリは、 SecureAgentのアクセス権を持っている必要 がある
    • セットアップが正常に終了した時点で、 ディレクトリ配下に組織ID名のフォルダが作成 される
  • ファイル取り込みタスクで、それぞれ 接続タイプに「Cloud Integration Hub」を設定 する

    • ファイル取り込みタスクでピックアップ後の削除を設定 すれば、ディレクトリにファイルを残さない
  • 組織IDフォルダ > トピック名 > 日付 > イベントID > ファイル 」の構成で出力される

次回はAPIによるパブリケーション/サブスクリプションについて記事を書きたいと思います。
以上、CIH開発や導入検討の参考になれば幸いです。

この記事をシェアする

facebook logohatena logotwitter logo

© Classmethod, Inc. All rights reserved.