通用文件访问函数

通用文件访问函数提供了对数据库服务器上的文件的本地访问接口。只有openGauss目录和log_directory目录里面的文件可以访问。使用相对路径访问openGauss目录里面的文件，以及匹配log_directory配置而设置的路径访问日志文件。只有数据库初始化用户才能使用这些函数。

  • pg_ls_dir(dirname text)

    描述：列出目录中的文件。

    返回值类型：setof text

    备注：pg_ls_dir返回指定目录里面的除了特殊项“.”和“..”之外所有名称。

    示例：

    1. postgres=# SELECT pg_ls_dir('./');
    2.       pg_ls_dir       
    3. ----------------------
    4.  .postgresql.conf.swp
    5.  postgresql.conf
    6.  pg_tblspc
    7.  PG_VERSION
    8.  pg_ident.conf
    9.  core
    10.  server.crt
    11.  pg_serial
    12.  pg_twophase
    13.  postgresql.conf.lock
    14.  pg_stat_tmp
    15.  pg_notify
    16.  pg_subtrans
    17.  pg_ctl.lock
    18.  pg_xlog
    19.  pg_clog
    20.  base
    21.  pg_snapshots
    22.  postmaster.opts
    23.  postmaster.pid
    24.  server.key.rand
    25.  server.key.cipher
    26.  pg_multixact
    27.  pg_errorinfo
    28.  server.key
    29.  pg_hba.conf
    30.  pg_replslot
    31.  .pg_hba.conf.swp
    32.  cacert.pem
    33.  pg_hba.conf.lock
    34.  global
    35.  gaussdb.state
    36. (32 rows)

  • pg_read_file(filename text, offset bigint, length bigint)

    描述：返回一个文本文件的内容。

    返回值类型：text

    备注：pg_read_file返回一个文本文件的一部分，从offset开始，最多返回length字节（如果先达到文件结尾，则小于这个数值）。如果offset是负数，则它是相对于文件结尾回退的长度。如果省略了offset和length，则返回整个文件。

    示例：

    1. postgres=# SELECT pg_read_file('postmaster.pid',0,100);
    2.              pg_read_file              
    3. ---------------------------------------
    4.  53078                                +
    5.  /srv/BigData/hadoop/data1/dbnode+
    6.  1500022474                           +
    7.  8000                                +
    8.  /var/run/FusionInsight               +
    9.  localhost                            +
    10.   2
    11. (1 row)

  • pg_read_binary_file(filename text [, offset bigint, length bigint,missing_ok boolean])

    描述：返回一个二进制文件的内容。

    返回值类型：bytea

    备注：pg_read_binary_file的功能与pg_read_file类似，除了结果的返回值为bytea类型不一致，相应地不会执行编码检查。与convert_from函数结合，这个函数可以用来读取用指定编码的一个文件。

    1. postgres=# SELECT convert_from(pg_read_binary_file('filename'), 'UTF8');

  • pg_stat_file(filename text)

    描述：返回一个文本文件的状态信息。

    返回值类型：record

    备注：pg_stat_file返回一条记录，其中包含：文件大小、最后访问时间戳、最后更改时间戳、最后文件状态修改时间戳以及标识传入参数是否为目录的Boolean值。典型的用法：

    1. postgres=# SELECT * FROM pg_stat_file('filename');
    1. postgres=# SELECT (pg_stat_file('filename')).modification;

    示例：

    1. postgres=# SELECT convert_from(pg_read_binary_file('postmaster.pid'), 'UTF8');
    2.              convert_from             
    3. --------------------------------------
    4.  4881                                +
    5.  /srv/BigData/gaussdb/data1/dbnode+
    6.  1496308688                          +
    7.  25108                               +
    8.  /opt/user/Bigdata/gaussdb/gaussdb_tmp +
    9.  *                                   +
    10.   25108001  43352069                 +
    12. (1 row)
    1. postgres=# SELECT * FROM pg_stat_file('postmaster.pid');
    3.  size |         access         |      modification      |         change         
    4. | creation | isdir 
    5. ------+------------------------+------------------------+------------------------
    6. +----------+-------
    7.   117 | 2017-06-05 11:06:34+08 | 2017-06-01 17:18:08+08 | 2017-06-01 17:18:08+08 
    8. |          | f
    9. (1 row)
    1. postgres=# SELECT (pg_stat_file('postmaster.pid')).modification;
    2.       modification      
    3. ------------------------
    4.  2017-06-01 17:18:08+08
    5. (1 row)