更新时间:2024-06-03 GMT+08:00

CREATE DIRECTORY

功能描述

使用CREATE DIRECTORY语句创建一个目录对象,该目录对象定义了服务器文件系统上目录的别名,用于存放用户使用的数据文件,用户可以通过dbe_file高级包来读写这些文件。

该目录对象对于指定用户可以赋予READ和WRITE的操作权限,用于给dbe_file提供权限控制。

注意事项

  • 当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),如果权限不全,会提示用户使用风险。
  • 在数据库环境下用户指定的路径需要用户保证各节点上路径的一致性,否则在不同节点上执行会产生找不到路径的问题。
  • 可在pg_directory表中查看已存在目录对象。

语法格式

CREATE [OR REPLACE] DIRECTORY directory_name
AS 'path_name';

参数说明

  • directory_name

    目录名称。

    取值范围:字符串,要符合标识符命名规范

  • path_name

    操作系统的路径。

    取值范围: 有效的操作系统路径。

示例

--创建目录对象。
gaussdb=# CREATE OR REPLACE DIRECTORY  dir  AS '/tmp/';

--查看已创建的目录对象。
gaussdb=# select * from pg_directory;
 dirname | owner | dirpath | diracl 
---------+-------+---------+--------
 dir     |    10 | /tmp    | 
(1 row)

--删除目录对象。
gaussdb=# DROP DIRECTORY dir;