Skip to content

Commit 2a84a68

Browse files
VinnieKhannarwestMSFT
authored andcommitted
document db scoped config
Added documentation for FULLTEXT_INDEX_VERSION configuration option, including its effects and available versions. add 'index_version' column to sys.fulltext_indexes Added 'index_version' column with details about its application and behavior in full-text indexes. Fix alter db config link Updated the reference link for ALTER DATABASE SCOPED CONFIGURATION in the index_version description.
1 parent 0dc2b18 commit 2a84a68

2 files changed

Lines changed: 22 additions & 1 deletion

File tree

docs/relational-databases/system-catalog-views/sys-fulltext-indexes-transact-sql.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ monikerRange: "=azuresqldb-current||>=sql-server-2016||>=sql-server-linux-2017||
2929
|-----------------|---------------|-----------------|
3030
|**object_id**|**int**|ID of the object to which this full-text index belongs.|
3131
|**unique_index_id**|**int**|ID of the corresponding unique, non-full-text index that is used to relate the full-text index to the rows.|
32+
|**index_version**|**int**|**Applies to:** [!INCLUDE [sql-server-2025](../../includes/sssql25-md.md)] and later. <br/><br/> Version of full-text filter and wordbreaker components that are used to populate and query this index. This is controlled by the `FULLTEXT_INDEX_VERSION` database scoped configuration. See [ALTER DATABASE SCOPED CONFIGURATION](../../t-sql/statements/alter-database-scoped-configuration-transact-sql.md#fulltext_index_version) for details. <br/><br/> In the case of an in-place upgrade from [!INCLUDE [sql-server-2022](../../includes/sssql22-md.md)] or prior to [!INCLUDE [sql-server-2025](../../includes/sssql25-md.md)]) or later, existing indexes are assigned `index_version` = `1`. |
3233
|**fulltext_catalog_id**|**int**|ID of the full-text catalog in which the full-text index resides.|
3334
|**is_enabled**|**bit**|1 = Full-text index is currently enabled.|
3435
|**change_tracking_state**|**char(1)**|State of change-tracking.<br /><br /> M = Manual<br /><br /> A = Auto<br /><br /> O = Off|
@@ -71,4 +72,3 @@ GO
7172
[CREATE FULLTEXT INDEX &#40;Transact-SQL&#41;](../../t-sql/statements/create-fulltext-index-transact-sql.md)
7273
[ALTER FULLTEXT INDEX &#40;Transact-SQL&#41;](../../t-sql/statements/alter-fulltext-index-transact-sql.md)
7374

74-

docs/t-sql/statements/alter-database-scoped-configuration-transact-sql.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,7 @@ The following settings are supported in [!INCLUDE [ssazure-sqldb](../../includes
5757
- Specify the number of minutes a paused resumable index operation is paused before it is automatically aborted by the [!INCLUDE [ssDE-md](../../includes/ssde-md.md)].
5858
- Enable or disable waiting for locks at low priority for asynchronous statistics update.
5959
- Enable or disable uploading ledger digests to Azure Blob Storage.
60+
- Set the default [full-text index](../../relational-databases/search/full-text-search.md) version (1, 2).
6061

6162
This setting is only available in [!INCLUDE [ssazuresynapse-md](../../includes/ssazuresynapse-md.md)].
6263

@@ -116,6 +117,7 @@ ALTER DATABASE SCOPED CONFIGURATION
116117
| OPTIONAL_PARAMETER_PLAN_OPTIMIZATION = { ON | OFF }
117118
| ALLOW_STALE_VECTOR_INDEX = { ON | OFF }
118119
| PREVIEW_FEATURES = { ON | OFF }
120+
| FULLTEXT_INDEX_VERSION = <version>
119121
}
120122
```
121123

@@ -547,6 +549,25 @@ The vector index isn't updated when new data is inserted or updated in the table
547549
> [!NOTE]
548550
> The `ALLOW_STALE_VECTOR_INDEX` database scoped configuration option isn't currently available in [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)].
549551
552+
#### FULLTEXT_INDEX_VERSION
553+
554+
**Applies to:** [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] (Starting with [!INCLUDE [sql-server-2025](../../includes/sssql25-md.md)]), [!INCLUDE [ssazure-sqldb](../../includes/ssazure-sqldb.md)], and [!INCLUDE [ssazuremi](../../includes/ssazuremi-md.md)]
555+
556+
Sets the full-text index version to use when creating or rebuilding indexes. This configuration only takes effect when issuing either a `CREATE FULLTEXT INDEX` statement for new indexes or an `ALTER FULLTEXT CATALOG ... REBUILD` statement to rebuild all indexes in a catalog.
557+
558+
As of [!INCLUDE [sql-server-2025](../../includes/sssql25-md.md)], the available versions are:
559+
560+
| Version | Comments |
561+
|---------|----------|
562+
|`1`| All new and rebuilt indexes as described above will use the legacy full-text filter and wordbreaker components included in [!INCLUDE [sql-server-2022](../../includes/sssql22-md.md)] and prior for future populations and queries. As these components are no longer included from [!INCLUDE [sql-server-2025](../../includes/sssql25-md.md)] onward, they must be manually copied from an older instance. |
563+
|`2`| Default. New and rebuilt indexes will use the new full-text filter and wordbreaker components included in [!INCLUDE [sql-server-2025](../../includes/sssql25-md.md)] for future populations and queries. |
564+
565+
The `FULLTEXT_INDEX_VERSION` configuration also controls which full-text components are reported and/or used by the following system stored procedures, views, and functions:
566+
- [sp_help_fulltext_system_components ](../../relational-databases/system-stored-procedures/sp-help-fulltext-system-components-transact-sql.md)
567+
- [sys.fulltext_languages](../../relational-databases/system-catalog-views/sys-fulltext-languages-transact-sql.md)
568+
- [sys.fulltext_document_types](../../relational-databases/system-catalog-views/sys-fulltext-document-types-transact-sql.md)
569+
- [sys.dm_fts_parser](../../relational-databases/system-dynamic-management-views/sys-dm-fts-parser-transact-sql.md)
570+
550571
<a id="preview-features"></a>
551572

552573
#### PREVIEW_FEATURES = { ON | OFF }

0 commit comments

Comments
 (0)