TRUNCATE TEXT INDEX Statement

Quick Links:

Syntax

TRUNCATE TEXT INDEX <text-index-name> 
    ON [ <owner.]table-name>

Parameters

(back to top)

ON the name of the table on which the text index is built.

Examples

(back to top)

Example 1
the first statement creates the txt_index_manual text index. The second statement populates the text index with data. The third statement truncates the text index data.
```
CREATE TEXT INDEX txt_index_manual ON GROUPO.MarketingInformation ( Description ) 
    MANUAL REFRESH; 
REFRESH TEXT INDEX txt_index_manual ON GROUPO.MarketingInformation; 
TRUNCATE TEXT INDEX txt_index_manual ON GROUPO.MarketingInformation;
```
The truncated text index is repopulated with data the next time it is refreshed.

Usage

(back to top)

Use the TRUNCATE TEXT INDEX statement when you want to delete data from a manual text index without dropping the text index definition. For example, to alter the text configuration object for the text index to change the stoplist, truncate the text index, change the text configuration object it refers to, and then refresh the text index to populate it with new data.

You cannot perform a TRUNCATE TEXT INDEX statement on a text index defined as IMMEDIATE REFRESH (the default). For IMMEDIATE REFRESH text indexes, you must drop the index instead.

The TRUNCATE TEXT INDEX requires exclusive access to the table. Any open cursors that reference the table being truncated must be closed, and a COMMIT or ROLLBACK statement must be executed to release the reference to the table.

Standards

(back to top)

ANSI SQL–Compliance level: Transact-SQL extension.

Permissions

(back to top)

Requires one of:

ALTER ANY INDEX system privilege.
ALTER ANY OBJECT system privilege.
REFERENCES privilege on the table.
You own the table.