

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM CLPPlus
<a name="db2-connecting-with-ibm-clpplus-client"></a>

Sie können ein Dienstprogramm wie IBM CLPPlus für die Verbindung mit einer DB-Instance von Amazon RDS für Db2 verwenden. Dieses Dienstprogramm ist Teil von IBM Data Server Runtime Client. Informationen zum Herunterladen des Clients** **von IBM Fix Centralfinden Sie unter [IBM Data Server Client Packages Version 11.5 Mod 8 Fix Pack 0](https://www.ibm.com/support/pages/node/6830885) im IBM-Support. 

**Wichtig**  
Es wird empfohlen, IBM CLPPlus unter einem Betriebssystem auszuführen, das grafische Benutzeroberflächen wie macOS, Windows oder Linux mit Desktop unterstützt. Wenn Sie Headless Linux ausführen, verwenden Sie switch **-nw** mit CLPPlus-Befehlen.

**Topics**
+ [Installieren des Clients](#db2-connecting-ibm-clpplus-install-client)
+ [Herstellen einer Verbindung mit einer DB-Instance](#db2-connecting-ibm-clpplus-connect-db-instance)
+ [CLOB-Daten aus gespeicherten Prozeduren abrufen DB2](#db2-connecting-ibm-clpplus-retrieve-clob-data)

## Installieren des Clients
<a name="db2-connecting-ibm-clpplus-install-client"></a>

Nachdem Sie das Paket für Linux heruntergeladen haben, installieren Sie den Client. 

**Anmerkung**  
Um den Client auf AIX oder Windows zu installieren, gehen Sie genauso vor, ändern Sie jedoch die Befehle für Ihr Betriebssystem.

**So installieren Sie den Client unter Linux**

1. Führen Sie **`./db2_install`**.

1. Lauf **`clientInstallDir/instance/db2icrt -s client`*instance\$1name***. *instance\$1name*Ersetzen Sie durch einen gültigen Betriebssystembenutzer aufLinux. Unter Linux ist der Name der Db2-DB-Instance an den Betriebssystem-Benutzernamen gebunden.

   Mit diesem Befehl wird ein **`sqllib`**-Verzeichnis im Home-Verzeichnis des angegebenen Benutzers unter Linux erstellt.

## Herstellen einer Verbindung mit einer DB-Instance
<a name="db2-connecting-ibm-clpplus-connect-db-instance"></a>

Sie benötigen den DNS-Namen und die Portnummer Ihrer DB-Instance von RDS für Db2, um sich mit ihr zu verbinden. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Ermitteln des Endpunkts](db2-finding-instance-endpoint.md). Sie müssen auch den Datenbanknamen, den Hauptbenutzernamen und das Hauptpasswort kennen, die Sie bei der Erstellung Ihrer DB-Instance von RDS für Db2 definiert haben. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).

**So verbinden Sie eine DB-Instance von RDS für Db2 mit IBM CLPPlus**

1. Überprüfen Sie die Befehlssyntax. Ersetzen Sie im folgenden Beispiel *clientDir* durch den Speicherort, an dem der Client installiert ist. 

   ```
   cd clientDir/bin
       ./clpplus -h
   ```

1. Konfigurieren Sie Ihren Db2-Server. Ersetzen Sie *dsn\$1name* im folgenden Beispiel,, und *port* durch den DSN-Namen*endpoint*, den Datenbanknamen, den Endpunkt und den Port für Ihre RDS for Db2-DB-Instance. *database\$1name* Weitere Informationen finden Sie unter [Ermitteln des Endpunkts Ihrer DB-Instance von Amazon RDS für Db2](db2-finding-instance-endpoint.md).

   ```
   db2cli writecfg add -dsn dsn_name -database database_name -host endpoint -port port -parameter "Authentication=SERVER_ENCRYPT"
   ```

1. Stellen Sie eine Verbindung mit Ihrer DB-Instance von RDS für Db2 her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *dsn\$1name* durch den Master-Benutzernamen und den DSN-Namen.

   ```
   ./clpplus -nw master_username@dsn_name
   ```

1. Ein Java Shell-Fenster wird geöffnet. Geben Sie das Hauptpasswort für Ihre DB-Instance von RDS für Db2 ein. 
**Anmerkung**  
Wenn kein Java Shell-Fenster geöffnet wird, führen Sie `./clpplus -nw` aus, um dasselbe Befehlszeilenfenster zu verwenden.

   ```
   Enter password: *********
   ```

   Eine Verbindung wird hergestellt und die Ausgabe ist ähnlich dem folgenden Beispiel:

   ```
   Database Connection Information :
   ---------------------------------
   Hostname = database-1.abcdefghij.us-east-1.rds.amazonaws.com
   Database server = DB2/LINUXX8664  SQL110590
   SQL authorization ID = admin
   Local database alias = DB2DB
   Port = 50000
   ```

1. Führen Sie Abfragen aus und sehen Sie sich die Ergebnisse an. Das folgende Beispiel zeigt eine SQL-Anweisung, die die von Ihnen erstellte Datenbank auswählt. 

   ```
   SQL > select current server from sysibm.dual;
   ```

   Die Ausgabe dieses Befehls sieht etwa so aus:

   ```
   1
       --------------------
       DB2DB
       SQL>
   ```

## CLOB-Daten aus gespeicherten Prozeduren abrufen DB2
<a name="db2-connecting-ibm-clpplus-retrieve-clob-data"></a>

Gespeicherte Prozeduren wie rdsadmin.db2pd\$1command geben Ergebnisse in CLOB-Spalten zurück, die bis zu 2 GB an Daten unterstützen. DB2 CLP begrenzt die CLOB-Ausgabe jedoch auf 8 KB (8192 Byte) und kürzt alle Daten, die diesen Schwellenwert überschreiten. Verwenden Sie stattdessen CLPPLUS, um die vollständige Ausgabe abzurufen.

1. Rufen Sie die Task-ID (task\$1id) ab 

   ```
   db2 "select task_id, task_type, database_name, lifecycle, varchar(bson_to_json(task_input_params), 500) as task_params,
   cast(task_output as varchar(500)) as task_output, CREATED_AT, LAST_UPDATED_AT from table(rdsadmin.get_task_status(null,null,null))"
   ```

1. Führen Sie den CLPPLUS-Befehl aus

   Nachdem Sie die task\$1id abgerufen haben, führen Sie den folgenden Befehl an der Unix-Eingabeaufforderung aus (ersetzen Sie TASK\$1ID durch die tatsächliche numerische Aufgaben-ID):

   ```
   $ (echo "select task_output from table(rdsadmin.get_task_status(task_id,null,null));" ; echo "disconnect;" ; echo "exit;") | clpplus -nw -silent masteruser/MasterUserPassword@hostname:port_num/rdsadmin
   ```