X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fquerymodel.xml;h=6c12214e2c9a7b6f948f2512a6f8db10b1a66601;hb=213c8c2649191ea7385934f5ac039928362b96ed;hp=82d25ec6a072ed011b76c004f72e2819cf3b7328;hpb=3b8c3227f359d5a4ff1b2df52139f1b88a01ce34;p=idzebra-moved-to-github.git diff --git a/doc/querymodel.xml b/doc/querymodel.xml index 82d25ec..6c12214 100644 --- a/doc/querymodel.xml +++ b/doc/querymodel.xml @@ -1,11 +1,11 @@ - + Query Model - +
Query Model Overview - +
Query Languages @@ -29,7 +29,7 @@ - +
Prefix Query Format (PQF) Index Data has defined a textual representation in the @@ -41,12 +41,12 @@ parties developing Z39.50 software, and is often referred to as Prefix Query Notation, or in short PQN. See - for further explanations and + for further explanations and descriptions of Zebra's capabilities. - +
- +
Common Query Language (CQL) The query model of the type-1 RPN, @@ -59,11 +59,11 @@ Zebra can be configured to understand and map CQL to PQF. See . - +
- +
- +
Operation types Zebra supports all of the three different @@ -73,7 +73,7 @@ functionality and purpose of each is quite in order here. - +
Explain Operation The syntax of Z39.50/SRU queries is @@ -106,9 +106,9 @@ auto-configure a client user interface to the servers capabilities. - +
- + - +
Scan Operation The scan operation is a helper functionality, @@ -137,15 +137,15 @@ spelling of search terms, to auto-fill search boxes, or to display controlled vocabularies. - +
- +
- +
- - Prefix Query Format syntax and semantics +
+ RPN queries and semantics The PQF grammar is documented in the YAZ manual, and shall not be @@ -155,10 +155,10 @@ query parse tree. - - PQF tree structure +
+ RPN tree structure - The PQF parse tree - or the equivalent textual representation - + The RPN parse tree - or the equivalent textual representation in PQF - may start with one specification of the attribute set used. Following is a query tree, which @@ -169,7 +169,7 @@ complex query trees. - +
Attribute sets Attribute sets define the exact meaning and semantics of queries @@ -184,7 +184,7 @@ Attribute set - Short hand + PQF notation (Short hand) Status Notes @@ -192,7 +192,7 @@ - Explain + Explain exp-1 Special attribute set used on the special automagic IR-Explain-1 database to gain information on @@ -201,7 +201,7 @@ predefined - Bib1 + Bib-1 bib-1 Standard PQF query language attribute set which defines the semantics of Z39.50 searching. In addition, all of the @@ -211,14 +211,14 @@ default - GILS + GILS gils - Extension to the Bib1 attribute set. + Extension to the Bib-1 attribute set. predefined - +
Zebra Extension Rank Weight Attribute (type 9) Rank weight is a way to pass a value to a ranking algorithm - so @@ -1613,9 +1622,9 @@ Z> find @attr 2=102 @or @attr 9=30 @attr 1=4 utah @attr 9=20 utah - +
- +
Zebra Extension Approximative Limit Attribute (type 11) Zebra computes - unless otherwise configured - @@ -1667,9 +1676,9 @@ extension. Do not use in production code. - +
- +
Zebra Extension Term Reference Attribute (type 10) Zebra supports the searchResult-1 facility. @@ -1690,11 +1699,11 @@ - - +
+
- +
Zebra specific Scan Extensions to all Attribute Sets Zebra extends the Bib1 attribute types, and these extensions are @@ -1729,7 +1738,7 @@ - +
Zebra Extension Result Set Narrow (type 8) If attribute Result Set Narrow (type 8) @@ -1765,35 +1774,25 @@ - - - Experimental. Do not use in production code. - - - + + Zebra 2.0.2 and later is able to skip 0 hit counts. This, however, + is known not to scale if the number of terms to skip is high. + This most likely will happen if the result set is small (and + result in many 0 hits). + +
- +
Zebra Extension Approximative Limit (type 11) The Zebra Extension Approximative Limit (type 11) is a way to enable approximate hit counts for scan hit counts, in the same way as for search hit counts. - - - - Experimental and buggy. Definitely not to be used in production code. - - - - +
+
- +
Zebra special IDXPATH Attribute Set for GRS indexing The attribute-set idxpath consists of a single @@ -1815,7 +1814,7 @@ - +
IDXPATH Use Attributes (type = 1) This attribute set allows one to search GRS filter indexed @@ -1939,11 +1938,11 @@ - - +
+
- +
Mapping from PQF atomic APT queries to Zebra internal register indexes @@ -1955,7 +1954,7 @@ the named register. - +
Mapping of PQF APT access points Zebra understands four fundamental different types of access @@ -2088,10 +2087,10 @@ - +
- +
Mapping of PQF APT structure and completeness to register type @@ -2298,10 +2297,10 @@ contents. - - +
+
- +
Zebra Regular Expressions in Truncation Attribute (type = 5) @@ -2405,7 +2404,7 @@ Z> find @attr 1=4 @attr 5=102 @attr 2=102 "informat.* retrieval" - +
- +
- +
Server Side CQL to PQF Query Translation Using the @@ -2475,23 +2474,19 @@ Exhaustive information can be found in the Section "Specification of CQL to RPN mappings" in the YAZ manual. - - http://www.indexdata.dk/yaz/doc/tools.tkl#tools.cql.map, - and shall therefore not be repeated here. + , + and shall therefore not be repeated here. - - - +