mirror of https://github.com/postgres/postgres
- collowner field - CREATE COLLATION - ALTER COLLATION - DROP COLLATION - COMMENT ON COLLATION - integration with extensions - pg_dump support for the above - dependency management - psql tab completion - psql \dO commandpull/1/head
Peter Eisentraut
15 years ago
parent
d31e2a495b
commit
b313bca0af
@ -0,0 +1,128 @@ |
||||
<!-- |
||||
doc/src/sgml/ref/alter_collation.sgml |
||||
PostgreSQL documentation |
||||
--> |
||||
|
||||
<refentry id="SQL-ALTERCOLLATION"> |
||||
<refmeta> |
||||
<refentrytitle>ALTER COLLATION</refentrytitle> |
||||
<manvolnum>7</manvolnum> |
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||
</refmeta> |
||||
|
||||
<refnamediv> |
||||
<refname>ALTER COLLATION</refname> |
||||
<refpurpose>change the definition of a collation</refpurpose> |
||||
</refnamediv> |
||||
|
||||
<indexterm zone="sql-altercollation"> |
||||
<primary>ALTER COLLATION</primary> |
||||
</indexterm> |
||||
|
||||
<refsynopsisdiv> |
||||
<synopsis> |
||||
ALTER COLLATION <replaceable>name</replaceable> RENAME TO <replaceable>new_name</replaceable> |
||||
ALTER COLLATION <replaceable>name</replaceable> OWNER TO <replaceable>new_owner</replaceable> |
||||
ALTER COLLATION <replaceable>name</replaceable> SET SCHEMA <replaceable>new_schema</replaceable> |
||||
</synopsis> |
||||
</refsynopsisdiv> |
||||
|
||||
<refsect1> |
||||
<title>Description</title> |
||||
|
||||
<para> |
||||
<command>ALTER COLLATION</command> changes the definition of a |
||||
collation. |
||||
</para> |
||||
|
||||
<para> |
||||
You must own the collation to use <command>ALTER COLLATION</>. |
||||
To alter the owner, you must also be a direct or indirect member of the new |
||||
owning role, and that role must have <literal>CREATE</literal> privilege on |
||||
the collation's schema. (These restrictions enforce that altering the |
||||
owner doesn't do anything you couldn't do by dropping and recreating the |
||||
collation. However, a superuser can alter ownership of any collation |
||||
anyway.) |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>Parameters</title> |
||||
|
||||
<variablelist> |
||||
<varlistentry> |
||||
<term><replaceable class="parameter">name</replaceable></term> |
||||
<listitem> |
||||
<para> |
||||
The name (optionally schema-qualified) of an existing collation. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable class="parameter">new_name</replaceable></term> |
||||
<listitem> |
||||
<para> |
||||
The new name of the collation. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable class="parameter">new_owner</replaceable></term> |
||||
<listitem> |
||||
<para> |
||||
The new owner of the collation. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable class="parameter">new_schema</replaceable></term> |
||||
<listitem> |
||||
<para> |
||||
The new schema for the collation. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
</variablelist> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>Examples</title> |
||||
|
||||
<para> |
||||
To rename the collation <literal>de_DE</literal> to |
||||
<literal>german</literal>: |
||||
<programlisting> |
||||
ALTER COLLATION "de_DE" RENAME TO german; |
||||
</programlisting> |
||||
</para> |
||||
|
||||
<para> |
||||
To change the owner of the collation <literal>en_US</literal> to |
||||
<literal>joe</literal>: |
||||
<programlisting> |
||||
ALTER COLLATION "en_US" OWNER TO joe; |
||||
</programlisting> |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>Compatibility</title> |
||||
|
||||
<para> |
||||
There is no <command>ALTER COLLATION</command> statement in the SQL |
||||
standard. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>See Also</title> |
||||
|
||||
<simplelist type="inline"> |
||||
<member><xref linkend="sql-createcollation"></member> |
||||
<member><xref linkend="sql-dropcollation"></member> |
||||
</simplelist> |
||||
</refsect1> |
||||
</refentry> |
||||
@ -0,0 +1,175 @@ |
||||
<!-- doc/src/sgml/ref/create_collation.sgml --> |
||||
|
||||
<refentry id="SQL-CREATECOLLATION"> |
||||
<refmeta> |
||||
<refentrytitle>CREATE COLLATION</refentrytitle> |
||||
<manvolnum>7</manvolnum> |
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||
</refmeta> |
||||
|
||||
<refnamediv> |
||||
<refname>CREATE COLLATION</refname> |
||||
<refpurpose>define a new collation</refpurpose> |
||||
</refnamediv> |
||||
|
||||
<indexterm zone="sql-createcollation"> |
||||
<primary>CREATE COLLATION</primary> |
||||
</indexterm> |
||||
|
||||
<refsynopsisdiv> |
||||
<synopsis> |
||||
CREATE COLLATION <replaceable>name</replaceable> ( |
||||
[ LOCALE = <replaceable>locale</replaceable>, ] |
||||
[ LC_COLLATE = <replaceable>lc_collate</replaceable>, ] |
||||
[ LC_CTYPE = <replaceable>lc_ctype</replaceable>, ] |
||||
) |
||||
CREATE COLLATION <replaceable>name</replaceable> FROM <replaceable>existing_collation</replaceable> |
||||
</synopsis> |
||||
</refsynopsisdiv> |
||||
|
||||
<refsect1 id="sql-createcollation-description"> |
||||
<title>Description</title> |
||||
|
||||
<para> |
||||
<command>CREATE COLLATION</command> defines a new collation using |
||||
the specified operating system locales or from an existing collation. |
||||
</para> |
||||
|
||||
<para> |
||||
To be able to create a collation, you must |
||||
have <literal>CREATE</literal> privilege on the destination schema. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
|
||||
<refsect1> |
||||
<title>Parameters</title> |
||||
|
||||
<variablelist> |
||||
<varlistentry> |
||||
<term><replaceable>name</replaceable></term> |
||||
|
||||
<listitem> |
||||
<para> |
||||
The name of the collation. The collation name can be |
||||
schema-qualified. If it is not, the collation is defined in the |
||||
current schema. The collation name must be unique within a |
||||
schema. (The system catalogs can contain collations with the |
||||
same name for other encodings, but these are not usable if the |
||||
database encoding does not match.) |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable>existing_collation</replaceable></term> |
||||
|
||||
<listitem> |
||||
<para> |
||||
The name of an existing collation to copy. The new collation |
||||
will have the same properties as the existing one, but they |
||||
will become independent objects. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable>locale</replaceable></term> |
||||
|
||||
<listitem> |
||||
<para> |
||||
This is a shortcut for setting <symbol>LC_COLLATE</symbol> |
||||
and <symbol>LC_CTYPE</symbol> at once. If you specify this, |
||||
you cannot specify either of the other parameters. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable>lc_collate</replaceable></term> |
||||
|
||||
<listitem> |
||||
<para> |
||||
Use the specified operating system locale for |
||||
the <symbol>LC_COLLATE</symbol> locale category. The locale |
||||
must be applicable to the current database encoding. |
||||
(See <xref linkend="sql-createdatabase"> for the precise |
||||
rules.) |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable>lc_ctype</replaceable></term> |
||||
|
||||
<listitem> |
||||
<para> |
||||
Use the specified operating system locale for |
||||
the <symbol>LC_CTYPE</symbol> locale category. The locale |
||||
must be applicable to the current database encoding. |
||||
(See <xref linkend="sql-createdatabase"> for the precise |
||||
rules.) |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
</variablelist> |
||||
</refsect1> |
||||
|
||||
|
||||
<refsect1 id="sql-createcollation-notes"> |
||||
<title>Notes</title> |
||||
|
||||
<para> |
||||
Use <command>DROP COLLATION</command> to remove user-defined collations. |
||||
</para> |
||||
|
||||
<para> |
||||
See <xref linkend="collation"> for more information about collation |
||||
support in PostgreSQL. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="sql-createcollation-examples"> |
||||
<title>Examples</title> |
||||
|
||||
<para> |
||||
To create a collation from the locale <literal>fr_FR.utf8</literal> |
||||
(assuming the current database encoding is <literal>UTF8</literal>): |
||||
<programlisting> |
||||
CREATE COLLATION french (LOCALE = 'fr_FR.utf8'); |
||||
</programlisting> |
||||
</para> |
||||
|
||||
<para> |
||||
To create a collation from an existing collation: |
||||
<programlisting> |
||||
CREATE COLLATION german FROM "de_DE"; |
||||
</programlisting> |
||||
This can be convenient to be able to use operating-system |
||||
independent collation names in applications. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
|
||||
<refsect1 id="sql-createcollation-compat"> |
||||
<title>Compatibility</title> |
||||
|
||||
<para> |
||||
There is a <command>CREATE COLLATION</command> statement in the SQL |
||||
standard, but it is limited to copying an existing collation. The |
||||
syntax to create a new collation is |
||||
a <productname>PostgreSQL</productname> extension. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
|
||||
<refsect1 id="sql-createcollation-seealso"> |
||||
<title>See Also</title> |
||||
|
||||
<simplelist type="inline"> |
||||
<member><xref linkend="sql-altercollation"></member> |
||||
<member><xref linkend="sql-dropcollation"></member> |
||||
</simplelist> |
||||
</refsect1> |
||||
|
||||
</refentry> |
||||
@ -0,0 +1,110 @@ |
||||
<!-- doc/src/sgml/ref/drop_collation.sgml --> |
||||
|
||||
<refentry id="SQL-DROPCOLLATION"> |
||||
<refmeta> |
||||
<refentrytitle>DROP COLLATION</refentrytitle> |
||||
<manvolnum>7</manvolnum> |
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||
</refmeta> |
||||
|
||||
<refnamediv> |
||||
<refname>DROP COLLATION</refname> |
||||
<refpurpose>remove a collation</refpurpose> |
||||
</refnamediv> |
||||
|
||||
<indexterm zone="sql-dropcollation"> |
||||
<primary>DROP COLLATION</primary> |
||||
</indexterm> |
||||
|
||||
<refsynopsisdiv> |
||||
<synopsis> |
||||
DROP COLLATION [ IF EXISTS ] <replaceable>name</replaceable> [ CASCADE | RESTRICT ] |
||||
</synopsis> |
||||
</refsynopsisdiv> |
||||
|
||||
<refsect1 id="sql-dropcollation-description"> |
||||
<title>Description</title> |
||||
|
||||
<para> |
||||
<command>DROP COLLATION</command> removes a previously defined collation. |
||||
To be able to drop a collation, you must own the collation. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>Parameters</title> |
||||
|
||||
<variablelist> |
||||
<varlistentry> |
||||
<term><literal>IF EXISTS</literal></term> |
||||
<listitem> |
||||
<para> |
||||
Do not throw an error if the collation does not exist. |
||||
A notice is issued in this case. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable>name</replaceable></term> |
||||
|
||||
<listitem> |
||||
<para> |
||||
The name of the collation. The collation name can be |
||||
schema-qualified. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><literal>CASCADE</literal></term> |
||||
<listitem> |
||||
<para> |
||||
Automatically drop objects that depend on the collation. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><literal>RESTRICT</literal></term> |
||||
<listitem> |
||||
<para> |
||||
Refuse to drop the collation if any objects depend on it. This |
||||
is the default. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
</variablelist> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="sql-dropcollation-examples"> |
||||
<title>Examples</title> |
||||
|
||||
<para> |
||||
To drop the collation named <literal>german</>: |
||||
<programlisting> |
||||
DROP COLLATION german; |
||||
</programlisting> |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="sql-dropcollation-compat"> |
||||
<title>Compatibility</title> |
||||
|
||||
<para> |
||||
The <command>DROP COLLATION</command> command conforms to the |
||||
<acronym>SQL</acronym> standard, apart from the <literal>IF |
||||
EXISTS</> option, which is a <productname>PostgreSQL</> extension.. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>See Also</title> |
||||
|
||||
<simplelist type="inline"> |
||||
<member><xref linkend="sql-altercollation"></member> |
||||
<member><xref linkend="sql-createcollation"></member> |
||||
</simplelist> |
||||
</refsect1> |
||||
|
||||
</refentry> |
||||
@ -0,0 +1,163 @@ |
||||
/*-------------------------------------------------------------------------
|
||||
* |
||||
* pg_collation.c |
||||
* routines to support manipulation of the pg_collation relation |
||||
* |
||||
* Portions Copyright (c) 1996-2011, PostgreSQL Global Development Group |
||||
* Portions Copyright (c) 1994, Regents of the University of California |
||||
* |
||||
* |
||||
* IDENTIFICATION |
||||
* src/backend/catalog/pg_collation.c |
||||
* |
||||
*------------------------------------------------------------------------- |
||||
*/ |
||||
#include "postgres.h" |
||||
|
||||
#include "access/heapam.h" |
||||
#include "access/sysattr.h" |
||||
#include "catalog/dependency.h" |
||||
#include "catalog/indexing.h" |
||||
#include "catalog/objectaccess.h" |
||||
#include "catalog/pg_collation.h" |
||||
#include "catalog/pg_collation_fn.h" |
||||
#include "catalog/pg_namespace.h" |
||||
#include "catalog/pg_proc.h" |
||||
#include "mb/pg_wchar.h" |
||||
#include "miscadmin.h" |
||||
#include "utils/acl.h" |
||||
#include "utils/builtins.h" |
||||
#include "utils/fmgroids.h" |
||||
#include "utils/rel.h" |
||||
#include "utils/syscache.h" |
||||
#include "utils/tqual.h" |
||||
|
||||
/*
|
||||
* CollationCreate |
||||
* |
||||
* Add a new tuple to pg_collation. |
||||
*/ |
||||
Oid |
||||
CollationCreate(const char *collname, Oid collnamespace, |
||||
Oid collowner, |
||||
int32 collencoding, |
||||
const char *collcollate, const char *collctype) |
||||
{ |
||||
int i; |
||||
Relation rel; |
||||
TupleDesc tupDesc; |
||||
HeapTuple tup; |
||||
bool nulls[Natts_pg_collation]; |
||||
Datum values[Natts_pg_collation]; |
||||
NameData name_name, name_collate, name_ctype; |
||||
Oid oid; |
||||
ObjectAddress myself, |
||||
referenced; |
||||
|
||||
AssertArg(collname); |
||||
AssertArg(collnamespace); |
||||
AssertArg(collowner); |
||||
AssertArg(collcollate); |
||||
AssertArg(collctype); |
||||
|
||||
/* make sure there is no existing collation of same name */ |
||||
if (SearchSysCacheExists3(COLLNAMEENCNSP, |
||||
PointerGetDatum(collname), |
||||
Int32GetDatum(collencoding), |
||||
ObjectIdGetDatum(collnamespace))) |
||||
ereport(ERROR, |
||||
(errcode(ERRCODE_DUPLICATE_OBJECT), |
||||
errmsg("collation \"%s\" for encoding \"%s\" already exists", |
||||
collname, pg_encoding_to_char(collencoding)))); |
||||
|
||||
/* open pg_collation */ |
||||
rel = heap_open(CollationRelationId, RowExclusiveLock); |
||||
tupDesc = rel->rd_att; |
||||
|
||||
/* initialize nulls and values */ |
||||
for (i = 0; i < Natts_pg_collation; i++) |
||||
{ |
||||
nulls[i] = false; |
||||
values[i] = (Datum) NULL; |
||||
} |
||||
|
||||
/* form a tuple */ |
||||
namestrcpy(&name_name, collname); |
||||
values[Anum_pg_collation_collname - 1] = NameGetDatum(&name_name); |
||||
values[Anum_pg_collation_collnamespace - 1] = ObjectIdGetDatum(collnamespace); |
||||
values[Anum_pg_collation_collowner - 1] = ObjectIdGetDatum(collowner); |
||||
values[Anum_pg_collation_collencoding - 1] = Int32GetDatum(collencoding); |
||||
namestrcpy(&name_collate, collcollate); |
||||
values[Anum_pg_collation_collcollate - 1] = NameGetDatum(&name_collate); |
||||
namestrcpy(&name_ctype, collctype); |
||||
values[Anum_pg_collation_collctype - 1] = NameGetDatum(&name_ctype); |
||||
|
||||
tup = heap_form_tuple(tupDesc, values, nulls); |
||||
|
||||
/* insert a new tuple */ |
||||
oid = simple_heap_insert(rel, tup); |
||||
Assert(OidIsValid(oid)); |
||||
|
||||
/* update the index if any */ |
||||
CatalogUpdateIndexes(rel, tup); |
||||
|
||||
myself.classId = CollationRelationId; |
||||
myself.objectId = HeapTupleGetOid(tup); |
||||
myself.objectSubId = 0; |
||||
|
||||
/* create dependency on namespace */ |
||||
referenced.classId = NamespaceRelationId; |
||||
referenced.objectId = collnamespace; |
||||
referenced.objectSubId = 0; |
||||
recordDependencyOn(&myself, &referenced, DEPENDENCY_NORMAL); |
||||
|
||||
/* create dependency on owner */ |
||||
recordDependencyOnOwner(CollationRelationId, HeapTupleGetOid(tup), |
||||
collowner); |
||||
|
||||
/* dependency on extension */ |
||||
recordDependencyOnCurrentExtension(&myself); |
||||
|
||||
/* Post creation hook for new collation */ |
||||
InvokeObjectAccessHook(OAT_POST_CREATE, |
||||
CollationRelationId, HeapTupleGetOid(tup), 0); |
||||
|
||||
heap_freetuple(tup); |
||||
heap_close(rel, RowExclusiveLock); |
||||
|
||||
return oid; |
||||
} |
||||
|
||||
/*
|
||||
* RemoveCollationById |
||||
* |
||||
* Remove a tuple from pg_collation by Oid. This function is solely |
||||
* called inside catalog/dependency.c |
||||
*/ |
||||
void |
||||
RemoveCollationById(Oid collationOid) |
||||
{ |
||||
Relation rel; |
||||
HeapTuple tuple; |
||||
HeapScanDesc scan; |
||||
ScanKeyData scanKeyData; |
||||
|
||||
ScanKeyInit(&scanKeyData, |
||||
ObjectIdAttributeNumber, |
||||
BTEqualStrategyNumber, F_OIDEQ, |
||||
ObjectIdGetDatum(collationOid)); |
||||
|
||||
/* open pg_collation */ |
||||
rel = heap_open(CollationRelationId, RowExclusiveLock); |
||||
|
||||
scan = heap_beginscan(rel, SnapshotNow, |
||||
1, &scanKeyData); |
||||
|
||||
/* search for the target tuple */ |
||||
if (HeapTupleIsValid(tuple = heap_getnext(scan, ForwardScanDirection))) |
||||
simple_heap_delete(rel, &tuple->t_self); |
||||
else |
||||
elog(ERROR, "could not find tuple for collation %u", collationOid); |
||||
heap_endscan(scan); |
||||
heap_close(rel, RowExclusiveLock); |
||||
} |
||||
@ -0,0 +1,401 @@ |
||||
/*-------------------------------------------------------------------------
|
||||
* |
||||
* collationcmds.c |
||||
* collation creation command support code |
||||
* |
||||
* Portions Copyright (c) 1996-2011, PostgreSQL Global Development Group |
||||
* Portions Copyright (c) 1994, Regents of the University of California |
||||
* |
||||
* |
||||
* IDENTIFICATION |
||||
* src/backend/commands/collationcmds.c |
||||
* |
||||
*------------------------------------------------------------------------- |
||||
*/ |
||||
#include "postgres.h" |
||||
|
||||
#include "access/heapam.h" |
||||
#include "catalog/dependency.h" |
||||
#include "catalog/indexing.h" |
||||
#include "catalog/namespace.h" |
||||
#include "catalog/pg_collation.h" |
||||
#include "catalog/pg_collation_fn.h" |
||||
#include "commands/alter.h" |
||||
#include "commands/collationcmds.h" |
||||
#include "commands/dbcommands.h" |
||||
#include "commands/defrem.h" |
||||
#include "mb/pg_wchar.h" |
||||
#include "miscadmin.h" |
||||
#include "parser/parse_type.h" |
||||
#include "utils/acl.h" |
||||
#include "utils/builtins.h" |
||||
#include "utils/lsyscache.h" |
||||
#include "utils/syscache.h" |
||||
|
||||
static void AlterCollationOwner_internal(Relation rel, Oid collationOid, |
||||
Oid newOwnerId); |
||||
|
||||
/*
|
||||
* CREATE COLLATION |
||||
*/ |
||||
void |
||||
DefineCollation(List *names, List *parameters) |
||||
{ |
||||
char *collName; |
||||
Oid collNamespace; |
||||
AclResult aclresult; |
||||
ListCell *pl; |
||||
DefElem *fromEl = NULL; |
||||
DefElem *localeEl = NULL; |
||||
DefElem *lccollateEl = NULL; |
||||
DefElem *lcctypeEl = NULL; |
||||
char *collcollate = NULL; |
||||
char *collctype = NULL; |
||||
|
||||
collNamespace = QualifiedNameGetCreationNamespace(names, &collName); |
||||
|
||||
aclresult = pg_namespace_aclcheck(collNamespace, GetUserId(), ACL_CREATE); |
||||
if (aclresult != ACLCHECK_OK) |
||||
aclcheck_error(aclresult, ACL_KIND_NAMESPACE, |
||||
get_namespace_name(collNamespace)); |
||||
|
||||
foreach(pl, parameters) |
||||
{ |
||||
DefElem *defel = (DefElem *) lfirst(pl); |
||||
DefElem **defelp; |
||||
|
||||
if (pg_strcasecmp(defel->defname, "from") == 0) |
||||
defelp = &fromEl; |
||||
else if (pg_strcasecmp(defel->defname, "locale") == 0) |
||||
defelp = &localeEl; |
||||
else if (pg_strcasecmp(defel->defname, "lc_collate") == 0) |
||||
defelp = &lccollateEl; |
||||
else if (pg_strcasecmp(defel->defname, "lc_ctype") == 0) |
||||
defelp = &lcctypeEl; |
||||
else |
||||
{ |
||||
ereport(ERROR, |
||||
(errcode(ERRCODE_SYNTAX_ERROR), |
||||
errmsg("collation attribute \"%s\" not recognized", |
||||
defel->defname))); |
||||
break; |
||||
} |
||||
|
||||
*defelp = defel; |
||||
} |
||||
|
||||
if ((localeEl && (lccollateEl || lcctypeEl)) |
||||
|| (fromEl && list_length(parameters) != 1)) |
||||
ereport(ERROR, |
||||
(errcode(ERRCODE_SYNTAX_ERROR), |
||||
errmsg("conflicting or redundant options"))); |
||||
|
||||
if (fromEl) |
||||
{ |
||||
Oid collid; |
||||
HeapTuple tp; |
||||
|
||||
collid = LookupCollation(NULL, defGetQualifiedName(fromEl), -1); |
||||
tp = SearchSysCache1(COLLOID, ObjectIdGetDatum(collid)); |
||||
if (!HeapTupleIsValid(tp)) |
||||
elog(ERROR, "cache lookup failed for collation %u", collid); |
||||
|
||||
collcollate = pstrdup(NameStr(((Form_pg_collation) GETSTRUCT(tp))->collcollate)); |
||||
collctype = pstrdup(NameStr(((Form_pg_collation) GETSTRUCT(tp))->collctype)); |
||||
|
||||
ReleaseSysCache(tp); |
||||
} |
||||
|
||||
if (localeEl) |
||||
{ |
||||
collcollate = defGetString(localeEl); |
||||
collctype = defGetString(localeEl); |
||||
} |
||||
|
||||
if (lccollateEl) |
||||
collcollate = defGetString(lccollateEl); |
||||
|
||||
if (lcctypeEl) |
||||
collctype = defGetString(lcctypeEl); |
||||
|
||||
if (!collcollate) |
||||
ereport(ERROR, |
||||
(errcode(ERRCODE_INVALID_OBJECT_DEFINITION), |
||||
errmsg("parameter \"lc_collate\" parameter must be specified"))); |
||||
|
||||
if (!collctype) |
||||
ereport(ERROR, |
||||
(errcode(ERRCODE_INVALID_OBJECT_DEFINITION), |
||||
errmsg("parameter \"lc_ctype\" must be specified"))); |
||||
|
||||
check_encoding_locale_matches(GetDatabaseEncoding(), collcollate, collctype); |
||||
|
||||
CollationCreate(collName, |
||||
collNamespace, |
||||
GetUserId(), |
||||
GetDatabaseEncoding(), |
||||
collcollate, |
||||
collctype); |
||||
} |
||||
|
||||
/*
|
||||
* DROP COLLATION |
||||
*/ |
||||
void |
||||
DropCollationsCommand(DropStmt *drop) |
||||
{ |
||||
ObjectAddresses *objects; |
||||
ListCell *cell; |
||||
|
||||
/*
|
||||
* First we identify all the collations, then we delete them in a single |
||||
* performMultipleDeletions() call. This is to avoid unwanted DROP |
||||
* RESTRICT errors if one of the collations depends on another. (Not that |
||||
* that is very likely, but we may as well do this consistently.) |
||||
*/ |
||||
objects = new_object_addresses(); |
||||
|
||||
foreach(cell, drop->objects) |
||||
{ |
||||
List *name = (List *) lfirst(cell); |
||||
Oid collationOid; |
||||
HeapTuple tuple; |
||||
Form_pg_collation coll; |
||||
ObjectAddress object; |
||||
|
||||
collationOid = get_collation_oid(name, drop->missing_ok); |
||||
|
||||
if (!OidIsValid(collationOid)) |
||||
{ |
||||
ereport(NOTICE, |
||||
(errmsg("collation \"%s\" does not exist, skipping", |
||||
NameListToString(name)))); |
||||
continue; |
||||
} |
||||
|
||||
tuple = SearchSysCache1(COLLOID, ObjectIdGetDatum(collationOid)); |
||||
if (!HeapTupleIsValid(tuple)) |
||||
elog(ERROR, "cache lookup failed for collation %u", |
||||
collationOid); |
||||
coll = (Form_pg_collation) GETSTRUCT(tuple); |
||||
|
||||
/* Permission check: must own collation or its namespace */ |
||||
if (!pg_collation_ownercheck(collationOid, GetUserId()) && |
||||
!pg_namespace_ownercheck(coll->collnamespace, GetUserId())) |
||||
aclcheck_error(ACLCHECK_NOT_OWNER, ACL_KIND_COLLATION, |
||||
NameStr(coll->collname)); |
||||
|
||||
object.classId = CollationRelationId; |
||||
object.objectId = collationOid; |
||||
object.objectSubId = 0; |
||||
|
||||
add_exact_object_address(&object, objects); |
||||
|
||||
ReleaseSysCache(tuple); |
||||
} |
||||
|
||||
performMultipleDeletions(objects, drop->behavior); |
||||
|
||||
free_object_addresses(objects); |
||||
} |
||||
|
||||
/*
|
||||
* Rename collation |
||||
*/ |
||||
void |
||||
RenameCollation(List *name, const char *newname) |
||||
{ |
||||
Oid collationOid; |
||||
Oid namespaceOid; |
||||
HeapTuple tup; |
||||
Relation rel; |
||||
AclResult aclresult; |
||||
|
||||
rel = heap_open(CollationRelationId, RowExclusiveLock); |
||||
|
||||
collationOid = get_collation_oid(name, false); |
||||
|
||||
tup = SearchSysCacheCopy1(COLLOID, ObjectIdGetDatum(collationOid)); |
||||
if (!HeapTupleIsValid(tup)) /* should not happen */ |
||||
elog(ERROR, "cache lookup failed for collation %u", collationOid); |
||||
|
||||
namespaceOid = ((Form_pg_collation) GETSTRUCT(tup))->collnamespace; |
||||
|
||||
/* make sure the new name doesn't exist */ |
||||
if (SearchSysCacheExists3(COLLNAMEENCNSP, |
||||
CStringGetDatum(newname), |
||||
Int32GetDatum(GetDatabaseEncoding()), |
||||
ObjectIdGetDatum(namespaceOid))) |
||||
ereport(ERROR, |
||||
(errcode(ERRCODE_DUPLICATE_OBJECT), |
||||
errmsg("collation \"%s\" for current database encoding \"%s\" already exists in schema \"%s\"", |
||||
newname, |
||||
GetDatabaseEncodingName(), |
||||
get_namespace_name(namespaceOid)))); |
||||
|
||||
/* must be owner */ |
||||
if (!pg_collation_ownercheck(collationOid, GetUserId())) |
||||
aclcheck_error(ACLCHECK_NOT_OWNER, ACL_KIND_COLLATION, |
||||
NameListToString(name)); |
||||
|
||||
/* must have CREATE privilege on namespace */ |
||||
aclresult = pg_namespace_aclcheck(namespaceOid, GetUserId(), ACL_CREATE); |
||||
if (aclresult != ACLCHECK_OK) |
||||
aclcheck_error(aclresult, ACL_KIND_NAMESPACE, |
||||
get_namespace_name(namespaceOid)); |
||||
|
||||
/* rename */ |
||||
namestrcpy(&(((Form_pg_collation) GETSTRUCT(tup))->collname), newname); |
||||
simple_heap_update(rel, &tup->t_self, tup); |
||||
CatalogUpdateIndexes(rel, tup); |
||||
|
||||
heap_close(rel, NoLock); |
||||
heap_freetuple(tup); |
||||
} |
||||
|
||||
/*
|
||||
* Change collation owner, by name |
||||
*/ |
||||
void |
||||
AlterCollationOwner(List *name, Oid newOwnerId) |
||||
{ |
||||
Oid collationOid; |
||||
Relation rel; |
||||
|
||||
rel = heap_open(CollationRelationId, RowExclusiveLock); |
||||
|
||||
collationOid = get_collation_oid(name, false); |
||||
|
||||
AlterCollationOwner_internal(rel, collationOid, newOwnerId); |
||||
|
||||
heap_close(rel, NoLock); |
||||
} |
||||
|
||||
/*
|
||||
* Change collation owner, by oid |
||||
*/ |
||||
void |
||||
AlterCollationOwner_oid(Oid collationOid, Oid newOwnerId) |
||||
{ |
||||
Relation rel; |
||||
|
||||
rel = heap_open(CollationRelationId, RowExclusiveLock); |
||||
|
||||
AlterCollationOwner_internal(rel, collationOid, newOwnerId); |
||||
|
||||
heap_close(rel, NoLock); |
||||
} |
||||
|
||||
/*
|
||||
* AlterCollationOwner_internal |
||||
* |
||||
* Internal routine for changing the owner. rel must be pg_collation, already |
||||
* open and suitably locked; it will not be closed. |
||||
*/ |
||||
static void |
||||
AlterCollationOwner_internal(Relation rel, Oid collationOid, Oid newOwnerId) |
||||
{ |
||||
Form_pg_collation collForm; |
||||
HeapTuple tup; |
||||
|
||||
Assert(RelationGetRelid(rel) == CollationRelationId); |
||||
|
||||
tup = SearchSysCacheCopy1(COLLOID, ObjectIdGetDatum(collationOid)); |
||||
if (!HeapTupleIsValid(tup)) /* should not happen */ |
||||
elog(ERROR, "cache lookup failed for collation %u", collationOid); |
||||
|
||||
collForm = (Form_pg_collation) GETSTRUCT(tup); |
||||
|
||||
/*
|
||||
* If the new owner is the same as the existing owner, consider the |
||||
* command to have succeeded. This is for dump restoration purposes. |
||||
*/ |
||||
if (collForm->collowner != newOwnerId) |
||||
{ |
||||
AclResult aclresult; |
||||
|
||||
/* Superusers can always do it */ |
||||
if (!superuser()) |
||||
{ |
||||
/* Otherwise, must be owner of the existing object */ |
||||
if (!pg_collation_ownercheck(HeapTupleGetOid(tup), GetUserId())) |
||||
aclcheck_error(ACLCHECK_NOT_OWNER, ACL_KIND_COLLATION, |
||||
NameStr(collForm->collname)); |
||||
|
||||
/* Must be able to become new owner */ |
||||
check_is_member_of_role(GetUserId(), newOwnerId); |
||||
|
||||
/* New owner must have CREATE privilege on namespace */ |
||||
aclresult = pg_namespace_aclcheck(collForm->collnamespace, |
||||
newOwnerId, |
||||
ACL_CREATE); |
||||
if (aclresult != ACLCHECK_OK) |
||||
aclcheck_error(aclresult, ACL_KIND_NAMESPACE, |
||||
get_namespace_name(collForm->collnamespace)); |
||||
} |
||||
|
||||
/*
|
||||
* Modify the owner --- okay to scribble on tup because it's a copy |
||||
*/ |
||||
collForm->collowner = newOwnerId; |
||||
|
||||
simple_heap_update(rel, &tup->t_self, tup); |
||||
|
||||
CatalogUpdateIndexes(rel, tup); |
||||
|
||||
/* Update owner dependency reference */ |
||||
changeDependencyOnOwner(CollationRelationId, collationOid, |
||||
newOwnerId); |
||||
} |
||||
|
||||
heap_freetuple(tup); |
||||
} |
||||
|
||||
/*
|
||||
* Execute ALTER COLLATION SET SCHEMA |
||||
*/ |
||||
void |
||||
AlterCollationNamespace(List *name, const char *newschema) |
||||
{ |
||||
Oid collOid, nspOid; |
||||
Relation rel; |
||||
|
||||
rel = heap_open(CollationRelationId, RowExclusiveLock); |
||||
|
||||
collOid = get_collation_oid(name, false); |
||||
|
||||
/* get schema OID */ |
||||
nspOid = LookupCreationNamespace(newschema); |
||||
|
||||
AlterObjectNamespace(rel, COLLOID, -1, |
||||
collOid, nspOid, |
||||
Anum_pg_collation_collname, |
||||
Anum_pg_collation_collnamespace, |
||||
Anum_pg_collation_collowner, |
||||
ACL_KIND_COLLATION); |
||||
|
||||
heap_close(rel, NoLock); |
||||
} |
||||
|
||||
/*
|
||||
* Change collation schema, by oid |
||||
*/ |
||||
Oid |
||||
AlterCollationNamespace_oid(Oid collOid, Oid newNspOid) |
||||
{ |
||||
Oid oldNspOid; |
||||
Relation rel; |
||||
|
||||
rel = heap_open(CollationRelationId, RowExclusiveLock); |
||||
|
||||
oldNspOid = AlterObjectNamespace(rel, COLLOID, -1, |
||||
collOid, newNspOid, |
||||
Anum_pg_collation_collname, |
||||
Anum_pg_collation_collnamespace, |
||||
Anum_pg_collation_collowner, |
||||
ACL_KIND_COLLATION); |
||||
|
||||
heap_close(rel, RowExclusiveLock); |
||||
|
||||
return oldNspOid; |
||||
} |
||||
@ -0,0 +1,23 @@ |
||||
/*-------------------------------------------------------------------------
|
||||
* |
||||
* pg_collation_fn.h |
||||
* prototypes for functions in catalog/pg_collation.c |
||||
* |
||||
* |
||||
* Portions Copyright (c) 1996-2011, PostgreSQL Global Development Group |
||||
* Portions Copyright (c) 1994, Regents of the University of California |
||||
* |
||||
* src/include/catalog/pg_collation_fn.h |
||||
* |
||||
*------------------------------------------------------------------------- |
||||
*/ |
||||
#ifndef PG_COLLATION_FN_H |
||||
#define PG_COLLATION_FN_H |
||||
|
||||
extern Oid CollationCreate(const char *collname, Oid collnamespace, |
||||
Oid collowner, |
||||
int32 collencoding, |
||||
const char *collcollate, const char *collctype); |
||||
extern void RemoveCollationById(Oid collationOid); |
||||
|
||||
#endif /* PG_COLLATION_FN_H */ |
||||
@ -0,0 +1,28 @@ |
||||
/*-------------------------------------------------------------------------
|
||||
* |
||||
* collationcmds.h |
||||
* prototypes for collationcmds.c. |
||||
* |
||||
* |
||||
* Portions Copyright (c) 1996-2011, PostgreSQL Global Development Group |
||||
* Portions Copyright (c) 1994, Regents of the University of California |
||||
* |
||||
* src/include/commands/collationcmds.h |
||||
* |
||||
*------------------------------------------------------------------------- |
||||
*/ |
||||
|
||||
#ifndef COLLATIONCMDS_H |
||||
#define COLLATIONCMDS_H |
||||
|
||||
#include "nodes/parsenodes.h" |
||||
|
||||
extern void DefineCollation(List *names, List *parameters); |
||||
extern void DropCollationsCommand(DropStmt *drop); |
||||
extern void RenameCollation(List *name, const char *newname); |
||||
extern void AlterCollationOwner(List *name, Oid newOwnerId); |
||||
extern void AlterCollationOwner_oid(Oid collationOid, Oid newOwnerId); |
||||
extern void AlterCollationNamespace(List *name, const char *newschema); |
||||
extern Oid AlterCollationNamespace_oid(Oid collOid, Oid newNspOid); |
||||
|
||||
#endif /* COLLATIONCMDS_H */ |
||||
Loading…
Reference in new issue