通过

FULLTEXTCATALOGPROPERTY (Transact-SQL)

  • 项目

返回有关 SQL Server 2012 中的全文目录属性的信息。

主题链接图标 Transact-SQL 语法约定

语法

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')

参数

注意注意

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

  • catalog_name
    包含全文目录名称的表达式。

  • property
    包含全文目录属性名称的表达式。下表列出了这些属性，并提供对返回的信息的说明。

    属性

    说明

    AccentSensitivity

    区分重音设置。

    0 = 不区分重音

    1 = 区分重音

    IndexSize

    全文目录的逻辑大小 (MB)。包括语义关键字短语和文档相似性索引的大小。

    有关详细信息，请参阅本主题后面的“备注”。

    ItemCount

    包括目录中所有全文索引、关键字短语索引和文档相似性索引在内的索引项的数目

    LogSize

    支持它仅仅是为了保持向后兼容。总是返回 0。

    与 Microsoft Search 服务全文目录关联的错误日志组合集的大小，以字节为单位。

    MergeStatus

    是否正在进行主合并。

    0 = 未进行主合并

    1 = 正在进行主合并

    PopulateCompletionAge

    上一次全文索引填充的完成时间与 01/01/1990 00:00:00 之间的时间差（秒）。

    仅针对完全和增量爬网填充进行了更新。如果未发生填充，则返回 0。

    PopulateStatus

    0 = 空闲

    1 = 正在进行完全填充

    2 = 已暂停

    3 = 已中止

    4 = 正在恢复

    5 = 关闭

    6 = 正在进行增量填充

    7 = 正在生成索引

    8 = 磁盘已满。已暂停。

    9 = 更改跟踪

    UniqueKeyCount

    全文目录中的唯一键数。

    ImportStatus

    是否将导入全文目录。

    0 = 不将导入全文目录。

    1 = 将导入全文目录。

返回类型

int

异常

出现错误时或调用方没有查看对象的权限时，将返回 NULL。

在 SQL Server 2012 中，用户只能查看其拥有的安全对象的元数据，或者已对其授予权限的安全对象的元数据。也就是说，如果用户对该对象没有任何权限，则某些会产生元数据的内置函数（如 FULLTEXTCATALOGPROPERTY）可能返回 NULL。有关详细信息，请参阅sp_help_fulltext_catalogs (Transact-SQL)。

注释

FULLTEXTCATALOGPROPERTY ('catalog_name' ,'IndexSize') 只查看状态为 4 或为 6 的片段，如 sys.fulltext_index_fragments 中所示。这些片段是逻辑索引的一部分。因此，IndexSize 属性仅返回逻辑索引大小。但是，在索引合并期间，实际的索引大小可能会两倍于其逻辑大小。若要找出合并期间将由全文索引使用的实际大小，请使用 sp_spaceused 系统存储过程。该过程查看与全文索引关联的所有片段。如果您限制全文目录文件的增长，且没有足够的空间用于合并进程，则全文填充可能会失败。在这种情况下，FULLTEXTCATALOGPROPERTY（“catalog_name”、“IndexSize“）返回 0，并将以下错误写入全文日志：

Error: 30059, Severity: 16, State: 1. A fatal error occurred during a full-text population and caused the population to be cancelled. Population type is: FULL; database name is FTS_Test (id: 13); catalog name is t1_cat (id: 5); table name t1 (id: 2105058535). Fix the errors that are logged in the full-text crawl log. Then, resume the population. The basic Transact-SQL syntax for this is: ALTER FULLTEXT INDEX ON table_name RESUME POPULATION.

不应使应用程序在死循环中等待，它会不断检查 PopulateStatus 属性是否变为空闲（表明填充已完成）。这一点很重要，因为这会使数据库和全文搜索进程得不到 CPU 周期，从而导致超时。此外，一般最好使用 OBJECTPROPERTYEX 系统函数检查对应的表级 PopulateStatus 属性，即 TableFullTextPopulateStatus。此属性以及 OBJECTPROPERTYEX 中的其他新的全文属性可以提供有关全文索引表的更详尽的信息。有关详细信息，请参阅OBJECTPROPERTYEX (Transact-SQL)。

示例

以下示例将返回名为 Cat_Desc 的全文目录中的全文索引项数目。

USE AdventureWorks2012;
GO
SELECT fulltextcatalogproperty('Cat_Desc', 'ItemCount');
GO

请参阅

参考

FULLTEXTSERVICEPROPERTY (Transact-SQL)

元数据函数 (Transact-SQL)

sp_help_fulltext_catalogs (Transact-SQL)