Die Funktion ist nur für Java™-Generierung gültig.
sqlLib.defineDatabaseAlias(
Aliasname STRING in,
Datenbank STRING in)
Das folgende Beispiel veranschaulicht, wie Sie mithilfe der Funktion 'sqlLib.defineDatabaseAlias()' zwei separate Datenbankverbindungen verwalten können:
// Verbindung zu einer Datenbank mit dem Aliasnamen "alias" herstellen;
// Diese Verbindung wird zur aktuellen Verbindung.
defineDatabaseAlias( "alias", "database" );
connect( "alias", "user", "pwd" );
// Zwei Verbindungen zu derselben Datenbank herstellen.
String db = "database";
defineDatabaseAlias( "alias1", db );
defineDatabaseAlias( "alias2", db );
connect( "alias1", "user", "pwd" );
connect( "alias2", "user", "pwd" );
// Weitere Methode zum Herstellen von zwei Verbindungen
// zu derselben Datenbank.
defineDatabaseAlias( "alias", "database" );
connect( "alias", "user", "pwd" );
connect( "database", "user", "pwd" );
// Ein Aliasname wird definiert, jedoch nicht verwendet. Die zweite Funktion
// 'connect()' erstellt keine neue Verbindung.
defineDatabaseAlias( "alias", "database" );
connect( "database", "user", "pwd" );
connect( "database", "user", "pwd" );
// Verwendung eines Aliasnamens (bei dem die Groß-/Kleinschreibung nicht beachtet werden muss)
// beim Trennen der Verbindung.
defineDatabaseAlias( "alias", "database" );
connect( "aLiAs", "user", "pwd" );
disconnect( "ALIAS" );
// Der nächste Aufruf zum Trennen der Verbindung schlägt fehl, da
// der Name der Verbindung "alias", nicht "database" ist.
defineDatabaseAlias( "alias", "database" );
connect( "alias", "user", "pwd" );
disconnect( "database" );
// Ein Aliasname kann sich ändern. Nach dem nächsten Aufruf
// verweist "alias" auf "firstDatabase"
defineDatabaseAlias( "alias", "firstDatabase" );
// Nach dem nächsten Aufruf
// verweist "alias" auf "secondDatabase".
defineDatabaseAlias( "alias", "secondDatabase" );
// Der letzte Aufruf wäre fehlgeschlagen,
// wenn eine Verbindung mit "alias" vorhanden gewesen wäre.
| Plattform | Problem |
|---|---|
| Jasper-Berichte | Sie können den Datenbankaliasnamen im Feld connectionName einer Variablen für Berichtsdaten (ReportData) verwenden. |
| VisualAge Generator-Kompatibilität | Sie können den Datenbankaliasnamen in einem Aufruf 'vgLib.connectionService()' verwenden. |