object $DB_DataObject->database ( 
      
       
       string $name
      
      
      
      
                  
     )
Without any argument, it returns the database that the object deals with. With a string, it will set the database for the instance of the object.
This function can not be called statically.
Getting the database name
<?php
$person = new DataObjects_Person;
echo $person->database();
// echo's mydatabase
// now use the same object to check on a mirror..
$person->database('mirror1');
$person->id = 12;
$person->find(true);
?>