Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Connessione a un’istanza database Amazon RDS per Db2 con IBM CLPPlus
Puoi utilizzare un’utilità come IBM CLPPlus per connetterti a un’istanza database Amazon RDS per Db2. Questa utilità fa parte di IBM Data Server Runtime Client. Per scaricare il client** **da IBM Fix Central, consulta [IBM Data Server Client Packages Version 11.5 Mod 8 Fix Pack 0](https://www.ibm.com/support/pages/node/6830885) in IBM Support.
**Importante**
È consigliabile utilizzare IBM CLPPlus su un sistema operativo che supporti interfacce utente grafiche come macOS, Windows o Linux con Desktop. Se esegui Linux headless, utilizza l’opzione **-nw** con i comandi CLPPlus.
**Topics**
+ [Installazione del client](#db2-connecting-ibm-clpplus-install-client)
+ [Connessione a un’istanza database](#db2-connecting-ibm-clpplus-connect-db-instance)
+ [Recupero dei dati CLOB dalle Stored Procedure DB2](#db2-connecting-ibm-clpplus-retrieve-clob-data)
## Installazione del client
Dopo aver scaricato il pacchetto per Linux, installa il client.
**Nota**
Per installare il client su AIX o Windows, segui la stessa procedura modificando i comandi per il tuo sistema operativo.
**Per installare il client su Linux**
1. Esegui **`./db2_install`**.
1. Corri **`clientInstallDir/instance/db2icrt -s client`*instance\$1name***. Sostituisci *instance\$1name* con un utente valido del sistema operativo suLinux. In Linux, il nome dell’istanza database Db2 è legato al nome utente del sistema operativo.
Questo comando crea una directory **`sqllib`** nella home directory dell’utente designato su Linux.
## Connessione a un’istanza database
Per connetterti alla tua istanza database RDS per Db2, devi disporre del relativo DNS e del numero di porta. Per informazioni su come trovarli, consulta [Ricerca dell'endpoint](db2-finding-instance-endpoint.md). Devi anche conoscere il nome del database, il nome utente principale e la password principale definiti al momento della creazione dell’istanza database RDS per Db2. Per ulteriori informazioni su come trovarli, consulta [Creazione di un'istanza database](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
**Per connetterti a un’istanza database RDS per Db2 con IBM CLPPlus**
1. Esamina la sintassi del comando. Nell'esempio seguente, sostituiscilo *clientDir* con la posizione in cui è installato il client.
```
cd clientDir/bin
./clpplus -h
```
1. Configura il tuo server Db2. Nell'esempio seguente, sostituisci, *dsn\$1name* *database\$1name**endpoint*, e *port* con il nome DSN, il nome del database, l'endpoint e la porta per l'istanza DB RDS for Db2. Per ulteriori informazioni, consulta [Ricerca dell’endpoint dell’istanza database RDS per Db2](db2-finding-instance-endpoint.md).
```
db2cli writecfg add -dsn dsn_name -database database_name -host endpoint -port port -parameter "Authentication=SERVER_ENCRYPT"
```
1. Connettiti all’istanza database Amazon RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *dsn\$1name* con il nome utente principale e il nome DSN.
```
./clpplus -nw master_username@dsn_name
```
1. Viene visualizzata una finestra Java Shell. Inserisci la password principale per l’istanza database RDS per Db2.
**Nota**
Se non si apre una finestra Java Shell, esegui `./clpplus -nw` per utilizzare la stessa finestra della riga di comando.
```
Enter password: *********
```
Viene effettuata una connessione e viene restituito un output simile all’esempio seguente:
```
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. Esegui query e visualizza i risultati. L’esempio seguente mostra un’istruzione SQL che seleziona il database creato.
```
SQL > select current server from sysibm.dual;
```
Questo comando genera un output simile all’esempio seguente:
```
1
--------------------
DB2DB
SQL>
```
## Recupero dei dati CLOB dalle Stored Procedure DB2
Le procedure archiviate come rdsadmin.db2pd\$1command restituiscono risultati in colonne CLOB, che supportano fino a 2 GB di dati. Tuttavia, DB2 CLP limita l'output CLOB a 8 KB (8192 byte), troncando tutti i dati oltre questa soglia. Per recuperare l'output completo, utilizzate invece CLPPLUS.
1. Ottieni l'ID dell'attività (task\$1id)
```
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. Esegui il comando CLPPLUS
Dopo aver ottenuto il task\$1id, esegui il seguente comando dal prompt di Unix (sostituisci TASK\$1ID con l'effettivo ID numerico dell'attività):
```
$ (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
```