PostgreSQL自带的命令行工具17- oid2name

PostgreSQL自带的命令行工具17- oid2name

基础信息
OS版本：Red Hat Enterprise Linux Server release 7.9 (Maipo)
DB版本：16.2
pg软件目录：/home/pg16/soft
pg数据目录：/home/pg16/data
端口：5777

oid2name 是 PostgreSQL 工具之一，主要用于显示数据库及其相关对象的 OID（对象标识符）和名称之间的映射。这个命令非常实用，特别是在处理大量数据库对象时，它可以帮助你快速地识别特定数据库或表的 OID。OID 是 PostgreSQL 内部使用的唯一标识符，对于数据库管理员了解和维护系统非常有帮助。

通过help查看帮助文档。

[pg16@test ~]$ oid2name --help
oid2name helps examining the file structure used by PostgreSQL.

Usage:
  oid2name [OPTION]...

Options:
  -f, --filenode=FILENODE    show info for table with given file node
  -i, --indexes              show indexes and sequences too
  -o, --oid=OID              show info for table with given OID
  -q, --quiet                quiet (don't show headers)
  -s, --tablespaces          show all tablespaces
  -S, --system-objects       show system objects too
  -t, --table=TABLE          show info for named table
  -V, --version              output version information, then exit
  -x, --extended             extended (show additional columns)
  -?, --help                 show this help, then exit

Connection options:
  -d, --dbname=DBNAME        database to connect to
  -h, --host=HOSTNAME        database server host or socket directory
  -H                         (same as -h, deprecated)
  -p, --port=PORT            database server port number
  -U, --username=USERNAME    connect as specified database user

The default action is to show all database OIDs.

Report bugs to <pgsql-bugs@lists.postgresql.org>.
PostgreSQL home page: <https://www.postgresql.org/>

基本用法

oid2name 的基本使用非常简单，它可以通过命令行直接运行。使用时需要访问 PostgreSQL 数据库的权限，通常也需要指明数据库服务器的连接参数，如主机、端口、用户等。

一般形式如下：

oid2name [-h host] [-p port] [-U username] [-W password] [-d database]

选项

• -h 或 --host：指定 PostgreSQL 数据库服务器的主机名。
• -p 或 --port：指定 PostgreSQL 数据库服务的端口号。
• -U 或 --username：指定连接 PostgreSQL 数据库服务器的用户名。
• -d 或 --dbname：指定要查询的数据库名称。如果省略此选项，oid2name 会查询所有数据库。

示例1

列出所有数据库的 OID 和名称

[pg16@test ~]$ oid2name -h localhost -p 5777 -U postgres     
All databases:
    Oid  Database Name  Tablespace
----------------------------------
      5       postgres  pg_default
      4      template0  pg_default
      1      template1  pg_default
  16505          white  pg_default
  16520         white2  pg_default
  16535         white3  pg_default

示例2

列出指定的数据库

[pg16@test ~]$ oid2name -h localhost -p 5777 -U postgres -d white
From database "white":
  Filenode        Table Name
----------------------------
     16579  pgbench_accounts
     16580  pgbench_branches
     16589   pgbench_history
     16582   pgbench_tellers
     16508                t1
     16511                t2
     16563                t4
     16517                t4

高级用法

除了简单的映射显示外，oid2name 还支持显示表空间、表和索引的 OID，甚至可以显示哪些文件与特定的表或索引关联。这些高级功能需要在命令行中添加额外的选项，具体的使用方法和选项可以通过 oid2name --help 命令查看或参考 PostgreSQL 官方文档。

注意事项

• 使用 oid2name 需要适当的数据库访问权限。
• 基于安全考虑，运维时应尽量避免在命令行中直接使用明文密码。
• 当发现 oid2name 不可用时，检查 PostgreSQL 安装情况或考虑更新你的 PostgreSQL 版本。

谨记：心存敬畏，行有所止。