begriffs open source - ai-pg/blob - full-docs/txt/sql-alterconversion.txt

   1
   2 ALTER CONVERSION
   3
   4    ALTER CONVERSION — change the definition of a conversion
   5
   6 Synopsis
   7
   8 ALTER CONVERSION name RENAME TO new_name
   9 ALTER CONVERSION name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSI
  10 ON_USER }
  11 ALTER CONVERSION name SET SCHEMA new_schema
  12
  13 Description
  14
  15    ALTER CONVERSION changes the definition of a conversion.
  16
  17    You must own the conversion to use ALTER CONVERSION. To alter the
  18    owner, you must be able to SET ROLE to the new owning role, and that
  19    role must have CREATE privilege on the conversion's schema. (These
  20    restrictions enforce that altering the owner doesn't do anything you
  21    couldn't do by dropping and recreating the conversion. However, a
  22    superuser can alter ownership of any conversion anyway.)
  23
  24 Parameters
  25
  26    name
  27           The name (optionally schema-qualified) of an existing
  28           conversion.
  29
  30    new_name
  31           The new name of the conversion.
  32
  33    new_owner
  34           The new owner of the conversion.
  35
  36    new_schema
  37           The new schema for the conversion.
  38
  39 Examples
  40
  41    To rename the conversion iso_8859_1_to_utf8 to latin1_to_unicode:
  42 ALTER CONVERSION iso_8859_1_to_utf8 RENAME TO latin1_to_unicode;
  43
  44    To change the owner of the conversion iso_8859_1_to_utf8 to joe:
  45 ALTER CONVERSION iso_8859_1_to_utf8 OWNER TO joe;
  46
  47 Compatibility
  48
  49    There is no ALTER CONVERSION statement in the SQL standard.
  50
  51 See Also
  52
  53    CREATE CONVERSION, DROP CONVERSION