GET_CONNECTION

Verwenden Sie die Script-Funktion GET_CONNECTION, um einen bestimmten Wert eines DB-Verbindungsobjekts zu lesen und als Rückgabewert zurückgegeben. Wurde das angegebene Objekt nicht gefunden, entspricht das Verbindungs-Objekt nicht dem Typ DB oder ist das spezifizierte Attribut ungültig, so kommt es zu einem Laufzeitfehler.

Syntax

GET_CONNECTION (Objektname, Attribut)

Parameter

  • GET_CONNECTION
    Liest Informationen aus einem DB-Verbindungsobjekt.

  • Objektname
    Name eines DB-Verbindungsobjekts. Weitere Informationen finden Sie unter Verbindung (CONN)
    Format: AE Name, Script-Literal oder Script-Variable

  • Attribut
    • Aus dem Objekt zu lesender Wert
    Format:AE-Name, Script-Literal oder Script-Variable
    Zulässige Werte:
    • db.type
      Datenbanktyp
      Mögliche Rückgabewerte 
      • DB2
        für IBM DB2
      • EXASOL
        für Exasol
      • GENERICJDBC
        für die Generic JDBC
      • HANA
        für SAP HANA
      • INFORMIX
        für Informix
      • MYSQL
        für MySQL
      • MSSQL
        für Microsoft SQL Server
      • ORACLE
        für Oracle
      • ORACLE_OCI
        für Oracle OCI
      • POSTGRESQL
        für PostgreSQL
      • SYBASE
        für Sybase
    • db.server
      Name des DB-Servers
    • db.port
      Port-Nummer des DB-Servers
    • db.name
      Name der Datenbank
    • DbUserid
      Datenbankbenutzer
      Achtung! In Datenbanken, bei der die Groß-/Kleinschreibung beachtet wird, müssen Sie den Wert genau wie hier gezeigt verwenden.
    • DbPassword
      Kennwort des DB-Benutzers
    • Login
      Name des alternativen Login-Objekts

Rückgabewerte
Der Rückgabewert ist der Wert des von Ihnen definierten CONN-Objekts.

Beispiele

Das folgende Beispiel ruft den Datenbank-Typ des Verbindungs-Objekts CONN.DB ab und schreibt diesen in den Aktivierungsreport.

:SET &VAR# = GET_CONNECTION(CONN.DB, db.type)
:P &VAR#

So erscheint die zugehörige Zeile im Aktivierungsreport:

2022-07-30 12:45:21 - U0020408 MSSQL


Siehe auch: