hypertable_size()

Get the total disk space used by a hypertable, that is, the sum of the size for the table itself (including chunks), any indexes on the table, and any toast tables. The size is reported in bytes. This is equivalent to computing the sum of total_bytes column from the output of hypertable_detailed_size function.

Required arguments

NameTypeDescription
hypertableREGCLASSHypertable to show size of.

Returns

NameTypeDescription
hypertable_sizeBIGINTTotal disk space used by the specified hypertable, including all indexes and TOAST data.
tip

NULL is returned if the function is executed on a non-hypertable relation.

Sample usage

Get size information for a hypertable.

  1. SELECT hypertable_size('devices') ;
  2. hypertable_size
  3. -----------------
  4. 73728

Get size information for all hypertables.

  1. SELECT hypertable_name, hypertable_size(format('%I.%I', hypertable_schema, hypertable_name)::regclass)
  2. FROM timescaledb_information.hypertables;