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().