使用するCData製品

CData API Server

MySQLへの接続確認

（注意）CData準備のハンズオン環境のマシンは、MySQL Community Serverのインストール、および、サンプルデータベースの作成済です。

MySQLのインストール、および、サンプルデータベースの設定を実施していない場合は下記の記事にしたがってMySQLの環境を準備してください。

WindowマシンへのMySQL Community Serverのインストール、および、サンプルデータベースの作成方法

MySQL Workbenchを起動して、MySQLへ接続して、サンプルの「sakila」データベース内の「actor」テーブルのデータを表示してみます。

CData API Serverのインストール

以下のリンクからCData API Serverのビルドをダウンロードします。

CData API Server

ダウンロードされた「CDataAPIServer.exe」ファイルを起動します。下記のようなインストーラが起動するので、ライセンス契約書を確認した上で、デフォルト設定のままインストールを進めて完了させます。

途中、APIServerの管理者(admin)のパスワードを設定する画面が表示されるので、設定したパスワードは手元に控えておいてください。

インストールが完了するとWindows右下の通知エリアに青い雲のアイコンのCData APIServerに組み込まれているWebサーバが起動します。

また、デフォルトブラウザが起動してCData APIServerの管理コンソールへのログイン画面が起動します。

MySQLへの接続設定

CData APIServerの管理コンソールへのログイン画面で、ユーザ名「admin」、インストーラで設定したパスワードを入力して「サインイン」します。サインイン出来ると「情報」ページが表示されます。ライセンスが認証されていない旨のメッセージが表示されるので、「30日間の評価版をアクティベーションする」ボタンをクリックして、表示されるダイアログに「名前：」「Eメール」と入力し、「Terms and Conditions」を確認したら「評価版をアクティベーションする」ボタンをクリックします。

ブラウザのリフレッシュをして、プロダクトーに30日間の試用版（30 DAY TRIAL VERSION - 30 DAYS LEFT）が表示されることを確認します。

「設定 > 接続」タブを開き、Databases内の「MySQL」を選択します。

MySQLへの接続情報を設定します。設定後「Test Connection」ボタンをクリックして「The connection was successful.」が表示されればCDataAPIServerからMySQLへ接続出来たことになります。接続情報を「Save Changes」ボタンで保存します。

設定項目	設定値
Name	任意（例では「MySQL」と設定）
Provider Class	変更不可（「System.Data.CData.MySQL」と設定）
Settings Format	デフォルト値「Property List」
Server	MySQLがインストールされているマシン名、もしくは、IPアドレス（例では「localhost」と設定）
Database	MySQLのデータベース(例では「sakila」と設定)
User	MySQLへの接続ユーザ(例では「root」と設定)
Password	MySQLへの接続パスワード

接続情報が保存されてConnectionsにMySQLへの接続情報が表示されることを確認します。

APIエンドポイントの作成

「設定 > リソース」タブを開き、「リソースを追加...」ボタンをクリックします。

先の手順で作成したMySQLへのデータ接続設定を選択して「次へ」ボタンをクリックします。

MySQL内のテーブルおよびビューが一覧として表示されます。今回は[sakila].[actor]テーブルを選択して「次」ボタンをクリックします。

[sakila].[actor]テーブル内の項目一覧が表示されます。デフォルトでは、「操作：」に全てチェックが付与されており、GET（SELECT）、POST（INSERT）、PUT（UPDATE）、DELETE（DELETE）と全てのCRUD操作を許可しています。また、アクセスユーザも「*(全ユーザ)」と設定してます。今回は、このまま「保存」ボタンをクリックします。

リソース一覧画面に戻り、「sakila_actor」リソースが追加されたことを確認します。

APIアクセスユーザの作成

「設定 > ユーザー」タブに移動して、ユーザの「追加」ボタンをクリックします。

「ユーザーを追加」ダイアログが表示されます。ユーザー名を入力（任意）して、ユーザ毎の操作権限「GET（SELECT）、POST（INSERT）、PUT（UPDATE）、DELETE（DELETE）」全てにチェックを入れて「変更を保存」ボタンをクリックします。本画面で、一定時間内のAPIアクセス数制限（RateLimit）および同時接続数の制限を付与することも出来ます。

ユーザ一覧画面に戻り、ユーザが追加されてAuthトークンが生成されたことを確認します。ユーザ名と本AuthトークンはAPIアクセス時に必要となりますの手元に控えておいてください。

WebAPIへのアクセス

それでは、作成したWebAPIにアクセスしてみましょう。「API」タブを開くと、APIリファレンスが開きます。
左側にリソースの一覧が表示されますので、上の手順で追加したリソース「/api.rsc/sakila_actor」を選択します。

右側にHTTPメソッド、および、各種プロパティや追加フォーマットの情報が表示されます。GETメソッドは、Webブラウザからリクエストを発行することができるので、ブラウザの新しいタブ、もしくは、Windowを開いてURLに「 http://localhost:8387/api.rsc/sakila_actor/ 」を入力して開いてみます。ブラウザのレスポンスとして、JSON形式で、MySQL内のactorテーブル内のデータが表示されれば成功です。

管理コンソールと同一のWebブラウザからアクセスする場合は、ユーザ認証が必要ありませんが、新規ブラウザからだと認証が必要となります。ユーザ名に上記手順で作成したAPIアクセスユーザ名、パスワードにAuthトークンを入力してください。

MySQLからWebAPIをを作成して、Webブラウザからアクセスすることが出来ました。