Module org.elasticsearch.server
Package org.elasticsearch.index.mapper

Class MapperService

java.lang.Object
org.elasticsearch.index.AbstractIndexComponent
org.elasticsearch.index.mapper.MapperService
All Implemented Interfaces:
Closeable, AutoCloseable
public class MapperService extends AbstractIndexComponent implements Closeable

  • Field Details

    • SINGLE_MAPPING_NAME

      public static final String SINGLE_MAPPING_NAME
      See Also:

    • TYPE_FIELD_NAME

      public static final String TYPE_FIELD_NAME
      See Also:

    • INDEX_MAPPING_NESTED_FIELDS_LIMIT_SETTING

      public static final Setting<Long> INDEX_MAPPING_NESTED_FIELDS_LIMIT_SETTING

    • INDEX_MAPPING_NESTED_DOCS_LIMIT_SETTING

      public static final Setting<Long> INDEX_MAPPING_NESTED_DOCS_LIMIT_SETTING

    • INDEX_MAPPING_TOTAL_FIELDS_LIMIT_SETTING

      public static final Setting<Long> INDEX_MAPPING_TOTAL_FIELDS_LIMIT_SETTING

    • LOGSDB_DEFAULT_IGNORE_DYNAMIC_BEYOND_LIMIT

      public static final NodeFeature LOGSDB_DEFAULT_IGNORE_DYNAMIC_BEYOND_LIMIT

    • INDEX_MAPPING_IGNORE_DYNAMIC_BEYOND_LIMIT_SETTING

      public static final Setting<Boolean> INDEX_MAPPING_IGNORE_DYNAMIC_BEYOND_LIMIT_SETTING

    • INDEX_MAPPING_DEPTH_LIMIT_SETTING

      public static final Setting<Long> INDEX_MAPPING_DEPTH_LIMIT_SETTING

    • INDEX_MAPPING_FIELD_NAME_LENGTH_LIMIT_SETTING

      public static final Setting<Long> INDEX_MAPPING_FIELD_NAME_LENGTH_LIMIT_SETTING

    • INDEX_MAPPING_DIMENSION_FIELDS_LIMIT_SETTING

      public static final Setting<Long> INDEX_MAPPING_DIMENSION_FIELDS_LIMIT_SETTING

    • INDEX_MAPPER_DYNAMIC_SETTING

      @Deprecated public static final Setting<Boolean> INDEX_MAPPER_DYNAMIC_SETTING
      Deprecated.
      Legacy index setting, kept for 7.x BWC compatibility. This setting has no effect in 8.x. Do not use.

  • Constructor Details

  • Method Details

    • hasNested

      public boolean hasNested()

    • getIndexAnalyzers

      public IndexAnalyzers getIndexAnalyzers()

    • parserContext

      public MappingParserContext parserContext()

    • documentParser

      public DocumentParser documentParser()
      Exposes a DocumentParser
      Returns:
      a document parser to be used to parse incoming documents

    • parseMapping

      public static Map<String,Object> parseMapping(NamedXContentRegistry xContentRegistry, String mappingSource) throws IOException
      Parses the mappings (formatted as JSON) into a map
      Throws:
      IOException

    • parseMapping

      public static Map<String,Object> parseMapping(NamedXContentRegistry xContentRegistry, CompressedXContent mappingSource) throws IOException
      Parses the mappings (formatted as JSON) into a map
      Throws:
      IOException

    • updateMapping

      public void updateMapping(IndexMetadata currentIndexMetadata, IndexMetadata newIndexMetadata)
      Update local mapping by applying the incoming mapping that have already been merged with the current one on the master

    • merge

      public void merge(IndexMetadata indexMetadata, MapperService.MergeReason reason)

    • merge

      public DocumentMapper merge(String type, List<CompressedXContent> mappingSources, MapperService.MergeReason reason)
      Merging the provided mappings. Actual merging is done in the raw, non-parsed, form of the mappings. This allows to do a proper bulk merge, where parsing is done only when all raw mapping settings are already merged.

    • merge

      public DocumentMapper merge(String type, CompressedXContent mappingSource, MapperService.MergeReason reason)

    • parseMapping

      public Mapping parseMapping(String mappingType, MapperService.MergeReason reason, CompressedXContent mappingSource)

    • parseMapping

      public Mapping parseMapping(String mappingType, MapperService.MergeReason reason, Map<String,Object> mappingSource)
      A method to parse mapping from a source in a map form.
      Parameters:
      mappingType - the mapping type
      reason - the merge reason to use when merging mappers while building the mapper
      mappingSource - mapping source already converted to a map form, but not yet processed otherwise
      Returns:
      a parsed mapping

    • mergeMappings

      public static Mapping mergeMappings(DocumentMapper currentMapper, Mapping incomingMapping, MapperService.MergeReason reason, IndexSettings indexSettings)

    • documentMapper

      public DocumentMapper documentMapper()
      Return the document mapper, or null if no mapping has been put yet or no documents have been indexed in the current index yet (which triggers a dynamic mapping update)

    • mappingVersion

      public long mappingVersion()

    • isMappingSourceTyped

      public static boolean isMappingSourceTyped(String type, Map<String,Object> mapping)
      Returns true if the given mappingSource includes a type as a top-level object.

    • fieldType

      public MappedFieldType fieldType(String fullName)
      Given the full name of a field, returns its MappedFieldType.

    • mappingLookup

      public MappingLookup mappingLookup()
      Exposes a snapshot of the mappings for the current index. If no mappings have been registered for the current index, an empty MappingLookup instance is returned. An index does not have mappings only if it was created without providing mappings explicitly, and no documents have yet been indexed in it.

    • getEagerGlobalOrdinalsFields

      public Iterable<MappedFieldType> getEagerGlobalOrdinalsFields()
      Returns field types that have eager global ordinals.

    • indexAnalyzer

      public NamedAnalyzer indexAnalyzer(String field, Function<String,NamedAnalyzer> unindexedFieldAnalyzer)
      Return the index-time analyzer associated with a particular field
      Parameters:
      field - the field name
      unindexedFieldAnalyzer - a function to return an Analyzer for a field with no directly associated index-time analyzer

    • close

      public void close() throws IOException
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
      Throws:
      IOException

    • isMetadataFieldStatic

      @Deprecated public static boolean isMetadataFieldStatic(String fieldName)
      Deprecated.
      Use an instance method isMetadataField instead
      Returns:
      Whether a field is a metadata field Deserialization of SearchHit objects sent from pre 7.8 nodes and GetResults objects sent from pre 7.3 nodes, uses this method to divide fields into meta and document fields. TODO: remove in v 9.0

    • isMetadataField

      public boolean isMetadataField(String field)
      Returns:
      Whether a field is a metadata field. this method considers all mapper plugins

    • isMultiField

      public boolean isMultiField(String field)
      Returns:
      If this field is defined as a multifield of another field

    • reloadSearchAnalyzers

      public List<String> reloadSearchAnalyzers(AnalysisRegistry registry, @Nullable String resource, boolean preview) throws IOException
      Reload any search analyzers that have reloadable components if resource is null, otherwise only the provided resource is reloaded.
      Parameters:
      registry - the analysis registry
      resource - the name of the reloadable resource or null if all resources should be reloaded.
      preview - false applies analyzer reloading. true previews the reloading operation, so analyzers are not reloaded but the results retrieved. This is useful for understanding analyzers usage in the different indices.
      Returns:
      The names of reloaded resources (or resources that would be reloaded if preview is true).
      Throws:
      IOException

    • getAllDynamicTemplates

      public DynamicTemplate[] getAllDynamicTemplates()
      Returns:
      Returns all dynamic templates defined in this mapping.

    • getMapperRegistry

      public MapperRegistry getMapperRegistry()

    • getBitSetProducer

      public Function<org.apache.lucene.search.Query,org.apache.lucene.search.join.BitSetProducer> getBitSetProducer()

    • getMapperMetrics

      public MapperMetrics getMapperMetrics()