データ可視化ソリューション「Reveal」から Nuclia に接続する方法

CData API Server を使って、Reveal にNuclia データをフィードして、ビジュアライズを実現できます。コネクターによりリアルタイムデータ連携が可能になり、リフレッシュ操作で最新のデータを取得可能になります。この記事では、Reveal からNuclia のデータに接続しビジュアライズする方法を説明します。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなNuclia OData サービスを作成していきましょう。

Nuclia への接続

Reveal からNuclia のデータを操作するには、まずNuclia への接続を作成・設定します。

1. API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
2. 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Nuclia」を選択します。
3. 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
   CData コネクタの追加方法はこちら >>
4. それでは、Nuclia への接続設定を行っていきましょう！

5. API キー認証の設定

   Nuclia は、Knowledge Box のデータにアクセスするために API キー認証を使用します。API キーを取得するには、以下のステップで進めます：

   1. https://nuclia.cloud で Nuclia Cloud Dashboard にログインします
   2. Knowledge Box の設定に移動します
   3. Service Accounts セクションに移動します
   4. 新しいサービスアカウントを作成するか、既存の API キーをコピーします

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

   • AuthScheme：APIKey に設定します。
   • APIKey：Nuclia サービスアカウントの API キーに設定します。
   • KbId：Knowledge Box の UUID に設定します。
   • Zone：Nuclia のデプロイゾーンに設定します（例：aws-us-east-2-1）。

   接続文字列の例

   Profile=C:\profiles\Nuclia.apip;AuthScheme=APIKey;APIKey=your_service_account_key;KbId=your_kb_uuid;Zone=aws-us-east-2-1;
   

   Nuclia への接続

   認証を設定すると、Nuclia に接続して、Resources、KnowledgeBox、LabelSets、ProcessingStatus などの利用可能なテーブルからデータをクエリできます。

6. 接続情報の入力が完了したら、「保存およびテスト」をクリックします。

API キー認証の設定

Nuclia は、Knowledge Box のデータにアクセスするために API キー認証を使用します。API キーを取得するには、以下のステップで進めます：

1. https://nuclia.cloud で Nuclia Cloud Dashboard にログインします
2. Knowledge Box の設定に移動します
3. Service Accounts セクションに移動します
4. 新しいサービスアカウントを作成するか、既存の API キーをコピーします

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

• AuthScheme：APIKey に設定します。
• APIKey：Nuclia サービスアカウントの API キーに設定します。
• KbId：Knowledge Box の UUID に設定します。
• Zone：Nuclia のデプロイゾーンに設定します（例：aws-us-east-2-1）。

接続文字列の例

Profile=C:\profiles\Nuclia.apip;AuthScheme=APIKey;APIKey=your_service_account_key;KbId=your_kb_uuid;Zone=aws-us-east-2-1;

Nuclia への接続

認証を設定すると、Nuclia に接続して、Resources、KnowledgeBox、LabelSets、ProcessingStatus などの利用可能なテーブルからデータをクエリできます。

API Server のユーザー設定

次に、API Server 経由でNuclia にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

1. 「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
2. 次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
3. その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

Nuclia 用のAPI エンドポイントの作成

ユーザーを作成したら、Nuclia のデータ用のAPI エンドポイントを作成していきます。

1. まず、「API」ページに移動し、 「 テーブルを追加」をクリックします。
2. アクセスしたい接続を選択し、次へをクリックします。
3. 接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でNuclia への接続を設定してユーザーを作成し、API Server でNuclia データのAPI を追加しました。これで、OData 形式のNuclia データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

ダッシュボードの作成

それでは実際に可視化を行っていきます。「Reveal」ではダッシュボードという単位でいくつかのグラフを配置して、構成していきます。

1. Revealにログインし、「新規」→「ダッシュボード」をクリックします。

2. データソースから「ODataフィード」を選択し

3. API ServerのAPIエンドポイントURLを指定し、資格情報を入力します。 URLは「https://XXXXXXX/api.rsc/」といったように末尾が「api.rsc」で終わっているものを入力します。

4. 資格情報は「汎用資格情報」を選択し、

5. あらかじめ作成しておいたAPI Serverのユーザー名と認証トークンをそれぞれ指定します。

6. 認証完了後、エンティティセットを選択する画面に移動するので、取得したい任意のエンティティセットを選択します。

7. これでダッシュボードを作成する準備が整いました。あとは Reveal の機能を使って、Nuclia・API Serverから取得したデータを可視化・分析することができます。

8. 以下のようなグラフを作成することができました。

このように Nuclia 内のデータをAPI を書くことなく Reveal 上で処理することができるようになります。

おわりに

これで、リアルタイムNuclia のデータから簡単なダッシュボードが作成できました。Nuclia （および150 を超えるほかのソース）からのOData フィードの作成方法の詳細については、API Server のページにアクセスしてください。30 日間無料トライアルをダウンロードしてOData API を使用するツールでNuclia のデータをリアルタイムに活用しましょう。