Mendix で CouchDB 連携アプリを構築

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
CData Connect AI を使って CouchDB のデータ用の OData フィードを作成し、Mendix でカスタムアプリを構築できます。

Mendix は、モバイルアプリとWeb アプリの両方を大規模に構築・保守できる高生産性アプリプラットフォームです。CData Connect AI と組み合わせることで、Mendix からクラウド間で即座にCouchDB のデータにアクセスできるようになります。この記事では、Mendix からCData Connect AI のデータソースに接続する方法を説明します。

CData Connect AI は CouchDB 専用のクラウド間インターフェースを提供し、ネイティブでサポートされているデータベースにデータをレプリケートすることなく、Mendix でリアルタイムのCouchDB のデータをインポートできます。Mendix でWeb およびモバイルアプリを構築する際、CData Connect AI はサポートされているすべてのSQL 操作（フィルター、JOIN など）を CouchDB に直接プッシュし、サーバーサイド処理を活用して必要なCouchDB のデータを迅速に返します。

Mendix 用に CouchDB への接続を設定

Mendix からCouchDB のデータを操作するには、Connect AI から CouchDB に接続し、接続へのユーザーアクセスを付与し、CouchDB のデータ 用のワークスペースを作成する必要があります。

Connect AI から CouchDB に接続

CData Connect AI は、シンプルなポイント＆クリック操作でデータソースに接続できるインターフェースを提供しています。

  1. Connect AI にログインして「Sources」をクリックし、 Add Connection をクリックします
    2. 接続の追加
  2. Add Connection パネルから「CouchDB」を選択します
    3. データソースの選択
  3. CouchDB への接続に必要な認証プロパティを入力します。

    Apache CouchDB 接続プロパティの取得・設定方法

    それでは、Apache CouchDB に接続していきましょう。Url 接続プロパティをApache CouchDB インスタンスのURL に設定します。例：http://localhost:5984

    ユーザー（またはJWT）が特定のデータベースだけにアクセスできるようにしたい場合は、Apache CouchDB インスタンスで"admin_only_all_dbs" オプションを設定し、テーブルをリストするためにCData 製品が必要とする"/_all_dbs" エンドポイントへのアクセス権をすべてのユーザーに付与する必要があります。

    Apache CouchDB への認証

    続いて、認証方法を設定しましょう。CData 製品では、3種類の認証をサポートしています。

    • Basic：基本的なユーザー名 / パスワード認証
    • JWT：JWT 認証
    • None：パブリックなデータベースへの匿名アクセス

    Basic 認証

    データに接続するには、以下のプロパティを設定してください。

    • AuthScheme：Basic
    • User：認証に使用されるApache CouchDB ユーザーアカウント
    • Password：認証するユーザーに関連付けられたApache CouchDB パスワード

    その他の認証方法については、ヘルプドキュメントの「接続の確立」セクションをご確認ください。

    接続の設定（Salesforce の例）
  4. Save & Test をクリックします
  5. Add CouchDB Connection ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。 権限の更新

Personal Access Token の追加

REST API、OData API、またはVirtual SQL Server 経由でConnect AI に接続する場合、Personal Access Token（PAT）を使用してConnect AI への接続を認証します。アクセス管理の粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。

  1. Connect AI アプリの右上にある歯車アイコン（）をクリックして設定ページを開きます。
  2. Settings ページで「Access Tokens」セクションに移動し、 Create PAT をクリックします。
  3. PAT に名前を付けて「Create」をクリックします。 新しいPAT の作成
  4. Personal Access Token は作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

Mendix 用に CouchDB エンドポイントを設定

CouchDB への接続後、対象テーブル用のワークスペースを作成します。

  1. 「Workspaces」ページに移動し、 Add をクリックして新しいワークスペースを作成します（または既存のワークスペースを選択します）。 ワークスペースページ 新しいワークスペースの追加
  2. Add をクリックしてワークスペースに新しいアセットを追加します。
  3. CouchDB 接続（例：ApacheCouchDB1）を選択し、「Next」をクリックします。 アセットの選択（Salesforce の例）
  4. 操作したいテーブルを選択し、「Confirm」をクリックします。 テーブルの選択（Salesforce の例）
  5. ワークスペースのOData サービスURL をメモしておきます。例：https://cloud.cdata.com/api/odata/{workspace_name}

接続、PAT、ワークスペースの設定が完了したら、Mendix からCouchDB のデータに接続する準備が整いました。

CouchDB 連携アプリの構築

OData メタデータファイルのダウンロード

Mendix で接続を作成する際、接続フローにはData Source Contract File が必要です。以下の手順に従って、curl（コマンドラインツール）を使用してCData Connect AI のOData メタデータファイルをダウンロードします：

  1. お使いのOS 用のコマンドラインウィンドウを開きます。Windows では、スタートメニューを開いて「cmd」と入力し、Enter キーを押してコマンドプロンプトを開きます。macOS およびLinux では、ターミナルウィンドウを開きます。
  2. curl がシステムにインストールされているか確認するには、「curl -help」と入力してEnter キーを押します。インストールされていない場合は、curl のWeb サイトからインストールしてください。
  3. 以下のcurl コマンドを実行します。USER をCData Connect AI のユーザー名に、PAT を先ほど生成したPAT に置き換えてください： 
    curl -u USER:PAT https://cloud.cdata.com/api/odata/{workspace_name}/$metadata -o metadata.xml
  4. curl コマンドで作成されたmetadata.xml ファイルを探し、アクセスしやすい場所に移動します。

Mendix からCData Connect AI に接続

以下の手順に従って、Mendix からCData Connect AI への接続を確立します：

  1. Mendix にログインし、Data Hub ページを開きます。
    2. Mendix ランディングページ
  2. 「Register a Data Source」セクションで「OData」を選択します。
    3. OData データソースの登録
  3. 上記の手順で取得したmetadata.xml ファイルをアップロードし、「Next」をクリックします。
    4. メタデータファイルのアップロード
  4. 「Data Source Name」と「Data Source Version」に希望する値を入力します。 「Data Source Relative Path」フィールドに「/api/odata/{workspace_name}」と入力し、「Next」をクリックします。
    5. データソースの作成
  5. 「Application information」ページで「Register a new application」をクリックします。
    6. 新しいアプリの登録
  6. 「Application Name」に名前を入力し、テクニカルオーナーを選択します（デフォルトでは現在ログインしているユーザーになります）。
    7. アプリのフィールドへの入力
  7. 「Next」をクリックします。「Environment Name」フィールドに希望する名前を入力します（例：CData Connect AI）。 「Environment Location」フィールドに「https://cloud.cdata.com」と入力し、必要に応じて適切な「Environment Type」（例：Production）を選択します。
    8. 環境の作成
  8. 「Done!」をクリックして接続を作成します。
    9. 接続の確定

これで、Mendix Studio Pro で接続を使用して、リアルタイムのCouchDB のデータにアクセスするアプリケーションを簡単に作成できるようになりました。

CData Connect AI の入手

クラウドアプリケーションから直接、数百種類のSaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、今すぐCData Connect AI をお試しください！

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル

この記事の内容

関連記事