Docco

My favorite Oracle manuals, in no particular order:

Reference
Concepts
SQL Reference
PL/SQL Packages and Types Reference
Application Developer’s Guide – Fundamentals
PL/SQL User’s Guide and Reference

I guess the shorter the title, the more I like it :-)

Seriously, I’ve always thought the quality and breadth of documentation from Oracle to be pretty good — especially when compared with docco from other vendors.  Microsoft and Siebel documentation is pretty poor in my opinion — non-existent or only documents blatantly obvious stuff.  I’m continually amazed at so-called Oracle developers who don’t have the Oracle Documentation link bookmarked…

http://www.oracle.com/technology/documentation/index.html

Well I’m takin’ my time, I’m just movin’ along

The old song by Boston just keeps playing in my head today, so I thought it would make a good post title.  It’s been a long time since my last post — crazy busy at work leading up to a week-long vacation in DisneyWorld.  I like vacationing at Disney, but it’s not the laid-back, sit by the pool with a good book kind of vacation.  Lots of clean air and exercise running around the theme parks.  With my kids getting older, we get to try more aggressive rides.  The Expedition Everest roller-coaster in Animal Kingdom is especially well done.

Anyway, I’ve got a bunch of post topics ready to roll, so on to today’s:

Have you noticed that some of the things you want to do in Oracle aren’t as well documented as you would like?  Heck, syntax diagrams are fine and all, but they don’t provide much context or advice or even information on conflicting parameters.  I know the options keep getting more and more advanced and complicated, and I’m not surprised that there just isn’t enough space or time to create exhaustive examples for every option.  And we only have so much time to experiment with them.

My latest foray into a new “feature” had to do with online table redefinition.  The relevant documentation (for 9i) is the Administrator’s Guide, Chapter 15 (Managing Tables),  Redefining Tables Online heading.  Actually, the documentation here is pretty good, but a little light on the technical details.  I needed to use this feature to “compress” a table after a set of archiving activities removed 50% of the rows from it.  (Yes, I know I don’t really need to do that, but I opened my big mouth again when someone said the delete would make things better — “Only if you reclaim the space to make full table scans faster”, I said — “When can you do that?” I got asked :-( )

Anyway, I started digging into online table redefinition, because (of course), we needed to do this activity without any outage whatsoever.  And anyway, I wanted to learn about OTR (online table redefinition) anyway.

So, basicially OTR creates a snapshot (oh, sorry — materialized view — MV) on the table you’re about to redefine — using a target table that you pre-create to receive the rows from the snapshot.  When you’re done, it syncs the delta rows using the standard snapshot refresh concept and then does the ole switcheroo on the table names to make the tables switch places.  I figured I’d do it to move the tables from one tablespace to another, thereby reclaiming the space from the deleted rows.

There’s a lot of work involved — you need to keep track of indexes, grants, constraints — everything that was on the base table.  And the docco isn’t very clear on when you want to put what on when.  In any event here’s what we did:

We wanted to use primary key method — that way we didn’t need the extra M_ROW$$ column hanging around on the target table.  But our source table didn’t have a primary key constraint (BTW, did I mention these were tables in a COTS 3rd-party application?).  Fortunately, it had a unique index on a non-null column — which quickly became declared as a primary key constraint :-)

So.  We created the target table as A_[table_name], created the necessary grants, altered the source table with a primary key constraint and got started.  One thing we learned is that you can’t have any MV’s on the original source table, so we had to drop those and save the creation scripts for them to re-run when we were done.

We started the process, which copied all of the rows — that was the “slow” step.  Once that was done, we added the unique index to the target table and did a re-sync.  We figured that the re-sync was primary key based (duh!) and so we wanted the index in place — good call.

Once that was done we created all of the other indexes (some 30-40 per table — yes, it’s a COTS application that begins with the letter S).  One problem — the index names needed to be different from the ones on the source table — otherwise we’d had namespace collisions — yuck.  So, all indexes get created with A_[index_name] as their new name.

We do another sync after all of the indexes are in place, and then finish the redefition.  But we’re not done yet!

What if there are hints referring to specific index names?  We need to rename all of the indexes — dropping or renaming the original ones first!  Reminder to self — you can’t drop an index if it’s being used to support a primary key constraint :-)

All in all, a good learning experience — especially the bit about the indexes and namespace collision problems.

I’ll have some more posts up later on, but I thought this was a good story…