mirror of https://github.com/postgres/postgres
Bruce Momjian
24 years ago
parent
609f71b760
commit
b976b8af80
@ -1,87 +0,0 @@ |
||||
|
||||
|
||||
-- Test Comment / Drop |
||||
create domain domaindroptest int4; |
||||
comment on domain domaindroptest is 'About to drop this..'; |
||||
|
||||
select * from pg_type where typname = 'domaindroptest'; |
||||
|
||||
drop domain domaindroptest restrict; |
||||
|
||||
select * from pg_type where typname = 'domaindroptest'; |
||||
|
||||
-- TEST Domains. |
||||
|
||||
create domain domainvarchar varchar(5); |
||||
create domain domainnumeric numeric(8,2); |
||||
create domain domainint4 int4; |
||||
create domain domaintext text; |
||||
|
||||
|
||||
-- Test tables using domains |
||||
create table basictest |
||||
( testint4 domainint4 |
||||
, testtext domaintext |
||||
, testvarchar domainvarchar |
||||
, testnumeric domainnumeric |
||||
); |
||||
|
||||
INSERT INTO basictest values ('88', 'haha', 'short', '123.12'); -- Good |
||||
INSERT INTO basictest values ('88', 'haha', 'short text', '123.12'); -- Bad varchar |
||||
INSERT INTO basictest values ('88', 'haha', 'short', '123.1212'); -- Truncate numeric |
||||
select * from basictest; |
||||
|
||||
|
||||
-- Array Test |
||||
create domain domainint4arr int4[1]; |
||||
create domain domaintextarr text[2][3]; |
||||
|
||||
create table arrtest |
||||
( testint4arr domainint4arr |
||||
, testtextarr domaintextarr |
||||
); |
||||
INSERT INTO arrtest values ('{2,2}', '{{"a","b"}{"c","d"}}'); |
||||
INSERT INTO arrtest values ('{{2,2}{2,2}}', '{{"a","b"}}'); |
||||
INSERT INTO arrtest values ('{2,2}', '{{"a","b"}{"c","d"}{"e"}}'); |
||||
INSERT INTO arrtest values ('{2,2}', '{{"a"}{"c"}}'); |
||||
INSERT INTO arrtest values (NULL, '{{"a","b"}{"c","d","e"}}'); |
||||
|
||||
|
||||
create domain dnotnull varchar(15) NOT NULL; |
||||
create domain dnull varchar(15) NULL; |
||||
|
||||
create table nulltest |
||||
( col1 dnotnull |
||||
, col2 dnotnull NULL -- NOT NULL in the domain cannot be overridden |
||||
, col3 dnull NOT NULL |
||||
, col4 dnull |
||||
); |
||||
INSERT INTO nulltest DEFAULT VALUES; |
||||
INSERT INTO nulltest values ('a', 'b', 'c', 'd'); -- Good |
||||
INSERT INTO nulltest values (NULL, 'b', 'c', 'd'); |
||||
INSERT INTO nulltest values ('a', NULL, 'c', 'd'); |
||||
INSERT INTO nulltest values ('a', 'b', NULL, 'd'); |
||||
INSERT INTO nulltest values ('a', 'b', 'c', NULL); -- Good |
||||
select * from nulltest; |
||||
|
||||
|
||||
create domain ddef1 int4 DEFAULT 3; |
||||
create domain ddef2 numeric(8,6) DEFAULT '1234.123456789'; |
||||
-- Type mixing, function returns int8 |
||||
create domain ddef3 text DEFAULT 5; |
||||
create sequence ddef4_seq; |
||||
create domain ddef4 int4 DEFAULT nextval(cast('ddef4_seq' as text)); |
||||
|
||||
create table defaulttest |
||||
( col1 ddef1 |
||||
, col2 ddef2 |
||||
, col3 ddef3 |
||||
, col4 ddef4 |
||||
, col5 ddef1 NOT NULL DEFAULT NULL |
||||
, col6 ddef2 DEFAULT '88.1' |
||||
, col7 ddef4 DEFAULT 8000 |
||||
); |
||||
insert into defaulttest default values; |
||||
insert into defaulttest default values; |
||||
insert into defaulttest default values; |
||||
select * from defaulttest; |
||||
@ -1,231 +0,0 @@ |
||||
<!-- |
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.1 2002/03/06 20:34:44 momjian Exp $ |
||||
PostgreSQL documentation |
||||
--> |
||||
|
||||
<refentry id="SQL-CREATEDOMAIN"> |
||||
<refmeta> |
||||
<refentrytitle id="sql-createdomian-title"> |
||||
CREATE DOMAIN |
||||
</refentrytitle> |
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||
</refmeta> |
||||
<refnamediv> |
||||
<refname> |
||||
CREATE DOMAIN |
||||
</refname> |
||||
<refpurpose> |
||||
define a new domain |
||||
</refpurpose> |
||||
</refnamediv> |
||||
<refsynopsisdiv> |
||||
<refsynopsisdivinfo> |
||||
<date>2002-02-24</date> |
||||
</refsynopsisdivinfo> |
||||
<synopsis> |
||||
CREATE DOMAIN <replaceable class="parameter">domainname</replaceable> <replaceable class="parameter">data_type</replaceable> [ DEFAULT <replaceable>default_expr</> ] [ <replaceable class="PARAMETER">column_constraint</replaceable> [, ... ] ] |
||||
[ CONSTRAINT <replaceable class="PARAMETER">constraint_name</replaceable> ] |
||||
{ NOT NULL | NULL <!-- | UNIQUE | PRIMARY KEY | |
||||
CHECK (<replaceable class="PARAMETER">expression</replaceable>) | |
||||
REFERENCES <replaceable class="PARAMETER">reftable</replaceable> [ ( <replaceable class="PARAMETER">refcolumn</replaceable> ) ] [ MATCH FULL | MATCH PARTIAL ] |
||||
[ ON DELETE <replaceable class="parameter">action</replaceable> ] [ ON UPDATE <replaceable class="parameter">action</replaceable> ] --> } |
||||
<!-- [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] --> |
||||
</synopsis> |
||||
|
||||
<refsect2 id="R2-SQL-CREATEDOMAIN-1"> |
||||
<refsect2info> |
||||
<date>2002-02-24</date> |
||||
</refsect2info> |
||||
<title> |
||||
Parameters |
||||
</title> |
||||
<para> |
||||
|
||||
<variablelist> |
||||
<varlistentry> |
||||
<term><replaceable class="parameter">domainname</replaceable></term> |
||||
<listitem> |
||||
<para> |
||||
The name of a domain to be created. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><replaceable class="PARAMETER">data_type</replaceable></term> |
||||
<listitem> |
||||
<para> |
||||
The data type of the domain. This may include array specifiers. |
||||
Refer to the <citetitle>User's Guide</citetitle> for further |
||||
information about data types and arrays. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><literal>DEFAULT |
||||
<replaceable>default_expr</replaceable></literal></term> |
||||
<listitem> |
||||
<para> |
||||
The <literal>DEFAULT</> clause assigns a default data value for |
||||
the column whose column definition it appears within. The value |
||||
is any variable-free expression (subselects and cross-references |
||||
to other columns in the current table are not allowed). The |
||||
data type of the default expression must match the data type of the |
||||
domain. |
||||
</para> |
||||
|
||||
<para> |
||||
The default expression will be used in any insert operation that |
||||
does not specify a value for the domain. If there is no default |
||||
for a domain, then the default is NULL. |
||||
</para> |
||||
|
||||
<note> |
||||
<para> |
||||
The default of a column will be tested before that of the domain. |
||||
</para> |
||||
</note> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><literal>CONSTRAINT <replaceable class="PARAMETER">constraint_name</replaceable></literal></term> |
||||
<listitem> |
||||
<para> |
||||
An optional name for a domain. If not specified, |
||||
the system generates a name. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><literal>NOT NULL</></term> |
||||
<listitem> |
||||
<para> |
||||
The column is not allowed to contain NULL values. This is |
||||
equivalent to the column constraint <literal>CHECK (<replaceable |
||||
class="PARAMETER">column</replaceable> NOT NULL)</literal>. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
<varlistentry> |
||||
<term><literal>NULL</></term> |
||||
<listitem> |
||||
<para> |
||||
The column is allowed to contain NULL values. This is the default. |
||||
</para> |
||||
|
||||
<para> |
||||
This clause is only available for compatibility with |
||||
non-standard SQL databases. Its use is discouraged in new |
||||
applications. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
|
||||
</variablelist> |
||||
</para> |
||||
</refsect2> |
||||
|
||||
<refsect2 id="R2-SQL-CREATEDOMAIN-2"> |
||||
<refsect2info> |
||||
<date>2002-02-24</date> |
||||
</refsect2info> |
||||
<title> |
||||
Outputs |
||||
</title> |
||||
<para> |
||||
|
||||
<variablelist> |
||||
<varlistentry> |
||||
<term><computeroutput> |
||||
CREATE DOMAIN |
||||
</computeroutput></term> |
||||
<listitem> |
||||
<para> |
||||
Message returned if the domain is successfully created. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
</variablelist> |
||||
</para> |
||||
</refsect2> |
||||
</refsynopsisdiv> |
||||
|
||||
<refsect1 id="R1-SQL-CREATEDOMAIN-1"> |
||||
<refsect1info> |
||||
<date>2002-02-24</date> |
||||
</refsect1info> |
||||
<title> |
||||
Description |
||||
</title> |
||||
|
||||
<para> |
||||
<command>CREATE DOMAIN</command> allows the user to register a new user data |
||||
domain with PostgreSQL for use in the current data base. The |
||||
user who defines a domain becomes its owner. |
||||
<replaceable class="parameter">domainname</replaceable> is |
||||
the name of the new type and must be unique within the |
||||
types and domains defined for this database. |
||||
</para> |
||||
|
||||
<para> |
||||
Domains are useful for abstracting common fields between tables into |
||||
a single location for maintenance. An email address column may be used |
||||
in several tables, all with the same properties. Define a domain and |
||||
use that rather than setting up each tables constraints individually. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>Examples</title> |
||||
<para> |
||||
This example creates the <type>country_code</type> data type and then uses the |
||||
type in a table definition: |
||||
<programlisting> |
||||
CREATE DOMAIN country_code char(2) NOT NULL; |
||||
CREATE TABLE countrylist (id INT4, country country_code); |
||||
</programlisting> |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="SQL-CREATEDOMAIN-compatibility"> |
||||
<title>Compatibility</title> |
||||
|
||||
<para> |
||||
This <command>CREATE DOMAIN</command> command is a |
||||
<productname>PostgreSQL</productname> extension. CHECK and FOREIGN KEY |
||||
constraints are currently unsupported. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="SQL-CREATEDOMAIN-see-also"> |
||||
<title>See Also</title> |
||||
|
||||
<simplelist type="inline"> |
||||
<member><xref linkend="sql-dropdomain"></member> |
||||
<member><citetitle>PostgreSQL Programmer's Guide</citetitle></member> |
||||
</simplelist> |
||||
</refsect1> |
||||
|
||||
</refentry> |
||||
|
||||
|
||||
<!-- Keep this comment at the end of the file |
||||
Local variables: |
||||
mode: sgml |
||||
sgml-omittag:nil |
||||
sgml-shorttag:t |
||||
sgml-minimize-attributes:nil |
||||
sgml-always-quote-attributes:t |
||||
sgml-indent-step:1 |
||||
sgml-indent-data:t |
||||
sgml-parent-document:nil |
||||
sgml-default-dtd-file:"../reference.ced" |
||||
sgml-exposed-tags:nil |
||||
sgml-local-catalogs:"/usr/lib/sgml/catalog" |
||||
sgml-local-ecat-files:nil |
||||
End: |
||||
--> |
||||
@ -1,167 +0,0 @@ |
||||
<!-- |
||||
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_domain.sgml,v 1.1 2002/03/06 20:34:44 momjian Exp $ |
||||
PostgreSQL documentation |
||||
--> |
||||
|
||||
<refentry id="SQL-DROPDOMAIN"> |
||||
<refmeta> |
||||
<refentrytitle id="SQL-DROPDOMAIN-TITLE"> |
||||
DROP DOMAIN |
||||
</refentrytitle> |
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||
</refmeta> |
||||
<refnamediv> |
||||
<refname> |
||||
DROP DOMAIN |
||||
</refname> |
||||
<refpurpose> |
||||
remove a user-defined domain |
||||
</refpurpose> |
||||
</refnamediv> |
||||
<refsynopsisdiv> |
||||
<refsynopsisdivinfo> |
||||
<date>1999-07-20</date> |
||||
</refsynopsisdivinfo> |
||||
<synopsis> |
||||
DROP DOMAIN <replaceable class="PARAMETER">domainname</replaceable> [, ...] |
||||
</synopsis> |
||||
|
||||
<refsect2 id="R2-SQL-DROPDOMAIN-1"> |
||||
<refsect2info> |
||||
<date>2002-02-24</date> |
||||
</refsect2info> |
||||
<title> |
||||
Inputs |
||||
</title> |
||||
<para> |
||||
<variablelist> |
||||
<varlistentry> |
||||
<term><replaceable class="PARAMETER">domainname</replaceable></term> |
||||
<listitem> |
||||
<para> |
||||
The name of an existing domain. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
</variablelist> |
||||
</para> |
||||
</refsect2> |
||||
|
||||
<refsect2 id="R2-SQL-DROPDOMAIN-2"> |
||||
<refsect2info> |
||||
<date>2002-02-24</date> |
||||
</refsect2info> |
||||
<title> |
||||
Outputs |
||||
</title> |
||||
<para> |
||||
<variablelist> |
||||
<varlistentry> |
||||
<term><computeroutput> |
||||
DROP |
||||
</computeroutput></term> |
||||
<listitem> |
||||
<para> |
||||
The message returned if the command is successful. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
<varlistentry> |
||||
<term><computeroutput> |
||||
ERROR: RemoveDomain: type '<replaceable class="parameter">domainname</replaceable>' does not exist |
||||
</computeroutput></term> |
||||
<listitem> |
||||
<para> |
||||
This message occurs if the specified domain (or type) is not found. |
||||
</para> |
||||
</listitem> |
||||
</varlistentry> |
||||
</variablelist> |
||||
</para> |
||||
</refsect2> |
||||
</refsynopsisdiv> |
||||
|
||||
<refsect1 id="R1-SQL-DROPDOMAIN-1"> |
||||
<refsect1info> |
||||
<date>2002-02-24</date> |
||||
</refsect1info> |
||||
<title> |
||||
Description |
||||
</title> |
||||
<para> |
||||
<command>DROP DOMAIN</command> will remove a user domain from the |
||||
system catalogs. |
||||
</para> |
||||
<para> |
||||
Only the owner of a domain can remove it. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="SQL-DROPDOMAIN-notes"> |
||||
<title>Notes</title> |
||||
|
||||
<itemizedlist> |
||||
<listitem> |
||||
<para> |
||||
It is the user's responsibility to remove any operators, |
||||
functions, aggregates, access methods, and tables that |
||||
use a deleted domain. |
||||
</para> |
||||
</listitem> |
||||
</itemizedlist> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="SQL-DROPDOMAIN-examples"> |
||||
<title>Examples</title> |
||||
<para> |
||||
To remove the <type>box</type> domain: |
||||
|
||||
<programlisting> |
||||
DROP DOMAIN box RESTRICT; |
||||
</programlisting> |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="SQL-DROPDOMAIN-compatibility"> |
||||
<title>Compatibility</title> |
||||
|
||||
<para> |
||||
A <command>DROP DOMAIN</command> statement exists in SQL99. As with |
||||
most other <quote>drop</quote> commands, <command>DROP |
||||
DOMAIN</command> in SQL99 requires a <quote>drop behavior</quote> |
||||
clause to select between dropping all dependent objects or refusing |
||||
to drop if dependent objects exist: |
||||
<synopsis> |
||||
DROP DOMAIN <replaceable>name</replaceable> { CASCADE | RESTRICT } |
||||
</synopsis> |
||||
<productname>PostgreSQL</productname> enforces the existance of |
||||
RESTRICT or CASCADE but ignores their enforcement against the |
||||
system tables. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1 id="SQL-DROPDOMAIN-see-also"> |
||||
<title>See Also</title> |
||||
|
||||
<simplelist type="inline"> |
||||
<member><xref linkend="sql-createdomain"></member> |
||||
</simplelist> |
||||
</refsect1> |
||||
</refentry> |
||||
|
||||
<!-- Keep this comment at the end of the file |
||||
Local variables: |
||||
mode: sgml |
||||
sgml-omittag:nil |
||||
sgml-shorttag:t |
||||
sgml-minimize-attributes:nil |
||||
sgml-always-quote-attributes:t |
||||
sgml-indent-step:1 |
||||
sgml-indent-data:t |
||||
sgml-parent-document:nil |
||||
sgml-default-dtd-file:"../reference.ced" |
||||
sgml-exposed-tags:nil |
||||
sgml-local-catalogs:"/usr/lib/sgml/catalog" |
||||
sgml-local-ecat-files:nil |
||||
End: |
||||
--> |
||||
Loading…
Reference in new issue