Language Identifier

公测版

语言识别器（language_identifier）是一种专用分词器，用于增强 Zilliz Cloud</zilliz> 的文本搜索能力，它通过自动化语言分析流程来实现。其主要功能是检测文本字段的语言，然后动态应用最适合该语言的预配置分析器。这对处理多语言的应用尤为重要，因为它免去了逐条输入手动指定语言的麻烦。

通过智能地将文本数据路由到合适的处理管道，language_identifier 简化了多语言数据的导入流程，并确保后续搜索与检索操作中的分词准确性。

工作流程

language_identifier 在处理文本字符串时会执行一系列步骤，用户理解这些步骤对于正确配置它至关重要。

1. 输入：工作流程以一个文本字符串作为输入。

2. 语言检测：该字符串首先被传递到语言检测引擎，系统尝试识别其语言。Zilliz Cloud</zilliz> 支持两个引擎：whatlang 和 lingua。

3. Analyzer 选择：

   • 成功情况：如果成功识别出语言，系统会检查该语言名称是否在 analyzers 字典中配置了对应的 Analyzer。如果找到匹配项，系统将对输入文本应用该分析器。例如，检测到 “Mandarin” 时，文本会路由到 jieba 分词器。

   • 回退情况：如果检测失败，或成功检测到语言但未配置对应分析器，系统会使用预先配置的 default Analyzer。这点非常关键：default Analyzer 既是检测失败的兜底方案，也是未匹配到 Analyzer 时的兜底方案。

在选择到合适的分析器后，文本会被分词并处理，从而完成整个工作流程。

可用的语言检测引擎

Zilliz Cloud</zilliz> 提供两种语言检测引擎可选：

• whatlang

• lingua

选择取决于应用对性能与精度的需求。

引擎	速度	精度	输出格式	适用场景
whatlang	快速	大多数语言精度良好	语言名称（如 "English", "Mandarin", "Japanese"） 参考：支持语言表中的 Language 列	对实时性要求高的应用
lingua	较慢	精度更高，尤其适用于短文本	英文语言名（如 "English", "Chinese", "Japanese"） 参考：支持语言列表	精度优先的应用场景

注意：两种引擎虽然都返回英文语言名，但部分语言的命名不同（例如，whatlang 返回 Mandarin，而 lingua 返回 Chinese）。分析器的 key 必须与所选检测引擎返回的语言名完全一致。

配置

要正确使用 language_identifier 分词器，需要完成以下配置步骤。

步骤 1：选择语言与分析器

设置 language_identifier 的核心是为计划支持的语言配置合适的分析器。系统会将检测到的语言与分析器对应匹配，因此这是保证文本处理准确性的关键。

下面是推荐的语言与 Zilliz Cloud</zilliz> 分析器映射表。该表帮助你将语言检测引擎的输出与最合适的工具建立对应关系。

语言（检测引擎输出）	推荐分析器	描述
English	type: english	标准英文分词，带词干提取与停用词过滤
Mandarin（whatlang 输出）或 Chinese（lingua 输出）	tokenizer: jieba	中文分词，适用于无空格分隔的文本
Japanese	tokenizer: icu	强大的分词器，适用于复杂文字体系，包括日语
French	type: standard, filter: ["lowercase", "asciifolding"]	自定义配置，用于处理法语重音符与特殊字符

📘说明

• 匹配是关键：分析器名称必须与检测引擎返回的语言名完全一致。例如，若使用 whatlang，则中文文本的 key 必须是 Mandarin。

• 最佳实践：上表仅列出部分常见语言的推荐配置，更多情况请参考最佳实践。

• 检测器输出：完整语言名称列表请参考：

• Whatlang 支持语言表

• Lingua 支持语言列表

步骤 2：定义 analyzer_params

在 Zilliz Cloud 中使用 language_identifier 分词器时，需要创建一个包含以下关键组件的字典：

必需组件：

• analyzers 配置集 – 包含所有分析器配置的字典，必须包括：

  • default – 兜底分析器，用于检测失败或无匹配分析器时

  • 特定语言分析器 – 定义为 <analyzer_name>: <analyzer_config>，其中：

    • analyzer_name 必须与所选检测引擎的输出完全一致（如 "English", "Japanese"）

    • analyzer_config 遵循标准分析器参数格式（见《分析器概览》）

可选组件：

• identifier – 指定使用的语言检测引擎（whatlang 或 lingua），若未指定则默认为 whatlang

• mapping – 为分析器创建自定义别名，可以用更具描述性的名称替代检测引擎的原始输出

运行逻辑：分词器会先检测输入文本的语言，再从配置中选择合适的分析器。如果检测失败或没有匹配分析器，会自动回退到默认分析器。

推荐：直接名称匹配

最佳做法是让你的分析器名称与所选语言检测引擎的输出保持完全一致。这种方式更简单，也能避免混淆。

无论使用 whatlang 还是 lingua，请严格按照官方文档中的语言名：

• whatlang 支持语言表（使用 Language 列）

• lingua 支持语言列表

analyzer_params = {
    "tokenizer": {
        "type": "language_identifier",  # Must be `language_identifier`
        "identifier": "whatlang",  # or `lingua`
        "analyzers": {  # A set of analyzer configs
            "default": {
                "tokenizer": "standard"  # fallback if language detection fails
            },
            "English": {  # Analyzer name that matches whatlang output
                "type": "english"
            },
            "Mandarin": {  # Analyzer name that matches whatlang output
                "tokenizer": "jieba"
            }
        }
    }
}

替代方法：使用映射的自定义名称

如果你更倾向于使用自定义的分析器名称，或需要与现有配置保持兼容，可以使用 mapping 参数。这样就能为分析器创建别名——既可以使用检测引擎返回的原始名称，也可以使用你自定义的名称。

analyzer_params = {
    "tokenizer": {
        "type": "language_identifier",
        "identifier": "lingua",
        "analyzers": {
            "default": {
                "tokenizer": "standard"
            },
            "english_analyzer": {  # Custom analyzer name
                "type": "english"
            },
            "chinese_analyzer": {  # Custom analyzer name
                "tokenizer": "jieba"
            }
        },
        "mapping": {
            "English": "english_analyzer",   # Maps detection output to custom name
            "Chinese": "chinese_analyzer"
        }
    }
}

定义 analyzer_params 后，您可以在定义 Collection Schema 时将其应用于 VARCHAR 字段。这使得 Zilliz Cloud 能够使用指定的分析器处理该字段中的文本，以实现高效的分词和过滤。更多信息，请参阅使用示例。

示例

以下是一些常见场景的即用型配置示例。每个示例都包含配置和验证代码，方便你立即测试设置。

中英文检测

from pymilvus import MilvusClient

# Configuration
analyzer_params = {
    "tokenizer": {
        "type": "language_identifier",
        "identifier": "whatlang",
        "analyzers": {
            "default": {"tokenizer": "standard"},
            "English": {"type": "english"},
            "Mandarin": {"tokenizer": "jieba"}
        }
    }
}

# Test the configuration
client = MilvusClient(
    uri="YOUR_CLUSTER_ENDPOINT",
    token="YOUR_CLUSTER_TOKEN"
)

# English text
result_en = client.run_analyzer("The Milvus vector database is built for scale!", analyzer_params)
print("English:", result_en)
# Output: 
# English: ['The', 'Milvus', 'vector', 'database', 'is', 'built', 'for', 'scale']

# Chinese text  
result_cn = client.run_analyzer("Milvus向量数据库专为大规模应用而设计", analyzer_params)
print("Chinese:", result_cn)
# Output: 
# Chinese: ['Milvus', '向量', '数据', '据库', '数据库', '专', '为', '大规', '规模', '大规模', '应用', '而', '设计']

欧洲语言检测

# Configuration for French, German, Spanish, etc.
analyzer_params = {
    "tokenizer": {
        "type": "language_identifier",
        "identifier": "lingua", 
        "analyzers": {
            "default": {"tokenizer": "standard"},
            "English": {"type": "english"},
            "French": {
                "tokenizer": "standard",
                "filter": ["lowercase", "asciifolding"]
            }
        }
    }
}

# Test with accented text
result_fr = client.run_analyzer("Café français très délicieux", analyzer_params)
print("French:", result_fr)
# Output: 
# French: ['cafe', 'francais', 'tres', 'delicieux']

使用须知

• 每字段单一语言：该功能以字段为单位，将其视为单一、同质化的文本块。它旨在处理不同数据记录中的不同语言，例如一条记录是英文句子，下一条记录是法文句子。

• 不支持混合语言字符串：它不适用于单个字符串中包含多种语言的情况。例如，一个 VARCHAR 字段同时包含英文句子和日文引语时，系统会将其作为单一语言来处理。

• 主导语言处理：在多语言混合场景下，检测引擎通常会识别主导语言，并