カスタムアナライザ

Overview

MongoDB Searchアナライザは、文字のシーケンスを変換、フィルタリング、グループ化するための一連の操作を実行して、インデックスを作成するドキュメントのセットを準備します。Atlas UIから、特定のインデックスニーズに合わせてカスタムアナライザを定義できます。

カスタムMongoDB Searchアナライザは、トークナイザ、文字フィルターの任意のリスト、トークンフィルターの任意のリストで構成されています。MongoDB Search がカスタムアナライザでテキストを分析する場合、テキストは最初に文字フィルター、次にトークナイザ、次にトークンフィルターを通過します。

構文

カスタムアナライザの構文は次のとおりです。

構文

"analyzers": [
  {
    "name": "<name>",
    "charFilters": [ <list-of-character-filters> ],
    "tokenizer": {
      "type": "<tokenizer-type>"
    },
    "tokenFilters": [ <list-of-token-filters> ]
  }
]

属性

カスタムアナライザには、次の属性があります。

属性	タイプ	説明	必須
`name`	string	カスタムアナライザの名前。名前はインデックス内で一意である必要があり、次のいずれかの文字列で始まらない必要があります。 `lucene.` `builtin.` `mongodb.`	はい
`charFilters`	オブジェクトのリスト	0個以上の文字フィルターを含む配列。文字フィルターは、テキストを 1 文字ずつ調べてフィルタリング処理を行います。詳細については、「文字フィルター」を参照してください。	no
`tokenizer`	オブジェクト	トークンを作成するために使用するトークナイザ。アナライザは、インデックスを作成する目的で、トークナイザを使用してテキストのかたまりをグループまたはトークンに分裂します。詳細については、「トークナイザ」を参照してください。	はい
`tokenFilters`	オブジェクトのリスト	0 個以上のトークンフィルターを含む配列。トークンフィルターは、以下のような処理を実行します。ステミング。これにより、「toring」、「thaled」、「torages」などの関連単語を語幹単語の「torage」に減らします。リダクションは、公開ドキュメントから機密情報を排除します。詳細については、「トークンフィルター」を参照してください。	no

組み込みカスタムアナライザテンプレート

Atlas UI Visual Editor には、カスタムアナライザの構築を始める際に、よく使用される次のテンプレートから選択するオプションも用意されています。

メールパーサー - uaxUrlEmail トークナイザで最大 200 文字のメールアドレスをトークン化するために使用します。たとえば、このアナライザはサンプルコレクションの page_updated_by.email フィールドに適用できます。
電話番号 - regexCaptureGroup トークナイザで米国形式の電話番号から単一トークンを作成するために使用します。たとえば、サンプルコレクションの page_updated_by.phone フィールドにこのアナライザを適用できます。
ハイフン区切りの ID - regexSplitトークナイザを使用して、ハイフンで区切られたテキストからトークンを作成する際に使用します。たとえば、コレクション例の message フィールドにこのアナライザを適用できます。

これらの組み込みカスタムアナライザを使用するか、 MongoDB Search Visual Editor または JSONエディターを使用して独自のカスタムアナライザを作成できます。

コレクションの例

文字フィルター、トークナイザ、トークンフィルターのページには、文字フィルター、トークナイザ、トークンフィルターのサンプルインデックス定義とクエリ例が含まれています。これらの例では、次のドキュメントを含むサンプルminutesコレクションを使用します。

{
  "_id": 1,
  "page_updated_by": {
    "last_name": "AUERBACH",
    "first_name": "Siân",
    "email": "auerbach@example.com",
    "phone": "(123)-456-7890"
  },
  "title": "The team's weekly meeting",
  "message": "try to siGn-In",
  "text": {
    "en_US": "<head> This page deals with department meetings.</head>",
    "sv_FI": "Den här sidan behandlar avdelningsmöten",
    "fr_CA": "Cette page traite des réunions de département"
  }
}

{
  "_id": 2,
  "page_updated_by": {
    "last_name": "OHRBACH",
    "first_name": "Noël",
    "email": "ohrbach@example.com",
    "phone": "(123) 456 0987"
  },
  "title": "The check-in with sales team",
  "message": "do not forget to SIGN-IN. See ① for details.",
  "text" : {
    "en_US": "The head of the sales department spoke first.",
    "fa_IR": "ابتدا رئیس بخش فروش صحبت کرد",
    "sv_FI": "Först talade chefen för försäljningsavdelningen"
  }
}

{
  "_id": 3,
  "page_updated_by": {
    "last_name": "LEWINSKY",
    "first_name": "Brièle",
    "email": "lewinsky@example.com",
    "phone": "(123).456.9870"
  },
  "title": "The regular board meeting",
  "message": "try to sign-in",
  "text" : {
    "en_US": "<body>We'll head out to the conference room by noon.</body>"
  }
}

{
  "_id": 4,
  "page_updated_by": {
    "last_name": "LEVINSKI",
    "first_name": "François",
    "email": "levinski@example.com",
    "phone": "123-456-8907"
  },
  "title": "The daily huddle on tHe StandUpApp2",
  "message": "write down your signature or phone №",
  "text" : {
    "en_US": "<body>This page has been updated with the items on the agenda.</body>" ,
    "es_MX": "La página ha sido actualizada con los puntos de la agenda.",
    "pl_PL": "Strona została zaktualizowana o punkty porządku obrad."
  }
}

詳細

独自のカスタムアナライザの作成についての詳細は、以下の参照ページをご覧ください。

注意

Atlas UI でVisual Editorを使用してカスタムアナライザを追加すると、Atlas UI のCustom Analyzersセクションにアナライザに関する次の詳細が表示されます。

名前	カスタムアナライザを識別するラベル。
で使用される	カスタムアナライザを使用するフィールド。カスタムアナライザがフィールドを分析するために使用されない場合、値は[なし]です。
文字フィルター	カスタムアナライザで構成されたMongoDB Search 文字フィルター。
トークナイザ	カスタムアナライザで構成されたMongoDB Searchトークナイザ。
トークンフィルター	カスタムアナライザで構成されたMongoDB Search トークンフィルター。
アクション	カスタムアナライザで実行できるアクションを示すクリック可能なアイコン。をクリックしますカスタムアナライザを編集します。をクリックしますカスタムアナライザを削除します。

戻る

multi

文字フィルター