merge method Leave feedback

Merges the specified index into the current index.

If the other index has a previous version, it must be updated before merging with IndexUpdater.

The indexes must divide the text of documents into terms in the same way; a search finds a document reliably only if the document was indexed with the dictionaries and settings that the index uses. The operation compares the current index with the other index if it contains documents: the settings IndexSettings.use_stop_words, IndexSettings.use_character_replacements, IndexSettings.replace_unpaired_surrogates and IndexSettings.skip_blended_only_terms, the alphabet, the tokenization dictionary, the stop word dictionary if the indexes use stop words, and the character replacement dictionary if the indexes use character replacements. If a difference is found, the operation throws a RuntimeError and no index is changed.

The alphabet, the tokenization dictionary, the stop word dictionary and the character replacement dictionary of the current index are not changed by the operation. The other dictionaries of the other index are merged into the dictionaries of the current index.

def merge(self, index, options):
    ...

from groupdocs.search import Index
from groupdocs.search.options import MergeOptions
from groupdocs.search.common import Cancellation

index1 = Index("./index1")
index1.add("./documents")

index2 = Index("./index2")
index2.add("./documents2")

options = MergeOptions()
options.cancellation = Cancellation()

try:
    index1.merge(index2, options)
except RuntimeError as exc:
    print(exc)

print("Documents in index1:", len(index1.get_indexed_documents()))

Merges indexes from the specified index repository into the current index.

If other indexes have a previous version, they must be updated before merging with IndexUpdater.

The indexes have to divide the text of documents into terms in the same way: a search finds a document reliably only if the document was indexed with the dictionaries and settings that the index uses. The operation compares the current index with every index of the repository that contains documents: the settings IndexSettings.use_stop_words, IndexSettings.use_character_replacements, IndexSettings.replace_unpaired_surrogates and IndexSettings.skip_blended_only_terms, the alphabet, the tokenization dictionary, the stop word dictionary if the indexes use stop words, and the character replacement dictionary if the indexes use character replacements. If a difference is found, the operation throws a RuntimeError and no index is changed.

The alphabet, the tokenization dictionary, the stop word dictionary and the character replacement dictionary of the current index are not changed by the operation. The other dictionaries of the other indexes are merged into the dictionaries of the current index.

def merge(self, repository, options):
    ...

from groupdocs.search import Index
from groupdocs.search.options import MergeOptions
from groupdocs.search.common import Cancellation

index1 = Index("./index1")          # Creating index1
index1.add("./documents")           # Indexing documents

index2 = Index("./index2")          # Creating index2
index2.add("./documents2")          # Indexing documents

options = MergeOptions()
options.cancellation = Cancellation()  # Create cancellation object

try:
    # Merge index2 into index1; index2 files remain unchanged
    index1.merge(index2, options)
except RuntimeError as e:
    print(e)

print("Documents in index1:", len(index1.get_indexed_documents()))

These names call merge too, limited to the overloads listed.

• class Index