gbase数据、南大通用产品文档：GBase8cCREATE DIRECTORY

功能描述
使用CREATE DIRECTORY 语句创建一个目录对象，该目录对象定义了服务器文件系
统上目录的别名，用于存放用户使用的数据文件。
注意事项

当enable_access_server_directory=off 时，只允许初始用户创建directory 对象；当
enable_access_server_directory=on 时，具有SYSADMIN 权限的用户和继承了内置角色
gs_role_directory_create 权限的用户可以创建directory 对象。

创建用户默认拥有此路径的READ 和WRITE 操作权限。

目录的默认owner 为创建directory 的用户。
以下路径禁止创建：

路径含特殊字符。

路径是相对路径。

路径是符号连接。
创建目录时会进行以下合法性校验：

创建时会检查添加路径是否为操作系统实际存在路径，如不存在会提示用户使用风险。

创建时会校验数据库初始化（omm）用户对于添加路径的权限(即操作系统目录权限，
读/写/执行- R/W/X)，如果权限不全，会提示用户使用风险。
在GBase 8c 环境下用户指定的路径需要用户保证各节点上路径的一致性，否则在不同
节点上执行会产生找不到路径的问题。
语法格式
CREATE [OR REPLACE] DIRECTORY directory_name
AS 'path_name';

GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
866
参数说明

directory_name
目录名称。
取值范围：字符串，要符合标识符的命名规范。

path_name
操作系统的路径。
取值范围：有效的操作系统路径。
示例
--创建目录。
gbase=#CREATE OR REPLACE DIRECTORY
dir
as '/tmp/';
相关命令
ALTER DIRECTORY，DROP DIRECTORY

当非关键 dbspace 内的主 chunk 上发生任何禁用事件时，
使用 ONDBSPACEDOWN 配置参数
来定义数据库服务器采取的行动。
onconfig.std 值
ONDBSPACEDOWN 2
值
0 = 数据库服务器将 dbspace 标记为 offline 并继续。
1 = 数据库服务器终止。
2
= 数据库服务器将 chunk 的状态写到日志并等待用户输入。如果您设置这个选项，但您
不想数据库服务器将一个禁用的 dbspace 标记为 down 并继续处理，
则使用 onmode
-O 来
取代这个 ONDBSPACEDOWN 设置。
生效
编辑 onconfig 文件并重启数据库服务器之后。
当您通过运行 onmode -wf 命令在 onconfig 文件中动态地重置该值时。
当您通过运行 onmode -wm 命令重置内存中的该值时。
当不应用 ONDBSPACEDOWN 时的数据库服务器行为
如果任何关键 dbspace（例如，rootdbs 或 logsdbs）内的 chunk 丢失，则数据库服务器
将不 online。
ONDBSPACEDOWN 的值不影响临时 dbspace。
对于临时 dbspace，
数据库不管 ONDBSPACEDOWN
设置，继续处理。如果临时 dbspace 需要修理，则您应停止并重新创建它。
对于非关键 dbspace 内的非主 chunk，当禁用事件发生时，数据库服务器的行为依赖于
chunk 的事务状态：
l 无事务：如果未检测到那个 chunk 的事务，则单独地将该 chunk 标记为关闭。在
这种情况下，随后对那个 chunk 的写尝试失败，回滚相关的事务。您可安全地放
回该 chunk，然后使用 onspaces -s 实用程序来将该 chunk 标记为 back
online。

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

l 检测到事务：
如果有事务前滚或回滚，
那么数据库终止并伴以适当的快速恢复错误。
在这种情况下，您应放回该 chunk 并重启数据库服务器。

sysautolocate 系统目录表保留供将来使用。
表 4. SYSAUTOLOCATE 表列描述
列
类型
解释
dbsnum
INTEGER
保留供将来使用。
dbsname
VARCHAR(128,0)
保留供将来使用。
pagesize
SMALLINT
保留供将来使用。
flags
INTEGER
保留供将来使用。