Revert word breakers used by Search to previous version (SQL Server Search)

Applies to: SQL Server Azure SQL Database

SQL Server installs and enables a version of the word breakers and stemmers for all languages supported by Full-Text Search with the exception of Korean. This article describes how to switch from this version of these components to the previous version, or to switch back from the previous version to the new version.

This article does not discuss the following languages:

• English. To revert or restore the English components, see Change the Word Breaker Used for US English and UK English.

• Danish, Polish, and Turkish. The third-party word breakers for Danish, Polish, and Turkish that were included with previous releases of SQL Server have been replaced with Microsoft components.

• Czech and Greek. There are new word breakers for Czech and Greek. Previous releases of SQL Server Full-Text Search did not include support for these two languages.

• Korean. The word breaker and stemmer for the Korean language are not upgraded in this release.

For general information about word breakers and stemmers, see Configure and Manage Word Breakers and Stemmers for Search.

Overview of reverting and restoring word breakers and stemmers

The instructions for reverting and restoring word breakers and stemmers depend on the language. The following table summarizes the three sets of actions that may be required to revert to the previous version of the components.

The files described in this article are DLL files that are installed in the MSSQL\Binn folder for the SQL Server instance. The full path is typically the following path:

C:\Program Files\Microsoft SQL Server\<instance>\MSSQL\Binn

Languages for which the file name of both the current and previous word breaker is NaturalLanguage6.dll

For the languages in the following table, the file name of both the current and previous word breaker is NaturalLanguage6.dll. To revert or restore these components, you have to overwrite NaturalLanguage6.dll with a different version of the same file. You do not have to change any registry entries, because the registry entries have not changed for this release.

List of affected languages

The preceding table is sorted alphabetically on the Abbreviation column.

To revert to the previous components

1. Navigate to the Binn folder described above.

2. Back up the SQL Server version of NaturalLanguage6.dll to another location.

3. Copy the previous version of NaturalLanguage6.dll from the Binn folder of an instance of SQL Server 2008 R2 (10.50.x) or SQL Server 2008 (10.0.x) into the Binn folder of the SQL Server instance.

   Warning

   This change affects all the languages that use NaturalLanguage6.dll in both the current and previous version.

4. Restart SQL Server.

To restore the current components

1. Navigate to the location where you backed up the SQL Server version of NaturalLanguage6.dll.

2. Copy the current version of NaturalLanguage6.dll from the backup location into the Binn folder of the SQL Server instance.

   Warning

   This change affects all the languages that use NaturalLanguage6.dll in both the current and previous version.

3. Restart SQL Server.

Languages for which the file name of the previous word breaker only is NaturalLanguage6.dll

For the languages in the following table, the file name of the previous word breaker is different from the file name of the new version. The previous file name is NaturalLanguage6.dll. To revert to the previous version, you have to overwrite the current version of NaturalLanguage6.dll with an earlier version of the same file. You also have to change a set of registry entries to specify the previous or current version of the components.

List of affected languages

The preceding table is sorted alphabetically on the Abbreviation column.

Use the following instructions together with the list of values in the section File names and registry values for reverting and restoring word breakers and stemmers.

To revert to the previous components

1. Navigate to the Binn folder described above.

2. Do not remove the files for the current version of the components from the Binn folder.

3. Back up the SQL Server version of NaturalLanguage6.dll to another location.

4. Copy the previous version of NaturalLanguage6.dll from the Binn folder of an instance of SQL Server 2008 R2 (10.50.x) or SQL Server 2008 (10.0.x) into the Binn folder of the new SQL Server instance.

   Warning

   This change affects all the languages that use NaturalLanguage6.dll in both the current and previous version.

5. In the registry, navigate to the following node: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server<InstanceRoot>\MSSearch\CLSID.

6. Use the following steps to add new keys for the COM ClassIDs for the previous word breaker and stemmer interfaces for the selected language:

   1. Add a new key with the value from the table for the previous word breaker.

   2. Update the (Default) data of that key value to the file name of the previous word breaker from the table.

   3. If the selected language uses a stemmer, then add a new key with the value from the table for the previous stemmer.

   4. If the selected language uses a stemmer, then update the (Default) data of that key value to the file name of the previous stemmer from the table.

7. In the registry, navigate to the following node: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server<InstanceRoot>\MSSearch\Language<language_key>. <language_key> represents the abbreviation for the language that is used in the registry; for example, "fra" for French and "esn" for Spanish.

8. Update the WBreakerClass key value to the value from the table for the current word breaker.

9. If the selected language uses a stemmer, then update the StemmerClass key value to the value from the table for the current stemmer.

10. Restart SQL Server.

To restore the current components

1. Navigate to the location where you backed up the SQL Server version of NaturalLanguage6.dll.

2. Copy the current version of NaturalLanguage6.dll from the backup location into the Binn folder of the SQL Server instance.

   Warning

   This change affects all the languages that use NaturalLanguage6.dll in both the current and previous version.

3. In the registry, navigate to the following node: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server<InstanceRoot>\MSSearch\CLSID.

4. If the following keys do not exist, then use the following steps to add new keys for the COM ClassIDs for the current word breaker and stemmer interfaces for the selected language:

   1. Add a new key with the value from the table for the current word breaker.

   2. Update the (Default) data of that key value to the file name of the current word breaker from the table.

   3. If the selected language uses a stemmer, then add a new key with the value from the table for the current stemmer.

   4. If the selected language uses a stemmer, then update the (Default) data of that key value to the file name of the current stemmer from the table.

5. In the registry, navigate to the following node: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server<InstanceRoot>\MSSearch\Language<language_key>. <language_key> represents the abbreviation for the language that is used in the registry; for example, "fra" for French and "esn" for Spanish.

6. Update the WBreakerClass key value to the value from the table for the previous word breaker.

7. If the selected language uses a stemmer, then update the StemmerClass key value to the value from the table for the previous stemmer.

8. Restart SQL Server.

File names and registry values for reverting and restoring word breakers and stemmers

Use the following list of file names and registry entries together with the instructions in the preceding section. Use the previous values to revert to the previous version, or use the current values to restore the current version of the components.

The following listed is sorted alphabetically on the abbreviation used for each language.

Arabic (ara), LCID 1025

German (deu), LCID 1031

Japanese (jpn), LCID 1041

Dutch (nld), LCID 1043

Russian (rus), LCID 1049

Languages for which neither the previous nor the current file name is NaturalLanguage6.dll

For the languages in the following table, the file names of the previous word breakers and stemmers are different from the file names of the new versions. Neither the previous nor the current file name is NaturalLanguage6.dll. You do not have to replace any files, because SQL Server setup copies both the current and the previous versions of the components to the Binn folder. However you have to change a set of registry entries to specify the previous or current version of the components.

List of affected languages

The preceding table is sorted alphabetically on the Abbreviation column.

Use the following instructions together with the list of values in the section File names and registry values for reverting and restoring word breakers and stemmers.

To revert to the previous components

1. Do not remove the files for the current version of the components from the Binn folder.

2. In the registry, navigate to the following node: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server<InstanceRoot>\MSSearch\CLSID.

3. Use the following steps to add new keys for the COM ClassIDs for the previous word breaker and stemmer interfaces for the selected language:

   1. Add a new key with the value from the table for the previous word breaker.

   2. Update the (Default) data of that key value to the file name of the previous word breaker from the table.

   3. If the selected language uses a stemmer, then add a new key with the value from the table for the previous stemmer.

   4. If the selected language uses a stemmer, then update the (Default) data of that key value to the file name of the previous stemmer from the table.

4. In the registry, navigate to the following node: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server<InstanceRoot>\MSSearch\Language<language_key>. <language_key> represents the abbreviation for the language that is used in the registry; for example, "fra" for French and "esn" for Spanish.

5. Update the WBreakerClass key value to the value from the table for the current word breaker.

6. If the selected language uses a stemmer, then update the StemmerClass key value to the value from the table for the current stemmer.

7. Restart SQL Server.

To restore the previous components

1. Do not remove the files for the previous version of the components from the Binn folder.

2. In the registry, navigate to the following node: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server<InstanceRoot>\MSSearch\CLSID.

3. If the following keys do not exist, then use the following steps to add new keys for the COM ClassIDs for the current word breaker and stemmer interfaces for the selected language:

   1. Add a new key with the value from the table for the current word breaker.

   2. Update the (Default) data of that key value to the file name of the current word breaker from the table.

   3. If the selected language uses a stemmer, then add a new key with the value from the table for the current stemmer.

   4. If the selected language uses a stemmer, then update the (Default) data of that key value to the file name of the current stemmer from the table.

4. In the registry, navigate to the following node: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server<InstanceRoot>\MSSearch\Language<language_key>. <language_key> represents the abbreviation for the language that is used in the registry; for example, "fra" for French and "esn" for Spanish.

5. Update the WBreakerClass key value to the value from the table for the previous word breaker.

6. If the selected language uses a stemmer, then update the StemmerClass key value to the value from the table for the previous stemmer.

7. Restart SQL Server.

File names and registry values for reverting and restoring word breakers and stemmers

Use the following list of file names and registry entries together with the instructions in the preceding section. Use the previous values to revert to the previous version, or use the current values to restore the current version of the components.

The following listed is sorted alphabetically on the abbreviation used for each language.

Simplified Chinese (chs), LCID 2052

Traditional Chinese (cht), LCID 1028

Thai (tha), LCID 1054

Chinese Traditional (zh-hk), LCID 3076

Chinese Traditional (zh-mo), LCID 5124

Chinese Simplified (zh-sg), LCID 4100

See Also

Change the Word Breaker Used for US English and UK English
Behavior Changes to Full-Text Search