]> begriffs open source - ai-pg/blob - full-docs/txt/sql-createtsconfig.txt
Convert HTML docs to more streamlined TXT
[ai-pg] / full-docs / txt / sql-createtsconfig.txt
1
2 CREATE TEXT SEARCH CONFIGURATION
3
4    CREATE TEXT SEARCH CONFIGURATION — define a new text search
5    configuration
6
7 Synopsis
8
9 CREATE TEXT SEARCH CONFIGURATION name (
10     PARSER = parser_name |
11     COPY = source_config
12 )
13
14 Description
15
16    CREATE TEXT SEARCH CONFIGURATION creates a new text search
17    configuration. A text search configuration specifies a text search
18    parser that can divide a string into tokens, plus dictionaries that can
19    be used to determine which tokens are of interest for searching.
20
21    If only the parser is specified, then the new text search configuration
22    initially has no mappings from token types to dictionaries, and
23    therefore will ignore all words. Subsequent ALTER TEXT SEARCH
24    CONFIGURATION commands must be used to create mappings to make the
25    configuration useful. Alternatively, an existing text search
26    configuration can be copied.
27
28    If a schema name is given then the text search configuration is created
29    in the specified schema. Otherwise it is created in the current schema.
30
31    The user who defines a text search configuration becomes its owner.
32
33    Refer to Chapter 12 for further information.
34
35 Parameters
36
37    name
38           The name of the text search configuration to be created. The
39           name can be schema-qualified.
40
41    parser_name
42           The name of the text search parser to use for this
43           configuration.
44
45    source_config
46           The name of an existing text search configuration to copy.
47
48 Notes
49
50    The PARSER and COPY options are mutually exclusive, because when an
51    existing configuration is copied, its parser selection is copied too.
52
53 Compatibility
54
55    There is no CREATE TEXT SEARCH CONFIGURATION statement in the SQL
56    standard.
57
58 See Also
59
60    ALTER TEXT SEARCH CONFIGURATION, DROP TEXT SEARCH CONFIGURATION