Share via

REMOVE TABLE Command

  • Article

Removes a table from the current database.

REMOVE TABLE TableName | ?   [DELETE] [RECYCLE]

Parameters

  • TableName
    Specifies the table to remove from the current database.

  • ?
    Displays the Remove dialog box from which you can choose a table in the current database to remove.

  • DELETE
    Specifies that the table is removed from the database and from disk.

    **Caution   **Any table deleted from disk with this clause cannot be retrieved. Even if SET SAFETY is ON, you are not warned before the table is deleted from disk.

  • RECYCLE
    Specifies that the table isn't immediately deleted from disk and is placed in the Windows Recycle Bin.

Remarks

When a table is removed from the database, it becomes a free table and can be added to another database. Tables are added to a database with ADD TABLE.

When REMOVE TABLE is issued, all primary indexes, default values, and validation rules associated with the table are also removed. If SET SAFETY is ON, Visual FoxPro displays a prompt asking if you are sure you want to remove the table from the database.

Caution   REMOVE TABLE affects other tables in the current database if those tables have rules or relations associated with the table being removed. The rules and relations are no longer valid when the table is removed from the database.

Example

The following example creates two databases named mydbc1 and mydbc2, and a table named table1. The table is added to mydbc1 when it is created. The table is then closed and removed from mydbc1. ADD TABLE is then used to add the table to mydbc2. RENAME TABLE is used to change the name of the table from table1 to table2.

CREATE DATABASE mydbc1
CREATE DATABASE mydbc2
SET DATABASE TO mydbc1
CREATE TABLE table1 (cField1 C(10), n N(10))  && Adds table to mydbc1
CLOSE TABLES     && A table must be closed to remove it from a database
REMOVE TABLE table1
SET DATABASE TO mydbc2
ADD TABLE table1
RENAME TABLE table1 TO table2

See Also

ADD TABLE | CLOSE DATABASES | CREATE DATABASE | DROP TABLE | FREE TABLE | OPEN DATABASE