gaussdb

语法

客户端应用程序为了访问数据库，将连接（通过网络或本地）到一个正在运行的gaussdb进程。然后该进程实例会启动一个独立的线程来处理这个连接。

一个gaussdb进程总是管理来自同一个数据库的数据。一个系统上可以同时运行多个gaussdb进程，只要使用不同的数据目录和不同的端口号。gaussdb启动时需要知道数据目录的位置，该位置必须通过-D指定。通常，-D直接指向由gs_initdb创建的数据库目录。

缺省时gaussdb在前台启动并将日志信息输出到标准错误。但在实际应用中，gaussdb应当作为后台进程启动，而且多数是在系统启动时自动启动。

gaussdb还能以单用户模式运行，这种用法主要用于gs_initdb的初始化过程中，有时候也被用于调试灾难性恢复。不过，单用户模式运行的服务器并不适合于调试，因为没有实际的进程间通讯和锁动作发生。当从shell上以单用户模式调用时，用户可以输入查询，然后结果会在屏幕上以一种更适合开发者阅读（不适合普通用户）的格式显示出来。在单用户模式下，将把会话用户ID设为1并赋予系统管理员权限。该用户不必实际存在，因此单用户模式运行的服务器可以用于对某些意外损坏的系统表进行手工恢复。

选项

gaussdb接受表1中所示的命令行参数。

表 1 参数说明

中的参数主要是便于开发人员调试使用，有时也用于帮助恢复严重损坏的数据库。在应用程序使用数据库提供服务时，请不要使用这些参数进行调试。

表 2 开发者选项

下面的选项表3仅在单用户模式下可用。

表 3 单用户模式选项

表 4 自启动模式选项

表 5 升级模式选项

除以上参数外，出现在postgres.conf中的所有参数，均可以用–guc_name=guc_value的方式在gaussdb启动时传给gaussdb。例如，–enable_fast_query_shipping=off。

• PGLINETENCODING：客户端使用的缺省字符编码。客户端可以独立地覆盖它。这个值也可以在配置文件里设置。
• PGDATESTYLE：运行时参数DateStyle的缺省值。现在反对使用该环境变量。
• TZ：服务器的时区。

错误处理

一个提到了semget或shmget的错误信息可能意味着需要重新配置内核，提供足够的共享内存和信号灯。可以通过降低shared_buffers值以减少openGauss的共享内存的消耗，或者降低max_connections值减少openGauss的信号灯的消耗。

如果发现类似“另外一个服务器正在运行”的错误信息，可以根据系统使用不同的命令：

或

如果确信没有冲突的服务器正在运行，可以删除消息里提到的锁文件然后再次运行。

无法绑定端口的错误信息可能表明该端口已经被其他非openGauss进程使用。如果终止gaussdb后又马上用同一端口号运行它，也可能得到错误信息。这时，必须多等几秒，等操作系统关闭了该端口再试。最后，如果使用了一个操作系统认为是保留的端口，也可能导致这个错误信息。例如：Unix版本认为低于1024的端口号是“可信任的”，因而只有Unix系统管理员可以使用它们。

启动一个单用户模式的服务器：

用-D给服务器提供正确的数据库目录的路径。同时还要声名已存在的特定数据库名称。

示例

• 用缺省值在后台启动gaussdb：

• 指定端口启动gaussdb，如1234：

• 使用gsql与服务器连接，用-p指定端口号：