OID2NAME(1)              PostgreSQL 18.6 Documentation             OID2NAME(1)

<?><?><?> (NAME)
       oid2name - <?><?><?><?><?> OID<?><?> <?> filenode<?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> PostgreSQL

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       oid2name [<?><?><?><?><?>...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       oid2name <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> PostgreSQL <?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?> 66 <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

           <?><?><?><?>

           <?><?><?> "oid2name" <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?><?> filenode <?><?><?><?><?><?><?>
           (<?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>) <?><?> <?>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           OID<?><?><?> <?><?><?><?> <?> filenode<?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?>!

       oid2name <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> OID<?>
       filenode <?>/<?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> OID<?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> OID<?><?><?> tablespace <?><?>
       <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       oid2name <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?>:

       -f filenode
       --filenode=filenode
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           filenode <?><?><?><?><?><?><?><?> <?><?> filenode.

       -i
       --indexes
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>.

       -o oid
       --oid=oid
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> OID <?><?><?><?><?><?><?><?> <?><?> oid.

       -q
       --quiet
           <?><?><?> <?><?><?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?>).

       -s
       --tablespaces
           <?><?><?><?><?> OID<?><?><?> tablespace.

       -S
       --system-objects
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           (<?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> information_schema<?> pg_toast
           <?> pg_catalog).

       -t tablename_pattern
       --table=tablename_pattern
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>(<?><?><?><?>)
           <?><?> <?><?> tablename_pattern <?><?><?><?><?> <?><?><?><?><?>.

       -V
       --version
           <?><?><?> <?><?><?><?> oid2name <?> <?><?><?><?>.

       -x
       --extended
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?>: <?><?><?> tablespace<?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?> OID.

       -?
       --help
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> oid2name
           <?> <?><?><?><?>.

       oid2name <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>:

       -d database
       --dbname=database
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?>.

       -h host
       --host=host
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       -H host
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.
           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
           PostgreSQL 12 <?><?><?><?><?> <?><?><?> <?><?><?>.

       -p port
       --port=port
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       -U username
       --username=username
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> -o<?> -f
           <?>/<?><?> -t <?><?><?><?><?><?> <?><?><?><?>.  -o <?><?> OID
           <?><?><?><?><?><?><?><?> -f <?><?> filenode
           <?><?><?><?><?><?><?><?> <?> -t <?><?><?> <?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?> (<?><?> <?><?><?><?><?> <?><?><?>
           <?><?> <?><?><?><?><?> LIKE <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> foo% <?><?><?><?><?><?><?> <?><?><?><?>). <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> -d <?><?> <?><?><?><?>
           <?><?><?><?>.

           <?><?><?> <?><?><?><?><?><?><?><?> <?><?> -o<?> -f <?><?> -t <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?> -d <?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> -d <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?>. <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> -S <?> -i <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

           <?><?><?> -d <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> OID<?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> -s <?><?> <?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?> tablespace<?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?> (ENVIRONMENT)
       PGHOST
       PGPORT
       PGUSER
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> PostgreSQL<?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> libpq <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?> 32.15 <?><?>
       <?><?><?><?><?><?>).

       <?><?><?><?><?> <?><?><?><?><?> PG_COLOR <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> always<?> auto <?> never.

<?><?><?><?> (NOTES)
       oid2name <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       (<?><?><?><?><?><?><?><?><?>) <?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           $ # what's in this database server, anyway?
           $ oid2name
           All databases:
               Oid  Database Name  Tablespace
           ----------------------------------
             17228       alvherre  pg_default
             17255     regression  pg_default
             17227      template0  pg_default
                 1      template1  pg_default

           $ oid2name -s
           All tablespaces:
                Oid  Tablespace Name
           -------------------------
               1663       pg_default
               1664        pg_global
             155151         fastdisk
             155152          bigdisk

           $ # OK, let's look into database alvherre
           $ cd $PGDATA/base/17228

           $ # get top 10 db objects in the default tablespace, ordered by size
           $ ls -lS * | head -10
           -rw-------  1 alvherre alvherre 136536064 sep 14 09:51 155173
           -rw-------  1 alvherre alvherre  17965056 sep 14 09:51 1155291
           -rw-------  1 alvherre alvherre   1204224 sep 14 09:51 16717
           -rw-------  1 alvherre alvherre    581632 sep  6 17:51 1255
           -rw-------  1 alvherre alvherre    237568 sep 14 09:50 16674
           -rw-------  1 alvherre alvherre    212992 sep 14 09:51 1249
           -rw-------  1 alvherre alvherre    204800 sep 14 09:51 16684
           -rw-------  1 alvherre alvherre    196608 sep 14 09:50 16700
           -rw-------  1 alvherre alvherre    163840 sep 14 09:50 16699
           -rw-------  1 alvherre alvherre    122880 sep  6 17:51 16751

           $ # What file is 155173?
           $ oid2name -d alvherre -f 155173
           From database "alvherre":
             Filenode  Table Name
           ----------------------
               155173    accounts

           $ # you can ask for more than one object
           $ oid2name -d alvherre -f 155173 -f 1155291
           From database "alvherre":
             Filenode     Table Name
           -------------------------
               155173       accounts
              1155291  accounts_pkey

           $ # you can mix the options, and get more details with -x
           $ oid2name -d alvherre -t accounts -f 1155291 -x
           From database "alvherre":
             Filenode     Table Name      Oid  Schema  Tablespace
           ------------------------------------------------------
               155173       accounts   155173  public  pg_default
              1155291  accounts_pkey  1155291  public  pg_default

           $ # show disk space for every db object
           $ du [0-9]* |
           > while read SIZE FILENODE
           > do
           >   echo "$SIZE       `oid2name -q -d alvherre -i -f $FILENODE`"
           > done
           16            1155287  branches_pkey
           16            1155289  tellers_pkey
           17561            1155291  accounts_pkey
           ...

           $ # same, but sort by size
           $ du [0-9]* | sort -rn | while read SIZE FN
           > do
           >   echo "$SIZE   `oid2name -q -d alvherre -f $FN`"
           > done
           133466             155173    accounts
           17561            1155291  accounts_pkey
           1177              16717  pg_proc_proname_args_nsp_index
           ...

           $ # If you want to see what's in tablespaces, use the pg_tblspc directory
           $ cd $PGDATA/pg_tblspc
           $ oid2name -s
           All tablespaces:
                Oid  Tablespace Name
           -------------------------
               1663       pg_default
               1664        pg_global
             155151         fastdisk
             155152          bigdisk

           $ # what databases have objects in tablespace "fastdisk"?
           $ ls -d 155151/*
           155151/17228/  155151/PG_VERSION

           $ # Oh, what was database 17228 again?
           $ oid2name
           All databases:
               Oid  Database Name  Tablespace
           ----------------------------------
             17228       alvherre  pg_default
             17255     regression  pg_default
             17227      template0  pg_default
                 1      template1  pg_default

           $ # Let's see what objects does this database have in the tablespace.
           $ cd 155151/17228
           $ ls -l
           total 0
           -rw-------  1 postgres postgres 0 sep 13 23:20 155156

           $ # OK, this is a pretty small table ... but which one is it?
           $ oid2name -d alvherre -f 155156
           From database "alvherre":
             Filenode  Table Name
           ----------------------
               155156         foo

       B. Palmer <bpalmer@crimelabs.net>

PostgreSQL 18.6                      2026                          OID2NAME(1)