| `upgrade_option` | **int** | Controls how full-text indexes are migrated when upgrading a database from [!INCLUDE [ssVersion2005](../../includes/ssversion2005-md.md)] to a later version. This property applies to upgrading by attaching a database, restoring a database backup, restoring a file backup, or copying the database by using the Copy Database Wizard.<br /><br />One of:<br /><br />- `0` = Full-text catalogs are rebuilt using the new and enhanced word breakers. Rebuilding indexes can take some time, and a significant amount of CPU and memory might be required after the upgrade.<br /><br />- `1` = Full-text catalogs are reset. [!INCLUDE [ssVersion2005](../../includes/ssversion2005-md.md)] full-text catalog files are removed, but the metadata for full-text catalogs and full-text indexes is retained. After being upgraded, all full-text indexes are disabled for change tracking and crawls aren't started automatically. The catalog will remain empty until you manually issue a full population, after the upgrade completes.<br /><br />- `2` = Full-text catalogs are imported. Typically, import is faster than rebuild. For example, when using only one CPU, import runs about 10 times faster than rebuild. However, an imported full-text catalog doesn't use the new and enhanced word breakers, so you might want to rebuild your full-text catalogs instead. Removed in [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] and later versions, and raises an error.<br /><br />**Note:** Rebuild can run in multi-threaded mode, and if more than 10 CPUs are available, rebuild might run faster than import if you allow rebuild to use all of the CPUs.<br /><br />If a full-text catalog isn't available, the associated full-text indexes are rebuilt. This option is only available for [!INCLUDE [ssVersion2005](../../includes/ssversion2005-md.md)] databases.<br /><br />For information about choosing a full-text upgrade option, see full-[Upgrade Full-Text Search](../search/upgrade-full-text-search.md).<br /><br />**Note:** To set this property in [!INCLUDE [ssManStudioFull](../../includes/ssmanstudiofull-md.md)], use the **Full-Text Upgrade Option** property. For more information, see [Manage and Monitor Full-Text Search for a Server Instance](../search/manage-and-monitor-full-text-search-for-a-server-instance.md). |
0 commit comments