=pod
=head1 NAME
ur define db - add a data source to the current namespace
=head1 VERSION
This document describes ur define db version 0.29.
=head1 SYNOPSIS
ur define db URI NAME
ur define db dbi:SQLite:/some/file.db Db1
ur define db me@dbi:mysql:myserver MainDb
ur define db me@dbi:Oracle:someserver ProdDb
ur define db me@dbi:Oracle:someserver~schemaname BigDb
ur define db me@dbi:Pg:prod Db1
ur define db me@dbi:Pg:dev Testing::Db1 # alternate for "Testing" (arbitrary) context
ur define db me@dbi:Pg:stage Staging::Db1 # alternate for "Staging" (arbitrary) context
=head1 REQUIRED ARGUMENTS
=over
=item URI I<Text>
a DBI connect string like dbi:mysql:someserver or user/passwd@dbi:Oracle:someserver~defaultns
=item NAME I<Text>
the name for this data source (used for class naming)
Default value 'Db1' if not specified
=back
=head1 DESCRIPTION:
add a data source to the current namespace
=cut