ダウンロードはこちら

CacheSQLGateway_2012.doc
Cache SQL Gateway
この資料では、Cache が提供している Cache SQL Gateway 機能を利用した、リンクテ
ーブル機能とデータ移行機能について記載しています。
Cache SQL Gateway 機能は、Cache が外部 DB（RDBMS）に対して ODBC 接続して、
外部 DB のデータを取り扱うことができるようにする機能です。この時、外部 DB のテ
ーブルを Cache のクラスとして、また、テーブルに含まれるカラムをクラスのプロパテ
ィとして操作できるようになります。
［Cache SQL Gateway 概念図］
Cache
外部 DB
ODBC
テーブル
クラス
カラム
プロパティ
［リンクテーブル機能とデータ移行機能の違いについて］
リンクテーブル機能とデータ移行機能の違いは下記の通りです。
機能名称
機能内容
リンクテーブル機能
外部 DB の内容を共有し、直接読み書きできます。
NameSpace
データ移行機能
LINKTABLE
外部 DB の定義情報（テーブル定義、カラム定義、他）を
Cache に移植します。移植後は、外部 DB に影響すること
なく、Cache の独自テーブル（クラス）として取り扱われ
ます。
NameSpace
DATAIKOU
1 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
［この資料のソフトウェア環境について］
この資料を作成するために使用したソフトウェアは下記の通りです。
ソフトウェア
製品名、バージョン等
O/S
WindowsServer2008R2 64bit
Cache
2012.1.1（Unicode）
外部 DB
MySQL5.5.23.0
.NET Framework
.NET Framework4.0
MySQL インストール時に要求されます。
Web ブラウザ
Firefox11.0
デフォルトブラウザに設定しています。
2 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
目次
1. MySQL のセットアップ .............................................................................................................4
1.1. MySQL のダウンロード ......................................................................................................4
1.2. .NET Framework 4.0 のダウンロードとインストール.................................................... 11
1.3. MySQL のインストール ....................................................................................................17
1.4. MySQL での準備 ................................................................................................................38
1.5. MySQL 接続用 DSN の設定 ..............................................................................................54
2. Cache のセットアップ...............................................................................................................58
3. Cache SQL Gateway のセットアップ ......................................................................................70
4. リンクテーブル機能..................................................................................................................77
4.1. ネームスペース「LINKTABLE」の設定.........................................................................77
4.2. リンクテーブルの設定.......................................................................................................86
4.3. リンクテーブルの確認.......................................................................................................94
4.3.1. リンクテーブルへのデータ登録と確認（オブジェクト） .................................. 105
4.3.2. リンクテーブルの確認（MySQL） ......................................................................... 109
4.3.3. リンクテーブルへのデータ登録と確認（SQL） .................................................. 111
5. データ移行機能 ....................................................................................................................... 113
5.1. ネームスペース「DATAIKOU」の設定 ........................................................................ 113
5.2. データ移行処理の実施..................................................................................................... 114
5.3. 移行テーブル確認............................................................................................................. 121
3 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
MySQL のセットアップ
1.
この資料では、Cache SQL Gateway 機能で接続する外部 DB に MySQL を利用してい
ます。
下記に MySQL のダウンロードからインストールについて記載します。
利用中のシステムに.NET Framework 4.0 がセットアップされていない場合には、
MySQL をインストールする時に、.NET Framework 4.0 のインストールを先行して実施す
るようにメッセージが表示されます。この資料では、.NET Framework 4.0 のインストー
ルも含めて記載しています。
なお、MySQL、.NET Framework 4.0 をダウンロードするホームページアドレスや、各
製品のバージョン等は、本書記載時と異なる場合があります。
1.1.
MySQL のダウンロード
最新版の MySQL は下記のアドレスからダウンロードすることができます。
http://www-jp.mysql.com/
4 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
表示されたホームページの「ダウンロード（GA）」タブをクリックして、MySQL Installer
for Windows 部分の［Download］ボタンを押下クリックします。
5 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
Download MySQL Installer 画面が表示されたら、Select Platform で「Microsoft Windows」
を選択します。
次に、
「Windows (x86, 32bit), MSI Installer」の右横にある［Download］ボタンをクリッ
クします。
6 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
MySQL.com へのログイン画面が表示されます。
すでに、MySQL.com のアカウントを所有している場合には、画面左側に電子メール
アドレスとパスワードを入力して［Login］ボタンをクリックします。
MySQL.com のアカウントを所有していない場合には、画面右側にある未登録者の
［Proceed］ボタンをクリックして、アカウントを取得します。
この資料では、MySQL.com のアカウントを所有していますので［Login］ボタンをク
リックして、次に進みます。
7 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
MySQL.com へのログイン後、下記の画面（Select a Mirror to Start Downloading –
mysql-installer-5.5.23.0.msi）が表示されます。
MySQL のインストーラファイルをどこからダウンロードするかを選択します。
この資料では、
「JAIST」の「HTTP」を選択します。
8 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「mysql-installer-5.5.23.0.msi を開く」画面が表示されますので［ファイルを保存］ボ
タンをクリックして、利用中のコンピュータにファイルを保存します。
※本書では、ブラウザに Firefox を利用していますので、上記のような画面が表示さ
れますが、他のブラウザをご利用の場合には、各ブラウザのダウンロード画面がさ
れます。
ファイルのダウンロードが完了したら、ダウンロードしたファイル
（mysql-installer-5.5.23.0.msi）をダブルクリックして、MySQL のインストールを開始し
ます。
（この資料では、C:¥MySQL にダウンロードファイルを保存しています。）
9 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
インストールファイル（mysql-installer-5.5.23.0.msi）をダブルクリックすると、下記の
ようなセキュリティ警告画面が表示されますので、
［実行］ボタンをクリックします。
この資料では、使用するシステムに.NET FRamework 4.0 がセットアップされていませ
んので、下記のような画面が表示されます。メッセージの内容を確認し［OK］ボタンを
クリックします。MySQL のインストールはキャンセルされます。
10 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
1.2.
.NET Framework 4.0 のダウンロードとインストール
MySQL のインストールに先行して、.NET Framework 4.0 をインストールするために、
下記のホームページから.NET Framework 4.0 のインストールファイルをダウンロードし
ます。
http://www.microsoft.com/ja-jp/net/netfx4/download.aspx/
下記の「.NET Framework 4 ダウンロード」画面が表示されます。
この資料では、標準インストーラーをダウンロードして使用しますので、画面上の「標
準インストーラー」をクリックします。
11 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
Microsoft Download Center Microsoft .NET Framework 4（スタンドアロンのインストー
ラー）画面が表示されたら［ダウンロード］ボタンをクリックします
「dotNetFx40_Full_x86_x64.exe を開く」画面が表示されますので［ファイルを保存］
ボタンをクリックして、利用中のコンピュータにファイルを保存します。
※本書では、ブラウザに Firefox を利用していますので、上記のような画面が表示さ
れますが、他のブラウザをご利用の場合には、各ブラウザのダウンロード画面が表
示されます。
12 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
ファイルのダウンロードが完了したら、ダウンロードしたファイル
（dotNetFx40_Full_x86_x64.exe）をダブルクリックして、.NET Framework 4.0 のインスト
ールを開始します。
（この資料では、C:¥MySQL にダウンロードファイルを保存していま
す。
）
インストールファイル（dotNetFx40_Full_x86_x64.exe）をダブルクリックすると、下
記のようなセキュリティ警告画面が表示されますので、
［実行］ボタンをクリックします。
13 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
インストールファイル（dotNetFx40_Full_x86_x64.exe）を利用できるように解凍する
画面が表示されます。
.NET Framework 4 セットアップ画面が表示されたら、
「□同意する」をチェック（☑）
して［インストール］ボタンをクリックします。
14 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
.NET Framework 4 のインストール進捗状況画面が表示されますので、インストールが
終了するのを待ちます。
15 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
.NET Framework 4 のインストールが終了すると「インストールが完了しました」画面
が表示されます。画面の内容を確認して［完了］ボタンをクリックします。
.NET Framework 4 のインストールを完了するために、コンピュータの再起動を要求す
る画面が表示されます。起動中のアプリケーションがある場合には、それらを終了し［今
すぐ再起動］ボタンをクリックして、コンピュータを再起動します。
※特別な理由がなければ、今すぐ再起動することをお勧めします。
16 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
1.3.
MySQL のインストール
※.NET Framework 4 をインストールした後、コンピュータを再起動しましたので、
MySQL をインストールする環境が整いました。
ファイルのダウンロードが完了したら、ダウンロードしたファイル
（mysql-installer-5.5.23.0.msi）をダブルクリックして、MySQL のインストールを開始し
ます。
（この資料では、C:¥MySQL にダウンロードファイルを保存しています。）
インストールファイル（mysql-installer-5.5.23.0.msi）をダブルクリックすると、下記の
ようなセキュリティ警告画面が表示されますので、
［実行］ボタンをクリックします。
17 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
MySQL のインストーラーが準備をしている状況（１）が表示されます。
MySQL のインストーラーが準備をしている状況（２）が表示されます。
MySQL のインストーラーの準備が完了すると、「Welcome」画面が表示されます。
「Install MySQL Products」をクリックして、MySQL をインストールします。
18 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「License Agreement」
（ライセンス許諾）画面が表示されますので、画面上の内容を確
認し、ライセンス許諾内容に合意できる場合には「□ I accept the license terms」をチェッ
ク（☑）し、
［Next >］ボタンをクリックします。
ライセンス許諾内容に合意できない場合には［Cancel］ボタンをクリックします。
19 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Find latest products」画面が表示されますので、
［Execute］ボタンをクリックします。
20 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Find latest products」画面での処理が完了すると、下記のような画面が表示されます。
画面の内容を確認後、
［Next >］ボタンをクリックします。
21 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Choose a Setup Type」画面が表示されます。
「Developer Default」を選択し［Next >］ボタンをクリックします。
22 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Check Requirements」画面が表示されます。
画面の内容を確認後、
［Execute］ボタンをクリックします。
23 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Check Requirements」画面の処理の中で、「Microsoft Visual C++ 2010 x86 Redistributable セ
ットアップ」画面が表示されます。
「□同意する」にチェック（☑）して［インストール］ボタンをクリックします。
24 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
下記のような「Microsoft Visual C++ 2010 x86 Redistributable セットアップ」画面が表
示されますので、インストールの完了を待ちます。
25 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Microsoft Visual C++ 2010 x86 Redistributable セットアップ」が完了すると、下記の
ような画面が表示されますので［完了］ボタンをクリックします。
26 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Check Requirments」画面が表示されます。
画面に表示されている内容を確認後、［Next >］ボタンをクリックします。
27 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Installation Progress」画面が表示されますので、
［Execute］ボタンをクリックします。
28 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Installation Progress」画面の処理を実施している中で、下記のような画面が表示され
ますが、必要な処理を実施後、自動的に画面が消去されます。
画面が自動的に消去されるのを待ちます。
29 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Installation Progress」画面の処理が完了すると、下記のような画面が表示されます。
画面に表示されている内容を確認後、［Next >］ボタンをクリックします。
30 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Configuration Overview」画面が表示されます。
画面に表示されている内容を確認後、［Next >］ボタンをクリックします。
31 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「MySQL Server Configuration」画面が表示されます。
「Developer Machine」を選択し、［Next >］ボタンをクリックします。
32 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「MySQL Server Configuration」画面が表示されます。
「□ Enable TCP/IP Networking」をチェック（☑）します。
「□ Create Windows Service」をチェック（☑）します。
「Security Setting」
で MySQL Root のパスワードを入力します。
（この資料では、
”abcdef”
としています。
）
上記の項目の内容を確認後、
［Next >］ボタンをクリックします。
33 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Configuration Overview」画面が表示され、処理の進捗状況が表示されます。
処理の完了を待ちます。
34 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
下記のような「Configuration Overview」画面が表示されたら、画面に表示されている
内容を確認後、
［Next >］ボタンをクリックします。
35 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
下記のような「Configuration Overview」画面が表示されたら、画面に表示されている
内容を確認後、
［Next >］ボタンをクリックします。
36 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Installation Complete」画面が表示されたら、
［Finish］ボタンをクリックします。
上記の画面では「Start MySQL Workbench after Setup」がチェック（☑）されています
ので、この画面が閉じられた後、MySQL Workbench が起動されます。
37 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
1.4.
MySQL での準備
Cache SQL Gateway 機能を確認するために、MySQL 側でテーブルを作成して、テス
トデータを登録します。
MySQL Workbench が起動したら「Local Instance MySQL55」をダブルクリックします。
38 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Connect to MySQL Server」画面が表示されます。
MySQL インストール時に設定した User：root のパスワードを Password 入力欄に入力
して［OK］ボタンをクリックします。
※１：この資料ではパスワードを“abcdef”としています。
※２：この資料ではパスワードを記憶させるために、
「□ Save password in vault」をチ
ェック（☑）しています。
）
39 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
MySQL Workbench が起動したら、スキーマを登録します。
「Object Browser」→「SCHEMAS」欄の「test」を右クリックして表示されるメニュ
ーの「Create Schema…」をクリックします。
40 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
スキーマを登録する画面が表示されます。
「Name：」入力欄に「Animal」と入力後、
［Apply］ボタンをクリックします。
41 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Review the SQL Script to be Applied on the Database」画面が表示されます。
画面に表示されている内容を確認後、［Apply］ボタンをクリックします。
42 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Applying SQL script to the database…」画面が表示されます。
画面に表示されている内容を確認後、［Finish］ボタンをクリックします。
43 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
次にテーブルを登録します。
「Object Browser」→「SCHEMAS」欄の「animal」→「tables」を右クリックして表示
されるメニューの「Create Table…」をクリックします。
44 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
テーブルを登録する画面が表示されます。
下記の内容を入力後、
［Apply］ボタンをクリックします。
テーブル関連
Table Name：
dog
カラム関連
Column Name
Data Type
PK
NN
UQ
BIN
UN
ZF
AI
Default
iddog
INT(11)
☑
☑
Namae
VARCHAR(45)
NULL
TEL
VARCHAR(45)
NULL
☑
45 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Review the SQL Script to be Applied on the Database」画面が表示されます。
画面に表示されている内容を確認後、［Apply］ボタンをクリックします。
46 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Applying SQL script to the database…」画面が表示されます。
画面に表示されている内容を確認後、［Finish］ボタンをクリックします。
47 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
次にテーブルにデータを登録します。
「Object Browser」→「SCHEMAS」欄の「animal」→「tables」→「dog」を右クリッ
クして表示されるメニューの「Edit Table Data」をクリックします。
48 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
テーブルにデータを登録する画面が表示されます。
下記の内容を入力後、
［Apply］ボタンをクリックします。
iddog
Namae
Tel
(null)
太郎
愛知県
(null)
次郎
岐阜県
49 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Review the SQL Script to be Applied on the Database」画面が表示されます。
画面に表示されている内容を確認後、［Apply］ボタンをクリックします。
50 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Applying SQL script to the database…」画面が表示されます。
画面に表示されている内容を確認後、［Finish］ボタンをクリックします。
51 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
テーブルに登録されたデータを確認します。
「Object Browser」→「SCHEMAS」欄の「animal」→「tables」→「dog」を右クリッ
クして表示されるメニューの「Select Rows – Limit 1000」をクリックします。
52 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
下記のようにテーブル（animal.dog）にデータが登録されていることが確認できます。
53 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
1.5.
MySQL 接続用 DSN の設定
Cache SQL Gateway では、ODBC を利用して MySQL に接続してデータベースのデー
タを読み書きします。
Cache SQL Gateway が ODBC 経由で MySQL に接続できるように、ODBC データソー
スアドミニストレーターを利用して DSN を設定します。
「Windows のスタートボタン」→「管理ツール」→「データソース（ODBC）」を選
択します。
54 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
ODBC データソースアドミニストレーター画面が表示されたら、
「システム DSN」タ
ブを選択し、
［追加］ボタンをクリックします。
「データソースの新規作成」画面が表示されたら、
「MySQL ODBC 5.1 Driver」を選択
し、
［完了］ボタンをクリックします。
55 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「MySQL Connector / ODBC Data Source Configuration」画面が表示されたら、下記のよ
うに値の入力／選択をします。
［入力値］
項目名称
値
備考
Data Source Name
MySQL55
Description
---
TCP/IP Server
選択します
Port
3306
Named Pipe
---
User
root
Password
abcdef
この資料の場合
Database
animal
▼をクリックして候補を
既定値
表示できます
入力値の妥当性を確認するために［Test］ボタンをクリックします。
56 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
下記のように「Connection successful」と表示されることを確認します。
表示された内容を確認後［OK］ボタンをクリックします。
ODBC データソースアドミニストレーター画面に登録した「MySQL55」の内容が表示
されます。
57 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
2.
Cache のセットアップ
Cache インストールファイル（cache-2012.1.1.602-win_x64.exe）をダブルクリックして、
Cache のインストールを開始します。
（この資料では、C:¥Cache にインストールファイル
を保存しています。
）
Cache インストールファイルの準備処理実行中に下記のようにいくつかの画面が表示
されます。
58 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
59 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」画面が表示されます。
使用許諾契約書の内容を確認し、その内容に同意できる場合には、「使用許諾契約の
条項に同意します」をチェックした後、
［次へ(N) >］ボタンをクリックします。
※使用許諾契約書の内容を確認し、その内容に同意できない場合には、
［キャンセル］
ボタンをクリックして、Cache のインストールをキャンセルします。
60 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」の「Cache インスタンス名」画面が表示されます。
Cache インスタンス名を入力します。
特に問題がなければ、既定値「CACHE」としておきます。
画面の内容を確認後、
［次へ(N) >］ボタンをクリックします。
61 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」の「インストール先のフォルダ」画面が表示されま
す。
Cache のインストール先を指定します。
特に問題がなければ、既定値「C:InterSystems¥Cache¥」としておきます。
画面の内容を確認後、
［次へ(N) >］ボタンをクリックします。
62 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」の「セットアップ タイプ」画面が表示されます。
この資料では「開発」を選択します。
画面の内容を確認後、
［次へ(N) >］ボタンをクリックします。
63 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」の「Unicode 版をインストールしますか？」画面が
表示されます。
特に問題がなければ、既定値「Unicode」を選択しておきます。
画面の内容を確認後、
［次へ(N) >］ボタンをクリックします。
64 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」の「初期セキュリティ設定」画面が表示されます。
特に問題がなければ、既定値「最少」を選択しておきます。
画面の内容を確認後、
［次へ(N) >］ボタンをクリックします。
65 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」の「プログラムをインストールする準備ができまし
た」画面が表示されます。
画面の内容を確認後、
［インストール(I) >］ボタンをクリックします。
66 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
Cache のインストールが開始されると、下記のようないくつかの画面が表示されます。
Cache のインストール完了を待ちます。
67 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」の「Cache インストレーションが完了しました」画
面が表示されます。
画面の内容を確認後、
［完了(F) >］ボタンをクリックします。
※画面上の「□ 「はじめに」ページを表示する」をチェック（☑）しておくと、次
ページのような「はじめに」画面が表示されます。
68 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Cache – インストレーション」の「Cache インストレーションが完了しました」画
面で「□ 「はじめに」ページを表示する」をチェック（☑）しておいた場合に、下記の
ような「はじめに」画面が表示されます。
69 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
3.
Cache SQL Gateway のセットアップ
Cache SQL Gateway に MySQL への接続情報を登録します。
Windows のタスクトレイに表示されている Cache キューブ
をクリックします。
下記のような Cache メニュー画面が表示されますので、
「管理ポータル」をクリック
します。
※この資料では、デフォルトブラウザに Firefox を指定していますので、これ以降の
管理ポータル画面が Firefox の画面となっています。ご利用のシステムによって、デ
フォルトブラウザの設定が異なる可能性がありますので、表示される画面が異なる
場合があります。
70 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「管理ポータル」画面が表示されます。
「システム管理」→「構成」→「接続性」→「SQL ゲートウェイ 接続」を選択しま
す。
71 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「SQL ゲートウェイ 接続」画面が表示されます。
［新規接続作成］ボタンをクリックします。
72 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「ゲートウェイ 接続」画面が表示されます。
下記の値を入力します。
［入力値］
項目
値
備考
接続の種類
「ODBC」を選択
接続名
MySQL55
任意の名称を指定します
DSN を選択して下さい
MySQL55
システム DSN で設定した名
称
ユーザ
root
MySQL に設定しているユ
ーザ
パスワード
本書では“abcdef”
MySQL に設定しているパ
スワード
レガシーouter join(Sybase)を
□
初期値
長いサイズのデータが必要
□
初期値
Unicode ストリームのサポー
☑
初期値
□
初期値
COALESCE 使用
☑
初期値
複合 Row ID 内で変換
{fn convert…}を選択
初期値
有効に
ト
デフォルトで区切り識別子を
使用しない
73 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
設定値に問題がないかを確認するために［テスト接続］ボタンをクリックします。
下記の画面のように、画面左下に「接続が成功しました」と表示されることを確認し
ます。
74 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
接続テストが正常に実施できたことを確認した後、
［保存］ボタンをクリックします。
下記の画面のように、画面右下に「接続が保存されました」を表示されたことを確認
します。画面上の［閉じる］ボタンをクリックします。
75 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「SQL ゲートウェイ 接続」画面に、登録した接続名「MySQL55」が表示されること
を確認します。
76 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
リンクテーブル機能
4.
Cache にネームスペース「LINKTABLE」を設定し、Cache SQL Gateway 機能を利用し
たリンクテーブル機能の動作確認を実施します。
4.1.
ネームスペース「LINKTABLE」の設定
管理ポータル画面で「システム管理」→「構成」→「システム構成」→「ネームスペ
ース」をクリックします。
77 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「ネームスペース」画面が表示されます。
［新規ネームスペース作成］ボタンをクリックします。
78 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「新規ネームスペース」画面が表示されます。
ネームスペース名に「LINKTABLE」を入力します。
「□ このネームスペースにデフォルトのウェブアプリケーションを作成」は、□（初
期値は☑）とします。
画面の内容を確認後、
［新規データベース作成］ボタンをクリックして、データベー
ス作成を実施します。
79 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「データベースウィザード」画面が表示されます。
下記の値を入力した後、
［次へ >］ボタンをクリックします。
［入力値］
データベースの名前を入力
LINKTABLE
データベースディレクトリ
C:¥DB¥LINKTABLE
80 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「データベースウィザード」画面（データベースの説明を入力して下さい）が表示さ
れます。
下記の値を入力した後、
［次へ >］ボタンをクリックします。
［入力値］
データベースの初期サイズ
1（MB）
初期値
ジャーナルグローバル
はい
初期値
暗号化データベース？
□
初期値
81 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「データベースウィザード」画面（データベースリソースは Cache データベースへの
アクセスをコントロールします）が表示されます。
下記の値を入力した後、
［次へ >］ボタンをクリックします。
［入力値］
このデータベースのデー
デフォルトリソースを使用
タベースリソースは何で
する、%DB_%DEFAULT
初期値
すか？
82 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「データベースウィザード」画面（ウィザードを終了しようとしています…）が表示
されます。
画面の内容を確認した後、
［完了］ボタンをクリックします。
83 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「新規ネームスペース」画面が表示されます。
画面の内容を確認した後、
［保存］ボタンをクリックします。
84 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「ネームスペース」画面が表示されます。
追加したネームスペース「LINKTABLE」が表示されていることを確認します。
85 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
4.2.
リンクテーブルの設定
作成したネームスペース「LINKTABLE」に対して、MySQL へのリンクテーブル設定
を実施します。
管理ポータル画面で「システムエクスプローラ」→「SQL」→「リンクテーブルウィ
ザード」をクリックします。
86 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「リンクテーブルウィザード（ネームスペース LINKTABLE）」画面（リンクテーブ
ルウィザードは、定義済みの Cache ゲートウェイ 接続を使用して SQL テーブルのリン
クを作成する作業のお手伝いをします。
）が表示されます。
下記の値を入力した後、
［次へ >］ボタンをクリックします。
［入力値］
目的のネームスペースをネームスペース
LINKTABLE
を選択してください
▼で候補を表示
できます
SQL ゲートウェイ 接続を選択してくださ
MySQL55
い
テーブルタイプ
テーブル
スキーマ
[null schema]
テーブル
dog
87 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「リンクテーブルウィザード（ネームスペース LINKTABLE）」画面（カラムを選択
してください）が表示されます。
使用したいカラムを選択します。（この資料ではすべてのカラムを選択しています。
）
画面の内容を確認した後、
［次へ >］ボタンをクリックします。
88 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「リンクテーブルウィザード（ネームスペース LINKTABLE）」画面（選択したカラ
ムの属性を指定したり、指定したテキストボックスのプロパティカラム名を変更するこ
とができます。
）が表示されます。
必要に応じて設定内容を変更します。（この資料ではすべての初期値を選択していま
す。
）
画面の内容を確認した後、
［次へ >］ボタンをクリックします。
89 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「リンクテーブルウィザード（ネームスペース LINKTABLE）」画面（ウィザードを
終了しています。
）が表示されます。
必要に応じて設定内容を変更します。
（この資料では、クラス名を「dog」に変更して
います。
）
画面の内容を確認した後、
［完了］ボタンをクリックします。
90 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
リンクテーブルウィザードの最終画面で［完了］ボタンをクリックすると、リンクテ
ーブルの設定処理が実施されます。この時、画面上には「バックグラウンドジョブ」画
面が表示されます。
この「バックグラウンドジョブ」画面に表示されている「バックグラウンドタスクペ
ージを参照するにはここをクリックしてください」をクリックして、リンクテーブル処
理の結果情報を確認します。
91 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「バックグラウンドジョブ」画面に表示されている「バックグラウンドタスクページ
を参照するにはここをクリックしてください」をクリックすると、下記のような処理結
果表示画面が表示されます。
処理結果の内容を確認後、
［ウィンドウを閉じる］ボタンをクリックします。
※下記の画面では「エラーカウント」欄が空白となっています。このように空白とな
っている場合には、エラーが無かったことを示します。もし、何らかのエラーが確
認された場合には、エラー件数（1,2,3…）が表示されます。また、その値をクリッ
クすると、エラーの原因情報を確認することができます。
92 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「リンクテーブルウィザード（ネームスペース LINKTABLE）」画面（ウィザードを
終了しています。
）が表示されます。
画面の内容を確認した後、
［完了］ボタンをクリックします。
以上で、リンクテーブルの設定処理は終了です。
93 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
4.3.
リンクテーブルの確認
これまでに設定したリンクテーブルの内容を、Cache の SQL 機能を利用して確認しま
す。
管理ポータル画面で「システムエクスプローラ」→「SQL」→「SQL スキーマを参照」
をクリックします。
94 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「スキーマ」画面が表示されます。
画面左側の「ネームスペース」欄の「LINKTABLE」を選択します。
画面右側に表示される「スキーマ」の「SQLUser」を選択（クリック）します。
※スキーマ「SQLUser」は Cache が既定値としてテーブルに設定するスキーマ名です。
95 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブル」画面が表示されます。
画面右側に表示されるクラス名「User.dog」の右隣にある「テーブルを開く」を選択
（クリック）します。
96 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブルを開く」画面が表示されます。
これまでの設定では、下記のようなエラーが表示されます。
この画面で表示されているエラーの原因は、Cache SQL Gateway の設定情報にありま
す。
「デフォルトで区切り識別子を使用しない」をチェック（☑）する必要があります。
このように「デフォルトで区切り識別子を使用しない」をチェックするか／チェック
しないかは、Cache SQL Gateway が接続する外部 DB の仕様に関わる事項となりますので、
接続する外部 DB の仕様を確認しておく必要があります。
97 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
Cache SQL Gateway の設定情報の変更を実施します。
「システム管理」→「構成」→「接続性」→「SQL ゲートウェイ 接続」を選択しま
す。
98 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「SQL ゲートウェイ接続」画面が表示されます。
画面右側に表示される接続情報の接続名「MySQL55」行の「編集」を選択（クリック）
します。
99 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「ゲートウェイ 接続」画面が表示されます。
下記の値を変更します。
［入力値］
項目
値
備考
デフォルトで区切り識別子を
☑
変更前の値は□
使用しない
テスト接続を実施し、MySQL への接続が確認できた後、
［保存］ボタンをクリックし
ます。
100 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
ゲートウェイ 接続情報を変更後、もう一度、MySQL への接続をテストします。
管理ポータル画面で「システムエクスプローラ」→「SQL」→「SQL スキーマを参照」
をクリックします。
101 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「スキーマ」画面が表示されます。
画面左側の「ネームスペース」欄の「LINKTABLE」を選択します。
画面右側に表示される「スキーマ」の「SQLUser」を選択（クリック）します。
102 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブル」画面が表示されます。
画面右側に表示されるクラス名「User.dog」の右隣にある「テーブルを開く」を選択
（クリック）します。
103 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブルを開く」画面が表示されます。
下記の画面のように MySQL（MySQL Workbench）で登録した値が表示されることを
確認します。このように画面に表示される値は、その時点で Cache が MySQL に接続し
て取得した値です。
※もし、上記のように MySQL に登録されている値が表示されない場合には、リンク
テーブルで設定したテーブル（dog）を削除後、再度リンクテーブルウィザードを使
用してリンクテーブル（dog）を設定します。
104 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
4.3.1.
リンクテーブルへのデータ登録と確認（オブジェクト）
リンクテーブルとして設定したテーブル（dog）に Cache ターミナルを使用してデー
タを登録します。
（後ほど、MySQL Workbench にて登録されたデータの確認をします。
）
Cache キューブから「ターミナル」を選択（クリック）します。
※Cache では、すべてのテーブルはクラスとして、また、すべてのクラスはテーブル
として取り扱うことができます。この仕様により、リンクテーブル（Cache SQL
Gateway にて接続した外部 DB のテーブル）もクラスとして操作することができま
す。
105 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
Cache ターミナルが起動したら、下記のようにコマンドを入力します。
（画面のサンプル）
（入力するコマンド：
「>」の左側をコピーして利用できます。）
USER>zn "LINKTABLE"
LINKTABLE>set obj=##class(dog).%New()
LINKTABLE>set obj.iddog=3
LINKTABLE>set obj.Namae="三郎"
LINKTABLE>set obj.Tel="三重県"
LINKTABLE>w obj.%Save()
1
LINKTABLE>set obj=""
106 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
先ほど dog テーブルのデータを確認した「テーブルを開く」画面を利用します。
「テーブルを開く」画面の［更新］ボタンをクリックします。
107 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブルを開く」画面の内容が下記のように表示されることを確認します。
※Namae「三郎」に表示されているデータは、Cache ターミナルで Cache Object Script
を利用して、dog クラス（User.Dog）にデータを登録した内容です。
108 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
4.3.2.
リンクテーブルの確認（MySQL）
Cache にて登録したデータを MySQL Workbench にて確認します。
MySQL Workbench の Object Browser から「SCHEMAS」→「animal」→「Tables」→「dog」
を選択し、
「dog」上で右クリックします。表示されたメニューの「Select Rows – Limit 1000」
をクリックします。
109 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
MySQL Workbench の結果表示欄に Cache にて登録したデータ（Namae：三郎）の値が
表示されることを確認できます。
※このように MySQL のテーブルに対して、Cache 側ではそのテーブルをクラスとし
て操作してデータを読み書きできます。
110 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
4.3.3.
リンクテーブルへのデータ登録と確認（SQL）
リンクテーブルとして設定したテーブル（dog）に CacheSQL を使用してデータを登
録します。
（後ほど、MySQL Workbench にて登録されたデータの確認をします。）
管理ポータル画面で「システム」→「SQL」→「SQL クエリ実行」をクリックします。
「SQL クエリ実行」画面が表示されます。
画面左側のネームスペースの「LINKTABLE」を選択します。
画面右側に表示される画面で下記の SQL コマンドを入力後、
［クエリ実行］ボタンを
クリックします。
画面下部に「完了」と表示されることを確認します。
（画面のサンプル）
111 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
（SQL コマンド：SQL コマンドをコピーして使用できます。
）
insert into dog
set
Namae='四朗'
, Tel='滋賀県'
4.3.2. リンクテーブルの確認（MySQL）と同様の手順で、CacheSQL にて登録したデ
ータを MySQL Workbench にて確認します。
MySQL Workbench の結果表示欄に Cache にて登録したデータ（Namae：四朗）の値が
表示されることを確認できます。
以上でリンクテーブルに対するデータ操作の動作確認は終了です。
112 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
データ移行機能
5.
Cache にネームスペース「DATAIKOU」を設定し、Cache SQL Gateway 機能を利用し
たデータ移行機能の動作確認を実施します。
5.1.
ネームスペース「DATAIKOU」の設定
ネームスペース「DATAIKOU」の設定手順は、
「4.1. ネームスペース「LINKTABLE」
の設定」と同様です。
（4.1. ネームスペース「LINKTABLE」の設定、を参照して下さい。
）
113 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
5.2.
データ移行処理の実施
作成したネームスペース「DATAIKOU」に対して、MySQL のテーブル設定・データ
移行を実施します。
管理ポータル画面で「システムエクスプローラ」→「SQL」→「データ移行ウィザー
ド」をクリックします。
114 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「データ移行ウィザード（ネームスペース DATAIKOU）」画面（データ移行ウィザー
ドは、定義済みの Cache ゲートウェイ 接続を使用して SQL テーブル定義とそのデータ
をコピーするお手伝いをします。
）が表示されます。
下記の値を入力した後、
［次へ >］ボタンをクリックします。
［入力値］
目的のネームスペースをネームスペース
DATAIKOU
を選択してください
▼で候補を表示
できます
SQL ゲートウェイ 接続を選択してくださ
MySQL55
い
テーブルタイプ
テーブル
スキーマ
[null schema]
テーブル
dog
115 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「データ移行ウィザード（ネームスペース DATAIKOU）」画面（新しいスキーマ名を
指定したり、各テーブルビューで定義またはデータをコピーするかどうかを指定できま
す。
）が表示されます。
必要に応じて設定内容を変更します。（この資料ではすべての初期値を選択していま
す。
）
画面の内容を確認した後、
［次へ >］ボタンをクリックします。
116 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「データ移行ウィザード（ネームスペース DATAIKOU）」画面（ウィザードを終了し
ています。
）が表示されます。
必要に応じて設定内容を変更します。（この資料ではすべての初期値を選択していま
す。
）
画面の内容を確認した後、
［完了］ボタンをクリックします。
117 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
データ移行ウィザードの最終画面で［完了］ボタンをクリックすると、データ移行処
理が実施されます。この時、画面上には「バックグラウンドジョブ」画面が表示されま
す。
この「バックグラウンドジョブ」画面に表示されている「バックグラウンドタスクペ
ージを参照するにはここをクリックしてください」をクリックして、リンクテーブル処
理の結果情報を確認します。
118 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「バックグラウンドジョブ」画面に表示されている「バックグラウンドタスクページ
を参照するにはここをクリックしてください」をクリックすると、下記のような処理結
果表示画面が表示されます。
処理結果の内容を確認後、
［ウィンドウを閉じる］ボタンをクリックします。
※上記の画面で、背景色が赤色に表示されている行は、何らかのエラーが確認された
処理を示しています。「エラーカウント」欄の「1」をクリックすると、エラー内容
の詳細を確認することができます。
119 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「データ移行ウィザード（ネームスペース DATAIKOU）」画面（ウィザードを終了し
ています。
）が表示されます。
画面の内容を確認した後、
［完了］ボタンをクリックします。
以上でデータ移行ウィザード処理は終了です。
120 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
5.3.
移行テーブル確認
データ移行機能を利用して移行したテーブル（dog）の内容を確認します。
管理ポータル画面で「システム」→「SQL」→「SQL スキーマを参照」をクリックし
ます。
121 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「スキーマ」画面が表示されます。
画面右側のネームスペースで「DATAIKOU」を選択します。
画面左側に表示される一覧表からスキーマ「SQLUser」を選択（クリック）します。
122 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブル」画面が表示されます。
画面右側に表示されるクラス名「User.dog」の右隣にある「テーブルを開く」を選択
（クリック）します。
123 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブルを開く」画面が表示されます。
下記の画面のように MySQL（MySQL Workbench）から移行した値が表示されること
を確認します。
※この時点で MySQL と Cache は別々にデータを操作できる環境となりました。以下
では、MySQL で登録したデータが Cache に影響を与えないこと、また、Cache で登録し
たデータが MySQL に影響を与えないことを確認します。
124 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
MySQL Workbench を使用して、animal.dog テーブルにデータを 1 件追加します。
（追加するデータ）
Name
五郎
Tel
石川県
画面上でデータを追加した後、
［Apply］ボタンをクリックします。
125 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Review the SQL Script to be Applied on the Database」画面が表示されます。
画面に表示されている内容を確認後、［Apply］ボタンをクリックします。
126 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「Applying SQL script to the database…」画面が表示されます。
画面に表示されている内容を確認後、［Finish］ボタンをクリックします。
127 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブル」画面を表示します。
管理ポータル画面で「システム」→「SQL」→「SQL をスキーマ参照」をク
リックします。
「スキーマ」画面が表示されます。
画面右側のネームスペースで「DATAIKOU」を選択します。
画面左側に表示される一覧表からスキーマ「SQLUser」を選択（クリック）し
ます。
画面右側に表示されるクラス名「User.dog」の右隣にある「テーブルを開く」を選択
（クリック）します。
128 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
「テーブルを開く」画面が表示されます。
下記の画面のように MySQL（MySQL Workbench）で登録したデータが表示されない
ことを確認します。
129 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
※なお、この時点でネームスペース「LINKTABLE」の dog テーブルには、MySQL
（MySQL Workbench）で登録したデータが表示されます。
130 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
次に Cache ターミナルで dog テーブル（User.dog クラス）にデータを登録した内容が
MySQL データベースに反映されないことを確認します。
Cache ターミナルが起動したら、下記のようにコマンドを入力します。
（画面のサンプル）
（入力するコマンド：
「>」の左側をコピーして利用できます。）
USER>zn "DATAIKOU"
DATAIKOU>set obj=##class(dog).%New()
DATAIKOU>set obj.Namae="六朗"
DATAIKOU>set obj.Tel="静岡県"
DATAIKOU>w obj.%Save()
1
DATAIKOU>set obj=""
131 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
4.3.2. リンクテーブルの確認（MySQL）と同様の手順で、CacheSQL にて登録したデ
ータを MySQL Workbench にて確認します。
MySQL Workbench の結果表示欄に Cache にて登録したデータ（Namae：六朗）の値が
表示されないことを確認できます。
このように、データ移行機能を利用してデータベースを移行した後は、MySQL と
Cache が相互に干渉しないことが確認できます。
132 / 133
©有限会社エムブィビィ
CacheSQLGateway_2012.doc
以上で Cache の影響する Cache SQL Gateway 機能を利用したリンクテーブル、データ
移行機能に関する手順は終了です。
この資料についてのご質問等は下記のメールアドレスにご連絡頂けますようにお願
いいたします
（連絡先メールアドレス）
[email protected]
改版履歴
初版
2012 年 4 月 18 日
有限会社エムブィビィ
http://www.mvb.jp
133 / 133
©有限会社エムブィビィ