1.3. 创建一个数据库

1.3.1. 创建分布式数据库

看看你能否访问数据库服务器的第一个例子就是试着创建一个数据库。 一台运行着的LightDB服务器可以管理许多数据库。 通常我们会为每个项目和每个用户单独使用一个数据库。

你的站点管理员可能已经为你创建了可以使用的数据库。 如果这样你就可以省略这一步, 并且跳到下一节。

要创建一个新的数据库,在我们这个例子里叫mydb,你可以使用下面的命令:

$ createdb mydb

如果不产生任何响应则表示该步骤成功,你可以跳过本节的剩余部分。

如果你看到类似下面这样的信息:

createdb: command not found

那么就是LightDB没有安装好。或者是根本没安装, 或者是你的shell搜索路径没有设置正确。尝试用绝对路径调用该命令试试:

$ /usr/local/lightdb-x/bin/createdb mydb

在你的站点上这个路径可能不一样。和你的站点管理员联系或者看看安装指导获取正确的位置。

另外一种响应可能是这样:

createdb: could not connect to database postgres: could not connect to server: No such file or directory
        Is the server running locally and accepting
        connections on Unix domain socket "/tmp/.s.PGSQL.5432"?

这意味着该服务器没有启动,或者在createdb期望去连接它的时候没有在监听。同样, 你也要查看安装指导或者咨询管理员。

另外一个响应可能是这样:

createdb: could not connect to database postgres: FATAL:  role "joe" does not exist

在这里提到了你自己的登录名。 如果管理员没有为你创建LightDB用户帐号, 就会发生这些现象。 (LightDB用户帐号和操作系统用户帐号是不同的。) 如果你是管理员,参阅Chapter 20获取创建用户帐号的帮助。 你需要变成安装LightDB的操作系统用户的身份(通常是 lightdb)才能创建第一个用户帐号。 也有可能是赋予你的LightDB用户名和你的操作系统用户名不同; 这种情况下,你需要使用-U选项或者使用LTUSER环境变量指定你的LightDB用户名。

如果你有个数据库用户帐号,但是没有创建数据库所需要的权限,那么你会看到下面的信息:

createdb: database creation failed: ERROR:  permission denied to create database

并非所有用户都被许可创建新数据库。 如果LightDB拒绝为你创建数据库, 那么你需要让站点管理员赋予你创建数据库的权限。出现这种情况时请咨询你的站点管理员。 如果你自己安装了LightDB, 那么你应该以你启动数据库服务器的用户身份登录然后参考手册完成权限的赋予工作。 [1]

你还可以用其它名字创建数据库。LightDB允许你在一个站点上创建任意数量的数据库。 数据库名必须是以字母开头并且小于 63 个字符长。 一个方便的做法是创建和你当前用户名同名的数据库。 许多工具假设该数据库名为缺省数据库名,所以这样可以节省你的敲键。 要创建这样的数据库,只需要键入:

$ createdb

如果你想创建一个分布式数据库mydb, 那么你就可以用lt_createdb命令创建它:

$ lt_createdb mydb

对于这条命令而言,你必须在cn 节点上执行,非cn 节点上创建的还是普通数据库。

如果你再也不想使用你的数据库了,那么你可以删除它。 比如,如果你是数据库mydb的所有人(创建人), 那么你就可以用下面的命令删除它:

$ dropdb mydb

(对于这条命令而言,数据库名不是缺省的用户名,因此你就必须声明它) 。这个动作将在物理上把所有与该数据库相关的文件都删除并且不可取消, 因此做这中操作之前一定要考虑清楚。

更多关于createdbdropdb的信息可以分别在createdbdropdb中找到。

1.3.1. 创建分布式数据库

LihgtDB分布式模式安装部署后,分布式集群会默认部署在postgres库中。针对其他业务库,需先手动在CN和DN每个节点中create database创建对应业务库,然后将每个节点添加到pg_dist_node表中。

-- 查看分布式节点信息
SELECT * from pg_dist_node;
 nodeid | groupid | nodename  | nodeport | noderack | hasmetadata | isactive | noderole | nodecluster | metadatasynced | shouldhaveshards
--------+---------+-----------+----------+----------+-------------+----------+----------+-------------+----------------+------------------
      1 |       1 | localhost |    12345 | default  | f           | t        | primary  | default     | f              | t
      2 |       2 | localhost |    12346 | default  | f           | t        | primary  | default     | f              | t
      3 |       3 | localhost |    12347 | default  | f           | t        | primary  | default     | f              | t
(3 rows)
    

设置分布式CN节点:通过canopy_set_coordinator_host函数进行配置;

    select canopy_set_coordinator_host('CN_NODE_IP', CN_NODE_PORT);
    

添加分布式DN节点:通过canopy_add_node函数进行配置;

    -- 在CN节点上执行该步骤即可,对应的DN节点会同步分布式集群信息
    select canopy_add_node('DN_NODE_IP', DN_NODE_PORT); 
    

删除节点:通过canopy_remove_node函数进行配置;

    select canopy_remove_node('NODE_IP', NODE_PORT);
    


[1] 为什么这么做的解释:LightDB用户名是和操作系统用户账号分开的。 如果你连接到一个数据库时,你可以选择以何种LightDB用户名进行联接; 如果你不选择,那么缺省就是你的当前操作系统账号。 如果这样,那么总有一个与操作系统用户同名的LightDB用户账号用于启动服务器, 并且通常这个用户都有创建数据库的权限。如果你不想以该用户身份登录, 那么你也可以在任何地方声明一个-U选项以选择一个用于连接的LightDB用户名。