From 3105dee95d21fffa0e2f9249c5827690d9d3e155 Mon Sep 17 00:00:00 2001 From: Marc Cromme Date: Tue, 20 Jun 2006 14:20:50 +0000 Subject: [PATCH] added section on named result sets, and section on scanning inside result sets --- doc/querymodel.xml | 174 ++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 149 insertions(+), 25 deletions(-) diff --git a/doc/querymodel.xml b/doc/querymodel.xml index 71cca4d..f4d5c96 100644 --- a/doc/querymodel.xml +++ b/doc/querymodel.xml @@ -1,5 +1,5 @@ - + Query Model @@ -165,7 +165,8 @@ may start with one specification of the attribute set used. Following is a query tree, which - consists of atomic query parts (APT), eventually + consists of atomic query parts (APT) or + named result sets, eventually paired by boolean binary operators, and finally recursively combined into complex query trees. @@ -178,48 +179,77 @@ issued. Zebra comes with some predefined attribute set definitions, others can easily be defined and added to the configuration. - - The Zebra internal query procesing is modeled after - the Bib1 attribute set, and the non-use - attributes type 2-6 are hard-wired in. It is therefore essential - to be familiar with . - + - + - + + - + + non-use attributes (type 2-9) define the hard-wired + Zebra internal query + processing. + - + + +
Attribute sets predefined in Zebra
exp-1 Explain attribute setexp-1 Special attribute set used on the special automagic IR-Explain-1 database to gain information on server capabilities, database names, and database and semantics.predefined
bib-1 Bib1 attribute setbib-1 Standard PQF query language attribute set which defines the semantics of Z39.50 searching. In addition, all of the - non-use attributes (type 2-9) define the Zebra internal query - processingdefault
gils GILS attribute setgils Extention to the Bib1 attribute set.predefined
+ + + The use attributes (type 1) of the predefined attribute sets can + be reconfigured by tweaking the files + tab/*.att. + New attribute sets can be defined by adding similar files in the + configuration path of the server. + + + + The Zebra internal query processing is modeled after + the Bib1 attribute set, and the non-use + attributes type 2-6 are hard-wired in. It is therefore essential + to be familiar with . + + Boolean operators @@ -372,6 +402,51 @@ + + + Named Result Sets + + Named result sets are supported in Zebra, and result sets can be + used as operands without limitations. + + + After the execution of a search, the result set is available at + the server, such that the client can use it for subsequent + searches or retrieval requests. The Z30.50 standard actually + stresses the fact that result sets are voliatile. It may cease + to exist at any time point after search, and the server will + send a diagnostic to the effect that the requested + result set does not exist any more. + + + + Defining a named result set and re-using it in the next query, + using yaz-client. + + Z> f @attr 1=4 mozart + ... + Number of hits: 43, setno 1 + ... + Z> f @and @set 1 @attr 1=4 amadeus + ... + Number of hits: 14, setno 2 + ... + Z> f @attr 1=1016 beethoven + ... + Number of hits: 26, setno 3 + ... + + + + + Named result sets are only supported by the Z39.50 protocol. + The SRU web service is stateless, and therefore the notion of + named result sets does not exist when acessing a Zebra server by + the SRU protocol. + + + + Zebra's special use attribute type 1 of form 'string' @@ -509,6 +584,30 @@ this facility when speed is essential, and the database content size is medium to large. + + + @@ -648,9 +747,6 @@ Bib1 Attribute Set - Something about querying to be written .. - - Most of the information contained in this section is an excerpt of the ATTRIBUTE SET BIB-1 (Z39.50-1995) SEMANTICS, @@ -659,13 +755,13 @@ Bib-1 Attribute Set version from 2003. Index Data is not the copyright holder of this - information. + information, except for the configuration details, the listing of + Zebra's capabilities, and the example queries. Use Attributes (type 1) - A use attribute specifies an access point for any atomic query. @@ -697,7 +793,13 @@ Z> find @attr 1=4 "information retrieval" + + + + + + Zebra general Bib1 Non-Use Attributes (type 2-6) Relation Attributes (type 2) @@ -1306,14 +1408,36 @@ result set. Each hit count in scan is @and'ed with the result set given. - + - Experimental and buggy. Definitely not to be used in production code. + Experimental. Do not use in production code. @@ -1332,7 +1456,7 @@ --> - Experimental. Do not use in production code. + Experimental and buggy. Definitely not to be used in production code. -- 1.7.10.4