git.8kb.co.uk Git - postgresql/pg_update_chunks/blob - README.md

   1 pg_chunk_update
   2 ===============
   3
   4 Quick and dirty pl/pgsql function to split full / large table updates into
   5 chunks and perform intermediate vacuums.
   6
   7 Connects via dblink to perform individual transactions.
   8
   9 Arguments
  10 ---------
  11
  12         pg_chunk_update(
  13                 in_nspname              -- Schema containing the table
  14                 in_relname              -- Table name
  15                 in_fields               -- The field names to update comma separated *
  16                 in_values               -- The values for the corresponding field names *
  17                 in_where_clause         -- Any where clause for the update *
  18                 in_chunks               -- Break the update into this many chunks
  19                 in_conninfo             -- database conninfo to pass to dblink
  20         )
  21
  22 * Arguments for in_fields, in_values and in_where_clause are plain text and not
  23 sanitized in any way, so ensure tight permissions to prevent sql injection.
  24
  25 Usage
  26 -----
  27 For vacuum to do it's work best we should not have a long running transaction
  28 in the database containing the table, so best to switch to another database:
  29
  30 ```sql
  31 TEST=# \c postgres
  32 You are now connected to database "postgres"
  33 postgres=# SELECT pg_chunk_update('public', 'test', 'b', E'\'SOMETHING ELSE \' || a', 'a > 500000', 200, 'dbname=TEST user=glyn');
  34 ```
  35