DolphinDB客户端软件教程

DolphinDB提供了从基于Java的GUI, VS Code Extension, Web界面，到命令行等各种灵活友好的交互界面，具体包括以下6种客户端交互方式。

1. DolphinDB GUI

DolphinDB GUI是基于Java的功能齐全的图形化编程以及数据浏览界面。 DolphinDB GUI可以在任何支持Java的操作系统上使用，例如: Windows, Linux, 以及Mac。DolphinDB GUI的特点是速度快，功能齐全，用户友好的图形化界面。 GUI适合用于管理和开发DolphinDB脚本、模块，以及数据库交互，查看运行结果等。 GUI提供非常友好的编程界面：查找替换文本、保留字高亮显示、系统函数提示、行号显示，选择部分代码执行、执行结果浏览、log信息、临时变量浏览、数据库浏览。 通过Project浏览器，可以浏览所有项目。通过Database浏览器，可以浏览所有DFS数据库以及其分区表的schema。适用于DolphinDB脚本项目管理和程序开发。

1.1 核心概念

Server

GUI菜单中的server是指DolphinDB数据库服务器。完成添加后，会自动出现在server下拉菜单中。默认添加的server为localhost:8848。 这里值得注意的是，连接远端服务器，我们一般建议连接数据节点，因为DolphinDB关于数据库的操作都是在数据节点上执行的。

Login

登录数据库服务器主要有三种方法：

• 在添加server的时候指定用户名和密码
• 通过工具条中的login按钮
• 通过脚本中使用 login函数

Workspace

启动GUI的时候，首先会要求用户指定workspace路径。 Workspace用于项目管理。 Workspace下面可以有多个项目。 GUI同时只能有一个workspace，可以在不同的workspace直接切换.

Project

指定workspace后，可以通过 New Project来创建新的项目，也可以通过Import Folder来导入已有的项目。

File

创建完project后，用户可以在project下面通过New Folder以及New File来生成脚本目录以及脚本文件。脚本文件创建之后，即可通过编辑器来编写、修改、以及执行脚本。

Synchronize to server

在远端服务器上执行一个脚本文件或者调用了一个module都会在该服务器上查找对应的脚本文件。当GUI和DolphinDB server不在一个机器上时，有可能需要把本地新编辑的脚本文件同步到远程服务器上。 为此，DolphinDB提供了Synchronize to server, 即文件同步功能。在项目浏览器中右键点击需要同步的目录或者文件，并选择 Synchronize to server，将其传送到服务器的对应目录。 在添加远程服务器的同时可以指定服务器相应目录。如果添加的时候未指定，则可通过 Server->Edit Server菜单来指定。例如远端目录是'/home/usr1"， 而本地需要同步的文件名是"C:/users/usr1/Project/scripts/test.dos, 同步的时候，系统会在远端自动创建目录和相应文件'/home/usr1/Project/scripts/test.dos'。

1.2 安装和启动

在启动GUI前，需要确保已经安装java 8 64bit以及以上版本。

DolphinDB GUI无需安装，可以直接运行。在Windows环境下，双击gui.bat即可。在Linu和Mac环境下，在Terminal中输入：

cd /your/gui/folder
./gui.sh