Use this statement to delete all rows from a table, without deleting the table.

Syntax

TRUNCATE TABLE table-name

Remarks

The TRUNCATE TABLE statement deletes all rows from a table and the MobiLink server is not informed of their removal upon subsequent synchronization. It is equivalent to executing the following statements:

STOP SYNCHRONIZATION DELETE;
DELETE FROM TABLE;
START SYNCHRONIZATION DELETE;

After a TRUNCATE TABLE statement, the table structure and all of the indexes continue to exist, as well as the constraints and column definitions; only data is deleted.

TRUNCATE TABLE cannot execute if a statement that affects the table is already being referenced by another request or query. Similarly, UltraLite does not process requests referencing the table while that table is being altered. Furthermore, you cannot execute TRUNCATE TABLE when the database includes active queries or uncommitted transactions.

For UltraLite.NET users: You cannot execute this statement unless you also call the Dispose method for all data objects (for example, ULDataReader). See Dispose method.

Schema changes   Statements are not released if schema changes are initiated at the same time. See Schema changes with DDL statements.

Side effects

If the table contains a column defined as DEFAULT AUTOINCREMENT or DEFAULT GLOBAL AUTOINCREMENT, TRUNCATE TABLE resets the next available value for the column.

Once rows are marked as deleted with TRUNCATE TABLE, they are no longer accessible to the user who performed this action, unless the user issues a ROLLBACK statement. However, they do remain accessible from other connections. Use COMMIT to make the deletion permanent, thereby making the data inaccessible from all connections.

If you synchronize the truncated table, all INSERT statements applied to the table take precedence over a TRUNCATE TABLE statement.

See also

• UltraLite DELETE statement
• UltraLite START SYNCHRONIZATION DELETE statement
• UltraLite STOP SYNCHRONIZATION DELETE statement

Example

The following statement deletes all rows from the Departments table.

TRUNCATE TABLE Departments;

If you execute this example, be sure to execute a ROLLBACK statement to revert your change. See UltraLite ROLLBACK statement.