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

ダイナミックマッピング

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

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

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

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

静的マッピング

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

多形データを含むフィールドを静的にインデックスした場合、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
      }
    }
  }
}