![• Talend Cloud にログインし、画面右上のユーザーメニューから [ パーソナルアク
セストークン ]-[ トークンを追加 ]
o 表示されたトークン文字列を大切に保管
• 全ユーザーのトークン一覧や削除は、 Talend Management Console の [Users &
Security]-[ トークン管理 ] タブで行える
12
パーソナルアクセストークンの作成
Talend Cloud にログインするユーザーのプロファイル環境設定で行う](https://image.slidesharecdn.com/qliktipstactmcapi20241119-241119060343-9a8c3bf8/85/Talend-Administration-Center-MetaServlet-API-Talend-Management-Console-API-12-320.jpg)
Talend Administration Center MetaServlet API、Talend Management Console API の使い方
- 1. Talend Administration Center MetaServlet API 、 Talend Management Console API の使い方 Qlik Tips 2024 年 11 月 19 日
- 2. • オンプレ版の「 Talend Administration Center(TAC) 」には「 Talend Administration Center MetaServlet API 」が用意されており、外部のシ ステムから TAC の機能にアクセス出来るようになっています。 • クラウド版の「 Talend Management Console(TMC) 」にも「 Talend Management Console API 」が用意されており、外部のシステムから TMC の機能にアクセスできるようになっています。 このセミナーでは、それぞれの API の使い方の例として、タスクのロ グデータを取得する方法を Python のサンプルプログラムとともに説明 いたします。 2 はじめに タスクのログデータを Talend の API を使用して取得してみよう !!
- 4. • MetaServlet API を呼び出すことで、外部システムから Talend Administration Center に接続し、アクションを実行可能 o 例 : 外部スケジューラから MetaServlet API を呼び出して、 ETL ジョブを起動 • MetaServlet API は、 RPC スタイルの HTTP API で、 RESTful ではない o すべての MetaServlet API オペレーションは、 HTTP GET リクエスト (POST でも可 ) で呼び出 す o オペレーションのパラメータは、 GET リクエストに単一の無名 Base64 エンコードされた JSON データを渡す • Talend Administration Center User Guide >> Non-GUI operation in metaServlet o https://help.qlik.com/talend/en-US/administration-center-user-guide/8.0/non-gui-operation-in -metaservlet • Talend Administration Center API >> Talend Administration Center MetaServlet API o https://help.qlik.com/talend/en-US/administration-center-api/8.0/metaservlet-api 4 Talend Administration Center MetaServlet API とは ? Talend Administration Center をプログラムで管理できる HTTP API
- 5. • Talend Administration Center(TAC) は、 Tomcat のサーブレットコンテナ上で動作 する JavaEE の Web アプリ o Compatible web application servers • https://help.qlik.com/talend/en-US/installation-guide-windows/8.0/compatible-web-application-serv ers#anchor-1 o .war ファイル (org.talend.administrator-8.0.1.war) が展開されて、 TAC として機能する • Windows の場合 o <Tomcat>/webapps/<TAC>/WEB-INF/classes/MetaServletCaller.bat • Linux の場合 o <Tomcat>/webapps/<TAC>/WEB-INF/classes/MetaServletCaller.sh • 引数なしで MetaServletCaller を実行すると、ヘルプメッセージが表示される 5 MetaServlet API のコマンドラインツールが付属 Java ベースのコマンド (.bat,.sh) が TAC の Web アプリのフォルダに展開されてい ます
- 6. • オンラインヘルプ o https://help.qlik.com/talend/en-US/administration-center-api/8.0/metaservlet-commands • コマンドライン o <Tomcat>/webapps/<TAC>/WEB-INF/classes/MetaServletCaller.sh --tac-url=http://localhost:8080/org.talend.administrator-8.0.1/ -help all 6 MetaServlet API のオペレーション一覧 オペレーションの例 : runTask や taskLog など
- 7. • 結果 (HTTP レスポンスの BODY) は標準出力に出力される • あるタスク (ID が 1) のすべての実行履歴のログを取得 o ./MetaServletCaller.sh --tac-url https://192.168.149.136:8080/org.talend.administrator-8.0.1 -- json-params “{”actionName“: ”taskLog“,”authPass“: ”admin“,”authUser“: ”security@company.com“, ”lastExecution“: false,”taskId“: 1}" • あるタスク (ID が 1) で「 2024-10-23 16:49:17 」から「 2024-10-23 16:50:52 」の 期間に開始したジョブの実行履歴のログだけを取得 o ./MetaServletCaller.sh --tac-url https://192.168.149.136:8080/org.talend.administrator-8.0.1 -- json-params "{"actionName": "taskLog","authPass": "admin","authUser": "security@company.com", "endTime": "2024-10-23 16:50:52","lastExecution": false,"startTime": "2024-10-23 16:49:17","taskId": 1}" 7 コマンドラインツールで taskLog を呼び出し、タスクログを 取得 JSON データ (TAC への認証情報含む ) を 1 行の文字列にして、パラメータとして 指定する
- 8. • エンドポイントの例 : http://192.168.149.136:8080/org.talend.administrator-8.0.1/metaServlet • HTTP GET リクエストの例 : http://192.168.149.136:8080/org.talend.administrator-8.0.1/metaServlet?eyJhY3Rpb25OYW1lIjogInRhc2tMb2ci LCJhdXRoUGFzcyI6ICJhZG1pbiIsImF1dGhVc2VyIjogInNlY3VyaXR5QGNvbXBhbnkuY29tIiwibGFzdEV4ZWN1dGlv biI6IGZhbHNlLCJ0YXNrSWQiOiAxfQ== 8 MetaServlet API のエンドポイントを直接呼び出す プログラムの例として、 Python を使用
- 9. 9 参考 : タスクの ID を取得する TAC にデプロイしたタスク (ETL ジョブ ) には 1 から始まる ID が付きます
- 10. Talend Management Console API 10
- 11. • Talend Cloud API に含まれる API 群の一部で、外部システムから Talend Management Console に接続し、アクションを実行可能 o 例 : 外部スケジューラから REST API を呼び出して、 ETL ジョブを起動 o Talend Cloud API ユーザーガイド >> Talend Cloud API の概要 • https://help.qlik.com/talend/ja-JP/api-user-guide/Cloud/introduction-to-talend-cloud-apis o 認証は、 Authentication ヘッダーに「パーソナルアクセストークン」を「 Bearer トークン」 として渡す o すべてのオペレーションは、 HTTP リクエスト (GET,POST,DELETE,PUT) で呼び出す o オペレーションのパラメータは、クエリパラメータや、 JSON データを HTTP リクエストのボ ディとして渡す • Talend Management Console Public API( 最新 ) o https://api.talend.com/apis/ o Talend Management Console Public API V2.6(deprecated) • https://api.eu.cloud.talend.com/tmc/swagger/swagger-ui.html • r2024-03 より API v2.6 は非推奨 o 11 Talend Management Console API とは ? 任意のプログラムで、 Talend Management Console(TMC) と対話できる REST API
- 12. • Talend Cloud にログインし、画面右上のユーザーメニューから [ パーソナルアク セストークン ]-[ トークンを追加 ] o 表示されたトークン文字列を大切に保管 • 全ユーザーのトークン一覧や削除は、 Talend Management Console の [Users & Security]-[ トークン管理 ] タブで行える 12 パーソナルアクセストークンの作成 Talend Cloud にログインするユーザーのプロファイル環境設定で行う
- 13. 13 特定のタスクのジョブの実行履歴のログ ( 例 : 最大 100 件 ) を取得 プログラムの例として、 Python を使用
- 14. その他の情報 14
- 15. • https://github.com/ttcodegear?tab=repositories • Python o https://github.com/ttcodegear/TACMetaServletAPI_TMCAPI 15 サンプルコードの提供場所 GitHub 上で公開しています
- 16. Thank you ! 16