我如何知道 SQL 全文索引填充何时完成？

Question

我们正在为针对测试 SQL Server 数据库运行的 ASP.NET 应用程序编写单元测试。 也就是说，ClassInitialize 方法创建一个包含测试数据的新数据库，ClassCleanup 删除该数据库。我们通过从代码运行 .bat 脚本来做到这一点。

被测试的类被赋予一个连接到单元测试数据库而不是生产数据库的连接字符串。

我们的问题是，数据库包含全文索引，需要用测试数据完全填充该索引，以便我们的测试按预期运行。

据我所知，全文索引始终在后台填充。我希望能够：

1. 使用同步（transact-SQL？）语句创建完全填充的全文索引，或者
2. 了解全文填充何时完成，是否有回调选项，或者我可以重复询问？

我当前的解决方案是在类初始化方法结束时强制延迟 - 5 秒似乎有效 - 因为我在文档中找不到任何内容。

Answer 1

这是我们根据 GarethOwen 的答案创建的存储过程。它接受逗号分隔的表列表作为参数，并等待所有表的全文索引更新。它每隔十分之一秒进行一次检查，以防止磁盘崩溃，并在 10 秒后超时，以防万一运行缓慢/损坏。如果您的 FT 搜索跨多个索引，则非常有用。

通过以下方式调用：

EXECUTE [dbo].[WaitForFullTextIndexing] 'MY_TABLE,ALTERNATE_NAMES,TAG_GROUP_VALUES,TAG_GROUPS,FIELD_OPTION';

来源：

CREATE PROCEDURE WaitForFullTextIndexing
    @TablesStr varchar(max)
AS
BEGIN
    DECLARE @Tables AS TABLE( [word] [varchar](8000) NULL)

    INSERT INTO @Tables (word) SELECT items from dbo.Split(@TablesStr, ',');

    DECLARE @NumberOfTables int;
    SELECT @NumberOfTables = COUNT(*) from @Tables;

    DECLARE @readyCount int;
    SET @readyCount = 0;

    DECLARE @waitLoops int;
    SET @waitLoops = 0;

    DECLARE @result bit;

    WHILE @readyCount <> @NumberOfTables AND @waitLoops < 100
    BEGIN

        select @readyCount = COUNT(*)
        from @Tables tabs
        where OBJECTPROPERTY(object_id(tabs.word), 'TableFulltextPopulateStatus') = 0;

        IF @readyCount <> @NumberOfTables
        BEGIN
            -- prevent thrashing
            WAITFOR DELAY '00:00:00.1';
        END

        set @waitLoops = @waitLoops + 1;

    END

END
GO

dbo.split 是一个现在每个人都必须拥有的表值函数，它将分隔符上的字符串拆分为临时表：

CREATE FUNCTION [dbo].[Split](@String varchar(8000), @Delimiter char(1))        
returns @temptable TABLE (items varchar(8000))        
as        
begin        
    declare @idx int        
    declare @slice varchar(8000)        

    select @idx = 1        
        if len(@String)<1 or @String is null  return        

    while @idx!= 0        
    begin        
        set @idx = charindex(@Delimiter,@String)        
        if @idx!=0        
            set @slice = left(@String,@idx - 1)        
        else        
            set @slice = @String        

        if(len(@slice)>0)   
            insert into @temptable(Items) values(@slice)        

        set @String = right(@String,len(@String) - @idx)        
        if len(@String) = 0 break        
    end    
return        
end 

GO

Answer 2

谢谢丹尼尔，你的回答让我走上了正轨。

我实际上使用以下T-SQL语句来询问全文索引的填充状态是否为Idle：

SELECT OBJECTPROPERTY(object_id('v_doc_desc_de'), 'TableFulltextPopulateStatus')

'v_doc_desc_de'是我们索引的数据库视图的名称。

如果人口状态不是空闲，我会等待几秒钟并再次询问，直到它变为空闲。在检查之间等待一小段时间非常重要，以确保连续检查填充状态不会减慢全文填充速度。

MSDN 文档指出建议使用 OBJECTPROPERTYEX 函数（在表级别），而不是具有属性“PopulateStatus”的 FULLTEXTCATALOGPROPERTY 语句。它规定如下：

以下属性将在 SQL Server 的未来版本中删除：LogSize 和 PopulateStatus。避免在新的开发工作中使用这些属性，并计划修改当前使用其中任何属性的应用程序。

Answer 3

要等待全文目录完成所有表和视图的填充，而不必指定其名称，可以使用以下存储过程。这是 JohnB 对这个问题的回答和 cezarm 对 相关问题的回答的组合< /a>:

CREATE PROCEDURE WaitForFullTextIndexing
@CatalogName VARCHAR(MAX)
AS
BEGIN
    DECLARE @status int;
    SET @status = 1;
    DECLARE @waitLoops int;
    SET @waitLoops = 0;

    WHILE @status > 0 AND @waitLoops < 100
    BEGIN       
        SELECT @status = FULLTEXTCATALOGPROPERTY(@CatalogName,'PopulateStatus')
        FROM sys.fulltext_catalogs AS cat;

        IF @status > 0
        BEGIN
            -- prevent thrashing
            WAITFOR DELAY '00:00:00.1';
        END
        SET @waitLoops = @waitLoops + 1;
    END
END

Answer 4

我做了以下事情：

        var indexIsPopulating = true;
        var stopWatch = new Stopwatch();
        stopWatch.Start();
        while (indexIsPopulating)
        {
            System.Threading.Thread.Sleep(500);
            using var con = new SqlConnection(databaseConnectionString);
            // using dapper here - but you just need to run query on databsae
            var status = await con.QueryFirstAsync<int>("SELECT OBJECTPROPERTY(OBJECT_ID('dbo.MyTableName'), 'TableFulltextPopulateStatus'); ");
            if (status == 0)
            {
                indexIsPopulating = false;
            }
            else if (stopWatch.ElapsedMilliseconds > 60000) // 1 minute
            {
                stopWatch.Stop();
                throw new Exception("Full Text Index failed to populate within 1 minute.");
            }
        }
        stopWatch.Stop();

Answer 5

我在使用带有全文搜索的 dockerized sql 服务器时遇到了同样的问题。数据库已成功播种，但当我运行测试时，索引填充状态尚未完成，因此在我的测试中没有返回结果。

为了确保在运行测试之前重建索引，我使用了一个带有查询的自旋锁，该查询标识我的任何表是否有正在重建的索引：

public MyApplication SeedDatabase( Action<MyDbContext> seed )
{
    using var scope = Services.CreateScope();
    var scopedServices = scope.ServiceProvider;
    var db = scopedServices.GetRequiredService<MyDbContext>();

    db.Database.EnsureDeleted();
    db.Database.EnsureCreated();

    CreateFullTextCatalog();
    CreateFullTextIndexes();

    seed.Invoke( db );
    db.SaveChanges();

    SpinWait.SpinUntil( () => IsFullTextPopulateStatusIdle(), TimeSpan.FromSeconds( 5 ) );

    return this;

    bool IsFullTextPopulateStatusIdle() => db.Database.SqlQuery<int>( $"select case when EXISTS(SELECT OBJECTPROPERTY(object_id, 'TableFulltextPopulateStatus') from sys.tables where OBJECTPROPERTY(object_id, 'TableFulltextPopulateStatus') <> 0) then 1  else 0  end as value" ).Single() == 0;

    void CreateFullTextCatalog() => db.Database.ExecuteSqlRaw( File.ReadAllText( Path.Combine( Directory.GetCurrentDirectory(), "Sql", "FT_Catalog.sql" ) ) );

    void CreateFullTextIndexes() => db.Database.ExecuteSqlRaw( File.ReadAllText( Path.Combine( Directory.GetCurrentDirectory(), "Sql", "FullTextIndexes.sql" ) ) );
}

Answer 6

我想提供 @Daniel Renshaw 的答案的更易于阅读的版本：

DECLARE @CatalogName VARCHAR(MAX)
SET     @CatalogName = 'FTS_Demo_Catalog'

SELECT
    DATEADD(ss, FULLTEXTCATALOGPROPERTY(@CatalogName,'PopulateCompletionAge'), '1/1/1990') AS LastPopulated
    ,(SELECT CASE FULLTEXTCATALOGPROPERTY(@CatalogName,'PopulateStatus')
        WHEN 0 THEN 'Idle'
        WHEN 1 THEN 'Full Population In Progress'
        WHEN 2 THEN 'Paused'
        WHEN 3 THEN 'Throttled'
        WHEN 4 THEN 'Recovering'
        WHEN 5 THEN 'Shutdown'
        WHEN 6 THEN 'Incremental Population In Progress'
        WHEN 7 THEN 'Building Index'
        WHEN 8 THEN 'Disk Full.  Paused'
        WHEN 9 THEN 'Change Tracking' END) AS PopulateStatus

结果：

LastPopulated           PopulateStatus
----------------------- ----------------------------------
2012-05-08 14:51:37.000 Idle

(1 row(s) affected)

Answer 7

您可以使用 FULLTEXTCATALOGPROPERTY 查询状态（请参阅此处：http://technet.microsoft. com/en-us/library/ms190370.aspx）。

例如：

SELECT
    FULLTEXTCATALOGPROPERTY(cat.name,'ItemCount') AS [ItemCount],
    FULLTEXTCATALOGPROPERTY(cat.name,'MergeStatus') AS [MergeStatus],
    FULLTEXTCATALOGPROPERTY(cat.name,'PopulateCompletionAge') AS [PopulateCompletionAge],
    FULLTEXTCATALOGPROPERTY(cat.name,'PopulateStatus') AS [PopulateStatus],
    FULLTEXTCATALOGPROPERTY(cat.name,'ImportStatus') AS [ImportStatus]
FROM sys.fulltext_catalogs AS cat

您可能还想使用 SQL Profiler 来监视在打开目录属性对话框时 SQL Server Management Studio 发出的命令。该对话框包括人口状态指示，并且显示的所有信息均使用 T-SQL 查询。