2007-08-21 23:08:47 +02:00
|
|
|
<!--
|
2010-09-20 22:08:53 +02:00
|
|
|
doc/src/sgml/ref/alter_tsdictionary.sgml
|
2007-08-21 23:08:47 +02:00
|
|
|
PostgreSQL documentation
|
|
|
|
-->
|
|
|
|
|
|
|
|
<refentry id="SQL-ALTERTSDICTIONARY">
|
|
|
|
<refmeta>
|
2010-04-03 09:23:02 +02:00
|
|
|
<refentrytitle>ALTER TEXT SEARCH DICTIONARY</refentrytitle>
|
2008-11-14 11:22:48 +01:00
|
|
|
<manvolnum>7</manvolnum>
|
2007-08-21 23:08:47 +02:00
|
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
|
|
</refmeta>
|
|
|
|
|
|
|
|
<refnamediv>
|
|
|
|
<refname>ALTER TEXT SEARCH DICTIONARY</refname>
|
|
|
|
<refpurpose>change the definition of a text search dictionary</refpurpose>
|
|
|
|
</refnamediv>
|
|
|
|
|
|
|
|
<indexterm zone="sql-altertsdictionary">
|
|
|
|
<primary>ALTER TEXT SEARCH DICTIONARY</primary>
|
|
|
|
</indexterm>
|
|
|
|
|
|
|
|
<refsynopsisdiv>
|
|
|
|
<synopsis>
|
2007-08-22 03:39:46 +02:00
|
|
|
ALTER TEXT SEARCH DICTIONARY <replaceable>name</replaceable> (
|
|
|
|
<replaceable class="parameter">option</replaceable> [ = <replaceable class="parameter">value</replaceable> ] [, ... ]
|
|
|
|
)
|
2009-09-19 12:23:27 +02:00
|
|
|
ALTER TEXT SEARCH DICTIONARY <replaceable>name</replaceable> RENAME TO <replaceable>new_name</replaceable>
|
|
|
|
ALTER TEXT SEARCH DICTIONARY <replaceable>name</replaceable> OWNER TO <replaceable>new_owner</replaceable>
|
2007-08-21 23:08:47 +02:00
|
|
|
</synopsis>
|
|
|
|
</refsynopsisdiv>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Description</title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
<command>ALTER TEXT SEARCH DICTIONARY</command> changes the definition of
|
2007-08-22 03:39:46 +02:00
|
|
|
a text search dictionary. You can change the dictionary's
|
|
|
|
template-specific options, or change the dictionary's name or owner.
|
2007-08-21 23:08:47 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
You must be the owner of the dictionary to use
|
|
|
|
<command>ALTER TEXT SEARCH DICTIONARY</>.
|
|
|
|
</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 text search
|
|
|
|
dictionary.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
2007-08-22 03:39:46 +02:00
|
|
|
<term><replaceable class="parameter">option</replaceable></term>
|
2007-08-21 23:08:47 +02:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2007-08-22 03:39:46 +02:00
|
|
|
The name of a template-specific option to be set for this dictionary.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><replaceable class="parameter">value</replaceable></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
The new value to use for a template-specific option.
|
|
|
|
If the equal sign and value are omitted, then any previous
|
|
|
|
setting for the option is removed from the dictionary,
|
|
|
|
allowing the default to be used.
|
2007-08-21 23:08:47 +02:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
2009-09-19 12:23:27 +02:00
|
|
|
<term><replaceable class="parameter">new_name</replaceable></term>
|
2007-08-21 23:08:47 +02:00
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
The new name of the text search dictionary.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
2009-09-19 12:23:27 +02:00
|
|
|
<term><replaceable class="parameter">new_owner</replaceable></term>
|
2007-08-21 23:08:47 +02:00
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
The new owner of the text search dictionary.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
2007-08-22 03:39:46 +02:00
|
|
|
|
|
|
|
<para>
|
|
|
|
Template-specific options can appear in any order.
|
|
|
|
</para>
|
2007-08-21 23:08:47 +02:00
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Examples</title>
|
|
|
|
|
|
|
|
<para>
|
2007-08-22 03:39:46 +02:00
|
|
|
The following example command changes the stopword list
|
|
|
|
for a Snowball-based dictionary. Other parameters remain unchanged.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<programlisting>
|
|
|
|
ALTER TEXT SEARCH DICTIONARY my_dict ( StopWords = newrussian );
|
|
|
|
</programlisting>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
The following example command changes the language option to dutch,
|
|
|
|
and removes the stopword option entirely.
|
2007-08-21 23:08:47 +02:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<programlisting>
|
2007-08-22 03:39:46 +02:00
|
|
|
ALTER TEXT SEARCH DICTIONARY my_dict ( language = dutch, StopWords );
|
2007-08-21 23:08:47 +02:00
|
|
|
</programlisting>
|
2007-10-17 03:01:28 +02:00
|
|
|
|
|
|
|
<para>
|
|
|
|
The following example command <quote>updates</> the dictionary's
|
|
|
|
definition without actually changing anything.
|
|
|
|
|
|
|
|
<programlisting>
|
|
|
|
ALTER TEXT SEARCH DICTIONARY my_dict ( dummy );
|
|
|
|
</programlisting>
|
|
|
|
|
|
|
|
(The reason this works is that the option removal code doesn't complain
|
|
|
|
if there is no such option.) This trick is useful when changing
|
|
|
|
configuration files for the dictionary: the <command>ALTER</> will
|
|
|
|
force existing database sessions to re-read the configuration files,
|
|
|
|
which otherwise they would never do if they had read them earlier.
|
|
|
|
</para>
|
2007-08-21 23:08:47 +02:00
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Compatibility</title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
There is no <command>ALTER TEXT SEARCH DICTIONARY</command> statement in
|
|
|
|
the SQL standard.
|
|
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>See Also</title>
|
|
|
|
|
|
|
|
<simplelist type="inline">
|
2010-04-03 09:23:02 +02:00
|
|
|
<member><xref linkend="sql-createtsdictionary"></member>
|
|
|
|
<member><xref linkend="sql-droptsdictionary"></member>
|
2007-08-21 23:08:47 +02:00
|
|
|
</simplelist>
|
|
|
|
</refsect1>
|
|
|
|
</refentry>
|