Name
vt_batch_feed — Add words to a free text update batch.
Synopsis
vt_batch_feed
(
|
in vt_batch any , |
| in text_or_xml any , | |
| in is_del integer , | |
in
is_xml
integer
); |
Description
This function allows you to add words to a free text update batch.
It can be called in sequence to feed group of documents that share a common document ID
and the result is similar to the single call whose text_or_xml
parameter is concatenation of documents of that group. It is even allowed to mix
XML and non-XML documents by feeding an XML document and some text documents:
the first document to feed may be an XML document, other documents should be only texts.
If one wishes to mix XML and non-XML documents, knowledge of details of the indexing method is needed.
vt_batch_feed
assigns a sequence number to every word of the provided document
using an internal counter.
The call of vt_batch_d_id
not only sets document id but also resets this counter to 0.
The first element of an XML document should have number 0 so it is impossible to feed an XML document if
there were other calls of vt_batch_feed
after the last vt_batch_d_id
.
Moreover, xcontains
will ignore words from text documents
that were fed after the first XML document, only
contains
will use all data.
Parameters
vt_batch
must be an object returned by
vt_batch
on which
vt_batch_d_id
has been called; e.g. it can be called inside the index hook function
text_or_xml
must be a blob, wide blob, varchar, nvarchar or XML entity object.
is_del
if 0 means that the data is to be added, 1 means the data is to be deleted.
is_xml
if 1, means that the
text_or_xml
must be a well formed XML fragment and
that it will be indexed for use with xcontains
. The default is 0 that means
"plain text".
Return Types
None.
Examples
Please refer to examples for function vt_batch_feed_offband() .