gbase数据、南大通用产品文档：GBase8sonspaces c x: 创建 extspace

使用 onspaces -c -x 选项创建 extspace。
语法:

元素
用途
关键注意事项
- c
创建 dbspace 、
blobspace、 sbspace 或
extspace
最多可以创建 2047 个任
意类型的存储空间
创建存储空间之后，必须备份该存储空间和
root dbspace。如果所创建的存储空间名称
与已删除存储空间的名称相同，那么执行另
一个 0 级备份，
以确保以后的恢复不混淆新
存储空间和旧存储空间。
有关更多信息，请参阅 GBase 8s 管理员指
南 中 管理磁盘空间 一章中的 创建
dbspace 、blobspace 或 extspace
-l location
指定 extspace 的位置
存取方法决定该字符串的
格式
限制：String 。值不得长于 255 字节。
有关更多信息，请参阅 GBase 8s 管理员指
南 中的 管理磁盘空间 一章中的 创建
extspace
-o offset
指示为到达新的
blobspace、dbspace 或
sbspace 的初始 chunk 而
限制：无符号整数。无符号整数。开始偏移
量必须大于等于 0 。开始偏移量加 chunk
大小不能超过最大 chunk 大小。 最大偏移

GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 417 -

元素
用途
关键注意事项
发生的磁盘分区或设备中
的偏移量（千字节）
量为 2 或 4 太兆字节，这与平台有关。
有关更多信息，
请参阅GBase
8s 管理员指南
中的 管理磁盘空间 一章中的 分配原始磁
盘空间
-s size
指示新的 blobspace 或
dbspace 初始 chunk 的大
小（千字节）
限制: 无符号整数。大小必须等于或大于
1000 千字节，并且必须是页大小的整倍数。
开始偏移量加 chunk 大小不能超过最大
chunk 大小。
最大 chunk 大小为 2 或 4 太字节。
这与平
台有关。
-x extspace
给出要创建的 extspace
的名称
限制：
Extspace 的名称必须唯一，
且不能超
过 128 字节。它必须以字母或下划线开始，
且必须只包含字母、
数字、
下划线或 $ 字符。

有关更多信息，请参阅 GBase 8s 管理员指
南 中 管理磁盘空间 一章中的 extspace

通信支持服务包括与连接相关的服务，例如：

认证，这是验证用户或应用程序的身份的过程。最普通形式的认证是要求用户输入
密码以获得对计算机或应用程序的访问权。

消息完整性，用于确保通信消息在到达其目的地时完整无缺且未变更。

消息机密性，用于在传输期间保护消息以免受到未经授权的查看，通常是通过加密
和解密来实现这一点。
通信支持服务还可以包括其他处理，如数据压缩或基于流量的记帐。
数据库服务器通过名为“通信支持模块”(CSM) 的插件软件模块来提供额外的安全性相关
通信支持服务。数据库服务器将在您未指定通信支持模块时使用该缺省认证策略。

gbase_change_user
 摘要：

GBase 8a 程序员手册C API 篇


- 10 -

南大通用数据技术股份有限公司
更改用户，将参数db 的值作为gbase 连接句柄的当前默认数据库。在后续
查询中，对于不包含显式数据库区分符的表引用，该数据库是默认数据库。
如果不能确定已连接的用户或用户不具有使用数据库的权限，
gbase_change_user()将失败。在这种情况下，不会改变用户和数据库。
如果不打算拥有默认数据库，可将db 参数设置为NULL。
该命令总是会执行活动事务的ROLLBACK 操作，关闭所有的临时表，解锁所
有的锁定表，并复位状态，就像进行了新连接那样。即使未更改用户，也会出
现该情况。
 语法：
gs_bool gbase_change_user(GBASE *gbase,
const char *user,
const char *passwd,
const char *db);
 参数：
 返回值：
0 表示成功，非0 值表示出现错误。
 错误：
CR_COMMANDS_OUT_OF_SYNC 以不恰当的顺序执行了命令。
CR_SERVER_GONE_ERROR
GBase 服务器不可用。
CR_SERVER_LOST

在查询过程中丢失了与服务器的连接。
CR_UNKNOWN_ERROR

出现未知错误。
ER_UNKNOWN_COM_ERROR
GBase 服务器未实施该命令
ER_ACCESS_DENIED_ERROR 用户或密码错误。
ER_BAD_DB_ERROR

数据库不存在。



GBase 8a 程序员手册C API 篇
南大通用数据技术股份有限公司

- 11 -
ER_DBACCESS_DENIED_ERROR 用户没有访问数据库的权限。
ER_WRONG_DB_NAME

数据库名称过长。