Marklogic学习 由浅入深（4）—— 初识Query Console

前言： query console是Marklogic为了便于开发者快速测试代码，调试问题，资料查询，运行XQuery脚本而设计的查询控制台。本节主要介绍它的基本结构和使用要点。

Marklogic qconsole简介

qConsole启动

在win7上，直接在浏览器输入http://localhost:8000/qconsole/。输入用户名好密码，可以看到下图展示界面

如果Marklogic安装在其他服务器上，访问方式应为http://host_name:8000/qconsole
如果没有看到上面界面，可能是权限不够，要想使用qConsole,还必须成为qconsole-user成员，admin用户可以管理成员。
有时你的权限可能是只读，你可以正常打开上述页面，并执行相关的查询操作，但当你运行诸如文档插入或删除命令时，会被Marklogic拒绝。
对于某一特定用户，Marklogic只会保持一个session在server端。如果某一用户同时开启多个qConsole, 它们的状态会不一致，因此最好不要多个浏览器或标签页下使用同一用户名登陆。

---

在windows下，如果Marklogic是以默认方式安装的，会开机自启动，可能会拖慢开机速度。以下方式可以将其变为手动启动：
计算机 –> （右键） –> 管理 –> 服务和应用程序 –> 服务 – > MarkLogic


常规 –> 启动类型 –> 手动 –>确定

下次开机后，就不能直接在浏览器中输入qConsole地址打开，而是需要先手动启动服务

qConsole组件

query 可以执行的XQuery， SQL， SPARQL，JavaScript脚本。当你在Query Console中运行语句时，可以在结果区看到result.
workspace 工作区就是一系列的语句集合，可以用workspace来组织你的Query. 你可以创建很多workspace, 但是只有一个是处于激活状态。
history 可以记录你之前运行过的query语句。每在Query Console中执行一次，它变可以历史记录存档。点击任意存档，可以恢复当时的query。
content source 概念同数据库，query console 可以自动为Marklogic构建可用的content sources

qConsole使用

创建query

1. 创建workspace
   点击右上角的workspace下拉按钮，新建一个workspace.
   
2. 添加query
   点击左上角“+”，打开一个新的query编辑界面
   
3. 重命名
   双击query或者workspace的名字，可以重命名
   
4. 选择查询语言
   Query Type的下拉列表可以选择查询的方式，Marklogic 8 支持以下几种查询语言：
   
   • JavaScript
   • XQuery
   • SQL
   • SPARQL Query
   • SPARQL Update
     

运行Query

1. 选择content source
   每一次运行query，都应选择正确的content soure. 本例中，你可以选择任意的content source.
   
2. 点击 “Run”
   
3. 选择结果格式
   

看历史query

每次修改与运行query，qConsole都会将运行脚本与执行时间存档。只有运行过的脚本才会被保存，只有修改过的代码才会生成新的历史记录。qConsole最多保存50条历史记录。

分析Query

qConsole可以分析当前运行query的性能。

浏览数据库

1. 从content source中选择一个数据库
2. 点击右边的 Explore ，在结果区将展示这个数据库中的文件
   
3. 点击蓝色的文件URI链接，会直接打开此文档
4. 来回切换窗口