Drupal legacy database

Question:
How to use a legacy database with Drupal

Within the settings.php file the default and legacy databases can be defined. An example is shown below.

$db_url['default'] = 'mysqli://user:password@localhost/default_database_name';
$db_url['legacy'] = 'mysqli://user:password@localhost/legacy_database_name';

Taxonomy: