フィールド マッピングの定義

ダイナミックマッピング

動的マッピング を使用して、コレクション内のサポートされているタイプのすべてのフィールドを自動的にインデックス。スキーマが定期的に変更される場合や不明な場合、またはAtlas Searchを試す場合にのみ、動的マッピングを使用することをお勧めします。動的にマップされたインデックスは、静的にマップされたインデックスよりも多くのディスク領域を占有し、パフォーマンスを低下させる可能性があります。

多形データを含むフィールドを動的にインデックスと、Atlas Search は、データに対応する動的にインデックス付け可能なすべてのフィールドタイプとしてフィールドを自動的にインデックス化します。自動的にインデックスしない種類のデータがフィールドに含まれている場合、Atlas Search はそのデータのインデックスしません。

Atlas Search は、検出データ型のデフォルト設定を使用して、ドキュメント内のすべてのフィールドを動的にインデックス化します。 Atlas Search は、dynamic を false に設定して明示的にオーバーライドしない限り、ドキュメントの下にネストされたすべてのドキュメントも動的にインデックス化します。

動的インデックスをサポートするデータ型については、以下の「 データ型 」セクションを参照してください。

静的マッピング

静的マッピングを使用して、動的にインデックスを作成 したくない フィールドのインデックスオプションを設定したり、1 つのフィールドをインデックス内の他のフィールドと独立して構成したりします。静的マッピングを使用する場合、Atlas Search はmappings.fields で指定したフィールドのみをインデックス化します。

多形データを含むフィールドを静的にインデックスと、Atlas Search は、そのフィールドのインデックス定義で指定されたマッピングに対応するドキュメントのみをインデックス化します。 Atlas Search は、そのフィールドのインデックス定義で指定されたデータ型と一致しないドキュメントのインデックスを作成しません。

ネストされたフィールドのインデックスを定義するには、そのネストされたフィールドの各親フィールドのマッピングを定義する必要があります。ドット表記を使用してネストされたフィールドを静的にインデックスことはできません。例については、以下の例 または 組み合わせマッピングの例 を参照してください。

複数のデータ型としてのインデックス フィールド

フィールドを複数のタイプとしてインデックス化するには、フィールドのフィールド定義配列でタイプを定義します。

1
{
2
  ...
3
  "mappings": {
4
    "dynamic": <boolean>,
5
    "fields": {
6
      "<field-name>": [
7
        {
8
          "type": "<field-type>",
9
          ...
10
        },
11
        {
12
          "type": "<field-type>",
13
          ...
14
        },
15
        ...
16
      ],
17
      ...
18
    },
19
    ...
20
  }
21
}

静的マッピングの例

以下のインデックス定義例では、静的マッピングを使用しています。

• デフォルトのインデックス アナライザは lucene.standard です。

• デフォルトの検索アナライザは lucene.standard です。Atlas Search インデックスに格納する方法とは異なる方法でクエリ用語を解析する場合は、検索アナライザを変更できます。

• インデックスは静的フィールドマッピング（dynamic: false）を指定します。つまり、明示的に指定されていないフィールドにはインデックスが付けられません。したがって、インデックス定義には次のものが含まれます。

  • document型である、address フィールド。埋め込まれたサブフィールドには cityとstate の 2 つがあります。

    cityサブフィールドは、クエリに対してデフォルトで lucene.simple アナライザを使用します。ignoreAboveオプションを使用すると、長さが 255 バイトを超える文字列を無視します。

    stateサブフィールドは、クエリに対してデフォルトで lucene.english アナライザを使用します。

  • string型である、company フィールド。クエリにはデフォルトで lucene.whitespace アナライザが使用されます。クエリにデフォルトで lucene.french アナライザを使用するmySecondaryAnalyzerという名前のmultiアナライザがあります。

  • 文字列の配列である employees フィールド。クエリにはデフォルトで lucene.standard アナライザが使用されます。配列のインデックス作成において、Atlas Search では配列要素のデータ型のみが必要です。インデックス定義でデータが配列に含まれていることを指定する必要はありません。

{
  "analyzer": "lucene.standard",
  "searchAnalyzer": "lucene.standard",
  "mappings": {
    "dynamic": false,
    "fields": {
      "address": {
        "type": "document",
        "fields": {
          "city": {
            "type": "string",
            "analyzer": "lucene.simple",
            "ignoreAbove": 255
          },
          "state": {
            "type": "string",
            "analyzer": "lucene.english"
          }
        }
      },
      "company": {
        "type": "string",
        "analyzer": "lucene.whitespace",
        "multi": {
          "mySecondaryAnalyzer": {
            "type": "string",
            "analyzer": "lucene.french"
          }
        }
      },
      "employees": {
        "type": "string",
        "analyzer": "lucene.standard"
      }
    }
  }
}

複合マッピングの例

次のインデックス定義の例では、静的マッピングと動的マッピングの両方を使用します。

• デフォルトのインデックス アナライザは lucene.standard です。

• デフォルトの検索アナライザは lucene.standard です。Atlas Search インデックスに格納する方法とは異なる方法でクエリ用語を解析する場合は、検索アナライザを変更できます。

• インデックスは静的フィールドマッピング（dynamic: false）を指定します。つまり、明示的に指定されていないフィールドにはインデックスが付けられません。したがって、インデックス定義には次のものが含まれます。

  • string型である、company フィールド。クエリにはデフォルトで lucene.whitespace アナライザが使用されます。クエリにデフォルトで lucene.french アナライザを使用するmySecondaryAnalyzerという名前のmultiアナライザがあります。

  • 文字列の配列である employees フィールド。クエリにはデフォルトで lucene.standard アナライザが使用されます。

  • document 型である、address フィールド。埋め込まれたサブフィールドには city と state の 2 つがあります。ドキュメント内のネストされた各フィールドを明示的に指定する代わりに、インデックス定義により、ドキュメント内のすべてのサブフィールドの動的なマッピングが可能になります。クエリにはデフォルトで lucene.standard アナライザが使用されます。

{
  "analyzer": "lucene.standard",
  "searchAnalyzer": "lucene.standard",
  "mappings": {
    "dynamic": false,
    "fields": {
      "company": {
        "type": "string",
        "analyzer": "lucene.whitespace",
        "multi": {
          "mySecondaryAnalyzer": {
            "type": "string",
            "analyzer": "lucene.french"
          }
        }
      },
      "employees": {
        "type": "string",
        "analyzer": "lucene.standard"
      },
      "address": {
        "type": "document",
        "dynamic": true
      }
    }
  }
}