Oracle FAQ | Your Portal to the Oracle Knowledge Grid |
Home -> Community -> Usenet -> c.d.o.server -> ANNOUNCE: DDL::Oracle v0.27
Release of version 0.27 of DDL::Oracle
NAME
DDL::Oracle - a DDL generator for Oracle 7.3, 8.0 and 8i databases
CHANGES DDL::Oracle has been updated to produce DDL for Oracle 7.3 and 8.0 databases for the following:
TABLES
INDEXES
TABLESPACES
Program defrag.pl now does an ANALYZE TABLE/INDEX after the import for
objects which were previously analyzed. It also has been revised to handle
tables containing '$' in their names. Some changes for robustness have been
made, such as verifying that log directories are writeable before file
creation. And a few bugs were squashed.
DESCRIPTION
Overview
Designed for Oracle DBA's and users. It reverse engineers database objects (tables, indexes, users, profiles, tablespaces, roles, constraints, etc.). It generates DDL to *resize* tables and indexes to the provided standard or to a user defined standard.
We originally wrote a script to defrag tablespaces, but as DBA's we regularly find a need for the DDL of a single object or a list of objects (such as all of the indexes for a certain table). So we took all of the DDL statement creation logic out of defrag.pl, and put it into the general purpose DDL::Oracle module. DDL::Oracle was then expanded to include tablespaces, users, roles, and all other dictionary objects. The completely revised program 'defrag.pl' is included with the distribution.
Oracle tablespaces tend to become fragmented (now THAT's an understatement). Even when object sizing standards are adopted, it is difficult to get 100% compliance from users. And even if you get a high degree of compliance, objects turn out to be a different size than originally thought/planned -- small tables grow to become large (i.e., hundreds of extents); what was thought would be a large table ends up having only a few rows. And so forth. So the main driver for creating DDL::Oracle was the object management needs of Oracle DBA's. The "resize" method generates DDL for a list of tables or indexes. For partitioned objects, the "appropriate" size of EACH partition is calculated and supplied in the generated DDL.
Initialization and Constructor
configure
The configure method is used to define the DBI connection and to set several session level options. These are:
dbh A reference to a valid DBI connection (obtained via DBI->connect). This is a mandatory argument. NOTE: The user connecting MUST have SELECT privileges on the following (in addition to the DBA or USER views): V$INSTANCE V$PARAMETER schema Defines whether and what to use as the scema for DDL on objects which use this syntax. "1" means use the owner of the object as the schema; "0" means omit the schema syntax; any other arbtrary string will be imbedded in the DDL as the schema. The default is "1". resize Defines whether and what to use in resizing segments. "1" means resize segments using the default algorithm; "0" means keep the current INITIAL and NEXT values; any other string will be interpreted as a resize definition. The default is "1". view Defines which Dictionary views to query: DBA or USER (e.g., DBA_TABLES or USER_TABLES). The default is DBA.
new
The new method is the object constructor. The two mandatory object definitions are defined by calling this method, to wit:
type The type of object (e.g., TABLE, INDEX, SYNONYM, table family, etc.). For 'table family', supply the name(s) of tables -- the DDL will include the table and its: Comments (Table and Column) Indexes Constraints Triggers list An arrayref to an array of arrayrefs (as in the DBI's "fetchall_arrayref" method) containing pairs of owner and name.
Object methods
create
The create method generates the DDL to create the list of Oracle objects.
drop
The drop method generates the DDL to drop the list of Oracle objects.
resize
The resize method generates the DDL to resize the list of Oracle objects. The 'type' defined in the 'new' method is limited to 'index' and 'table'. For tables, this generates an ALTER TABLE MOVE statement; for indexes, it generates an ALTER INDEX REBUILD statement. If the table or index is partitioned, then a statement for each partition is generated.
To generate DDL for a single partition of an index or table, define the 'name' as a colon delimited field (e.g., 'name:partition').
SYNOPSIS
use DBI; use DDL::Oracle; my $dbh = DBI->connect( "dbi:Oracle:dbname", "username", "password", { PrintError => 0, RaiseError => 1 } ); # Use default resize and schema options. # query default DBA_xxx tables (could use USER_xxx for non-DBA types) ::Oracle->configure( dbh => $dbh, resize => 1 schema => 1 view => 'dba' ); # Create a list of one or more objects my $sth = $dbh->prepare( "SELECT owner , name FROM dba_tables WHERE tablespace_name = 'MY_TBLSP' -- your mileage may vary " ); $sth->execute; my $list = $sth->fetchall_arrayref; my $obj = DDL::Oracle->new( type => 'table', list => $list, ); my $ddl = $obj->create; # or $obj->resize; or $obj->drop; print $ddl; # Use STDOUT so user can redirect to desired file. FILES ddl.pl defrag.pl copy_user.pl copy_user.sh README README.defrag AUTHOR Richard V. Sutherland rvsutherland_at_yahoo.com
COPYRIGHT
Copyright (c) 2000, Richard V. Sutherland. All rights reserved.
This module is free software. It may be used, redistributed,
and/or modified under the same terms as Perl itself. See:
http://www.perl.com/perl/misc/Artistic.html
AVAILABILITY DDL::Oracle has been uploaded to the CPAN and is also available from:
http://sourceforge.net/projects/ddl-oracle