View or change registered filters and word breakers

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance

After any word breakers or filters are installed or uninstalled on a system, the changes don't automatically take effect on server instances. This article describes how to view the currently registered word breaker or filters and how to register newly installed word breakers and filters on an instance of SQL Server.

Note

Azure SQL Managed Instance supports viewing registered filters and word breakers, but changing them is not supported. Only preinstalled ones can be used. Third party filters and word breakers are not supported on managed instance.

View a list of languages whose word breakers are currently registered

  1. Use the sys.fulltext_languages catalog view, as follows:

    SELECT * FROM sys.fulltext_languages;
    

View a list of the filters that are currently registered

  1. Use the sp_help_fulltext_system_components system stored procedure, as follows:

    EXEC sp_help_fulltext_system_components 'filter';
    

Register newly installed word breakers and filters

  1. Use the sp_fulltext_service system stored procedure to update the list of languages, as follows:

    EXEC sp_fulltext_service 'update_languages';
    

Unregister uninstalled word breakers and filters

  1. Use the sp_fulltext_service to update the list of languages, as follows:

    EXEC sp_fulltext_service 'update_languages';
    
  2. Use the sp_fulltext_service to restart the filter daemon host processes (fdhost.exe), as follows:

    EXEC sp_fulltext_service 'restart_all_fdhosts';
    

Replace existing word breakers or filters when installing new ones

  1. When preparing to install a DLL file that contains new word breakers or filters, verify that it has a different filename from any of the existing DLL files installed on your server instance.

  2. Copy the new DLL file into the directory containing the standard SQL Server DLL files for the server instance. The default location is:

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

    Important

    We highly recommend that you load only signed and verified components. Also, we recommend that you run the FDHOST Launcher (MSSQLFDLauncher) Service with the least possible privileges.

  3. Install the new word breaker or filters.

    To install and load Microsoft Filter Pack IFilters

  4. Use sp_fulltext_service to load newly installed word breakers and filters in the server instance, as follows:

    EXEC sp_fulltext_service @action='load_os_resources', @value=1;
    
  5. Use sp_fulltext_service to update the list of languages, as follows:

    EXEC sp_fulltext_service 'update_languages';
    
  6. Restart the filter daemon host processes (fdhost.exe), using sp_fulltext_service as follows:

    EXEC sp_fulltext_service 'restart_all_fdhosts';