doc/src/sgml/ref/drop_tablespace.sgml

   1 <!--
   2 $PostgreSQL: pgsql/doc/src/sgml/ref/drop_tablespace.sgml,v 1.1 2004/06/18 06:13:05 tgl Exp $
   3 PostgreSQL documentation
   4 -->
   5
   6 <refentry id="SQL-DROPTABLESPACE">
   7  <refmeta>
   8   <refentrytitle id="SQL-DROPTABLESPACE-TITLE">DROP TABLESPACE</refentrytitle>
   9   <refmiscinfo>SQL - Language Statements</refmiscinfo>
  10  </refmeta>
  11
  12  <refnamediv>
  13   <refname>DROP TABLESPACE</refname>
  14   <refpurpose>remove a tablespace</refpurpose>
  15  </refnamediv>
  16
  17  <indexterm zone="sql-droptablespace">
  18   <primary>DROP TABLESPACE</primary>
  19  </indexterm>
  20
  21  <refsynopsisdiv>
  22 <synopsis>
  23 DROP TABLESPACE <replaceable class="PARAMETER">tablespacename</replaceable>
  24 </synopsis>
  25  </refsynopsisdiv>
  26
  27  <refsect1>
  28   <title>Description</title>
  29
  30   <para>
  31    <command>DROP TABLESPACE</command> removes a tablespace from the system.
  32   </para>
  33
  34   <para>
  35    A tablespace can only be dropped by its owner or a superuser.
  36    The tablespace must be empty of all database objects before it can be
  37    dropped. It is possible that objects in other databases may still reside
  38    in the tablespace even if no objects in the current database are using
  39    the tablespace.
  40   </para>
  41  </refsect1>
  42
  43  <refsect1>
  44   <title>Parameters</title>
  45
  46   <variablelist>
  47    <varlistentry>
  48     <term><replaceable class="PARAMETER">tablespacename</replaceable></term>
  49     <listitem>
  50      <para>
  51       The name of a tablespace.
  52      </para>
  53     </listitem>
  54    </varlistentry>
  55   </variablelist>
  56  </refsect1>
  57
  58  <refsect1>
  59   <title>Examples</title>
  60
  61   <para>
  62    To remove tablespace <literal>mystuff</literal> from the system:
  63 <programlisting>
  64 DROP TABLESPACE mystuff;
  65 </programlisting>
  66   </para>
  67  </refsect1>
  68
  69  <refsect1>
  70   <title>Compatibility</title>
  71
  72   <para>
  73    <command>DROP TABLESPACE</command> is a <productname>PostgreSQL</>
  74    extension.
  75   </para>
  76  </refsect1>
  77
  78  <refsect1>
  79   <title>See Also</title>
  80
  81   <simplelist type="inline">
  82    <member><xref linkend="sql-createtablespace" endterm="sql-createtablespace-title"></member>
  83   </simplelist>
  84  </refsect1>
  85
  86 </refentry>
  87
  88 <!-- Keep this comment at the end of the file
  89 Local variables:
  90 mode: sgml
  91 sgml-omittag:nil
  92 sgml-shorttag:t
  93 sgml-minimize-attributes:nil
  94 sgml-always-quote-attributes:t
  95 sgml-indent-step:1
  96 sgml-indent-data:t
  97 sgml-parent-document:nil
  98 sgml-default-dtd-file:"../reference.ced"
  99 sgml-exposed-tags:nil
 100 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 101 sgml-local-ecat-files:nil
 102 End:
 103 -->