NAME
dbunjoin - create new tables from a joined table
SYNOPSIS
int dbunjoin ( Dbptr db, char *database_name, int rewrite );
DESCRIPTION
Dbunjoin provides a means for creating a subset of a
database, by adding all the unique records from each table in
a view
db into a new database
database_name.
dbunjoin looks through a view and compiles a list
of all the unique record numbers for each table in the view.
It then copies those records to a new set of tables.
OPTIONS
If
rewrite is non-zero, then existing tables will
be overwritten by the new information. Otherwise, if a
table already exists, dbunjoin will do nothing, and return dbINVALID.
FILES
Dbunjoin will create new database files for each table in the
view, named after
database_name.
RETURN VALUES
Dbunjoin return 0 on success, dbINVALID otherwise.
LIBRARY
$(DBLIBS)
DIAGNOSTICS
-
Won't write over existing table file
-
Can't create table file
SEE ALSO
dbintro(3)
BUGS AND CAVEATS
Probably it should be possible to add to an existing database, but
this would complicate and slow down this procedure enormously.
AUTHOR
Daniel Quinlan