この記事はMarkLogic Advent Calendar 2017の2日目です。

#はじめに
いよいよ12月となりまして、JucoMLが主催するMarkLogic Advent Calendar 2017に参加することにしました。クリスマスまでよろしくお願いします（既に12月1日分を投稿済みですが・・・）。

MarkLogicといえばスキーマレスのXML/JSON DBですが、魅力的なのはそれだけではなく、多くの機能を搭載しています。MarkLogicの魅力をお伝えしたいと思います。

#なにをやろう
で、テーマをどうするか悩みましたが、ちょうど年末年始に遊ぼうと思っていたRaspberry Pi3や各種センサー類が手元にありますので、これとMarkLogicを連携して何か面白いことをやってみようと思います。

取りあえずは以下のようなことを徐々に投稿していきます。

MarkLogic9のインストール
node.jsとの連携
MQTTでMarkLogicにアクセスしてみる
RaspberryPi3のセンサー情報をMQTTで連携してみる

#今回やること
まずはMarkLogic環境を構築するところから始めます。そして今回の一連の記事で使用するデータベースを構築するところまで実施します。

#環境
以下の環境を使用します。

環境	バージョン等
CentOS7	7.4.1708
MarkLogic9	9.0-3

#注意事項
MarkLogicは商用DBです。商用利用する際にはライセンスの購入が必要になります。
開発目的や今回のような実験目的であれば、無料の開発者ライセンスが使用可能です。

MarkLogicの開発者ライセンスの詳細は以下をご確認下さい。
http://developer.marklogic.com/free-developer

#事前準備
MarkLogicのインストールや設定・管理を行うためには、WebブラウザでMarkLogicに接続する必要があり、ポート番号8001番や8000番を使用します。
CentOS7の場合、firewalldの設定でこれらのポートへのアクセスを許可するか、firewalldを無効化しておいて下さい。

#まずはMarkLogic9のインストール
CentOS7にMarkLogic9をインストールします。MarkLogic9はこの辺りからRPMを入手出来ます。

以下でインストールを実行します。

# yum install MarkLogic-9.0-3.1.x86_64.rpm -y

インストールが完了したら起動します。

# systemctl start MarkLogic.service

MarkLogicのセットアップとデータベース作成

初期設定

インストールと起動が完了したら、MarkLogicの初期設定を行います。
初期設定については、JucoMLのこの記事が参考になります。こちら記事はMarkLogic8ですが、MarkLogic9も同様の手順で設定出来ます。

データベースの作成

初期設定の完了後、今回使用するデータベースを作成します。
Webブラウザで8001番にアクセスし、管理画面を表示します。

データベースを作成するには、管理画面の左ペインから「Databases」をクリックします。次に右ペインの「Create」タブをクリックします。

この画面で必要事項を入力するとデータベースが作成されます。

今回は以下のように設定しました。それ以外は初期値にしておきます。

項目名	設定値
database name	IoTDatabase
language	ja

入力を終えたら、画面の「ok」ボタンを押します。
すると、「This database has no forests, select Database->Forests to attach a forest.」と警告されます。

MarkLogicのデータベース情報は「フォレスト」と呼ばれるファイル群に保存されています。Oracleで例えるなら「データファイル」のようなものでしょうか。
データベースを作成しようとしても、このフォレストが存在しないため警告されました。

フォレストの作成

続いてフォレストを作成します。警告文中の「Database->Forests」リンクを押下すると、フォレストの作成を行えます。

「Create a Forest」を押下します。

上記画面で必要事項を入力して「ok」を押下するとフォレストが作成されます。
「forest name」に「IoTDatabaseForest01」と入力し、それ以外は初期値としました。

フォレストを作成したら、先ほど作成したデータベースに紐付けます。
画面の右ペインの「Summary」タブをクリックすると、現在存在するフォレストの一覧が表示されます。

この中から先ほど作成したフォレスト「IoTDatabaseForest01」を探し、「Databases」列のドロップダウンから紐付けるデータベースを選択します。そして「ok」ボタンを押下するとデータベースにフォレストが紐付き、データベースを使用できるようになります。

#データを登録してみる
作成したデータベースを使用出来るか確認してみます。

今回はQueryConsoleを使用します。Webブラウザ上でXQueryやJavascriptを実行できます。
Webブラウザを起動し、当該サーバの8000番ポートにアクセスしてログインします。

画面右上のドロップダウン「Database」で「IoTDatabase」を選択します。
その右隣の「Query Type:」で「XQuery」を選択します。

そして、以下のクエリを実行してXMLファイルを作成してみます。
クエリをテキストエリアに入力し、「Run」を押下すると実行されます。
ちなみに、「ALT+Enter」でも実行可能です。

xdmp:document-insert("/helloworld.xml", <message>Hello, World</message>)

これでドキュメントが作成されたはずです。確認してみます。

fn:doc("/helloworld.xml")

登録したドキュメントの内容が表示されれば成功です。

#おしまい
MarkLogicはインストールからDB構築まで非常に簡単に実施できる商用DBです。
初期設定のままでも十分使用可能な状態となっています。

#次回予告
次はnode.jsを導入し、MarkLogicと接続してみようと思います。