CloverDX（旧CloverETL）で Browse AI のデータ に接続

CData JDBC Driver for Browse AI を使用すると、CloverDX（旧CloverETL）のデータ変換コンポーネントで Browse AI をソースとして扱えます。この記事では、JDBC Driver for Browse AI を使用して、フラットファイルへのシンプルな転送を設定する方法を説明します。

JDBC データソースとして Browse AI に接続

1. Browse AI のデータ への接続を作成します。新規のCloverDX グラフで、Outline ペインの「Connections」ノードを右クリックし、「Connections」->「Create Connection」をクリックします。Database Connection ウィザードが表示されます。
2. プラスアイコンをクリックし、JAR からドライバーをロードします。インストールディレクトリのlib サブフォルダを参照し、cdata.jdbc.api.jar ファイルを選択します。
3. JDBC URL を入力します。

   まず、Profile 接続プロパティをディスク上の BrowseAI プロファイルの場所に設定します（例：C:\profiles\BrowseAI.apip）。次に、ProfileSettings 接続プロパティを BrowseAI の接続文字列に設定します（以下を参照）。

   BrowseAI API プロファイル設定

   BrowseAI は、ロボットをトレーニングして Web サイトからデータを抽出・監視できる Web スクレイピング・自動化プラットフォームです。認証には API キーを使用し、Authorization ヘッダーで Bearer トークンとして送信されます。

   BrowseAI の API キーは {userId}:{apiKey} という形式で、コロンで区切られた2つの UUID で構成されています。BrowseAI ダッシュボードでは、この文字列全体が1つの値として提供されます。

   API キーは以下の手順で取得できます。

   1. https://app.browse.ai で BrowseAI アカウントにログインします。
   2. ダッシュボードの「Settings」に移動します。
   3. 「API」セクションを探します。
   4. 表示された API キーの文字列全体をコピーします（形式：userId:apiKey）。

   API キーを取得したら、以下の接続プロパティを設定します。

   • AuthScheme：APIKey に設定します。

   ProfileSettings 接続プロパティには、以下を設定します。

   • APIKey：BrowseAI の API キーに設定します（形式：userId:apiKey）。

   組み込みの接続文字列デザイナー

   JDBC URL の構築には、Browse AI JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから実行します。

   
   java -jar cdata.jdbc.api.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   一般的なJDBC URL は次のようになります：

   jdbc:api:Profile=C:\profiles\BrowseAI.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_user_id:your_api_key';

DBInputTable コンポーネントで Browse AI のデータ をクエリ

1. Palette の「Readers」から「DBInputTable」をジョブフローにドラッグし、ダブルクリックして設定エディターを開きます。
2. 「DB connection」プロパティで、ドロップダウンメニューから Browse AI JDBC データソースを選択します。
3. SQL クエリを入力します。例：

   SELECT Id, Status FROM RobotTasks WHERE RobotId = 'your-robot-id'

クエリの出力をUniversalDataWriter に書き込む

1. 「Writers」から「UniversalDataWriter」をジョブフローにドラッグします。
2. UniversalDataWriter をダブルクリックして設定エディターを開き、ファイルURL を追加します。
3. DBInputTable を右クリックし、「Extract Metadata」をクリックします。
4. DBInputTable の出力ポートをUniversalDataWriter に接続します。
5. UniversalDataWriter の「Select Metadata」メニューで、RobotTasks テーブルを選択します。（このメニューはUniversalDataWriter の入力ポートを右クリックしても開けます。）
6. 「Run」をクリックして、ファイルに書き込みます。