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

静的マッピング

静的マッピングを使用して、動的にインデックスを作成したくないフィールドのインデックス オプションを設定したり、1 つのフィールドをインデックス内の他のフィールドと独立して構成したりします。

静的マッピングの場合は、mappings.dynamic を false に設定し、mappings.fields を使用してインデックスするフィールドを指定します。Atlas Search は、特定のオプションを使用して指定されたフィールドのみをインデックス化します。 インデックス付きフィールドに多形データが含まれている場合、Atlas Search は、そのフィールドのインデックス定義で指定されたマッピングに対応するドキュメントのみをインデックス化し、そのフィールドのインデックス定義で指定されたデータ型ではない値を含むドキュメントを無視します。

ドット表記を使用してネストされたフィールドを静的にインデックスすることはできません。ネストされたフィールドのインデックスを定義する場合、そのネストされたフィールドの各親フィールドのマッピングを定義する必要があります。例については、このページの例を参照してください。ここでは、addressという名前のフィールド内にネストされているcityという名前のフィールドのインデックス構文が示されています。

ダイナミックマッピング

スキーマが定期的に変更される場合や不明な場合、またはAtlas Searchを試す場合は、動的マッピングを使用します。動的マッピングを使用するようにインデックス全体を構成することも、document タイプのフィールドなどの個々のフィールドを動的にマッピングするように指定することもできます。動的マッピングを使用する前に、データ型の表を参照してください。

動的マッピングの場合は、mappings.dynamicをtrueにします。Atlas Search は、各ドキュメント内のサポートされている型のフィールドを自動的にインデックス化します。文字列 型のフィールドの場合、Atlas Search はそのフィールドをmongotに保存します。

制限

デフォルトでは 、Atlas Search は、レプリカセットまたは単一のシャードで、2.100億インデックスオブジェクトを超えるインデックスの変更のレプリケートを停止します。ここでは、インデックス作成されたドキュメントまたはネストされた embeddedDocument はそれぞれ単一のオブジェクトとしてカウントされます。つまり、インデックスはクエリ可能ですが、古い結果が生じる可能性があります。

2.110 億オブジェクトを超える可能性のあるフィールドのインデックスを作成する場合は、numPartitions を使用するか、クラスターをシャーディングします。

フィールド名の先頭にドル記号（$）が含まれるフィールドにはインデックスを付けられません。

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

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

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アナライザがあります。

    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 アナライザがあります。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
      }
    }
  }
}