主题:
【公告】「荏苒之境」数据库系统开放测试
From:
「荏苒之境」 <admin@gilatod.art>
日期:
2021/9/14 下午6:38
收件人:
list@gilatod.art

亲爱的旅人:

「荏苒之境」数据库系统是为「荏苒之境」创作者开放的表格资料存放处,可用于存放架空语言词典、架空事件等信息。

为了使用该数据库系统,首先确保您拥有「荏苒之境」统一账号(详见本网站注册说明页),并下载支持 MySQL 或 MariaDB 格式数据库的本地客户端(例如 TablePlusMySQL Workbench 等)。

本公告将使用 TablePlus 介绍该系统的使用方法,其他数据库客户端操作类似(包括手机版的 TablePlus 或其他移动端应用)。

连接数据库服务器

打开 TablePlus,可见如下引导界面:

点击位于底部的 Create a new connection…(创建一个新的连接),在弹出的菜单中选择 MariaDB,之后在出现的窗口中填入如下信息:

具体而言:

  1. 主机(Host)文本框中输入「荏苒之境」数据库服务器的地址 db.gilatod.art。端口(Port)保持默认的 3306。
  2. 用户名(User)和密码(Password)为您的「荏苒之境」统一账号的用户名(通常为名字的小写形式)与密码。
  3. 数据库(Database)可以留空,在您连接成功后再做选择,也可填入一个连接成功后默认进入的数据库(关于数据库的内容将在后文介绍)。
  4. 「荏苒之境」数据库强制要求使用加密连接,因此 SSL 模式(SSL mode)需要选为 REQUIRED(强制要求)。

输入完成后点击 Connect(连接)即可登录数据库。

数据库系统的结构

包括「荏苒之境」数据库在内的关系形数据库采用如下结构来组织数据:

  1. 数据被存放在表格(Table)中,表格的一行称为一条记录。
  2. 表格本身规定了每一条记录中数据项的个数(即列数),以及每一项数据的格式(文本、数字、日期、文件等等)。
  3. 表格被存放在若干独立的数据库(Database)中,每一个数据库拥有不同的名称与访问权限。

特别地,在「荏苒之境」数据库系统中,存在如下数据库:

  1. public:「荏苒之境」公共数据库。在此数据库中任何用户都可创建、修改、删除任何表格或表格中的记录。
  2. [用户名]_protected:每位「荏苒之境」用户都拥有一个以自己用户名开头、连接“_protected”后缀的数据库,称为该用户的受保护数据库。只有该用户拥有创建、修改、删除表格与表格记录的权限,其他用户只有浏览权限。
  3. [用户名]_private:每位「荏苒之境」用户都拥有一个以自己用户名开头、连接“_private”后缀的数据库,称为该用户的私有数据库。每位用户只能查看或修改自己的私有数据库,其他用户无法访问。

受保护数据库可用于存放展示给其他用户的资料(例如公开的词典、架空世界设定),而私有数据库则可用于存放用户私密或正在编写中的资料。

进入数据库

了解了数据库系统的结构以后,数据库客户端的使用方式就变得易于理解了——我们首先应当选择需要进入的数据库(Database)。点击登陆后出现的主界面上方的数据库菜单项:

连接 public 公共数据库:

进入后主界面左侧的 Tables 栏就是所有表格的显示处:

创建表格

 Tables 上点击右键即可开始新表格的创建流程。数据库系统在创建新的表格时会要求用户指定表格每一列的名称、数据项类型等信息。常见的数据项类型有 TEXT(文本),DATETIME(日期),TIME(时间间隔),BOOLEAN(布尔值,可选值为 true 与 false)等等,具体可查阅 MySQL / MariaDB 数据库教程。

例如,我们可以创建一个人造语言接龙活动的表格(点击下方的 + Column 来加入新的表格列):

具体而言:

  1. # 代表表格每一列的序号,保持默认即可。
  2. column_name 表示列的名称。
  3. data_type 表示该列存放的数据项的类型(见上文)。
  4. is_nullable 表示数据项是否可以为空(在这里我们要求参与接龙的成员的名称,即“参与者”一列不可为空,其余保持默认可为空)。
  5. column_default 表示该列数据项的默认值,可按需求选填。

到目前位置,我们所做的一切修改都是在本地进行的,尚未同步到服务器——这种模式可以防止我们对数据进行误操作而无法撤回修改)。为了提交修改,需要点击窗口顶部的提交按钮:

这样表格就创建成功了。

向表格添加记录

首先我们可以试着向表格添加一个空行,并再次点击提交按钮:

服务器会拒绝我们的提交,因为在创建该表格时指定了参与者一列不可为空。填入参与者与其他信息以后再次点击提交:

可以看到该记录变为蓝色,说明记录提交成功。可以继续添加更多数据:

「荏苒之境」数据库系统的优势

  1. 数据库可以存放大量的表格记录并采用各种方式对这些记录进行排序、查找与修改。
  2. 对表格列类型、可否为空值等信息的指定能够防止错误格式数据的录入。
  3. 所有表格数据都在每一个连接「荏苒之境」数据库的客户端间实时同步,并可随时导出为 csv 等本地格式。
使用 TablePlus 的 iOS 客户端连接 「荏苒之境」数据库系统

呈上,

「荏苒之境」理事会。