20.5.3.Tables and Procedures Created By Text Triggers



          TTH_D_ID         INTEGER   - document ID, references unique id of [TARGET_TABLE]
          TTH_T_ID         INTEGER   - query ID, references QUERY table
          TTH_U_ID         INTEGER   - user ID, references USER table
          TTH_TS           TIMESTAMP - date and time of retrieval
          TTH_NOTIFY       VARCHAR   - e-mail address of user for notification
          TTH_TITLE        VARCHAR   - not used (can be filled with user-defined trigger)
          TTH_URL          VARCHAR   - not used (can be filled with user-defined trigger)



          TT_ID            INTEGER   - Unique ID of query
          TT_QUERY         VARCHAR   - query text
          TT_WORD          VARCHAR   - the best word for query
          TT_COMMENT       VARCHAR   - Description
          TT_CD            VARCHAR   - user data (not used)
          TT_PREDICATE     VARCHAR   - not used
          TT_XPATH         VARCHAR   - XPATH expression.  If specified,
                                                the test is this XPATH predicate,
                                                see separate section.



          TTU_U_ID         INTEGER - unique user ID can reference SYS_USERS.
          TTU_T_ID         INTEGER - query ID, references QUERY table
          TTU_COMMENT      VARCHAR - Description
          TTU_NOTIFY       VARCHAR - e-mail address of user for notification

Note that the queries are available given a table wide query identifier and an 'entry point' word. Such a word is a word that must occur in the document in order for the query to have a possibility of matching the document, The query text and other attributes are denormalized so that the primary key is the word, id pair when the id itself is unique. Note that in the case of an AND of words, the least frequent of the words will be used as unique entry point of the query, so that it will not be tried on documents that do not contain this word. However, a query with OR'ed terms may have several such words, hence the possibility of multiple rows in the query table for the same query.

The TT_USER_<xx> table maps from the query to a user. The idea of this is to allow a single query to have multiple users. Consider an application which allows creating personalized information filtering profiles. It is to be expected that multiple users would store the same profiles. Therefore the link between the user and the query is entitized as this table. The user specific comment and notification mode are thus stored here, not with the query. The notification mode itself is application dependent. The user id is an application dependent id that can be used to reference application user entities. Some applications may use this whereas other applications will have all queries on a single user.

When a hit is noticed an entry is made into the TT_HIT_<xx> table. One row is inserted for each unique document id, query id, user id combination for which the document matches the query and there is a link to a user from the query through TT_USER_<xx>. A query with no row in TT_USEER_<xx> is an integrity error. The number of times the pattern is found in each document or its free text hit score has no effect on the hit insertion.

One may note that defining application specific triggers on the hit table can be used to add immediate application reactions to incoming data.

The free text triggers are matched against the new content immediately before the content is inserted into the free text index. Therefore the batch mode setting affects the time of matching. In all situations, the matching takes place after the data is inserted but before the free text index is updated. If text index maintenance is in synchronous (non-batched) mode, the text trigger match and hit generation is in the same transaction as the update to the content being watched.


For queries definition

tt_query_[TARGET_TABLE_NAME] (
            in [query text] varchar,            - query expression
            in [user_id] integer,               - user id references SYS_USERS or SYS_DAV_USER
            in [comment] varchar,               - description
            in [e-mail or empty] varchar)       - e-mail address for user notification

or hits registration (used inside text index procedures)

vt_hits_[TARGET_TABLE_NAME] (inout [batch] any, inout [words array] any)


for hits removal after document delete occurred



-- create a table
create table T1 (id integer, dt varchar, primary key (id));

-- define text index
create text index on T1 (dt);

-- create text trigger
create text trigger on T1;

-- define an query
tt_query_T1 ('xyz and abc', 1, 'This is a test query', null);

-- do some inserts
insert into T1 (id, dt) values (1, 'xyz');
insert into T1 (id, dt) values (2, 'xyz abc');
insert into T1 (id, dt) values (3, 'abc');
update T1 set dt = 'xyz qwe abc' where id = 2;

select TTH_TS, dt from T1, T1_dt_HIT where id = TTH_D_ID order by TTH_TS desc;
-- produces following
TTH_TS      dt

2000-10-24 18:25:53  xyz qwe abc
2000-10-24 18:25:53  xyz qwe abc