NAME
stag-db.pl - persistent storage and retrieval for stag data (xml, sxpr, itext)
SYNOPSIS
stag-db.pl -r person -u social_security_no -i ./person-idx myrecords.xml
stag-db.pl -i ./person-idx -q 999-9999-9999 -q 888-8888-8888DESCRIPTION
Builds a simple file-based database for persistent storage and retrieval of nodes from a stag compatible document.
Imagine you have a very large file of data, in a stag compatible format such as XML. You want to index all the elements of type person; each person can be uniquely identified by social_security_no, which is a direct subnode of person
The first thing to do is to build an index file, which will be stored in your current directory:
stag-db.pl -r person -u social_security_no -i ./person-idx myrecords.xmlYou can then use the index "person-idx" to retrieve person nodes by their social security number
stag-db.pl -i ./person-idx -q 999-9999-9999 > some-person.xmlYou can export using different stag formats
stag-db.pl -i ./person-idx -q 999-9999-9999 -w sxpr > some-person.xmlYou can retrieve multiple nodes (although these need to be rooted to make a valid file)
stag-db.pl -i ./person-idx -q 999-9999-9999 -q 888-8888-8888 -top personsetOr you can use a list of IDs from a file (newline delimited)
stag-db.pl -i ./person-idx -qf my_ss_nmbrs.txt -top personsetARGUMENTS
SEE ALSO
For more complex stag to database mapping, see DBIx::DBStag and the scripts