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à.
# Amazon RDS per Db2
Amazon RDS supporta le istanze database che eseguono le seguenti versioni di IBM Db2:
+ Db2 Standard Edition
+ Db2 Advanced Edition
Amazon RDS supporta le istanze database che eseguono le seguenti versioni di Db2:
+ Db2 11.5
Per ulteriori informazioni sul supporto delle versioni secondarie, consulta [Versioni di Db2 in Amazon RDS](Db2.Concepts.VersionMgmt.md).
Prima di creare un’istanza database, completa i passi indicati nella sezione [Configurazione dell’ambiente Amazon RDS](CHAP_SettingUp.md) di questa guida. Quando crei un’istanza database utilizzando l’utente master, l’utente ottiene l’autorità `DBADM`, con alcune limitazioni. Utilizza questo utente per attività amministrative, ad esempio la creazione di account di database aggiuntivi. Non è possibile utilizzare l’autorità a livello di istanza `SYSADM`, `SYSCTRL`, `SYSMAINT` oppure l’autorità a livello di database `SECADM`.
Puoi creare:
+ Istanze DB
+ Snapshot DB
+ Ripristini point-in-time
+ Backup automatici di archiviazione
+ Backup manuali di archiviazione
Puoi utilizzare istanze database che eseguono Db2 all’interno di un cloud privato virtuale (VPC). Inoltre, puoi abilitare varie opzioni per aggiungere altre funzionalità all’istanza database Amazon RDS per Db2. Amazon RDS supporta le implementazioni Multi-AZ per RDS per Db2 come soluzione failover a elevata disponibilità.
**Importante**
Per offrire un'esperienza di servizio gestito, Amazon RDS non fornisce accesso shell alle istanze database. Limita anche l’accesso ad alcune procedure di sistema e tabelle che richiedono privilegi elevati. Puoi accedere al database utilizzando i client SQL standard come IBM Db2 CLP. Tuttavia, non è possibile accedere direttamente all'host utilizzando Telnet o Secure Shell (SSH).
**Topics**
+ [Panoramica di Db2 su Amazon RDS](db2-overview.md)
+ [Prerequisiti per la creazione di un’istanza database Amazon RDS per Db2](db2-db-instance-prereqs.md)
+ [Più database su un’istanza database Amazon RDS per Db2](db2-multiple-databases.md)
+ [Connessione all’istanza database Db2](USER_ConnectToDb2DBInstance.md)
+ [Protezione delle connessioni all’istanza database Amazon RDS per Db2](Db2.Concepts.RestrictedDBAPrivileges.md)
+ [Amministrazione dell’istanza database Amazon RDS per Db2](db2-administering-db-instance.md)
+ [Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3](db2-s3-integration.md)
+ [Migrazione di dati in Amazon RDS per Db2](db2-migrating-data-to-rds.md)
+ [Federazione per Amazon RDS per Db2](db2-federation.md)
+ [Utilizzo delle repliche in Amazon RDS per Db2](db2-replication.md)
+ [Opzioni per le istanze database Amazon RDS per Db2](Db2.Options.md)
+ [Stored procedure esterne per Amazon RDS per Db2](db2-external-stored-procedures.md)
+ [Problemi noti e limitazioni per Amazon RDS per Db2](db2-known-issues-limitations.md)
+ [Informazioni di riferimento sulle stored procedure di Amazon RDS per Db2](db2-stored-procedures.md)
+ [Informazioni di riferimento sulle funzioni definite dall’utente di Amazon RDS per Db2](db2-user-defined-functions.md)
+ [Risoluzione dei problemi relativi ad Amazon RDS per Db2](db2-troubleshooting.md)
# Panoramica di Db2 su Amazon RDS
Le sezioni seguenti includono una panoramica di Db2 su Amazon RDS.
**Topics**
+ [Funzionalità di Amazon RDS per Db2](Db2.Concepts.FeatureSupport.md)
+ [Versioni di Db2 in Amazon RDS](Db2.Concepts.VersionMgmt.md)
+ [Opzioni di licenza per Amazon RDS per Db2](db2-licensing.md)
+ [Amazon RDS per classi di istanza Db2](Db2.Concepts.General.InstanceClasses.md)
+ [Ruoli predefiniti di Amazon RDS per Db2](db2-default-roles.md)
+ [Parametri di Amazon RDS per Db2](db2-supported-parameters.md)
+ [Regole di confronto EBCDIC per i database Db2 su Amazon RDS](db2-ebcdic.md)
+ [Fuso orario locale per istanze database Amazon RDS per Db2](db2-time-zone.md)
# Funzionalità di Amazon RDS per Db2
Amazon RDS per Db2 supporta la maggior parte delle caratteristiche e funzionalità del database IBM Db2. Alcune funzionalità potrebbero avere un supporto o privilegi limitati. Per ulteriori informazioni sulle funzionalità del database Db2 per versioni specifiche di Db2, consulta la [documentazione di IBM Db2](https://www.ibm.com/docs/en/db2).
Puoi filtrare le nuove funzionalità di Amazon RDS alla pagina [Quali sono le novità del database?](https://aws.amazon.com/about-aws/whats-new/database/). Per **Prodotti**, scegli **Amazon RDS**. Quindi, esegui la ricerca utilizzando parole chiave come **Db2 2023**.
**Nota**
I seguenti elenchi non sono esaustivi.
**Topics**
+ [Funzionalità supportate in RDS per Db2](#db2-supported-features)
+ [Funzionalità non supportate in RDS per Db2](#db2-unsupported-features)
## Funzionalità supportate in RDS per Db2
RDS per Db2 supporta le funzionalità native di IBM Db2 e le funzionalità di base di Amazon RDS.
### Funzionalità native di IBM Db2
RDS per Db2 supporta le seguenti funzionalità dei database Db2:
+ Creazione di un database standard che utilizza un set di codici, regole di confronto, dimensioni della pagina e territorio definiti dal cliente. Utilizza la stored procedure [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) di Amazon RDS.
+ Aggiunta, eliminazione o modifica di utenti e gruppi locali. Utilizza le stored procedure di Amazon RDS per [Stored procedure per la concessione e la revoca dei privilegi per RDS per Db2](db2-sp-granting-revoking-privileges.md).
+ Creazione di ruoli con la stored procedure [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role) di Amazon RDS.
+ Supporto per tabelle organizzate a righe standard.
+ Supporto per il carico di lavoro analitico per tabelle organizzate in colonne.
+ Capacità di definire funzionalità di compatibilità con Db2, ad esempio Oracle e MySQL.
+ Supporto per stored procedure esterne basate su Java.
+ Supporto per la crittografia dei dati in transito tramite SSL/TLS.
+ Monitoraggio dello stato di un database (`ALIVE`, `DOWN`, `STORAGE_FULL`, `UNKNOWN` e `STANDBY_CONNECTABLE`).
+ Ripristino di un database Linux (LE) offline o online fornito dal cliente. Utilizzo delle stored procedure di Amazon RDS per [Stored procedure relative ai database per RDS per Db2](db2-sp-managing-databases.md).
+ Applicazione di log di archivio Db2 forniti dal cliente per mantenere il database sincronizzato con i database Db2 autogestiti. Utilizzo delle stored procedure di Amazon RDS per [Stored procedure relative ai database per RDS per Db2](db2-sp-managing-databases.md).
+ Supporto per l’auditing a livello di database e di istanza Db2.
+ Supporto per una federazione omogenea.
+ Capacità di caricare una tabella dai file di dati in Amazon Simple Storage Service (Amazon S3).
+ Autorizzazioni concesse a utenti, gruppi o ruoli, ad esempio `CONNECT`, `SYSMON`, `ACCESSCTRL`, `DATAACCESS`, `SQLADM`, `WLMADM`, `EXPLAIN`, `LOAD` o `IMPLICIT_SCHEMA`.
+ Creazione di più database.
**Nota**
Ogni istanza database RDS per Db2 può contenere al massimo 50 database. Per ulteriori informazioni, consulta [Più database su un’istanza database Amazon RDS per Db2](db2-multiple-databases.md).
### Funzionalità di base di Amazon RDS
RDS per Db2 supporta le seguenti funzionalità di base di Amazon RDS:
+ Gruppi di parametri personalizzati da assegnare alle istanze database
+ Creazione, modifica ed eliminazione di istanze database
+ Ripristino di un backup del database Db2 offline o online autogestito Linux (LE)
**Nota**
Per poter ripristinare il backup, non specificare un nome per il database quando crei un’istanza database. Per ulteriori informazioni, consulta [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md).
+ Supporto per i tipi di archiviazione gp3, io2 e io1
+ Uso di AWS Managed Microsoft AD per Kerberos l'autenticazione e l'autorizzazione di gruppo LDAP per RDS for Db2
+ Modifica di gruppi di sicurezza, porte, tipi di istanze, archiviazione, periodi di conservazione dei backup e altre impostazioni per le istanze Db2 esistenti
+ Protezione dall’eliminazione per le istanze database
+ point-in-timeRipristino interregionale (PITR), incluso per backup crittografati
+ Utilizzo di AWS Key Management Service (AWS KMS) per la crittografia dello storage e la crittografia a riposo
+ Istanze database Multi-AZ con un unico standby per un’elevata disponibilità
+ Riavvii delle istanze database
+ Aggiornamenti delle password principali
+ Ripristino delle istanze database a un orario specifico
+ Backup e ripristino di istanze database tramite backup a livello di archiviazione
+ Avvio e arresto delle istanze database
+ Manutenzione delle istanze database
+ Repliche in standby e di lettura nella stessa Regione e multi-Regione
## Funzionalità non supportate in RDS per Db2
RDS per Db2 non supporta le seguenti funzionalità dei database Db2:
+ Accesso `SYSADM`, `SECADM` e `SYSMAINT` per l’utente master.
+ Stored procedure esterne scritte in C, C\$1\$1 o Cobol.
+ Più istanze database Db2 su un singolo host.
+ Plugin GSS-API esterni per l’autenticazione.
+ Plugin esterni di terze parti per il backup o il ripristino dei database Db2.
+ Elaborazione MPP (Massively Parallel Processing) multinodo, ad esempio IBM Db2 Warehouse.
+ IBM Db2 pureScale.
+ Configurazione manuale di High Availability Disaster Recovery (HADR) per RDS per Db2.
**Nota**
Amazon RDS supporta e gestisce HADR per RDS per Db2 tramite repliche. Per ulteriori informazioni, consulta [Utilizzo delle repliche in Amazon RDS per Db2](db2-replication.md).
RDS per Db2 supporta implementazioni Multi-AZ, oltre a backup automatici e repliche multi-Regione. Per ulteriori informazioni, consultare [Implementazioni di istanze database Multi-AZ per Amazon RDS](Concepts.MultiAZSingleStandby.md) e [Replica dei backup automatici su un altro Regione AWS](USER_ReplicateBackups.md).
+ Crittografia di database nativa.
+ Federazione eterogenea a Informix, Sybase e Teradata. Per ulteriori informazioni, consulta [Federazione per Amazon RDS per Db2](db2-federation.md).
+ Creazione di routine non recintate e migrazione di routine non recintate esistenti tramite il backup e il ripristino dei dati. Per ulteriori informazioni, consulta [Routine non recintate](db2-known-issues-limitations.md#db2-known-issues-limitations-non-fenced-routines).
+ Creazione di nuovi tablespace di archiviazione non automatici. Per ulteriori informazioni, consulta [Tablespace di archiviazione non automatici durante la migrazione](db2-known-issues-limitations.md#db2-known-issues-limitations-non-automatic-storage-tablespaces).
+ Tabelle esterne.
# Versioni di Db2 in Amazon RDS
Per Db2, i numeri di versione hanno il formato *principale.secondaria.build.revisione*, ad esempio 11.5.9.0.sb00000000.r1. La nostra implementazione di versione corrisponde a quella di Db2.
**principale**
Il numero di versione principale è costituito dal numero intero e dalla prima parte frazionaria del numero di versione, ad esempio 11.5. Una modifica di versione è considerata principale se il numero di versione principale cambia, ad esempio in caso di passaggio dalla versione 11.5 alla 12.1.
**minore**
Il numero di versione secondaria è costituito dalla terza e dalla quarta parte del numero di versione, ad esempio 9.0 in 11.5.9.0. La terza parte indica il modpack Db2, ad esempio 9 in 9.0. La quarta parte indica il fixpack Db2, ad esempio 0 in 9.0. Una modifica di versione è considerata secondaria se il modpack Db2 o il fixpack Db2 cambia, ad esempio in caso di passaggio dalla versione 11.5.9.0 alla 11.5.9.1 o dalla versione 11.5.9.0 alla 11.5.10.0, con eccezioni relative agli aggiornamenti delle tabelle di catalogo. Amazon RDS tiene conto di queste eccezioni.
**costruire**
Il numero di build è costituito dalla quinta parte del numero di versione, ad esempio sb00000000 in 11.5.9.0.sb00000000. Un numero di build in cui la parte numerica è composta interamente da zero indica una build standard. Un numero di build in cui la parte numerica non è composta interamente da zero indica una build speciale. Il numero di build cambia in caso di correzione di sicurezza o di build speciale di una versione di Db2 esistente. Una variazione del numero di build indica anche che Amazon RDS ha applicato automaticamente una nuova versione secondaria.
**revisione**
Il numero di revisione è costituito dalla quinta parte del numero di versione, ad esempio r1 in 11.5.9.0.sb00000000.r1. Una revisione è una revisione di Amazon RDS a una versione di Db2 esistente. Una variazione del numero di revisione indica che Amazon RDS ha applicato automaticamente una nuova versione secondaria.
**Topics**
+ [Gestione degli upgrade per le istanze Amazon RDS Db2](Db2.Concepts.VersionMgmt.Supported.md)
+ [Versioni principali di Db2 supportate in Amazon RDS](#Db2.Concepts.VersionMgmt.ReleaseCalendar)
# Gestione degli upgrade per le istanze Amazon RDS Db2
Per visualizzare l'elenco corrente delle versioni secondarie di Db2 supportate su RDS, utilizzate uno dei seguenti comandi:
```
aws rds describe-db-engine-versions --engine db2-se
aws rds describe-db-engine-versions --engine db2-ae
```
Amazon RDS supporta anche la politica di implementazione degli aggiornamenti per gestire gli aggiornamenti automatici delle versioni secondarie su più risorse di database e. Account AWS Per ulteriori informazioni, consulta [Utilizzo della politica di implementazione degli AWS Organizations aggiornamenti per gli aggiornamenti automatici delle versioni secondarie](RDS.Maintenance.AMVU.UpgradeRollout.md).
Quando crei una nuova istanza database, puoi specificare qualsiasi versione di Db2 attualmente supportata. Puoi specificare la versione principale (ad esempio, Db2 11.5) e qualsiasi versione secondaria supportata per la versione principale specificata. Se non viene specificata alcuna versione, Amazon RDS utilizza per impostazione predefinita una versione supportata, in genere la più recente. Se viene specificata una versione principale ma non una secondaria, per impostazione predefinita Amazon RDS utilizza una release recente della versione principale specificata. Per visualizzare un elenco delle versioni supportate, nonché le impostazioni predefinite per le istanze DB appena create, usa il comando (). [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) AWS Command Line Interface AWS CLI
Ad esempio, per elencare le versioni del motore supportate per Amazon RDS per Db2, esegui il comando AWS CLI seguente. Sostituisci con il tuo*region*. Regione AWS
Per Linux, macOS o Unix:
```
aws rds describe-db-engine-versions \
--filters Name=engine,Values=db2-ae,db2-se \
--query "DBEngineVersions[].{Engine:Engine, EngineVersion:EngineVersion, DBParameterGroupFamily:DBParameterGroupFamily}" \
--region region
```
Per Windows:
```
aws rds describe-db-engine-versions ^
--filters Name=engine,Values=db2-ae,db2-se ^
--query "DBEngineVersions[].{Engine:Engine, EngineVersion:EngineVersion, DBParameterGroupFamily:DBParameterGroupFamily}" ^
--region region
```
Questo comando genera un output simile all’esempio seguente:
```
[
{
"Engine": "db2-ae",
"EngineVersion": "11.5.9.0.sb00000000.r1",
"DBParameterGroupFamily": "db2-ae-11.5"
},
{
"Engine": "db2-se",
"EngineVersion": "11.5.9.0.sb00000000.r1",
"DBParameterGroupFamily": "db2-se-11.5"
}
]
```
La versione predefinita di Db2 potrebbe variare in base alla Regione AWS. Per creare un'istanza DB con una versione secondaria specifica, specifica la versione secondaria durante la creazione dell'istanza DB. È possibile determinare la versione predefinita per an Regione AWS for `db2-ae` e i motori di `db2-se` database eseguendo il ` describe-db-engine-versions` comando. L’esempio seguente restituisce la versione predefinita per `db2-ae` in Stati Uniti orientali (Virginia settentrionale).
Per Linux, macOS o Unix:
```
aws rds describe-db-engine-versions \
--default-only --engine db2-ae \
--query "DBEngineVersions[].{Engine:Engine, EngineVersion:EngineVersion, DBParameterGroupFamily:DBParameterGroupFamily}" \
--region us-east-1
```
Per Windows:
```
aws rds describe-db-engine-versions ^
--default-only --engine db2-ae ^
--query "DBEngineVersions[].{Engine:Engine, EngineVersion:EngineVersion, DBParameterGroupFamily:DBParameterGroupFamily}" ^
--region us-east-1
```
Questo comando genera un output simile all’esempio seguente:
```
[
{
"Engine": "db2-ae",
"EngineVersion": "11.5.9.0.sb00000000.r1",
"DBParameterGroupFamily": "db2-ae-11.5"
}
]
```
Con Amazon RDS, puoi controllare quando eseguire l’aggiornamento dell’istanza Db2 a una nuova versione supportata da Amazon RDS. Puoi mantenere la compatibilità con versioni specifiche di Db2, testare le nuove versioni con l’applicazione prima di distribuirle in produzione e aggiornare le versioni principali quando è più appropriato in base alla tua pianificazione.
Quando l’aggiornamento automatico della versione secondaria è abilitato, le istanze database vengono aggiornate automaticamente alle nuove versioni secondarie di Db2 in quanto sono supportate da Amazon RDS. L'applicazione di patch avviene durante la finestra di manutenzione pianificata. È possibile modificare un'istanza DB per abilitare o disabilitare gli aggiornamenti automatici delle versioni secondarie.
Ad eccezione delle versioni 11.5.9.1 e 11.5.10.0 di Db2, gli aggiornamenti automatici alla nuova versione secondaria di Db2 includono aggiornamenti automatici a nuove build e revisioni. Per 11.5.9.1 e 11.5.10.0, aggiorna le versioni secondarie manualmente.
Se annulli gli aggiornamenti automatici pianificati, puoi eseguire manualmente l'aggiornamento a una versione secondaria supportata seguendo la stessa procedura utilizzata per l'aggiornamento di una versione principale. Per informazioni, consulta [Aggiornamento della versione del motore di di un'istanza database](USER_UpgradeDBInstance.Upgrading.md).
## Versioni principali di Db2 supportate in Amazon RDS
Il supporto standard delle versioni principali di RDS per Db2 resta disponibile almeno fino alla fine del supporto (base) di IBM per la versione di IBM corrispondente. Nella seguente tabella sono elencate le date che è possibile utilizzare per pianificare i cicli di test e aggiornamento. Se Amazon estende il supporto per una versione RDS per Db2 più a lungo di quanto inizialmente previsto, questa tabella verrà aggiornata in base alla nuova data.
È possibile utilizzare le date seguenti per pianificare i cicli di test e aggiornamento.
**Nota**
Le date con solo un mese e un anno sono approssimative e vengono aggiornate con una data esatta quando nota.
È possibile visualizzare le versioni principali dei database Db2 eseguendo il AWS CLI comando [describe-db-major-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-major-engine-versions.html) o utilizzando l'operazione [Descrivi DBMajor EngineVersions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBMajorEngineVersions.html) RDS API.
| Versione principale di Db2 | Data di rilascio IBM | Data di rilascio per RDS | Fine del supporto IBM (Standard e Advanced Edition) | Fine del supporto IBM (esteso) |
| --- | --- | --- | --- | --- |
| Db2 11.5 | 27 giugno 2019 | 27 novembre 2023 | 30 aprile 2027 | 30 aprile 2013 |
# Opzioni di licenza per Amazon RDS per Db2
Amazon RDS per Db2 offre due opzioni di licenza: bring your own license (BYOL) e Db2 license through. Marketplace AWS
**Topics**
+ [Uso di licenze proprie (BYOL) per Db2](#db2-licensing-options-byol)
+ [Licenza Db2 tramite Marketplace AWS](#db2-licensing-options-marketplace)
+ [Passaggio da una licenza Db2 all’altra](#db2-edition-license-switching)
## Uso di licenze proprie (BYOL) per Db2
Il modello BYOL, è possibile utilizzare le licenze di database Db2 esistenti per implementare database su Amazon RDS. Verifica di disporre della licenza del database Db2 appropriata per la classe di istanza database e l’edizione del database Db2 che desideri eseguire. È inoltre necessario rispettare le policy IBM per la licenza del software di database IBM nell’ambiente di cloud computing.
**Nota**
Le istanze database Multi-AZ sono standby a freddo perché il database Db2 è installato ma non è in esecuzione. Gli standby non sono leggibili, non sono in esecuzione o non soddisfano le richieste. Per ulteriori informazioni, consulta [IBM Db2 licensing information]( https://www.ibm.com/support/customer/csol/terms/licenses#license-search) sul sito web IBM.
Con questo modello di licenza, continui a usare l’account di supporto IBM attivo e contatti direttamente IBM per le richieste di assistenza per il database Db2. Se disponi di un Supporto account con assistenza clienti, puoi contattarci Supporto per problemi relativi ad Amazon RDS. Amazon Web Services e IBM offrono una procedura di assistenza multi-fornitore per i casi che richiedono l’intervento di entrambe le organizzazioni.
Amazon RDS supporta il modello BYOL per Db2 Standard Edition e Db2 Advanced Edition.
**Topics**
+ [IBM IDs per portare la propria licenza (BYOL) per Db2](#db2-prereqs-ibm-info)
+ [Aggiunta IBM IDs a un gruppo di parametri per RDS per istanze DB Db2](#db2-licensing-options-byol-adding-ids)
+ [Integrazione con AWS License Manager](#db2-lms-integration)
### IBM IDs per portare la propria licenza (BYOL) per Db2
Nel modello BYOL, è necessario disporre dell’IBM Customer ID e dell’IBM Site ID per creare, modificare o ripristinare istanze database RDS per Db2. Devi creare un gruppo di parametri personalizzato con il tuo IBM Customer ID e il tuo IBM Site ID *prima* di creare un’istanza database RDS per Db2. Per ulteriori informazioni, consulta [Aggiunta IBM IDs a un gruppo di parametri per RDS per istanze DB Db2](#db2-licensing-options-byol-adding-ids). È possibile eseguire più istanze database RDS per Db2 con IBM Customer IDs e IBM Site IDs diversi nello stesso Account AWS o nella stessa Regione AWS.
**Importante**
Se la verifica della licenza attraverso l’IBM Customer ID e l’IBM Site ID non riesce, è possibile che vengano terminate tutte le istanze database in esecuzione con queste licenze non verificate.
Se sei un nuovo cliente IBM Db2, devi prima acquistare una licenza software Db2 da [https://www.ibm.com/products/db2/pricing](https://www.ibm.com/products/db2/pricing). Dopo aver acquistato una licenza software Db2, riceverai un Proof of Entitlement da IBM che elenca il tuo IBM Customer ID e il tuo IBM Site ID.
Se sei già cliente IBM Db2, puoi trovare il tuo IBM Customer ID e il tuo IBM Site ID sul certificato Proof of Entitlement fornito da IBM.
Puoi trovare il tuo IBM Customer ID e il tuo IBM Site ID anche nel tuo account [IBM Passport Advantage Online](https://www.ibm.com/software/passportadvantage/pao_customer.html). Dopo aver effettuato l'accesso, è possibile visualizzarli entrambi IDs nella pagina principale o nella pagina di download del software.
### Aggiunta IBM IDs a un gruppo di parametri per RDS per istanze DB Db2
Poiché non è possibile modificare i gruppi di parametri predefiniti, devi creare un gruppo di parametri personalizzato e modificarlo per includere i valori relativi al tuo IBM Customer ID e al tuo IBM Site ID. Per informazioni sui gruppi di parametri, consultare [Gruppi di parametri database per istanze database Amazon RDS](USER_WorkingWithDBInstanceParamGroups.md).
**Importante**
Devi creare un gruppo di parametri personalizzato con il tuo IBM Customer ID e il tuo IBM Site ID *prima* di creare un’istanza database RDS per Db2.
Utilizza le impostazioni dei parametri riportate nella tabella seguente.
| Parametro | Valore |
| --- | --- |
| `rds.ibm_customer_id` | `` |
| `rds.ibm_site_id` | `` |
| `ApplyMethod` | `immediate`, `pending-reboot` |
Questi parametri sono dinamici, ovvero le modifiche apportate hanno effetto immediato e non è necessario riavviare l’istanza database. Se non desideri che le modifiche abbiano effetto immediato, puoi impostare `pending-reboot` su `ApplyMethod` e programmarle in modo che vengano applicate durante una finestra di manutenzione.
Puoi creare e modificare un’istanza database utilizzando la Console di gestione AWS, la AWS CLI o l’API Amazon RDS.
#### Console
**Per aggiungere il tuo IBM Customer ID e il tuo IBM Site ID a un gruppo di parametri**
1. Crea un nuovo gruppo di parametri database. Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Modifica il gruppo di parametri che hai creato. Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
#### AWS CLI
**Per aggiungere il tuo IBM Customer ID e il tuo IBM Site ID a un gruppo di parametri**
1. Crea un gruppo di parametri personalizzato eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html).
Includi le seguenti opzioni obbligatorie:
+ `--db-parameter-group-name`: un nome per il gruppo di parametri che stai creando.
+ `--db-parameter-group-family`: l’edizione e la versione principale del motore Db2. Valori validi: `db2-se-11.5`, `db2-ae-11.5`.
+ `--description`: una descrizione di questo gruppo di parametri.
Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Modifica i parametri nel gruppo di parametri personalizzato eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html).
Includi le seguenti opzioni obbligatorie:
+ `--db-parameter-group-name`: il nome del gruppo di parametri creato.
+ `--parameters`: un array di nomi di parametri, valori e metodi di applicazione per l’aggiornamento del parametro.
Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
#### API RDS
**Per aggiungere il tuo IBM Customer ID e il tuo IBM Site ID a un gruppo di parametri**
1. Crea un gruppo di parametri database utilizzando l’operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) dell’API Amazon RDS.
Includi i parametri obbligatori seguenti:
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Modifica i parametri nel gruppo di parametri personalizzato creato utilizzando l’operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) dell’API RDS.
Includi i parametri obbligatori seguenti:
+ `DBParameterGroupName`
+ `Parameters`
Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
A questo punto puoi creare un’istanza database e collegare il gruppo di parametri personalizzato all’istanza database. Per ulteriori informazioni, consultare [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md) e [Associazione di un gruppo di parametri database a un’istanza database in Amazon RDS](USER_WorkingWithParamGroups.Associating.md).
### Integrazione con AWS License Manager
Per facilitare il monitoraggio dell’utilizzo delle licenze RDS per Db2 nel modello BYOL, [AWS License Manager](https://aws.amazon.com/license-manager/) si integra con RDS per Db2. License Manager supporta il tracciamento delle edizioni del motore RDS for Db2 basate su virtual CPUs (vCPUs). È inoltre possibile utilizzare License Manager con AWS Organizations per gestire centralmente tutti gli account aziendali.
Per monitorare l’utilizzo delle licenze delle tue istanze database RDS per Db2, devi creare licenze autogestite. È possibile creare licenze autogestite utilizzando Console di gestione AWS, la AWS License Manager CLI e l'API. AWS License Manager In alternativa, puoi automatizzare la creazione di licenze autogestite con modelli e. CloudFormation Terraform
Le risorse RDS per Db2 corrispondenti al filtro delle informazioni sul prodotto vengono associate automaticamente alla configurazione della licenza. L’individuazione delle istanze database RDS per Db2 può richiedere fino a 24 ore.
La tabella seguente mostra i valori disponibili per il filtro delle informazioni sul prodotto Engine Edition per RDS per Db2.
| Valore | Description |
| --- | --- |
| `db2-se` | Db2 Standard Edition |
| `db2-ae` | Db2 Advanced Edition |
**Topics**
+ [Terminologia](#db2-lms-integration-terms)
+ [Creazione di una licenza autogestita in AWS License Manager](#db2-lms-integration-tracking)
+ [Automatizzazione della creazione di licenze autogestite con modelli AWS License Manager](#db2-lms-integration-templates)
+ [Impostazioni per la creazione di licenze autogestite](#db2-settings-lms)
#### Terminologia
Questa pagina utilizza la seguente terminologia per discutere dell'integrazione di Amazon RDS con. AWS License Manager
Licenza autogestita
Licenza autogestita è un termine usato in. AWS License Manager La console Amazon RDS fa riferimento alla licenza come AWS License Manager configurazione. Una licenza autogestita contiene le regole di licenza basate sui termini dei tuoi accordi aziendali. Le regole che crei determinano il modo in cui AWS elabora i comandi che utilizzano le licenze. Durante la creazione di una licenza autogestita, lavora a stretto contatto con il team di conformità della tua organizzazione per rivedere gli accordi aziendali. Per ulteriori informazioni, consulta [Self-managed licenses in License Manager](https://docs.aws.amazon.com/license-manager/latest/userguide/license-configurations.html).
#### Creazione di una licenza autogestita in AWS License Manager
È possibile creare una licenza autogestita utilizzando Console di gestione AWS, la AWS License Manager CLI e AWS License Manager l'API.
**Nota**
Se crei un'istanza DB RDS for Db2 utilizzando Console di gestione AWS, creerai una licenza autogestita inserendo un nome per la licenza. L’istanza database verrà quindi associata da Amazon RDS a questa licenza (Nella console Amazon RDS, questa licenza viene definita AWS License Manager configurazione.) Se desideri creare un'istanza DB RDS for Db2 utilizzando la AWS License Manager CLI o l' AWS License Manager API, devi prima creare una licenza autogestita con i seguenti passaggi. La stessa situazione si applica al ripristino di un’istanza database RDS per Db2 a un determinato punto nel tempo o da uno snapshot.
##### Console
**Per creare una licenza autogestita per monitorare l’utilizzo delle licenze delle tue istanze database RDS per Db2**
1. Passa a [https://console.aws.amazon.com/license-manager/](https://console.aws.amazon.com/license-manager/).
1. Crea una licenza autogestita.
Per istruzioni, consulta [Create a self-managed license](https://docs.aws.amazon.com/license-manager/latest/userguide/create-license-configuration.html) nella *Guida per l’utente di AWS License Manager *.
Aggiungere una regola per un **RDS Product Information Filter (Filtro di informazioni sui prodotti RDS)** nel pannello **Product Information (Informazioni sul prodotto)** .
Per ulteriori informazioni, consulta [ProductInformation](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_ProductInformation.html) nella *documentazione di riferimento dell’API AWS License Manager *.
##### AWS License Manager CLI
**Nota**
Questa procedura utilizza un comando AWS License Manager CLI.
Per creare una licenza autogestita utilizzando AWS CLI, esegui il comando. AWS License Manager [create-license-configuration](https://docs.aws.amazon.com/cli/latest/reference/license-manager/create-license-configuration.html) Usa l’opzione `--cli-input-yaml` o `--cli-input-json` per passare le opzioni al comando.
Per ulteriori informazioni, consulta [Impostazioni per la creazione di licenze autogestite](#db2-settings-lms).
Il comando seguente crea una licenza autogestita per Db2 Standard Edition.
```
aws license-manager create-license-configuration --cli-input-json file://rds-db2-se.json
```
Il seguente codice JSON è il contenuto del file `rds-db2-se.json` utilizzato nel comando precedente.
```
{
"Name": "rds-db2-se",
"Description": "RDS Db2 Standard Edition",
"LicenseCountingType": "vCPU",
"LicenseCountHardLimit": false,
"ProductInformationList": [
{
"ResourceType": "RDS",
"ProductInformationFilterList": [
{
"ProductInformationFilterName": "Engine Edition",
"ProductInformationFilterValue": ["db2-se"],
"ProductInformationFilterComparator": "EQUALS"
}
]
}
]
}
```
Per ulteriori informazioni sul prodotto, consulta la pagina relativa all'[individuazione automatica dell'inventario delle risorse](https://docs.aws.amazon.com/license-manager/latest/userguide/automated-discovery.html) nella *Guida per l'utente di AWS License Manager *.
Per ulteriori informazioni sul parametro `--cli-input`, consulta [Generazione di parametri di input e skeleton AWS CLI da un file di input JSON o YAML](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-skeleton.html) nella *Guida per l’utente di AWS CLI *.
##### AWS License Manager API
**Nota**
Questa procedura utilizza un comando AWS License Manager API.
Per creare una licenza autogestita, utilizza l'operazione [https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CreateLicenseConfiguration.html](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CreateLicenseConfiguration.html) AWS License Manager API con i seguenti parametri richiesti:
+ `Name`
+ `LicenseCountingType`
+ `ProductInformationList`
+ `ResourceType`
+ `ProductInformationFilterList`
+ `ProductInformationFilterName`
+ `ProductInformationFilterValue`
+ `ProductInformationFilterComparator`
Per ulteriori informazioni sui parametri, consulta [Impostazioni per la creazione di licenze autogestite](#db2-settings-lms).
#### Automatizzazione della creazione di licenze autogestite con modelli AWS License Manager
È possibile automatizzare la creazione di licenze autogestite utilizzando modelli e. CloudFormation Terraform
Il seguente CloudFormation modello di esempio crea licenze autogestite per Db2 Standard Edition su RDS per Db2. Per un modello per Db2 Advanced Edition, aggiorna i valori relativi a `Name`, `Description` e `ProductInformationFilter`.
```
AWSTemplateFormatVersion: "2010-09-09"
Description: CloudFormation template to create a License Configuration for Db2 Standard Edition on RDS for Db2.
Resources:
Db2LicenseConfiguration:
Type: "AWS::LicenseManager::LicenseConfiguration"
Properties:
Name: "rds-db2-se"
Description: "Db2 Standard Edition on RDS for Db2"
LicenseCountingType: "vCPU"
LicenseCountHardLimit: false
ProductInformationList:
- ResourceType: "RDS"
ProductInformationFilterList:
- ProductInformationFilterName: "Engine Edition"
ProductInformationFilterValue:
- "db2-se"
ProductInformationFilterComparator: "EQUALS"
```
Per ulteriori informazioni sull'utilizzo CloudFormation con Amazon RDS, consulta[Creazione di risorse Amazon RDS Aurora con AWS CloudFormation](creating-resources-with-cloudformation.md).
Il seguente modello Terraform di esempio crea licenze autogestite per Db2 Standard Edition su RDS per Db2. Sostituisci *us-east-1* con il tuo. Regione AWS Per un modello per Db2 Advanced Edition, aggiorna i valori relativi a `name`, `description` e `product_information_filter`.
```
provider "aws" {
region = "us-east-1"
}
resource "aws_licensemanager_license_configuration" "rds_db2_license_config" {
name = "rds-db2-se"
description = "Db2 Standard Edition on RDS for Db2
license_counting_type = "vCPU"
license_count_hard_limit = false
product_information_list {
resource_type = "RDS"
product_information_filter {
name = "Engine Edition"
comparator = "EQUALS"
value = ["db2-se"]
}
}
}
```
*Per ulteriori informazioni sull'utilizzo Terraform di Amazon RDS, consulta [Using Terraform as an an IaC tool for the Cloud AWS and Best practice for using the](https://docs.aws.amazon.com/prescriptive-guidance/latest/choose-iac-tool/terraform.html) [Terraform AWS Provider](https://docs.aws.amazon.com/prescriptive-guidance/latest/terraform-aws-provider-best-practices/introduction.html) in AWS Prescriptive Guidance.*
#### Impostazioni per la creazione di licenze autogestite
Nella tabella seguente, puoi trovare dettagli sulle impostazioni per la creazione di licenze autogestite utilizzando la AWS License Manager CLI, l' AWS License Manager API, un CloudFormation modello e un modello. Terraform Il nome del parametro nella tabella seguente viene visualizzato nel formato del nome utilizzato nell' AWS License Manager API e nel modello. CloudFormation
| Nome del parametro | Tipo di dati | Richiesto | Description |
| --- | --- | --- | --- |
| Nome | stringa | Sì | Nome della configurazione di licenza. |
| Description | stringa | No | Descrizione della configurazione di licenza. |
| LicenseCountingType | stringa | Sì | Dimensione utilizzata per tenere traccia dell’inventario delle licenze. Valore valido: `vCPU`. |
| LicenseCountHardLimit | booleano | No | Indica se viene utilizzata l’applicazione rigida o flessibile delle licenze. Il superamento di un limite rigido impedisce il lancio di nuove istanze. |
| ProductInformationList | array di oggetti | Sì | Elenco di informazioni sul prodotto per una configurazione di licenza. |
| ResourceType | stringa | Sì | Il tipo di risorsa. Valore valido: `RDS`. |
| ProductInformationFilterList | array di oggetti | Sì | Elenco di filtri di informazioni sul prodotto per una configurazione di licenza. |
| ProductInformationFilterName | stringa | Sì | Nome del tipo di filtro dichiarato. Valore valido: `Engine Edition`. |
| ProductInformationFilterValue | matrice di stringhe | Sì | Il valore da filtrare. Devi specificare un solo valore. Valori validi: `db2-se` o `db2-ae`. |
| ProductInformationFilterComparator | stringa | Sì | L’operatore logico per ProductInformationFilterName. Valore valido: EQUALS. |
## Licenza Db2 tramite Marketplace AWS
Nella licenza Db2 through Marketplace AWS model, si paga una tariffa oraria per abbonarsi alle licenze Db2. Questo modello consente di iniziare rapidamente a utilizzare RDS per Db2 senza dover acquistare licenze.
Per utilizzare la licenza Db2 tramite Marketplace AWS, è necessario un Marketplace AWS abbonamento attivo per la particolare IBM Db2 edizione che si desidera utilizzare. Se non ne disponi, [abbonati a Marketplace AWS](#db2-marketplace-subscribing-registering) per quell’edizione di IBM Db2.
Amazon RDS supporta la licenza Db2 Marketplace AWS per IBM Db2 Standard Edition e IBM Db2 Advanced Edition.
**Topics**
+ [Terminologia](#db2-marketplace-terminology)
+ [Pagamenti e fatturazione](#db2-marketplace-billing)
+ [Abbonamento a prodotti Db2 Marketplace e registrazione in IBM](#db2-marketplace-subscribing-registering)
+ [Ottenere un’offerta privata](#db2-marketplace-private-offer)
### Terminologia
Questa pagina utilizza la seguente terminologia per discutere dell'integrazione di Amazon RDS con. Marketplace AWS
Abbonamento SaaS
Nel Marketplace AWS, i prodotti software-as-a-service (SaaS) come il modello di pay-as-you-go licenza adottano un modello di abbonamento basato sull'utilizzo. IBM, il fornitore di software per Db2, monitora l’utilizzo dell’utente e i prezzi vengono calcolati in base all’uso effettivo.
Offerta pubblica
Le offerte pubbliche consentono di acquistare Marketplace AWS prodotti direttamente da. Console di gestione AWS
Offerta privata
Le offerte private sono un programma di acquisto che consente a venditori e acquirenti di negoziare prezzi personalizzati e termini di contratto di licenza con l'utente finale (EULA) per gli acquisti in. Marketplace AWS
Tariffe Db2 Marketplace
Tariffe applicate per l’utilizzo della licenza del software Db2 da IBM. Questi costi di servizio vengono contabilizzati Marketplace AWS e appaiono sulla fattura AWS nella sezione corrispondente. Marketplace AWS
Tariffe di Amazon RDS
Commissioni AWS addebitate per i servizi RDS per Db2, che escludono le licenze utilizzate per le licenze Db2. Marketplace AWS Le tariffe vengono contabilizzate tramite il servizio Amazon RDS utilizzato e appaiono sulla fattura AWS .
### Pagamenti e fatturazione
RDS for Db2 si integra con per offrire licenze orarie Marketplace AWS per Db2. pay-as-you-go Le tariffe Db2 Marketplace coprono i costi di licenza del software Db2 e le tariffe Amazon RDS coprono i costi di utilizzo dell’istanza database RDS per Db2. Per ulteriori informazioni sui prezzi, consulta [Prezzi di Amazon RDS per Db2](https://aws.amazon.com/rds/db2/pricing/).
Per interrompere l’applicazione di queste tariffe, devi eliminare tutte le istanze database RDS per Db2. Inoltre, puoi rimuovere gli abbonamenti alle licenze For Db2. Marketplace AWS Se rimuovi gli abbonamenti senza eliminare le istanze database, Amazon RDS continuerà ad addebitarti in fattura l’utilizzo delle istanze database. Per ulteriori informazioni, consulta [Eliminazione di un'istanza database](USER_DeleteInstance.md).
[Puoi visualizzare le fatture e gestire i pagamenti per le istanze DB RDS per Db2 che utilizzano la licenza Db2 tramite la console. Marketplace AWSAWS Billing](https://console.aws.amazon.com/billing) Le fatture includono due addebiti: uno per l'utilizzo della licenza Db2 tramite Marketplace AWS e uno per l'utilizzo di Amazon RDS. Per ulteriori informazioni sulla fatturazione, consulta [Visualizzazione di una fattura](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/getting-viewing-bill.html) nella *Guida per l’utente di Gestione dei costi e fatturazione AWS *.
### Abbonamento a prodotti Db2 Marketplace e registrazione in IBM
Per utilizzare la licenza Db2 tramite Marketplace AWS, è necessario utilizzare il Console di gestione AWS per completare le due attività seguenti. Non è possibile completare queste attività tramite l'API RDS AWS CLI o l'API RDS.
**Nota**
Se desideri creare le tue istanze DB utilizzando AWS CLI o l'API RDS, devi prima completare queste due attività.
**Topics**
+ [Attività 1: Abbonarsi a Db2 in Marketplace AWS](#db2-marketplace-subscribing)
+ [Attività 2: registrare l’abbonamento in IBM](#db2-marketplace-registering)
#### Attività 1: Abbonarsi a Db2 in Marketplace AWS
Per utilizzare la licenza Db2 con Marketplace AWS, è necessario disporre di un Marketplace AWS abbonamento attivo per Db2. [Poiché gli abbonamenti sono associati a un'IBM Db2edizione specifica, è necessario abbonarsi a Db2 Marketplace AWS per ogni edizione di Db2 che si desidera utilizzare: [IBM Db2Advanced](https://aws.amazon.com/marketplace/pp/prodview-w6m4yctzzy5fk) Edition, Standard Edition. IBM Db2](https://aws.amazon.com/marketplace/pp/prodview-gbsgwalbkphv6) *Per informazioni sugli Marketplace AWS abbonamenti, consulta Abbonamenti basati sull'[utilizzo Saas nella Guida](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-saas-products.html#saas-pricing-models) all'acquisto.Marketplace AWS *
[Ti consigliamo di abbonarti a Db2 Marketplace AWS*prima* di iniziare a creare un'istanza DB.](USER_CreateDBInstance.md)
#### Attività 2: registrare l’abbonamento in IBM
Dopo esserti abbonato a Db2 in Marketplace AWS, completa la registrazione del tuo ordine IBM dalla Marketplace AWS pagina relativa al tipo di abbonamento Db2 che hai scelto. Nella Marketplace AWS pagina, scegli **Visualizza opzioni di acquisto**, quindi scegli **Configura il tuo account**. Puoi registrarti con il tuo account IBM esistente o creando un account IBM gratuito.
### Ottenere un’offerta privata
Puoi richiedere un'offerta Marketplace AWS privata per Db2 aIBM. Per ulteriori informazioni, consulta [Offerte private](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-private-offers.html) nella *Guida all’acquisto di Marketplace AWS *.
**Nota**
Se sei un AWS Organizations utente e hai ricevuto un'offerta privata che è stata emessa sui tuoi account paganti e membri, segui la procedura seguente per iscriverti a Db2 direttamente su ciascun account della tua organizzazione.
**Per ottenere un’offerta privata Db2**
1. Dopo l’emissione di un’offerta privata, accedi alla console Marketplace AWS .
1. Apri l’e-mail con il link all’offerta privata Db2.
1. Segui il link per accedere direttamente all’offerta privata.
**Nota**
Se segui questo link prima di avere effettuato l’accesso all’account corretto, verrà visualizzato l’errore **Pagina non trovata** (404).
1. Esamina i termini e le condizioni.
1. Scegli **Accetta i termini**.
**Nota**
Se un'offerta Marketplace AWS privata non viene accettata, i costi del servizio Db2 Marketplace AWS continueranno a essere fatturati alla tariffa oraria pubblica.
1. Per verificare i dettagli dell’offerta, seleziona **Mostra dettagli** nell’elenco dei prodotti.
Dopo aver completato la procedura, puoi creare l’istanza database seguendo i passaggi riportati in [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md). **In Console di gestione AWS, sotto **Licenza**, assicurati di scegliere Attraverso. Marketplace AWS**
## Passaggio da una licenza Db2 all’altra
È possibile passare da una licenza Db2 all’altra in RDS per Db2. Ad esempio, puoi iniziare con uso di licenze proprie (BYOL) e poi passare alla licenza Db2 tramite Marketplace AWS.
**Importante**
Se vuoi passare alla licenza Db2 tramite Marketplace AWS, assicurati di avere un Marketplace AWS abbonamento attivo per l'IBM Db2edizione che desideri utilizzare. In caso contrario, prima [abbonati a Db2 in Marketplace AWS](#db2-marketplace-subscribing-registering) per quell’edizione di Db2, quindi completa la procedura di ripristino.
### Console
**Per passare da una licenza Db2 all’altra**
1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Nel riquadro di navigazione, selezionare **Automated backups (Backup automatici)**.
I backup automatici vengono visualizzati nella scheda **Current Region** (Regione corrente).
1. Scegli l'istanza database da ripristinare.
1. In **Actions (Operazioni)**, scegli **Restore to point in time (Ripristina a un istante temporale)**.
Viene visualizzata la finestra **Restore to point in time (Ripristina a un istante temporale)**.
1. Scegliere **Latest restorable time (Ultimo orario di ripristino)** per eseguire il ripristino in base al momento più recente oppure scegliere **Custom (Personalizzato)** per scegliere una data e un'ora.
Se scegli **Personalizzato**, immetti la data e l’ora a cui ripristinare l’istanza.
**Nota**
Gli orari vengono visualizzati nel fuso orario locale, indicato come un offset dell'ora UTC (Coordinated Universal Time). Ad esempio, UTC-5 è l'ora legale standard Time/Central orientale.
1. In **Motore database**, scegli la licenza Db2 da utilizzare.
1. Per **DB Instance Identifier (Identificatore istanze database)**, inserire il nome dell'istanza database di destinazione ripristinata. Il nome deve essere univoco.
1. Scegli altre opzioni in base alle esigenze, ad esempio la classe di istanza database, l'archiviazione e se desideri utilizzare la funzione di scalabilità automatica dell'archiviazione.
Per informazioni su ciascuna impostazione, consulta [Impostazioni per istanze database](USER_CreateDBInstance.Settings.md).
1. Scegli **Restore to point in time (Ripristina per punto nel tempo)**.
Per ulteriori informazioni, consulta [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
### AWS CLI
[Per passare da una licenza Db2 all'altra, esegui il comando -. restore-db-instance-to point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html) L'esempio seguente ripristina la point-in-time versione più recente, imposta il motore DB su IBM Db2 Advanced Edition e imposta il modello di licenza su Db2 license through. Marketplace AWS
È possibile specificare altre impostazioni. Per informazioni su ciascuna impostazione, consulta [Impostazioni per istanze database](USER_CreateDBInstance.Settings.md).
**Example**
Per Linux, macOS o Unix:
```
1. aws rds restore-db-instance-to-point-in-time \
2. --source-db-instance-identifier my_source_db_instance \
3. --target-db-instance-identifier my_target_db_instance \
4. --use-latest-restorable-time \
5. --engine db2-ae \
6. --license-model marketplace-license
```
Per Windows:
```
1. aws rds restore-db-instance-to-point-in-time ^
2. --source-db-instance-identifier my_source_db_instance ^
3. --target-db-instance-identifier my_target_db_instance ^
4. --use-latest-restorable-time ^
5. --engine db2-ae ^
6. --license-model marketplace-license
```
Per ulteriori informazioni, consulta [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
### API RDS
Per passare da una licenza Db2 all’altra, chiama l’operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html) dell’API Amazon RDS con i parametri seguenti:
+ `SourceDBInstanceIdentifier`
+ `TargetDBInstanceIdentifier`
+ `RestoreTime`
+ `Engine`
+ `LicenseModel`
Per ulteriori informazioni, consulta [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
# Amazon RDS per classi di istanza Db2
La capacità di calcolo e memoria di un’istanza database è determinata dalla relativa classe. La classe di istanza database di cui hai bisogno dipende dalla potenza di elaborazione e dai requisiti di memoria specifici.
## Classi di istanza RDS per Db2 supportate
Le classi di istanza RDS per Db2 supportate sono un sottoinsieme delle classi di istanza database Amazon RDS. Per un elenco completo delle classi di istanza Amazon RDS, consulta [Classi di istanze DB ](Concepts.DBInstanceClass.md).
**Topics**
+ [Classi di istanza RDS per Db2 supportate per Db2 Standard Edition](#Db2.Concepts.InstanceClasses.Supported.SE)
+ [Classi di istanza RDS per Db2 supportate per Db2 Advanced Edition](#Db2.Concepts.InstanceClasses.Supported.AE)
### Classi di istanza RDS per Db2 supportate per Db2 Standard Edition
Nella tabella seguente sono elencate tutte le classi di istanza supportate per la Db2 Standard Edition del database Db2 versione 11.5.9.0. Queste classi di istanza sono disponibili sia per l’uso di licenze proprie (BYOL) sia per la licenza Db2 tramite Marketplace AWS.
| Tipo di classe di istanza | Classe di istanza |
| --- | --- |
| Classi di istanza per uso generico con processori Intel Xeon Scalable di terza generazione, archiviazione SSD e ottimizzazione di rete | db.m6idn.large–db.m6idn.8xlarge |
| Classi di istanza per uso generico con processori Intel Xeon Scalable di terza generazione | db.m6in.large–db.m6in.8xlarge |
| Classi di istanza per uso generico | db.m7i.large–db.m7i.8xlarge db.m6i.large–db.m6i.8xlarge |
| Classi di istanze ottimizzate per la memoria con NVMe base locale SSDs, alimentate da Intel Xeon Scalable processori di terza generazione | db.x2iedn.xlarge |
| Classi di istanza ottimizzata per la memoria basate su processori Intel Xeon Scalable di terza generazione | db.r6idn.large–db.r6idn.4xlarge db.r6in.large–db.r6in.4xlarge |
| Classi di istanza ottimizzata per la memoria | db.r7i.large–db.r7i.8xlarge db.r6i.large–db.r6i.4xlarge |
| Classi di istanza espandibile | db.t3.small–db.t3.2xlarge |
### Classi di istanza RDS per Db2 supportate per Db2 Advanced Edition
Nella tabella seguente sono elencate tutte le classi di istanza supportate per la Db2 Advanced Edition del database Db2 versione 11.5.9.0. Queste classi di istanza sono disponibili sia per l’uso di licenze proprie (BYOL) sia per la licenza Db2 tramite Marketplace AWS.
| Tipo di classe di istanza | Classe di istanza |
| --- | --- |
| Classi di istanza per uso generico con processori Intel Xeon Scalable di terza generazione, archiviazione SSD e ottimizzazione di rete | db.m6idn.large–db.m6idn.32xlarge |
| Classi di istanza per uso generico con processori Intel Xeon Scalable di terza generazione | db.m6in.large–db.m6in.32xlarge |
| Classi di istanza per uso generico | db.m6i.large–db.m7i.48xlarge db.m7i.large–db.m7i.48xlarge |
| Classi di istanze ottimizzate per la memoria con NVMe tecnologia locale SSDs, alimentate da Intel Xeon Scalable processori di terza generazione | db.x2iedn.xlarge - db.x2iedn.32xlarge |
| Classi di istanza ottimizzata per la memoria basate su processori Intel Xeon Scalable di terza generazione | db.r6idn.large–db.r6idn.32xlarge db.r6in.8xlarge–db.r6in.32xlarge |
| Classi di istanza ottimizzata per la memoria | db.r6i.large–db.r7i.48xlarge db.r7i.large–db.r7i.48xlarge |
| Classi di istanza espandibile | db.t3.small–db.t3.2xlarge |
# Ruoli predefiniti di Amazon RDS per Db2
RDS per Db2 aggiunge i seguenti sei ruoli e li concede al `master_user_role` con l’opzione `ADMIN`. Quando viene eseguito il provisioning del database, RDS per Db2 concede il ruolo `master_user_role` all’utente principale. L’utente principale può a sua volta concedere questi ruoli ad altri utenti, gruppi o ruoli con istruzioni `GRANT` native collegandosi al database.
+ **DBA**: RDS per Db2 crea questo ruolo vuoto con autorizzazione `DATAACCESS`. L’utente principale può aggiungere ulteriori autorizzazioni o privilegi a questo ruolo, quindi concederlo ad altri utenti, gruppi o ruoli.
+ **DBA\$1RESTRICTED**: RDS per Db2 crea questo ruolo vuoto. L’utente principale può aggiungere privilegi a questo ruolo, quindi concederlo ad altri utenti, gruppi o ruoli.
+ **DEVELOPER**: RDS per Db2 crea questo ruolo vuoto con autorizzazione `DATAACCESS`. L’utente principale può aggiungere ulteriori autorizzazioni o privilegi a questo ruolo, quindi concederlo ad altri utenti, gruppi o ruoli.
+ **ROLE\$1NULLID\$1PACKAGES**: RDS per Db2 concede i privilegi `EXECUTE` a questo ruolo sui pacchetti `ALL NULLID` che erano vincolati da Db2 al momento dell’esecuzione di `CREATE DATABASE`.
+ **ROLE\$1PROCEDURES**: RDS per Db2 concede i privilegi `EXECUTE` a questo ruolo su tutte le procedure `SYSIBM`.
+ **ROLE\$1TABLESPACES**: RDS per Db2 concede i privilegi `USAGE` sui tablespace creati dal comando `CREATE DATABASE`.
# Parametri di Amazon RDS per Db2
Amazon RDS per Db2 utilizza tre tipi di parametri: parametri di configurazione del gestore di database, variabili di registro e parametri di configurazione del database. È possibile gestire i primi due tipi tramite gruppi di parametri e l’ultimo tipo tramite la stored procedure [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).
Per impostazione predefinita, un’istanza database RDS per Db2 utilizza un gruppo di parametri database specifico per un database Db2 e un’istanza database. Questo gruppo di parametri contiene i parametri per il motore di database IBM Db2, in particolare i parametri di configurazione del gestore di database e le variabili di registro. Per informazioni sull’utilizzo di gruppi di parametri, consulta [Gruppi di parametri per Amazon RDS](USER_WorkingWithParamGroups.md).
I parametri di configurazione del database di RDS per Db2 sono impostati sui valori predefiniti del motore di archiviazione selezionato. Per ulteriori informazioni sui parametri Db2, consulta [Db2 database configuration parameters](https://www.ibm.com/docs/en/db2/11.5?topic=parameters-database-configuration) nella documentazione di IBM Db2.
**Topics**
+ [Visualizzazione dei parametri nei gruppi di parametri](#db2-viewing-parameter-group-parameters)
+ [Visualizzazione di tutti i parametri con i comandi Db2](#db2-viewing-parameters-db2-commands)
+ [Modifica dei parametri nei gruppi di parametri](#db2-modifying-parameter-group-parameters)
+ [Modifica dei parametri di configurazione del database con i comandi Db2](#db2-modifying-parameters-db2-commands)
## Visualizzazione dei parametri nei gruppi di parametri
I parametri di configurazione del gestore di database e le variabili di registro sono impostati nei gruppi di parametri. È possibile visualizzare i parametri di configurazione del gestore di database e le variabili di registro per una versione specifica di Db2 utilizzando l' Console di gestione AWS AWS CLI API RDS o la.
### Console
**Per visualizzare i valori dei parametri per un gruppo di parametri del database**
1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Nel riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**.
I gruppi di parametri database vengono visualizzati in un elenco.
1. Scegliere il nome del gruppo di parametri per visualizzarne l’elenco di parametri.
### AWS CLI
È possibile visualizzare i parametri di configurazione del gestore di database e le variabili di registro per una versione di Db2 eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-engine-default-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-engine-default-parameters.html). Indica uno dei valori seguenti per l’opzione `--db-parameter-group-family`:
+ `db2-ae-11.5`
+ `db2-se-11.5`
Ad esempio, per visualizzare i parametri per Db2 Standard Edition 11.5, esegui il comando seguente:
```
aws rds describe-engine-default-parameters --db-parameter-group-family db2-se-11.5
```
Questo comando genera un output simile all’esempio seguente:
```
{
"EngineDefaults": {
"Parameters": [
{
"ParameterName": "agent_stack_sz",
"ParameterValue": "1024",
"Description": "You can use this parameter to determine the amount of memory that is allocated by Db2 for each agent thread stack.",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "integer",
"AllowedValues": "256-32768",
"IsModifiable": false
},
{
"ParameterName": "agentpri",
"ParameterValue": "-1",
"Description": "This parameter controls the priority given to all agents and to other database manager instance processes and threads by the operating system scheduler. This priority determines how CPU time is allocated to the database manager processes, agents, and threads relative to other processes and threads running on the machine.",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "integer",
"AllowedValues": "1-99",
"IsModifiable": false
},
...
]
}
}
```
Per elencare solo i parametri modificabili per Db2 Standard Edition 11.5, esegui il comando seguente:
Per Linux, macOS o Unix:
```
aws rds describe-engine-default-parameters \
--db-parameter-group-family db2-se-11.5 \
--query 'EngineDefaults.Parameters[?IsModifiable==`true`].{ParameterName:ParameterName, DefaultValue:ParameterValue}'
```
Per Windows:
```
aws rds describe-engine-default-parameters ^
--db-parameter-group-family db2-se-11.5 ^
--query 'EngineDefaults.Parameters[?IsModifiable==`true`].{ParameterName:ParameterName, DefaultValue:ParameterValue}'
```
### API RDS
Per visualizzare i valori dei parametri per un gruppo di parametri database, utilizza l’operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) con il seguente parametro obbligatorio.
+ `DBParameterGroupName`
## Visualizzazione di tutti i parametri con i comandi Db2
È possibile visualizzare le impostazioni per i parametri di configurazione del gestore di database, i parametri di configurazione del database e le variabili di registro utilizzando i comandi Db2.
**Per visualizzare le impostazioni**
1. Connettiti al database Db2. Nell'esempio seguente *database\$1name**master\$1username*, sostituisci e *master\$1password* con le tue informazioni.
```
db2 "connect to database_name user master_username using master_password"
```
1. Trova la versione di Db2 supportata.
```
db2 "select service_level, fixpack_num from table(sysproc.env_get_inst_info()) as instanceinfo"
```
1. Visualizza i parametri per una versione specifica di Db2.
+ Visualizza i parametri di configurazione del gestore di database eseguendo il comando seguente:
```
db2 "select cast(substr(name,1,24) as varchar(24)) as name, case
when value_flags = 'NONE' then '' else value_flags end flags,
cast(substr(value,1,64) as varchar(64)) as current_value
from sysibmadm.dbmcfg
order by name asc with UR"
```
+ Visualizza tutti i parametri di configurazione del database eseguendo il comando seguente:
```
db2 "select cast(substr(name,1,24) as varchar(24)) as name, case
when value_flags = 'NONE' then '' else value_flags end flags,
cast(substr(value,1,64) as varchar(64)) as current_value
from table(db_get_cfg(null)) order by name asc, member asc with UR"
```
+ Visualizza le variabili di registro attualmente impostate eseguendo il comando seguente:
```
db2 "select cast(substr(reg_var_name,1,50) as varchar(50)) as reg_var_name,
cast(substr(reg_var_value,1,50) as varchar(50)) as reg_var_value,
level from table(env_get_reg_variables(null))
order by reg_var_name,member with UR"
```
## Modifica dei parametri nei gruppi di parametri
È possibile modificare i parametri di configurazione del gestore del database e le variabili di registro in gruppi di parametri personalizzati utilizzando l' Console di gestione AWS API AWS CLI, the o RDS. Per ulteriori informazioni, consulta [Gruppi di parametri database per istanze database Amazon RDS](USER_WorkingWithDBInstanceParamGroups.md).
### Console
**Per modificare i parametri di configurazione del gestore di database e le variabili di registro**
1. Crea un gruppo di parametri personalizzato. Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Modifica i parametri nel gruppo di parametri personalizzato. Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
### AWS CLI
**Per modificare i parametri di configurazione del gestore di database e le variabili di registro**
1. Crea un gruppo di parametri personalizzato eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html).
Includi le seguenti opzioni obbligatorie:
+ `--db-parameter-group-name`: un nome per il gruppo di parametri che stai creando.
+ `--db-parameter-group-family`: l’edizione e la versione principale del motore Db2. Valori validi: `db2-se-11.5`, `db2-ae-11.5`.
+ `--description`: una descrizione di questo gruppo di parametri.
Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Modifica i parametri nel gruppo di parametri personalizzato eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html).
Includi le seguenti opzioni obbligatorie:
+ `--db-parameter-group-name`: il nome del gruppo di parametri creato.
+ `--parameters`: un array di nomi di parametri, valori e metodi di applicazione per l’aggiornamento del parametro.
Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
### API RDS
**Per modificare i parametri di configurazione del gestore di database e le variabili di registro**
1. Crea un gruppo di parametri database personalizzato utilizzando l’operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html).
Includi i parametri obbligatori seguenti:
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Modifica i parametri nel gruppo di parametri personalizzato creato utilizzando l’operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html).
Includi i parametri obbligatori seguenti:
+ `DBParameterGroupName`
+ `Parameters`
Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
## Modifica dei parametri di configurazione del database con i comandi Db2
È possibile modificare i parametri di configurazione del database con i comandi Db2.
**Per modificare i parametri di configurazione del database**
1. Connettiti al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Modifica i parametri di configurazione del database chiamando la stored procedure `rdsadmin.update_db_param`. Per ulteriori informazioni, consulta [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).
```
db2 "call rdsadmin.update_db_param(
'database_name',
'parameter_to_modify',
'changed_value',
'restart_database')"
```
# Regole di confronto EBCDIC per i database Db2 su Amazon RDS
Amazon RDS per Db2 supporta le regole di confronto EBCDIC per i database Db2. Puoi specificare una sequenza di regole di confronto EBCDIC per un database solo quando crei il database utilizzando la stored procedure [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) di Amazon RDS.
Quando crei un’istanza database RDS per Db2 utilizzando la Console di gestione AWS, la AWS CLI o l’API RDS, puoi specificare un nome di database. Se specifichi un nome di database, Amazon RDS crea un database con le regole di confronto predefinite di `SYSTEM`. Se devi creare un database con regole di confronto EBCDIC, non specificare un nome di database quando crei un’istanza database.
Le regole di confronto per un database in RDS per Db2 vengono impostate al momento della creazione e sono immutabili.
**Per creare un database Db2 con regole di confronto EBCDIC**
1. Se non disponi di un’istanza database RDS per Db2, crea un’istanza database senza specificare un nome di database. Puoi creare un’istanza database utilizzando la Console di gestione AWS, la AWS CLI o l’API RDS. Per ulteriori informazioni, consulta [Creazione di un'istanza database](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
1. Crea un database Db2 e imposta l’opzione delle regole di confronto su un valore EBCDIC chiamando la stored procedure `rdsadmin.create_database`. Per ulteriori informazioni, consulta [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
**Importante**
Dopo aver creato un database utilizzando la stored procedure, non è possibile modificare la sequenza di regole di confronto. Se desideri che un database utilizzi una sequenza di regole di confronto diversa, elimina il database chiamando la stored procedure [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database). Quindi, crea un database con la sequenza di regole di confronto richiesta.
# Fuso orario locale per istanze database Amazon RDS per Db2
Il fuso orario di un’istanza database Amazon RDS che esegue Db2 è impostato in modo predefinito. L'impostazione predefinita attuale è Universal Coordinated Time (UTC). Puoi tuttavia impostare un fuso orario locale per le istanze database in modo da farlo corrispondere a quello delle applicazioni.
Puoi impostare il fuso orario quando si crea prima l'istanza database. Per creare un’istanza database, puoi utilizzare la Console di gestione AWS, la AWS CLI o l’API RDS. Per ulteriori informazioni, consulta [Creazione di un'istanza database](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
Se l’istanza database fa parte di un’implementazione Multi-AZ, in caso di failover il fuso orario rimane quello locale impostato.
Puoi ripristinare l’istanza database in base a un momento specifico. L’ora viene visualizzata nel fuso orario locale. Per ulteriori informazioni, consulta [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
L’impostazione del fuso orario locale sull’istanza database è soggetta alle seguenti limitazioni:
+ Non è possibile modificare il fuso orario di un’istanza database Amazon RDS per Db2 esistente.
+ Non è possibile ripristinare uno snapshot da un'istanza database in un fuso orario a un'istanza database in un fuso orario diverso.
+ Consigliamo vivamente di non ripristinare un file di backup da un fuso orario a un fuso orario diverso. Se ripristini un file di backup da un fuso orario a un altro, devi controllare le query e le applicazioni per verificare gli effetti del cambiamento di fuso orario.
## Fusi orari disponibili
Per l’impostazione del fuso orario è possibile utilizzare i valori riportati di seguito.
| Zona | Time zone (Fuso orario) |
| --- | --- |
| Africa | Africa/Cairo, Africa/Casablanca, Africa/Harare, Africa/Lagos, Africa/Luanda, Africa/Monrovia, Africa/Nairobi, Africa/Tripoli, Africa/Windhoek |
| America | America/Araguaina, America/Argentina/Buenos\$1Aires, America/Asuncion, America/Bogota, America/Caracas, America/Chicago, America/Chihuahua, America/Cuiaba, America/Denver, America/Detroit, America/Fortaleza, America/Godthab, America/Guatemala, America/Halifax, America/Lima, America/Los\$1Angeles, America/Manaus, America/Matamoros, America/Mexico\$1City, America/Monterrey, America/Montevideo, America/New\$1York, America/Phoenix, America/Santiago, America/Sao\$1Paulo, America/Tijuana, America/Toronto |
| Asia | Asia/Amman, Asia/Ashgabat, Asia/Baghdad, Asia/Baku, Asia/Bangkok, Asia/Beirut, Asia/Calcutta, Asia/Damasco, Asia/Dhaka, Asia/Hong\$1Kong, Asia/Irkutsk, Asia/Giacarta, Asia/Gerusalemme, Asia/Kabul, Asia/Karachi, Asia/Kathmandu, Asia/Kolkata, Asia/Krasnoyarsk, Asia/Magadan, Asia/Manila, Asia/Muscat, Asia/Novosibirsk, Asia/Rangoon, Asia/Riyadh, Asia/Seul, Asia/Shanghai, Asia/Singapore, Asia/Taipei, Asia/Tehran, Asia/Tokyo, Asia/Ulaanbaatar, Asia/Vladivostok, Asia/Yakutsk, Asia/Yerevan |
| Atlantico | Atlantico/Azzorre, Atlantico/Cape\$1Verde |
| Australia | Australia/Adelaide, Australia/Brisbane, Australia/Darwin, Australia/Eucla, Australia/Hobart, Australia/Lord\$1Howe, Australia/Perth, Australia/Sydney |
| Brasile | Brasile/DeNoronha, Brasile/Est |
| Canada | Canada/Newfoundland, Canada/Saskatchewan |
| ecc | Ecc./GMT-3 |
| Europa | Europa/Amsterdam, Europa/Atene, Europa/Berlino, Europa/Dublino, Europa/Helsinki, Europa/Kaliningrad, Europa/Londra, Europa/Madrid, Europa/Mosca, Europa/Parigi, Europa/Praga, Europa/Roma, Europa/Sarajevo, Europa/Stoccolma |
| Pacifico | Pacifico/Apia, Pacifico/Auckland, Pacifico/Chatham, Pacifico/Fiji, Pacifico/Guam, Pacifico/Honolulu, Pacifico/Kiritimati, Pacifico/Marquesas, Pacifico/Samoa, Pacifico/Tongatapu, Pacifico/Wake |
| USA | Stati Uniti/Alaska, Stati Uniti/Centrali, Stati Uniti/Est-Indiana, Stati Uniti/Orientali, Stati Uniti/Pacifico |
| UTC | UTC |
# Prerequisiti per la creazione di un’istanza database Amazon RDS per Db2
Di seguito sono indicati i prerequisiti per creare un’istanza database.
**Topics**
+ [Account amministratore](#db2-prereqs-admin-account)
+ [Ulteriori considerazioni](#db2-prereqs-additional-considerations)
## Account amministratore
Quando crei un’istanza database, devi designare un account amministratore per l’istanza. Amazon RDS concede l’autorità `DBADM` a questo account Database Administrator locale.
L’account amministratore presenta le seguenti caratteristiche, capacità e limitazioni:
+ È un utente locale e non un Account AWS.
+ Non dispone di autorità a livello di istanza Db2 come `SYSADM`, `SYSMAINT` o `SYSCTRL`.
+ Non può interrompere o avviare un’istanza Db2.
+ Non può rimuovere un database Db2 se è stato specificato il nome quando è stata creata l’istanza database.
+ Dispone di accesso completo al database Db2, comprese le viste e le tabelle di catalogo.
+ Può creare utenti e gruppi locali utilizzando le stored procedure di Amazon RDS.
+ Può concedere e revocare autorità e privilegi.
L’account amministratore può eseguire queste attività:
+ Creare, modificare o eliminare istanze database.
+ Creare snapshot di database.
+ Avvia i point-in-time ripristini.
+ Creare backup automatizzati degli snapshot di database.
+ Creare backup manuali degli snapshot di database.
+ Utilizzare altre funzionalità di Amazon RDS.
## Ulteriori considerazioni
Prima di creare un’istanza database, tieni presente quanto segue:
+ Ogni istanza database Amazon RDS per Db2 può ospitare fino a 50 database Db2. Per ulteriori informazioni, consulta [Più database su un’istanza database Amazon RDS per Db2](db2-multiple-databases.md).
+ Initial database name (Nome del database iniziale)
+ Se non specifichi un nome di database quando crei un’istanza database, Amazon RDS non crea un database.
+ Non fornire un nome di database nelle seguenti circostanze:
+ Vuoi modificare il parametro `db2_compatibility_vector`. Per ulteriori informazioni, consulta [Impostazione del parametro db2\$1compatibility\$1vector](db2-known-issues-limitations.md#db2-known-issues-limitations-db2-compatibility-vector).
+ Nel modello che prevede l’uso di licenze proprie (BYOL), devi innanzitutto creare un gruppo di parametri personalizzato contenente il tuo IBM Customer ID e il tuo IBM Site ID. Per ulteriori informazioni, consulta [Uso di licenze proprie (BYOL) per Db2](db2-licensing.md#db2-licensing-options-byol).
+ Nel Marketplace AWS modello di licenza Db2, è necessario un Marketplace AWS abbonamento attivo per la particolare IBM Db2 edizione che si desidera utilizzare. Se non ne disponi, [abbonati a Db2 in Marketplace AWS](db2-licensing.md#db2-marketplace-subscribing-registering) per l’edizione di IBM Db2 che desideri utilizzare. Per ulteriori informazioni, consulta [Licenza Db2 tramite Marketplace AWS](db2-licensing.md#db2-licensing-options-marketplace).
# Più database su un’istanza database Amazon RDS per Db2
Puoi creare più database su una singola istanza database RDS per Db2 chiamando la stored procedure [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database). Una singola istanza database RDS per Db2 è limitata a 50 database. Questo numero include database sia in stato attivato che disattivato.
**Nota**
Se crei più database su un’istanza database RDS per Db2 creata prima del 15 novembre 2024, devi riavviare l’istanza database per abilitare il supporto per più database.
Per impostazione predefinita, Amazon RDS attiva i database quando vengono creati. Per ottimizzare le risorse di memoria, puoi disattivare i database che usi di rado e attivarli successivamente, se necessario. Per ulteriori informazioni, consultare [Disattivazione di un database](db2-managing-databases.md#db2-deactivating-database) e [Attivazione di un database](db2-managing-databases.md#db2-activating-database).
Il numero di database attivati su un’istanza database dipende dalle risorse di memoria disponibili sul server. Le risorse di memoria variano a seconda della classe di istanza database e della quantità di memoria configurata per il database. Per informazioni sulle classi di istanza database, consulta [Classi di istanze DB ](Concepts.DBInstanceClass.md). Per informazioni su come aggiornare la memoria per un database RDS per Db2, consulta [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).
È consigliabile scegliere una classe di istanza database con 2 GB di memoria per le attività di database comuni, i requisiti del sistema operativo e altre attività di automazione di Amazon RDS come i backup. Per ulteriori informazioni sulla modifica della classe di istanza database, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
Inoltre, IBM consiglia almeno 1 GB di memoria per ogni database attivo. Per ulteriori informazioni, consulta [Disk and memory requirements](https://www.ibm.com/docs/en/db2/11.5?topic=servers-disk-memory-requirements) nella documentazione IBM.
Per calcolare il numero massimo di database attivi che un’istanza database può avere, puoi utilizzare la formula seguente:
```
Active database limit = (total server memory - 2 GB) / 1 GB
```
L’esempio seguente mostra il numero massimo di database attivi per un’istanza database con una classe di istanza database db.m6i.xlarge:
```
Active database limit = (total server memory - 2 GB) / 1 GB
= (16 GB - 2 GB) / 1 GB
= 14 databases
```
Quando Amazon RDS ripristina un database dopo un arresto anomalo, attiva il database se era attivo in precedenza. In alcuni casi, ad esempio quando si modifica una classe di istanza database con una configurazione di memoria inferiore, la memoria potrebbe essere insufficiente per attivare tutti i database sull’istanza database. In questi casi, Amazon RDS attiva i database nell’ordine in cui sono stati creati.
**Nota**
Tutti i database che Amazon RDS non riesce ad attivare perché la memoria è insufficiente rimangono disattivati.
# Connessione all’istanza database Db2
Dopo che Amazon RDS ha allocato l’istanza database Amazon RDS per Db2, è possibile utilizzare un’applicazione client SQL standard per connettersi all’istanza database. Poiché Amazon RDS è un servizio gestito, non è possibile accedere come `SYSADM`, `SYSCTRL`, `SECADM` o `SYSMAINT`.
È possibile connettersi a un’istanza database che esegue il motore di database IBM Db2 utilizzando IBM Db2 CLP, IBM CLPPlus, DBeaver o IBM Db2 Data Management Console.
**Nota**
La connessione a un database Db2 può non riuscire se l’istanza database RDS per Db2 non dispone della memoria sufficiente. Per ulteriori informazioni, consulta [Errore di connessione al database](db2-troubleshooting.md#db2-database-connection-error).
**Topics**
+ [Ricerca dell’endpoint dell’istanza database RDS per Db2](db2-finding-instance-endpoint.md)
+ [Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 CLP](db2-connecting-with-clp-client.md)
+ [Connessione a un’istanza database Amazon RDS per Db2 con IBM CLPPlus](db2-connecting-with-ibm-clpplus-client.md)
+ [Connessione a un’istanza database Amazon RDS per Db2 con DBeaver](db2-connecting-with-dbeaver.md)
+ [Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md)
+ [Considerazioni relative ai gruppi di sicurezza con Amazon RDS per Db2](db2-security-groups-considerations.md)
# Ricerca dell’endpoint dell’istanza database RDS per Db2
Ogni istanza database Amazon RDS dispone di un endpoint e ciascun endpoint è associato a un nome DNS e a un numero di porta per l'istanza database. Per connetterti all’istanza database Amazon RDS per Db2 con un’applicazione client SQL, devi conoscere il nome DNS e il numero di porta dell’istanza database.
È possibile trovare l'endpoint per un'istanza DB utilizzando Console di gestione AWS o il AWS CLI.
## Console
**Per trovare l’endpoint di un’istanza database RDS per Db2**
1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Nell'angolo in alto a destra della console, scegli la tua Regione AWS istanza DB.
1. Trova il nome DNS e il numero della porta per l’istanza database RDS per Db2.
1. Scegliere **Databases (Database)** per visualizzare un elenco di istanze database.
1. Seleziona il nome dell’istanza database RDS per Db2 per visualizzare i relativi dettagli.
1. Nella scheda **Connectivity & security (Connettività e sicurezza)**, copiare l'endpoint. Annotare anche il numero di porta. L'endpoint e il numero di porta sono necessari per la connessione all'istanza database.
![\[La scheda Connettività e sicurezza per un’istanza database che mostra l’endpoint e la porta.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/db2-connectivity-security.png)
## AWS CLI
Per trovare l’endpoint di un’istanza database RDS per Db2, esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). Nell'esempio seguente, sostituiscilo *database-1* con il nome dell'istanza DB.
Per Linux, macOS o Unix:
```
aws rds describe-db-instances \
--db-instance-identifier database-1 \
--query 'DBInstances[].{DBInstanceIdentifier:DBInstanceIdentifier,DBName:DBName,Endpoint:Endpoint}' \
--output json
```
Per Windows:
```
aws rds describe-db-instances ^
--db-instance-identifier database-1 ^
--query 'DBInstances[].{DBInstanceIdentifier:DBInstanceIdentifier,DBName:DBName,Endpoint:Endpoint}' ^
--output json
```
Questo comando genera un output simile all’esempio seguente: La riga `Address` nell'output contiene il nome DNS.
```
[
{
"DBInstanceIdentifier": "database-1",
"DBName": "DB2DB",
"Endpoint": {
"Address": "database-1.123456789012.us-east-2.amazonaws.com",
"Port": 50000,
"HostedZoneId": "Z2OC4A7DETW6VH"
}
}
]
```
# Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 CLP
Puoi utilizzare un’utilità da riga di comando come IBM Db2 CLP per connetterti ad istanze 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.
**Topics**
+ [Terminologia](#db2-connecting-ibm-clp-terms)
+ [Installazione del client](#db2-connecting-ibm-clp-install-client)
+ [Connessione a un’istanza database](#db2-connecting-ibm-clp-connect-db-instance)
+ [Risoluzione dei problemi relativi alle connessioni a un’istanza database RDS per Db2](#db2-troubleshooting-connections-clp)
## Terminologia
I termini seguenti aiutano a spiegare i comandi utilizzati per la [connessione all’istanza database RDS per Db2](#db2-connecting-ibm-clp-connect-db-instance).
**catalog tcpip node**
Questo comando registra un nodo di database remoto presso un client Db2 locale, in modo che il nodo sia accessibile all’applicazione client. Per catalogare un nodo, si forniscono informazioni come il nome host del server, il numero di porta e il protocollo di comunicazione. Il nodo catalogato rappresenta quindi un server di destinazione in cui risiedono uno o più database remoti. Per ulteriori informazioni, consulta [CATALOG TCPIP/TCPIP4/TCPIP6 NODE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-catalog-tcpip-node) nella documentazione di IBM Db2.
**catalog database**
Questo comando registra un database remoto presso un client Db2 locale, in modo che il database sia accessibile all’applicazione client. Per catalogare un database, occorre fornire informazioni come l’alias del database, il nodo su cui risiede e il tipo di autenticazione necessario per connettersi al database. Per ulteriori informazioni, consulta [CATALOG DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-catalog-database) nella documentazione di IBM Db2.
## Installazione del client
Dopo il [downloading the package for Linux](#db2-downloading-package), installa il client utilizzando i privilegi root o di amministratore.
**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 -f sysreq`** e scegli **`yes`** per accettare la licenza.
1. Scegli la posizione in cui installare il client.
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 Db2 CLP**
1. Accedi con il nome utente specificato durante l’installazione del client IBM Db2 CLP.
1. Cataloga la tua istanza database RDS per Db2. Nell'esempio seguente *node\$1name**dns\$1name*, sostituisci e *port* con un nome per il nodo nel catalogo locale, il nome DNS dell'istanza DB e il numero di porta.
```
1. db2 catalog TCPIP node node_name remote dns_name server port
```
**Esempio**
```
db2 catalog TCPIP node remnode remote database-1.123456789012.us-east-1.amazonaws.com server 50000
```
1. Cataloga il database `rdsadmin` e il tuo database. In questo modo potrai connetterti al database `rdsadmin` per eseguire alcune attività amministrative utilizzando le stored procedure di Amazon RDS. Per ulteriori informazioni, consulta [Amministrazione dell’istanza database RDS per Db2](db2-administering-db-instance.md).
Nell'esempio seguente *database\$1alias**node\$1name*, sostituisci e *database\$1name* con gli alias per questo database, il nome del nodo definito nel passaggio precedente e il nome del tuo database. `server_encrypt`crittografa il nome utente e la password sulla rete.
```
db2 catalog database rdsadmin [ as database_alias ] at node node_name authentication server_encrypt
db2 catalog database database_name [ as database_alias ] at node node_name authentication server_encrypt
```
**Esempio**
```
db2 catalog database rdsadmin at node remnode authentication server_encrypt
db2 catalog database testdb as rdsdb2 at node remnode authentication server_encrypt
```
1. Connettiti al database RDS per Db2. Nell'esempio seguente*rds\$1database\$1alias*, *master\$1username* sostituisci e *master\$1password* con il nome del database, il nome utente principale e la password principale dell'istanza DB RDS for Db2.
```
db2 connect to rds_database_alias user master_username using master_password
```
Questo comando genera un output simile all’esempio seguente:
```
Database Connection Information
Database server = DB2/LINUXX8664 11.5.9.0
SQL authorization ID = ADMIN
Local database alias = TESTDB
```
1. Esegui query e visualizza i risultati. L’esempio seguente mostra un’istruzione SQL che seleziona il database creato.
```
db2 "select current server from sysibm.dual"
```
Questo comando genera un output simile all’esempio seguente:
```
1
------------------
TESTDB
1 record(s) selected.
```
## Risoluzione dei problemi relativi alle connessioni a un’istanza database RDS per Db2
Se viene visualizzato il seguente errore `NULLID`, in genere significa che le versioni del client e del server RDS per Db2 non corrispondono. Per le versioni del client Db2 supportate, consulta [Supported combinations of clients, drivers and server levels](https://www.ibm.com/docs/en/db2/11.5?topic=communications-supported-combinations-clients-drivers-server-levels) nella documentazione di IBM Db2.
```
db2 "select * from syscat.tables"
SQL0805N Package "NULLID.SQLC2O29 0X4141414141454A69" was not found.
SQLSTATE=51002
```
Dopo aver ricevuto questo errore, è necessario associare i pacchetti dal client Db2 precedente a una versione del server Db2 supportata da RDS per Db2.
**Per associare i pacchetti da un client Db2 meno recente a un server Db2 più recente**
1. Individua i file di associazione sul computer client. In genere, questi file si trovano nella directory **bnd** del percorso di installazione del client Db2 e hanno l’estensione **.bnd**.
1. Connettiti al server Db2. Nell'esempio seguente, sostituiscilo *database\$1name* con il nome del tuo server Db2. Sostituisci *master\$1username* e *master\$1password* con le tue informazioni. Questo utente ha l’autorità `DBADM`.
```
db2 connect to database_name user master_username using master_password
```
1. Esegui il comando `bind` per associare i pacchetti.
1. Accedi alla directory in cui si trovano i file di associazione sul computer client.
1. Esegui il comando `bind` per ogni file.
Sono richieste le seguenti opzioni:
+ `blocking all`: associa tutti i pacchetti nel file di associazione in un’unica richiesta al database.
+ `grant public`: concede l’autorizzazione `public` per l’esecuzione del pacchetto.
+ `sqlerror continue`: specifica che il processo `bind` continua anche in caso di errori.
Per ulteriori informazioni sul comando `bind`, consulta [BIND command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-bind) nella documentazione di IBM Db2.
1. Verifica che l’associazione sia avvenuta correttamente eseguendo una query sulla visualizzazione catalogo `syscat.package` o controllando il messaggio restituito dopo il comando `bind`.
Per ulteriori informazioni, consulta la versione [DB2 11.5 Bind File and Package Name List in Support](https://www.ibm.com/support/pages/node/6190455). IBM
# 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
```
# Connessione a un’istanza database Amazon RDS per Db2 con DBeaver
Puoi utilizzare strumenti di terze parti come DBeaver per connetterti a istanze database Amazon RDS per Db2. Per scaricare questa utilità, consulta [DBeaver Community](https://dbeaver.io/).
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 DBeaver**
1. Avvia **DBeaver**.
1. Scegli l’icona **Nuova connessione** sulla barra degli strumenti, quindi scegli **Db2 per LUW**.
![\[Il menu che elenca i tipi di motore in DBeaver.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/dbeaver-add-connection.png)
1. Nella finestra **Connettiti a un database**, inserisci le informazioni per la tua istanza database RDS per Db2.
1. Immetti le seguenti informazioni:
+ In **Host**, inserisci il nome DNS dell’istanza database.
+ In **Porta**, inserisci il numero di porta per l’istanza database.
+ In **Database**, inserisci il nome del database.
+ In **Nome utente**, inserisci il nome del Database Administrator per l’istanza database.
+ In **Password**, inserisci la password del Database Administrator per l’istanza database.
1. Seleziona **Salva password**.
1. Scegli **Impostazioni driver**.
![\[La finestra Connettiti a un database con varie impostazioni di connessione popolate DBeaver.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/dbeaver-connect-database.png)
1. Nella finestra **Modifica driver**, specifica le proprietà di sicurezza aggiuntive.
1. Scegli la scheda **Proprietà driver**.
1. Aggiungi due **Proprietà utente**.
1. Apri il menu contestuale (clic con il pulsante destro del mouse) e scegli **Aggiungi nuova proprietà**.
1. In **Nome proprietà** aggiungi **encryptionAlgorithm**, quindi scegli **OK**.
1. Con la riga **encryptionAlgorithm** selezionata, scegli la colonna **Valore** e aggiungi **2**.
1. Apri il menu contestuale (clic con il pulsante destro del mouse) e scegli **Aggiungi nuova proprietà**.
1. In **Nome proprietà** aggiungi **securityMechanism**, quindi scegli **OK**.
1. Con la riga **securityMechanism** selezionata, scegli la colonna **Valore** e aggiungi **7**.
1. Scegli **OK**.
![\[La scheda Proprietà driver nella finestra Modifica driver in DBeaver.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/dbeaver-driver-properties-tab.png)
1. Nella finestra **Connettiti a un database**, scegli **Prova la connessione**. Se sul computer non è installato un driver DB2 JBDC, il driver viene scaricato automaticamente.
1. Scegli **OK**.
1. Scegli **Fine**.
1. Nella scheda **Navigazione database**, scegli il nome del database. Ora puoi esplorare gli oggetti.
A questo punto puoi eseguire i comandi SQL.
**Per eseguire i comandi SQL e visualizzare i risultati**
1. Nel menu in alto, scegli **SQL**. Viene visualizzato un pannello di script SQL.
1. Nel pannello **Script**, immetti un comando SQL.
1. Per eseguire il comando, seleziona il pulsante **Esegui query SQL**.
1. Nel pannello dei risultati SQL, visualizza i risultati delle tue query SQL.
![\[Finestra che mostra come eseguire un comando SQL e visualizzare i risultati in DBeaver.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/dbeaver-sql-run-example.png)
# Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 Data Management Console
Puoi connetterti a un’istanza database Amazon RDS per Db2 con IBM Db2 Data Management Console. IBM Db2 Data Management Console può amministrare e monitorare diverse istanze database RDS per Db2.
**Nota**
È necessario disporre di un computer Linux o Windows Amazon EC2 che si trovi sullo stesso VPC e gruppo di sicurezza dell’istanza database RDS per Db2. Il VPC e il gruppo di sicurezza controllano la connessione all’istanza database tramite la rete interna.
IBM Db2 Data Management Console richiede un database di repository Db2 per archiviare i metadati e le metriche delle prestazioni, ma non è in grado di creare automaticamente un database di repository per RDS per Db2. Al contrario, devi prima creare un database di repository per monitorare una o più istanze database RDS per Db2. Quindi puoi installare IBM Db2 Data Management Console e connetterti alla tua istanza database RDS per Db2 con IBM Db2 Data Management Console.
**Topics**
+ [Fase 1: creazione di un database di repository per monitorare le istanze database](#db2-creating-repo-db-monitoring-dmc)
+ [Fase 2: installazione e configurazione di IBM Db2 Data Management Console](#db2-install-setup-dmc)
+ [Fase 3: configurazione del database di repository e connessione alle istanze database RDS per Db2](#db2-connecting-db-instances-with-dmc)
+ [Uso di IBM Db2 Data Management Console](#db2-using-dmc)
## Fase 1: creazione di un database di repository per monitorare le istanze database
È possibile utilizzare un’istanza database RDS per Db2 esistente di dimensioni adeguate come repository per IBM Db2 Data Management Console per monitorare altre istanze database RDS per Db2. Tuttavia, poiché l’utente amministratore non dispone dell’autorità `SYSCTRL` per creare pool di buffer e tablespace, l’utilizzo della creazione di repository di IBM Db2 Data Management Console per creare un database di repository non riesce. Devi invece creare tu un database di repository. Questo database di repository monitora le tue istanze database RDS per Db2.
Per creare un database di repository è possibile procedere in due modi diversi. Puoi creare un database RDS per Db2 e quindi creare manualmente un pool di buffer, un tablespace utente e un tablespace temporaneo di sistema. In alternativa, puoi creare un’istanza Amazon EC2 separata per ospitare un database di repository IBM Db2 Data Management Console.
**Topics**
+ [Creazione manuale di un pool di buffer, di un tablespace utente e di un tablespace temporaneo di sistema](#db2-manually-creating-dmc)
+ [Creazione di un’istanza Amazon EC2 per ospitare un repository IBM Db2 Data Management Console](#db2-creating-ec2-dmc)
### Creazione manuale di un pool di buffer, di un tablespace utente e di un tablespace temporaneo di sistema
**Per creare un pool di buffer, un tablespace utente e un tablespace temporaneo di sistema**
1. Connettiti al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Crea un pool di buffer per IBM Db2 Data Management Console. Nell'esempio seguente, sostituiscilo *database\$1name* con il nome del repository per cui hai creato per monitorare il tuo RDS IBM Db2 Data Management Console per le istanze DB Db2.
```
db2 "call rdsadmin.create_bufferpool('database_name',
'BP4CONSOLE', 1000, 'Y', 'Y', 32768)"
```
1. Crea un tablespace utente per IBM Db2 Data Management Console. Nell'esempio seguente, sostituiscilo *database\$1name* con il nome del repository per cui hai creato per monitorare il tuo RDS IBM Db2 Data Management Console per le istanze DB Db2.
```
db2 "call rdsadmin.create_tablespace('database_name',
'TS4CONSOLE', 'BP4CONSOLE', 32768)"
```
1. Crea un tablespace temporaneo di sistema per IBM Db2 Data Management Console. Nell'esempio seguente, sostituiscilo *database\$1name* con il nome del repository per cui hai creato per monitorare il tuo RDS IBM Db2 Data Management Console per le istanze DB Db2.
```
db2 "call rdsadmin.create_tablespace('database_name',
'TS4CONSOLE_TEMP', 'BP4CONSOLE', 32768, 0, 0, 'S')"
```
A questo punto puoi installare IBM Db2 Data Management Console. Per ulteriori informazioni sull’installazione e sulla configurazione, consulta [Fase 2: installazione e configurazione di IBM Db2 Data Management Console](#db2-install-setup-dmc).
### Creazione di un’istanza Amazon EC2 per ospitare un repository IBM Db2 Data Management Console
Puoi creare un’istanza Amazon Elastic Compute Cloud (Amazon EC2) separata per ospitare un repository IBM Db2 Data Management Console. Per ulteriori informazioni sull’avvio di un’istanza Amazon EC2, consulta [Tutorial: Nozioni di base sulle istanze Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) nella *Guida per l’utente di Amazon EC2*.
## Fase 2: installazione e configurazione di IBM Db2 Data Management Console
Dopo aver creato un pool di buffer, un tablespace utente e un tablespace temporaneo di sistema, puoi procedere all’installazione e configurazione di IBM Db2 Data Management Console.
**Importante**
È necessario disporre di un computer Linux o Windows Amazon EC2 che si trovi sullo stesso VPC e gruppo di sicurezza dell’istanza database RDS per Db2. Il VPC e il gruppo di sicurezza controllano la connessione all’istanza database tramite la rete interna. Inoltre, è necessario avere già [creato un database di repository](#db2-creating-repo-db-monitoring-dmc) per IBM Db2 Data Management Console.
**Per installare e configurare IBM Db2 Data Management Console**
1. Scarica IBM Db2 Data Management Console da [IBM Db2 Data Management Console Version 3.1x releases](https://www.ibm.com/support/pages/ibm-db2-data-management-console-version-31x-releases-new-features-and-enhancements) sul sito web IBM Support.
1. Installare IBM Db2 Data Management Console.
1. Apri IBM Db2 Data Management Console e utilizza l’indirizzo IP del computer Amazon EC2 e il numero di porta utilizzato per la connessione HTTP o HTTPS all’istanza Amazon EC2. Ad esempio, utilizza `http://xx.xx.xx.xx:11080` o `https://xx.xx.xx.xx.11081`. Sostituisci `xx.xx.xx.xx` con l’indirizzo IP del computer Amazon EC2. `11080` e `11081` sono le porte predefinite per le connessioni HTTP e HTTPS.
1. (Facoltativo) Se desideri utilizzare la porta 80 o 443 sulla tua istanza Amazon EC2, puoi utilizzare Apache httpd o un server Nginx HTTP per creare impostare il proxy della porta IBM Db2 Data Management Console sulla porta 80 o 443. Per ulteriori informazioni, consulta [Apache HTTP Server Project](https://httpd.apache.org) e il [sito web nginx](https://nginx.org/en/).
Per consentire la connessione a IBM Db2 Data Management Console, è necessario modificare le regole in entrata nel gruppo di sicurezza. Se utilizzi un proxy, modifica la TCP/IP porta 80 o 443 per reindirizzare alle porte. IBM Db2 Data Management Console Se non utilizzi un proxy, modifica la TCP/IP porta 80 o 443 con le porte predefinite 11080 (HTTP) o 11081 (HTTPS).
Ora puoi eseguire l’accesso a IBM Db2 Data Management Console per configurare il database di repository e connetterti alle tue istanze database RDS per Db2. Per ulteriori informazioni, consulta [Configurazione del database di repository e connessione alle istanze database](#db2-connecting-db-instances-with-dmc).
## Fase 3: configurazione del database di repository e connessione alle istanze database RDS per Db2
Quanto ti connetti al database di repository per la prima volta, IBM Db2 Data Management Console configura automaticamente il repository. Dopo aver configurato il database di repository, puoi aggiungere connessioni di database a IBM Db2 Data Management Console.
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). Se ti connetti tramite Internet, consenti il traffico verso la porta del database. Per ulteriori informazioni, consulta [Creazione di un'istanza database](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
**Per connetterti a istanze database RDS per Db2 con IBM Db2 Data Management Console**
1. Accedi a IBM Db2 Data Management Console con le credenziali impostate durante l’installazione.
1. Configura il repository.
1. Nella sezione **Connessione e database**, inserisci le seguenti informazioni per l’istanza database RDS per Db2:
+ In **Host**, inserisci il nome DNS dell’istanza database.
+ In **Porta**, inserisci il numero di porta per l’istanza database.
+ In **Database**, inserisci il nome del database.
![\[La sezione Connessione e database in IBM Db2 Data Management Console con i campi Host, Porta e Database.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ibm-dmc-connection-database.png)
1. Nella sezione **Sicurezza e credenziali**, inserisci le seguenti informazioni per la tua istanza database RDS per Db2:
+ In **Tipo di sicurezza**, scegli **Utente e password crittografati**.
+ In **Nome utente**, inserisci il nome del Database Administrator per l’istanza database.
+ In **Password**, inserisci la password del Database Administrator per l’istanza database.
1. Scegli **Test Connection (Connessione di prova)**.
**Nota**
Se la connessione non riesce, verifica che la porta del database sia aperta tramite le regole in entrata del gruppo di sicurezza. Per ulteriori informazioni, consulta [Considerazioni relative ai gruppi di sicurezza con Amazon RDS per Db2](db2-security-groups-considerations.md).
Se non hai [creato manualmente un pool di buffer, un tablespace utente e un tablespace temporaneo di sistema](#db2-manually-creating-dmc) in RDS per Db2, è possibile che venga visualizzato il seguente messaggio di errore:
![\[Messaggio di errore relativo alla mancanza delle autorizzazioni per eseguire operazioni.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ibm-dmc-error-message.png)
Assicurati di aver creato una tabella di buffer, un tablespace e gli oggetti per un repository IBM Db2 Data Management Console per monitorare l’istanza database RDS per Db2. In alternativa, puoi utilizzare un’istanza database Amazon EC2 Db2 per ospitare un repository IBM Db2 Data Management Console per monitorare l’istanza database RDS per Db2. Per ulteriori informazioni, consulta [Fase 1: creazione di un database di repository per monitorare le istanze database](#db2-creating-repo-db-monitoring-dmc).
1. Dopo aver testato la connessione, scegli **Avanti**.
![\[La sezione Sicurezza e credenziali in IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ibm-dmc-security-credential.png)
Se IBM Db2 Data Management Console trova il pool di buffer, il tablespace utente e il tablespace temporaneo di sistema nell’istanza database RDS per Db2, IBM Db2 Data Management Console configura automaticamente il database di repository. Se utilizzi l’istanza Db2 sull’istanza Amazon EC2 come database di repository, IBM Db2 Data Management Console crea automaticamente il pool di buffer e altri oggetti.
1. Nella finestra **Set statistics event monitor opt-in**, scegli **Next**.
1. (Facoltativo) Aggiungi una nuova connessione. Se desideri utilizzare un’istanza database RDS per Db2 diversa per l’amministrazione e il monitoraggio, aggiungi una connessione a un’istanza database RDS per Db2 non repository.
1. Nella sezione **Connessione e database**, inserisci le seguenti informazioni per l’istanza database RDS per Db2 da utilizzare per l’amministrazione e il monitoraggio:
+ In **Nome connessione**, inserisci l’identificatore del database Db2.
+ In **Host**, inserisci il nome DNS dell’istanza database.
+ In **Porta**, inserisci il numero di porta per l’istanza database.
+ In **Database**, inserisci il nome del database.
![\[La sezione Connessione e database per una nuova connessione in IBM Db2 Data Management Console con i campi Host, Porta e Database.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ibm-dmc-new-connection-database.png)
1. Nella sezione **Sicurezza e credenziali**,** **seleziona **Abilita raccolta dati di monitoraggio**.
1. Inserisci le informazioni seguenti per l’istanza database RDS per Db2:
+ In **Nome utente**, inserisci il nome del Database Administrator per l’istanza database.
+ In **Password**, inserisci la password del Database Administrator per l’istanza database.
1. Scegli **Test Connection (Connessione di prova)**.
1. Dopo aver testato la connessione, scegli **Salva**.
![\[La sezione Sicurezza e credenziali per una nuova connessione in IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ibm-dmc-new-security-credential.png)
Dopo aver aggiunto la connessione, viene visualizzata una finestra simile alla seguente. Questa finestra indica che il database è stato configurato correttamente.
![\[La finestra che indica che il database è stato configurato correttamente in IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ibm-dmc-configuration-success.png)
1. Scegli **Vai a Database**. Viene visualizzata una finestra Database simile alla seguente. Questa finestra è una dashboard che mostra metriche, stati e connessioni.
![\[La finestra di panoramica Database in IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ibm-dmc-database-view.png)
A questo punto, puoi iniziare a utilizzare IBM Db2 Data Management Console.
## Uso di IBM Db2 Data Management Console
Puoi utilizzare IBM Db2 Data Management Console per eseguire i seguenti tipi di attività:
+ Gestire più istanze database RDS per Db2.
+ Eseguire comandi SQL.
+ Esplorare, creare o modificare dati e oggetti di database.
+ Creare istruzioni `EXPLAIN PLAN` in SQL.
+ Ottimizzare le query.
**Per eseguire i comandi SQL e visualizzare i risultati**
1. Nella barra di navigazione a sinistra, seleziona **SQL**.
1. Inserisci un comando SQL.
1. Scegli **Esegui tutto**.
1. Per visualizzare i risultati, scegli la scheda **Risultati**.
![\[La finestra Database che mostra come eseguire un comando SQL e visualizzare i risultati in IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ibm-dmc-sql-run-example.png)
# Considerazioni relative ai gruppi di sicurezza con Amazon RDS per Db2
Per la connessione all’istanza database Amazon RDS per Db2, è necessario che questa sia associata a un gruppo di sicurezza contenente la configurazione di rete e gli indirizzi IP necessari. L’istanza database RDS per Db2 potrebbe utilizzare il gruppo di sicurezza predefinito. Se hai assegnato un gruppo di sicurezza predefinito non configurato al momento della creazione dell’istanza database RDS per Db2, il firewall impedirà le connessioni Internet. Per ulteriori informazioni sulla creazione di un nuovo gruppo di sicurezza, consulta [Controllo dell'accesso con i gruppi di sicurezza](Overview.RDSSecurityGroups.md).
Dopo aver creato il nuovo gruppo di sicurezza, modifica l'istanza database per associarla al gruppo di sicurezza. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
Puoi aumentare la sicurezza utilizzando la crittografia SSL per proteggere le connessioni alla tua istanza database. Per ulteriori informazioni, consulta [Utilizzo SSL/TLS con un'istanza database Amazon RDS per Db2](Db2.Concepts.SSL.md).
# Protezione delle connessioni all’istanza database Amazon RDS per Db2
Amazon RDS per Db2 offre soluzioni per migliorare la sicurezza per l’istanza database RDS per Db2.
**Topics**
+ [Utilizzo SSL/TLS con un'istanza database Amazon RDS per Db2](Db2.Concepts.SSL.md)
+ [Utilizzo dell’autenticazione Kerberos per Amazon RDS per Db2](db2-kerberos.md)
# Utilizzo SSL/TLS con un'istanza database Amazon RDS per Db2
Secure Sockets Layer (SSL) è un protocollo standard del settore utilizzato per proteggere connessioni di rete tra client e server. Dopo SSL versione 3.0, il nome è stato modificato in Transport Layer Security (TLS), ma spesso il protocollo viene ancora indicato come SSL. Amazon RDS supporta la crittografia SSL per le istanze database Amazon RDS per Db2. L'utilizzo del SSL/TLS, you can encrypt a connection between your application client and your RDS for Db2 DB instance. SSL/TLS supporto è disponibile in tutti i casi Regioni AWS per RDS for Db2.
Per abilitare SSL/TLS la crittografia per un'istanza DB RDS for Db2, aggiungi l'opzione Db2 SSL al gruppo di parametri associato all'istanza DB. Amazon RDS utilizza una seconda porta, come richiesto da Db2, per le SSL/TLS connessioni. In questo modo è consentito allo stesso tempo sia testo in chiaro sia comunicazioni con crittografia SSL tra un’istanza database e un client Db2. Ad esempio, è possibile utilizzare la porta con testo in chiaro per comunicare con altre risorse all'interno di un VPC mentre utilizzi la porta con crittografia SSL per comunicare con risorse all'esterno del VPC.
**Topics**
+ [Creare una connessione SSL/TLS](#db2-creating-ssl-connection)
+ [Connettiti al server di database Db2](#db2-connecting-to-server-ssl)
## Creare una connessione SSL/TLS
Per creare una SSL/TLS connessione, scegli un'autorità di certificazione (CA), scarica un pacchetto di certificati per tutti Regioni AWS e aggiungi parametri a un gruppo di parametri personalizzato.
### Fase 1: scegliere una CA e scaricare un certificato
Scegli un’autorità di certificazione (CA) e scarica un bundle di certificati per tutte le Regioni AWS. Per ulteriori informazioni, consulta [](UsingWithRDS.SSL.md).
### Fase 2: aggiornare i parametri in un gruppo di parametri personalizzato
**Importante**
Se utilizzi il modello basato sull’uso di licenze proprie (BYOL) per RDS per Db2, modifica il gruppo di parametri personalizzato che hai creato per l’IBM Customer ID e l’IBM Site ID. Se utilizzi un modello di licenza diverso per RDS per Db2, segui la procedura per aggiungere parametri a un gruppo di parametri personalizzato. Per ulteriori informazioni, consulta [Opzioni di licenza per Amazon RDS per Db2](db2-licensing.md).
Non è possibile modificare i gruppi di parametri predefiniti per le istanze database RDS per Db2. È pertanto necessario creare un gruppo di parametri personalizzato, modificarlo e collegarlo alle istanze database RDS per Db2. Per informazioni sui gruppi di parametri, consultare [Gruppi di parametri database per istanze database Amazon RDS](USER_WorkingWithDBInstanceParamGroups.md).
Utilizza le impostazioni dei parametri riportate nella seguente tabella.
| Parametro | Valore |
| --- | --- |
| DB2COMM | TCPIP,SSL o SSL |
| SSL\$1SVCENAME | |
**Per aggiornare i parametri in un gruppo di parametri personalizzato**
1. Crea un gruppo di parametri personalizzato eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html).
Includi le seguenti opzioni obbligatorie:
+ `--db-parameter-group-name`: un nome per il gruppo di parametri che stai creando.
+ `--db-parameter-group-family`: l’edizione e la versione principale del motore Db2. Valori validi: `db2-se-11-5`, `db2-ae-11.5`.
+ `--description`: una descrizione di questo gruppo di parametri.
Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Modifica i parametri nel gruppo di parametri personalizzato eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html).
Includi le seguenti opzioni obbligatorie:
+ `--db-parameter-group-name`: il nome del gruppo di parametri creato.
+ `--parameters`: un array di nomi di parametri, valori e metodi di applicazione per l’aggiornamento del parametro.
Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
1. Associa il gruppo di parametri all’istanza database RDS per Db2. Per ulteriori informazioni, consulta [Associazione di un gruppo di parametri database a un’istanza database in Amazon RDS](USER_WorkingWithParamGroups.Associating.md).
## Connettiti al server di database Db2
Le istruzioni per la connessione al server di database Db2 sono specifiche della lingua.
------
#### [ Java ]
**Per connettersi al server di database Db2 utilizzando Java**
1. Scarica il driver JDBC. Per ulteriori informazioni, consulta [Versioni e download dei driver DB2 JDBC nella documentazione](https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads) di IBM Support.
1. Crea un file di script della shell con i seguenti contenuti. Questo script aggiunge tutti i certificati del bundle in un Java KeyStore.
**Importante**
Verifica che `keytool` sia presente nel percorso dello script in modo da essere identificabile dallo script. Se utilizzi un client Db2, puoi individuare il `keytool` in `~sqlib/java/jdk64/jre/bin`.
```
#!/bin/bash
PEM_FILE=$1
PASSWORD=$2
KEYSTORE=$3
# number of certs in the PEM file
CERTS=$(grep 'END CERTIFICATE' $PEM_FILE| wc -l)
for N in $(seq 0 $(($CERTS - 1))); do
ALIAS="${PEM_FILE%.*}-$N"
cat $PEM_FILE |
awk "n==$N { print }; /END CERTIFICATE/ { n++ }" |
keytool -noprompt -import -trustcacerts -alias $ALIAS -keystore $KEYSTORE -storepass $PASSWORD
done
```
1. Per eseguire lo script della shell e importare il file PEM con il bundle di certificati in un Java KeyStore, esegui il comando seguente. Sostituiscilo *shell\$1file\$1name.sh* con il nome del tuo file di script di shell e *password* con la password per il tuo. Java KeyStore
```
./shell_file_name.sh global-bundle.pem password truststore.jks
```
1. Per connetterti al server Db2, esegui il comando seguente. Sostituisci i seguenti segnaposto nell’esempio con le informazioni relative all’istanza database RDS per Db2.
+ *ip\$1address*— L'indirizzo IP dell'endpoint dell'istanza DB.
+ *port*— Il numero di porta per la connessione SSL. Può essere qualsiasi numero di porta tranne quello utilizzato per la porta non SSL.
+ *database\$1name*— Il nome del database nell'istanza DB.
+ *master\$1username*— Il nome utente principale per l'istanza DB.
+ *master\$1password*— La password principale per l'istanza DB.
```
export trustStorePassword=MyPassword
java -cp ~/dsdriver/jdbc_sqlj_driver/linuxamd64/db2jcc4.jar \
com.ibm.db2.jcc.DB2Jcc -url \
"jdbc:db2://ip_address:port/database_name:\
sslConnection=true;sslTrustStoreLocation=\
~/truststore.jks;\
sslTrustStorePassword=${trustStorePassword};\
sslVersion=TLSv1.2;\
encryptionAlgorithm=2;\
securityMechanism=7;" \
-user master_username -password master_password
```
------
#### [ Node.js ]
**Per connettersi al server di database Db2 utilizzando Node.js**
1. Installa il driver **node-ibm\$1db**. Per ulteriori informazioni, consulta [Installing the node-ibm\$1db driver on Linux and UNIX systems](https://www.ibm.com/docs/en/db2/11.5?topic=nodejs-installing-node-db-driver-linux-unix-systems) nella documentazione di IBM Db2.
1. Crea un file JavaScript con i seguenti contenuti. Sostituisci i seguenti segnaposto nell’esempio con le informazioni relative all’istanza database RDS per Db2.
+ *ip\$1address*— L'indirizzo IP dell'endpoint dell'istanza DB.
+ *master\$1username*— Il nome utente principale per l'istanza DB.
+ *master\$1password*— La password principale per l'istanza DB.
+ *database\$1name*— Il nome del database nell'istanza DB.
+ *port*— Il numero di porta per la connessione SSL. Può essere qualsiasi numero di porta tranne quello utilizzato per la porta non SSL.
```
var ibmdb = require("ibm_db");
const hostname = "ip_address";
const username = "master_username";
const password = "master_password";
const database = "database_name";
const port = "port";
const certPath = "/root/qa-bundle.pem";
ibmdb.open("DRIVER={DB2};DATABASE=" + database + ";HOSTNAME=" + hostname + ";UID=" + username + ";PWD=" + password + ";PORT=" + port + ";PROTOCOL=TCPIP;SECURITY=SSL;SSLServerCertificate=" + certPath + ";", function (err, conn){
if (err) return console.log(err);
conn.close(function () {
console.log('done');
});
});
```
1. Per eseguire il file JavaScript, esegui il comando seguente.
```
node ssl-test.js
```
------
#### [ Python ]
**Per connettersi al server di database Db2 utilizzando Python**
1. Crea un file Python con i seguenti contenuti. Sostituisci i seguenti segnaposto nell’esempio con le informazioni relative all’istanza database RDS per Db2.
+ *port*— Il numero di porta per la connessione SSL. Può essere qualsiasi numero di porta tranne quello utilizzato per la porta non SSL.
+ *master\$1username*— Il nome utente principale per l'istanza DB.
+ *master\$1password*— La password principale per l'istanza DB.
+ *database\$1name*— Il nome del database nell'istanza DB.
+ *ip\$1address*— L'indirizzo IP dell'endpoint dell'istanza DB.
```
import click
import ibm_db
import sys
port = port;
master_user_id = "master_username" # Master id used to create your DB instance
master_password = "master_password" # Master password used to create your DB instance
db_name = "database_name" # If not given "db-name'
vpc_customer_private_ip = "ip_address" # Hosts end points - Customer private IP Addressicert_path = "/root/ssl/global-bundle.pem" # cert path
@click.command()
@click.option("--path", help="certificate path")
def db2_connect(path):
try:
conn = ibm_db.connect(f"DATABASE={db_name};HOSTNAME={vpc_customer_private_ip};PORT={port};
PROTOCOL=TCPIP;UID={master_user_id};PWD={master_password};SECURITY=ssl;SSLServerCertificate={path};", "", "")
try:
ibm_db.exec_immediate(conn, 'create table tablename (a int);')
print("Query executed successfully")
except Exception as e:
print(e)
finally:
ibm_db.close(conn)
sys.exit(1)
except Exception as ex:
print("Trying to connect...")
if __name__ == "__main__":
db2_connect()
```
1. Crea il seguente script della shell, che esegue il file Python creato. Sostituisci *python\$1file\$1name.py* con il nome del tuo file di script Python.
```
#!/bin/bash
PEM_FILE=$1
# number of certs in the PEM file
CERTS=$(grep 'END CERTIFICATE' $PEM_FILE| wc -l)
for N in $(seq 0 $(($CERTS - 1))); do
ALIAS="${PEM_FILE%.*}-$N"
cert=`cat $PEM_FILE | awk "n==$N { print }; /END CERTIFICATE/ { n++ }"`
cat $PEM_FILE | awk "n==$N { print }; /END CERTIFICATE/ { n++ }" > $ALIAS.pem
python3 --path $ALIAS.pem
output=`echo $?`
if [ $output == 1 ]; then
break
fi
done
```
1. Per importare il file PEM con il bundle di certificati ed eseguire lo script della shell, esegui il comando seguente. *shell\$1file\$1name.sh*Sostituiscilo con il nome del tuo file di script di shell.
```
./shell_file_name.sh global-bundle.pem
```
------
#### [ Db2 CLP ]
**Per connettersi al server di database Db2 utilizzando Db2 CLP**
1. Per connetterti alla tua istanza Db2 utilizzandoDb2 CLP, è necessario GSKit, che puoi scaricare da [IBM Fix Central](https://www.ibm.com/support/fixcentral/swg/selectFixes?parent=Security+Systems&product=ibm/Tivoli/IBM+Global+Security+Kit&release=All&platform=All&function=fixId&fixids=8.0.*&source=fc). Per utilizzare Db2 CLP, è necessario anche il client IBM Db2, che è possibile scaricare da [Download initial Version 11.5 clients and drivers](https://www.ibm.com/support/pages/download-initial-version-115-clients-and-drivers) sul sito di IBM Support.
1. Crea un keystore.
```
gsk8capicmd_64 -keydb -create -db "directory/keystore-filename" -pw "changeThisPassword" -type pkcs12 -stash
```
1. Importa il bundle di certificati nel keystore.
```
gsk8capicmd_64 -cert -import -file global-bundle.pem -target directory/keystore-filename> -target_stashed
```
1. Aggiorna la configurazione dell’istanza Db2.
```
db2 update dbm cfg using SSL_CLNT_KEYDB keystore-filename SSL_CLNT_STASH keystore stash file immediate
```
1. Cataloga il nodo e il database.
```
db2 catalog tcpip node ssluse1 REMOTE endpoint SERVER ssl_svcename security ssl
db2 catalog database testdb as ssltest at node ssluse1
```
1. Connettiti al database .
```
db2 connect to ssltest user username using password
```
------
# Utilizzo dell’autenticazione Kerberos per Amazon RDS per Db2
Puoi utilizzare l’autenticazione Kerberos per autenticare gli utenti quando si connettono alla tua istanza database Amazon RDS per Db2. In questa configurazione, l'istanza DB funziona con AWS Directory Service for Microsoft Active Directory, chiamato anche AWS Managed Microsoft AD. Aggiungi il dominio e altre informazioni della tua AWS Managed Microsoft AD directory all'istanza DB RDS for Db2. Quando gli utenti si autenticano con un'istanza DB RDS for Db2 aggiunta al dominio trusting, le richieste di autenticazione vengono inoltrate alla directory con cui è stata creata. AWS Managed Microsoft AD Directory Service
Mantenere tutte le credenziali nella stessa directory consente di ridurre il tempo e l'impegno. Con questo approccio, è disponibile una posizione centralizzata per archiviare e gestire le credenziali per più istanze database. L'uso di una directory può inoltre migliorare il profilo di sicurezza complessivo.
Puoi inoltre accedere alle credenziali da Microsoft Active Directory on-premise. A tale scopo, crea una relazione di dominio trusting in modo che la directory AWS Managed Microsoft AD consideri attendibile Microsoft Active Directory on-premise. In questo modo, gli utenti possono accedere alle istanze database RDS per Db2 con la stessa esperienza Single Sign-On (SSO) Windows dei carichi di lavoro nella rete on-premises.
[Per ulteriori informazioni, consulta What is? Directory Service](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/what_is.html) nella *Guida all'AWS Directory Service amministrazione*.
Per informazioni sull’autenticazione Kerberos, consulta i seguenti argomenti:
**Argomenti**
+ [Configurazione dell’autenticazione Kerberos per le istanze database Amazon RDS per Db2](db2-kerberos-setting-up.md)
+ [Connessione ad Amazon RDS per Db2 mediante l’autenticazione Kerberos](db2-kerberos-connecting.md)
## Disponibilità di regioni e versioni
Il supporto varia a seconda delle versioni specifiche di ciascun motore di database e a seconda delle Regioni AWS. Per ulteriori informazioni sulla disponibilità delle versioni e Regioni di RDS per Db2 con l’autenticazione Kerberos, consulta [Regioni e motori di database supportati per l’autenticazione Kerberos in Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.KerberosAuthentication.md).
**Nota**
L’autenticazione Kerberos non è supportata per classi di istanze database dichiarate obsolete per le istanze database RDS per Db2. Per ulteriori informazioni, consulta [Amazon RDS per classi di istanza Db2](Db2.Concepts.General.InstanceClasses.md).
## Panoramica dell’autenticazione Kerberos per istanze database RDS per Db2
Per configurare l’autenticazione Kerberos per un’istanza database RDS per Db2, completa i seguenti passaggi generali, descritti in dettaglio più avanti:
1. AWS Managed Microsoft AD Usare per creare una AWS Managed Microsoft AD directory. È possibile utilizzare il Console di gestione AWS, the AWS Command Line Interface (AWS CLI) o Directory Service per creare la directory. Per ulteriori informazioni, consulta [Create your AWS Managed Microsoft AD directory](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_getting_started_create_directory.html) nella *AWS Directory Service Administration Guide*.
1. Crea un ruolo AWS Identity and Access Management (IAM) che utilizzi la policy IAM gestita`AmazonRDSDirectoryServiceAccess`. Il ruolo IAM consente ad Amazon RDS di effettuare chiamate alla tua directory.
Affinché il ruolo IAM consenta l'accesso, l'endpoint AWS Security Token Service (AWS STS) deve essere attivato nel modo corretto Regione AWS per te Account AWS. AWS STS Gli endpoint sono tutti Regioni AWS attivi per impostazione predefinita e puoi utilizzarli senza ulteriori azioni. *Per ulteriori informazioni, consulta [Attivazione e disattivazione AWS STSRegione AWS in un](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html#sts-regions-activate-deactivate) capitolo della IAM User Guide.*
1. Crea o modifica un'istanza DB RDS for Db2 utilizzando l' Console di gestione AWS, la o l' AWS CLI API RDS con uno dei seguenti metodi:
+ [Crea una nuova istanza DB RDS for Db2 utilizzando la console, il [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)comando o l'operazione Create API. DBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) Per istruzioni, consulta [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md).
+ Modifica un’istanza database RDS per Db2 esistente utilizzando la console, il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) o l’operazione API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Per istruzioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
+ Ripristina un’istanza database RDS per Db2 da uno snapshot di database utilizzando la console, il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html) o l’operazione API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html). Per istruzioni, consulta [Ripristino in un’istanza database](USER_RestoreFromSnapshot.md).
+ Ripristina un'istanza DB RDS for Db2 point-in-time utilizzando la console, il [https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html)comando o l'operazione API. [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html) Per istruzioni, consulta [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
Puoi localizzare l'istanza DB nello stesso Amazon Virtual Private Cloud (VPC) della directory o in un altro VPC. Account AWS Quando crei o modifichi l’istanza database RDS per Db2, esegui le seguenti attività:
+ Specifica l'identificativo del dominio (identificativo `d-*`) generato al momento della creazione della directory.
+ Specifica anche il nome del ruolo IAM creato.
+ Assicurati che il gruppo di sicurezza dell’istanza database possa ricevere traffico in entrata dal gruppo di sicurezza della directory.
1. Configura il tuo client Db2 e verifica che il traffico possa fluire tra l'host del client e Directory Service le seguenti porte:
+ Porta TCP/UDP 53 – DNS
+ TCP 88 — autenticazione Kerberos
+ TCP 389 — LDAP
+ TCP 464 — autenticazione Kerberos
## Gestione di un'istanza database in un dominio
Puoi utilizzare l' Console di gestione AWS, la o l' AWS CLI API RDS per gestire la tua istanza DB e la sua relazione con la tua. Microsoft Active Directory Ad esempio, puoi associare una Active Directory per abilitare l’autenticazione Kerberos. Puoi anche rimuovere l’associazione per una Active Directory per disabilitare l’autenticazione Kerberos. Puoi anche spostare un’istanza database affinché venga autenticata esternamente da una Microsoft Active Directory a un’altra.
Ad esempio, il comando CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) consente di eseguire le seguenti azioni:
+ Tentare nuovamente di abilitare l’autenticazione Kerberos per un’appartenenza non riuscita specificando l’ID della directory dell’appartenenza corrente per l’opzione `--domain`.
+ Disabilitare l’autenticazione Kerberos su un’istanza database specificando `none` per l’opzione `--domain`.
+ Spostare un’istanza database da un dominio a un altro specificando l’identificatore di dominio del nuovo dominio per l’opzione `--domain`.
### Appartenenza al dominio
Quando l'istanza database viene creata o modificata diventa membro del dominio. Puoi visualizzare lo stato dell’appartenenza al dominio nella console o eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). Lo stato dell'istanza di database può essere uno dei seguenti:
+ `kerberos-enabled`: l’autenticazione Kerberos è abilitata nell’istanza database.
+ `enabling-kerberos`— AWS sta abilitando l'Kerberosautenticazione su questa istanza DB.
+ `pending-enable-kerberos`: l’abilitazione dell’autenticazione Kerberos è in sospeso su questa istanza database.
+ `pending-maintenance-enable-kerberos`— AWS tenterà di abilitare Kerberos l'autenticazione sull'istanza DB durante la successiva finestra di manutenzione programmata.
+ `pending-disable-kerberos`: la disabilitazione dell’autenticazione Kerberos è in sospeso su questa istanza database.
+ `pending-maintenance-disable-kerberos`— AWS tenterà di disabilitare Kerberos l'autenticazione sull'istanza DB durante la successiva finestra di manutenzione pianificata.
+ `enable-kerberos-failed`: un problema di configurazione ha impedito ad AWS di abilitare l’autenticazione Kerberos sull’istanza database. Correggi il problema di configurazione prima di inviare nuovamente il comando per modificare l’istanza database.
+ `disabling-kerberos`— AWS sta disabilitando l'Kerberosautenticazione su questa istanza DB.
Una richiesta di abilitare l’autenticazione Kerberos potrebbe non andare a buon fine a causa di un problema di connettività di rete o un ruolo IAM non corretto. In alcuni casi, il tentativo di abilitare l’autenticazione Kerberos potrebbe non riuscire quando crei o modifichi un’istanza database. In questo caso, assicurati che sia in uso il ruolo IAM corretto, quindi modifica l’istanza database per l’aggiunta al dominio.
# Configurazione dell’autenticazione Kerberos per le istanze database Amazon RDS per Db2
Si utilizza AWS Directory Service for Microsoft Active Directory (AWS Managed Microsoft AD) per configurare Kerberos l'autenticazione per un'istanza DB RDS for Db2. Per configurare l’autenticazione Kerberos, segui questa procedura:
**Topics**
+ [Passaggio 1: creare una directory utilizzando AWS Managed Microsoft AD](#db2-kerberos-setting-up.create-directory)
+ [Fase 2: creazione di un trust](#db2-kerberos-setting-up-create-forest-trust)
+ [Fase 3: creare un ruolo IAM a cui accedere ad Amazon RDS Directory Service](#db2-kerberos-setting-up-create-iam-role)
+ [Fase 4: creazione e configurazione di utenti](#db2-kerberos-setting-up.create-users)
+ [Passaggio 5: crea un gruppo di amministratori RDS for Db2 in AWS Managed Microsoft AD](#db2-kerberos-setting-up-vpc-peering)
+ [Fase 6: modifica del parametro di database](#db2-kerberos-setting-up-modify-db-parameter)
+ [Fase 7: creazione o modifica di un’istanza database RDS per Db2](#db2-kerberos-setting-up-create-modify)
+ [Fase 8: Recuperare il SID del gruppo Active Directory in PowerShell](#db2-kerberos-setting-up-retrieve-ad-group-sid)
+ [Passaggio 9: aggiungere il SID alle GroupName mappature all'istanza DB RDS for Db2](#db2-kerberos-setting-up-add-sid-group-mapping)
+ [Fase 10: configurazione di un client Db2](#db2-kerberos-setting-up-create-logins)
## Passaggio 1: creare una directory utilizzando AWS Managed Microsoft AD
Directory Service crea un file completamente gestito Active Directory in Cloud AWS. Quando crei una AWS Managed Microsoft AD directory, Directory Service crea automaticamente due controller di dominio e server DNS. I server di directory vengono creati in sottoreti diverse in un VPC. Questa ridondanza assicura che la directory rimanga accessibile anche se si verifica un errore.
Quando crei una AWS Managed Microsoft AD directory, Directory Service esegue le seguenti attività per tuo conto:
+ Configura una Active Directory all’interno del VPC.
+ Crea un account amministratore della directory con il nome utente `Admin` e la password specificata. Puoi utilizzare questo account per gestire le directory.
**Importante**
Assicurati di salvare questa password. Directory Service non memorizza questa password e non può essere recuperata o reimpostata.
+ Crea un gruppo di sicurezza per i controller della directory. Il gruppo di sicurezza deve consentire la comunicazione con l’istanza database RDS per Db2.
All'avvio AWS Directory Service for Microsoft Active Directory, AWS crea un'unità organizzativa (OU) che contiene tutti gli oggetti della directory. Questa unità organizzativa, che ha lo stesso nome NetBIOS che hai immesso al momento della creazione della directory, si trova nella radice del dominio. La radice del dominio è di proprietà e gestita da AWS.
L'`Admin`account creato con la AWS Managed Microsoft AD directory dispone delle autorizzazioni per le attività amministrative più comuni dell'unità organizzativa:
+ creazione, aggiornamento o eliminazione di utenti;
+ aggiunta di risorse al dominio, come file server o server di stampa, e assegnazione delle autorizzazioni per tali risorse a utenti dell’unità organizzativa;
+ Crea contenitori aggiuntivi OUs e.
+ delega dell'autorità;
+ ripristino degli oggetti eliminati dal Cestino di Active Directory;
+ esecuzione dei moduli Active Directory e DNS (Domain Name Service) per Windows PowerShell in Directory Service.
L'account `Admin` dispone anche dei diritti per eseguire queste attività in tutto il dominio:
+ gestione delle configurazioni DNS (aggiunta, eliminazione o aggiornamento di record, zone e server d'inoltro);
+ visualizzazione di log di eventi DNS;
+ visualizzazione di log di eventi di sicurezza.
**Per creare una directory con AWS Managed Microsoft AD**
1. Accedi a Console di gestione AWS e apri la Directory Service console all'indirizzo [https://console.aws.amazon.com/directoryservicev2/](https://console.aws.amazon.com/directoryservicev2/).
1. Scegli **Configura directory**.
1. Scegliete **AWS Managed Microsoft AD**. AWS Managed Microsoft AD è l'unica opzione attualmente supportata per l'uso con Amazon RDS.
1. Scegli ******Next (Successivo)******.
1. Nella pagina ******Enter directory information (Inserisci le informazioni sulla directory)****** inserisci le seguenti informazioni:
+ **Edizione**: scegli l’edizione che soddisfa i tuoi requisiti.
+ **Nome DNS della directory******: il nome completo della directory, ad esempio `corp.example.com`.
+ **Nome NetBIOS della directory******: un nome breve opzionale per la directory, ad esempio `CORP`.
+ **Descrizione della directory**: una descrizione opzionale della directory.
+ **Password amministratore******: la password per l’amministratore della directory. Durante il processo di creazione della directory viene generato un account amministratore con nome utente `Admin` e questa password.
La password dell'amministratore della directory non può includere il termine "admin". La password distingue tra maiuscole e minuscole e la lunghezza deve essere compresa tra 8 e 64 caratteri. Deve anche contenere un carattere di almeno tre delle seguenti quattro categorie:
+ Lettere minuscole (a–z)
+ Lettere maiuscole (A–Z)
+ Numeri (0–9)
+ Caratteri non alfanumerici (\$1\$1@\$1\$1%^&\$1\$1-\$1=`\$1\$1()\$1\$1[]:;"'<>,.?/)
+ Conferma la password: digita di nuovo la password di amministratore.
**Importante**
Assicurati di salvare questa password. Directory Service non memorizza questa password e non può essere recuperata o reimpostata.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Choose VPC and subnets (Scegli VPC e sottoreti)** fornire le seguenti informazioni:
+ **VPC**: scegli il VPC per la directory. L’istanza database RDS per Db2 può essere creata in questo VPC o in uno diverso.
+ **Sottoreti**: seleziona le sottoreti per i server di directory. Le due sottoreti devono trovarsi in diverse zone di disponibilità.
1. Seleziona **Next** (Successivo).
1. Verificare le informazioni della directory Se sono necessarie modifiche, seleziona **Previous (Precedente)** e apporta le modifiche. Quando le informazioni sono corrette, scegli **Create Directory (Crea directory)**.
![\[La finestra Rivedi e crea durante la creazione della directory nella Directory Service console.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/db2-create-ADS-directory.png)
Per creare la directory sono necessari alcuni minuti. Una volta creata correttamente la directory, il valore **Status (Stato)** viene modificato in **Active (Attivo)**.
Per visualizzare informazioni sulla tua directory, seleziona l’ID della directory in **ID directory**. Prendere nota del valore **Directory ID (ID directory)**. Questo valore è necessario per creare o modificare l’istanza database RDS per Db2.
![\[La sezione dei dettagli della directory con l'ID della directory nella Directory Service console.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/db2-ADS-directory-details.png)
## Fase 2: creazione di un trust
Se prevedi di utilizzare solo AWS Managed Microsoft AD, passa a[Fase 3: creare un ruolo IAM a cui accedere ad Amazon RDS Directory Service](#db2-kerberos-setting-up-create-iam-role).
Per abilitare l’autenticazione Kerberos utilizzando Active Directory autogestito, devi creare una relazione di trust tra foreste tra Active Directory autogestito e . Un forest trust è una relazione di trust tra Microsoft AD e un Active Directory autogestito e quella AWS Managed Microsoft AD creata nel passaggio precedente. Il trust può anche essere bidirezionale, in cui entrambe le Active Directory si considerano reciprocamente attendibili. Per ulteriori informazioni sulla configurazione dei trust delle foreste utilizzando Directory Service, vedere [Quando creare una relazione di trust](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_tutorial_setup_trust.html) nella *AWS Directory Service Administration Guide*.
## Fase 3: creare un ruolo IAM a cui accedere ad Amazon RDS Directory Service
Affinché Amazon RDS possa Directory Service chiamarti, hai Account AWS bisogno di un ruolo IAM che utilizzi la policy `AmazonRDSDirectoryServiceAccess` IAM gestita. Questo ruolo permette ad Amazon RDS di effettuare chiamate a Directory Service.
Quando crei un'istanza DB utilizzando Console di gestione AWS e l'account utente della console dispone dell'`iam:CreateRole`autorizzazione, la console crea automaticamente il ruolo IAM necessario. In questo caso, il nome del ruolo è `rds-directoryservice-kerberos-access-role`. In caso contrario, è necessario creare manualmente il ruolo IAM. Quando crei questo ruolo IAM`Directory Service`, scegli e allega la policy AWS gestita `AmazonRDSDirectoryServiceAccess` ad esso.
Per ulteriori informazioni sulla creazione di ruoli IAM per un servizio, consulta [Creating a role to delegate permissions to an AWS service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) nella *IAM User* Guide.
**Nota**
Il ruolo IAM utilizzato per l’autenticazione Windows per RDS per Microsoft SQL Server non può essere utilizzato per RDS per Db2.
Facoltativamente, puoi creare policy con le autorizzazioni richieste anziché utilizzare la policy `AmazonRDSDirectoryServiceAccess` gestita. In questo caso, il ruolo IAM deve avere la seguente policy di attendibilità IAM:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": [
"directoryservice.rds.amazonaws.com",
"rds.amazonaws.com"
]
},
"Action": "sts:AssumeRole"
}
]
}
```
------
Il ruolo deve anche disporre della seguente policy del ruolo IAM:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"ds:DescribeDirectories",
"ds:AuthorizeApplication",
"ds:UnauthorizeApplication",
"ds:GetAuthorizedApplicationDetails"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
## Fase 4: creazione e configurazione di utenti
Puoi creare utenti utilizzando lo strumento Active Directory Users and Computers. Si tratta di uno degli strumenti di Active Directory Domain Services e Active Directory Lightweight Directory Services. Per ulteriori informazioni, consulta [Add Users and Computers to the Active Directory domain](https://learn.microsoft.com/en-us/troubleshoot/windows-server/identity/create-an-active-directory-server#add-users-and-computers-to-the-active-directory-domain) nella documentazione di Microsoft. In questo caso, gli utenti sono persone o altre entità, ad esempio i loro computer, che fanno parte del dominio e le cui identità vengono conservate nella directory.
Per creare utenti in una Directory Service directory, devi essere connesso a un'istanza Amazon EC2 Windows basata che fa parte della Directory Service directory. Allo stesso tempo, devi avere effettuato l’accesso come un utente che dispone dei privilegi per creare utenti. Per ulteriori informazioni, consulta [Creazione di un utente](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_manage_users_groups_create_user.html) nella *Guida di amministrazione di AWS Directory Service *.
## Passaggio 5: crea un gruppo di amministratori RDS for Db2 in AWS Managed Microsoft AD
RDS per Db2 non supporta l’autenticazione Kerberos per l’utente principale o per i due utenti riservati di Amazon RDS `rdsdb` e `rdsadmin`. Invece, devi creare un nuovo gruppo chiamato `masterdba` in AWS Managed Microsoft AD. Per ulteriori informazioni, consulta [Create a Group Account in Active Directory](https://learn.microsoft.com/en-us/windows/security/operating-system-security/network-security/windows-firewall/create-a-group-account-in-active-directory) nella documentazione Microsoft. Tutti gli utenti aggiunti a questo gruppo avranno i privilegi dell’utente principale.
Dopo aver abilitato l’autenticazione Kerberos, l’utente principale perde il ruolo `masterdba`. Di conseguenza, l’utente principale non sarà in grado di accedere all’appartenenza al gruppo di utenti locali dell’istanza a meno che venga disabilitata l’autenticazione Kerberos. Per continuare a utilizzare l’utente principale con accesso tramite password, crea un utente AWS Managed Microsoft AD con lo stesso nome dell’utente principale. Quindi, aggiungi entrambi gli utenti al gruppo `masterdba`.
## Fase 6: modifica del parametro di database
Se prevedi di utilizzarlo AWS Managed Microsoft AD solo, vai a[Fase 7: creazione o modifica di un’istanza database RDS per Db2Fase 7: creazione o modifica di un’istanza database](#db2-kerberos-setting-up-create-modify).
Per abilitare l’autenticazione Kerberos utilizzando Active Directory autogestito, devi impostare il parametro `AWS_MANAGED_AD_WITH_TRUST` su `rds.active_directory_configuration` nel gruppo di parametri. Per impostazione predefinita, questo parametro è impostato solo `AWS_MANAGED_AD` per l'utilizzo di AWS Managed Microsoft AD.
Per informazioni sulla modifica dei parametri di database, consulta [Modifica dei parametri nei gruppi di parametri](db2-supported-parameters.md#db2-modifying-parameter-group-parameters).
## Fase 7: creazione o modifica di un’istanza database RDS per Db2
Crea o modifica un’istanza database RDS per Db2 per l’utilizzo con la directory. Puoi utilizzare la Console di gestione AWS, la AWS CLI o l’API RDS per associare un’istanza database a una directory. Questa operazione può essere eseguita in uno dei seguenti modi:
+ Crea una nuova istanza database RDS per Db2 utilizzando la console, il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) o l’operazione API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html). Per istruzioni, consulta [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md).
+ Modifica un'istanza DB RDS for Db2 esistente utilizzando la console, il [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)comando o l'operazione [Modify DBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) API. Per istruzioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
+ Ripristina un’istanza database RDS per Db2 da uno snapshot di database utilizzando la console, il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html) o l’operazione API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html). Per istruzioni, consulta [Ripristino in un’istanza database](USER_RestoreFromSnapshot.md).
+ Ripristina un'istanza DB RDS for Db2 point-in-time utilizzando la console, il [https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html)comando o l'operazione API. [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html) Per istruzioni, consulta [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
L’autenticazione Kerberos è supportata solo per istanze database RDS per Db2 in un VPC. L’istanza database può trovarsi nello stesso VPC della directory o in un VPC diverso. L’istanza database deve utilizzare un gruppo di sicurezza che accetta traffico in ingresso e in uscita all’interno del VPC della directory, in modo che l’istanza database possa comunicare con la directory.
### Console
Quando utilizzi la console per creare, modificare o ripristinare un’istanza database, scegli **Autenticazione di password e Kerberos** nella sezione **Autenticazione database**. Quindi scegli **Sfoglia directory**. Seleziona la directory o scegli **Crea directory** per utilizzare il servizio directory.
![\[La sezione Autenticazione database con l’opzione Autenticazione di password e Kerberos selezionata nella console Amazon RDS.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/db2-database-authentication-directory.png)
### AWS CLI
Quando si utilizza il AWS CLI, sono necessari i seguenti parametri affinché l'istanza DB possa utilizzare la directory creata:
+ Per il parametro `--domain`, utilizza l’identificatore di dominio (identificatore “`d-*`”) generato durante la creazione della directory.
+ Per il parametro `--domain-iam-role-name`, utilizza il ruolo creato che utilizza la policy IAM gestita `AmazonRDSDirectoryServiceAccess`.
Il comando seguente modifica un’istanza database per utilizzare una directory. Sostituisci i segnaposto seguenti con i tuoi valori:
+ *db\$1instance\$1name*— Il nome dell'istanza DB RDS for Db2.
+ *directory\$1id*— L'ID della AWS Directory Service for Microsoft Active Directory directory che hai creato.
+ *role\$1name*— Il nome del ruolo IAM che hai creato.
```
aws rds modify-db-instance --db-instance-identifier db_instance_name --domain d-directory_id --domain-iam-role-name role_name
```
**Importante**
Se modifichi un’istanza database per abilitare l’autenticazione Kerberos, riavvia l’istanza database dopo aver apportato la modifica.
## Fase 8: Recuperare il SID del gruppo Active Directory in PowerShell
Un ID di sicurezza (SID) identifica in modo univoco un principale di sicurezza o un gruppo di sicurezza. Quando si crea un account o un gruppo di sicurezza in Active Directory, Active Directory assegna un SID al gruppo. Per recuperare il SID del gruppo di sicurezza AD da Active Directory, usa il cmdlet `Get-ADGroup` in un computer client Windows che fa parte del dominio Active Directory. Il parametro `Identity` specifica il nome del gruppo Active Directory per cui recuperare il SID.
L’esempio seguente restituisce il SID del gruppo Active Directory `adgroup1`.
```
C:\Users\Admin> Get-ADGroup -Identity adgroup1 | select SID
SID
-----------------------------------------------
S-1-5-21-3168537779-1985441202-1799118680-1612
```
È necessario generare questa mappatura per tutti i gruppi rilevanti per il database.
## Passaggio 9: aggiungere il SID alle GroupName mappature all'istanza DB RDS for Db2
È necessario aggiungere il SID alle GroupName mappature create nel passaggio precedente all'istanza DB RDS for Db2. Per ogni mappatura, chiama la seguente stored procedure. Sostituisci *SID* e con le tue informazioni. *group\$1name*
```
db2 connect to rdsadmin
db2 "call rdsadmin.set_sid_group_mapping(?, 'SID','group_name')"
```
Per ulteriori informazioni, consulta [rdsadmin.set\$1sid\$1group\$1mapping](db2-sp-granting-revoking-privileges.md#db2-sp-set-sid-group-mapping).
Per informazioni sulla verifica dello stato delle attività, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## Fase 10: configurazione di un client Db2
**Per configurare un client Db2**
1. Crea un file **/etc/krb5.conf** (o equivalente) che punti al dominio.
**Nota**
Per i sistemi operativi Windows, crea un file **C:\$1windows\$1krb5.ini**.
1. Verifica che il traffico possa fluire tra l'host del client e Directory Service. Utilizza un’utilità di rete come Netcat per le seguenti attività:
1. Verifica il traffico su DNS per la porta 53.
1. Verifica il traffico verso TCP/UDP la porta 53 e versoKerberos, che include le porte 88 e 464 per Directory Service.
1. Verifica che il traffico scorra senza problemi tra l'host client e l'istanza database sulla porta del database. Puoi utilizzare il comando `db2` per connetterti e accedere al database.
L'esempio seguente è il contenuto del file /etc/krb5.conf per: AWS Managed Microsoft AD
```
[libdefaults]
default_realm = EXAMPLE.COM
[realms]
EXAMPLE.COM = {
kdc = example.com
admin_server = example.com
}
[domain_realm]
.example.com = EXAMPLE.COM
example.com = EXAMPLE.COM
```
# Connessione ad Amazon RDS per Db2 mediante l’autenticazione Kerberos
Utilizza la seguente procedura per stabilire una connessione a un’istanza database Amazon RDS per Db2 mediante l’autenticazione Kerberos.
**Per connetterti ad Amazon RDS per Db2 mediante l’autenticazione Kerberos**
1. Al prompt dei comandi, esegui il comando seguente . Nell'esempio seguente, sostituiscilo *username* con il tuo Microsoft Active Directory nome utente.
```
kinit username
```
1. Se l’istanza database RDS per Db2 utilizza un VPC accessibile pubblicamente, aggiungi l’indirizzo IP dell’endpoint dell’istanza database al file `/etc/hosts` sul client Amazon EC2. L’esempio seguente ottiene l’indirizzo IP e lo inserisce nel file `/etc/hosts`.
```
% dig +short Db2-endpoint.AWS-Region.rds.amazonaws.com
;; Truncated, retrying in TCP mode.
ec2-34-210-197-118.AWS-Region.compute.amazonaws.com.
34.210.197.118
% echo "34.210.197.118 Db2-endpoint.AWS-Region.rds.amazonaws.com" >> /etc/hosts
```
1. Utilizza il comando seguente per accedere a un’istanza database RDS per Db2 associata a Active Directory. Sostituiscilo *database\$1name* con il nome del tuo database RDS for Db2.
```
db2 connect to database_name
```
# Amministrazione dell’istanza database Amazon RDS per Db2
Di seguito sono riportate le attività di gestione comuni che si eseguono con un’istanza database Amazon RDS per Db2. Alcune attività sono uguali per tutte le istanze database Amazon RDS. Altre invece sono specifiche di RDS per Db2.
Le attività riportate di seguito sono comuni a tutti i database RDS. Esistono anche attività specifiche di RDS per Db2, come la connessione a un database RDS per Db2 con un client SQL standard.
| Area attività | Documentazione di riferimento |
| --- | --- |
| **Classi delle istanze, storage e PIOPS** Se si sta creando un'istanza di produzione, occorre conoscere il funzionamento di classi di istanza, tipi di storage e IOPS con provisioning in Amazon RDS. | [Classi di istanze DB ](Concepts.DBInstanceClass.md) [Tipi di storage Amazon RDS](CHAP_Storage.md#Concepts.Storage) |
| **Implementazioni Multi-AZ** Un'istanza database in produzione deve utilizzare implementazioni Multi-AZ. Le implementazioni Multi-AZ forniscono alle istanze database maggior disponibilità, longevità dei dati e tolleranza ai guasti. | [Configurazione e gestione di un’implementazione Multi-AZ per Amazon RDS](Concepts.MultiAZ.md) |
| **Amazon VPC** Se Account AWS disponi di un cloud privato virtuale (VPC) predefinito, l'istanza DB viene creata automaticamente all'interno del VPC predefinito. Se l'account non dispone di un VPC predefinito e desideri che l'istanza database sia in un VPC, è necessario creare il VPC e i gruppi di sottoreti prima di creare l'istanza database. | [Uso di un'istanza database in un VPC](USER_VPC.WorkingWithRDSInstanceinaVPC.md) |
| **Gruppi di sicurezza** Per impostazione predefinita, le istanze database utilizzano un firewall che impedisce l'accesso. Per accedere all'istanza database, assicurati di aver creato un gruppo di sicurezza con gli indirizzi IP e la configurazione di rete corretti. | [Controllo dell'accesso con i gruppi di sicurezza](Overview.RDSSecurityGroups.md) |
| **Gruppi di parametri** Poiché l’istanza database RDS per Db2 richiede l’aggiunta dei parametri `rds.ibm_site_id` e `rds.ibm_customer_id`, crea un gruppo di parametri prima di creare l’istanza database. Se la tua istanza database richiede altri parametri di database specifici, aggiungili a questo gruppo di parametri prima di creare l’istanza database. | [Aggiunta IBM IDs a un gruppo di parametri per RDS per istanze DB Db2](db2-licensing.md#db2-licensing-options-byol-adding-ids) [Gruppi di parametri per Amazon RDS](USER_WorkingWithParamGroups.md) |
| **Gruppi di opzioni** Se l'istanza database richiede opzioni database specifiche, crea un gruppo di opzioni prima di creare l'istanza database. | [Opzioni per le istanze database Amazon RDS per Db2](Db2.Options.md) |
| **Connessione all'istanza database** Dopo aver creato un gruppo di sicurezza e averlo associato a un’istanza database, puoi connetterti all’istanza database mediante un’applicazione client SQL standard, come IBM Db2 CLP. | [Connessione all’istanza database Db2](USER_ConnectToDb2DBInstance.md) |
| **Backup e ripristino** Puoi configurare l’istanza database affinché effettui backup automatici dell’archiviazione oppure acquisire snapshot manuali dell’archiviazione ed eseguire il ripristino di istanze dai backup o dagli snapshot. | [Backup, ripristino ed esportazione dei dati](CHAP_CommonTasks.BackupRestore.md) |
| **Monitoraggio** È possibile monitorare un’istanza database RDS per Db2 con IBM Db2 Data Management Console. Puoi anche monitorare un'istanza DB RDS for Db2 utilizzando i parametri, gli eventi e il monitoraggio avanzato di CloudWatch Amazon RDS. | [Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md) [Visualizzazione dei parametri nella console Amazon RDS](USER_Monitoring.md) [Visualizzazione di eventi Amazon RDS](USER_ListEvents.md) [Monitoraggio dei parametri del sistema operativo con il monitoraggio avanzato](USER_Monitoring.OS.md) |
| **File di log** È possibile accedere ai file di log per le istanze database RDS per Db2. | [Monitoraggio dei file di log di Amazon RDS](USER_LogAccess.md) |
**Topics**
+ [Esecuzione di attività di sistema comuni per le istanze database Amazon RDS per Db2](db2-performing-common-system-tasks-db-instances.md)
+ [Esecuzione di attività di database comuni per le istanze database Amazon RDS per Db2](db2-performing-common-database-tasks-db-instances.md)
# Esecuzione di attività di sistema comuni per le istanze database Amazon RDS per Db2
Nelle istanze database Amazon RDS che eseguono Db2 è possibile eseguire determinate attività di Database Administrator comuni relative al sistema. Per fornire un'esperienza di servizio gestito, Amazon RDS non fornisce accesso shell alle istanze database e limita l'accesso a certe procedure e tabelle di sistema che richiedono privilegi avanzati.
Per informazioni sulla concessione e la revoca dei privilegi e sul collegamento al database remoto per RDS per Db2, consulta i seguenti argomenti.
**Argomenti**
+ [Concessione e revoca dei privilegi per RDS per Db2](db2-granting-revoking-privileges.md)
+ [Collegamento all’istanza database RDS per Db2 remota](db2-attaching-to-remote.md)
## Creazione di un endpoint personalizzato per il database
Quando esegui la migrazione ad Amazon RDS for Db2, puoi utilizzare un endpoint di database personalizzato per ridurre al minimo URLs le modifiche all'applicazione. Ad esempio, se utilizzi `db2.example.com` come record DNS corrente, puoi aggiungerlo ad Amazon Route 53. In Route 53, puoi utilizzare zone ospitate private per mappare l’endpoint del database DNS corrente a un endpoint del database RDS per Db2. Per aggiungere un record `A` o `CNAME` personalizzato per un endpoint del database Amazon RDS, consulta [Come registrare e gestire domini tramite Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar.html) nella *Guida per sviluppatori di Amazon Route 53*.
**Nota**
Se non riesci a trasferire il dominio in Route 53, puoi utilizzare il tuo provider DNS per creare un record `CNAME` per l’URL dell’endpoint del database RDS per Db2. Consulta la documentazione del tuo provider DNS.
# Concessione e revoca dei privilegi per RDS per Db2
Gli utenti ottengono l’accesso ai database tramite l’appartenenza a gruppi collegati ai database.
Utilizza le seguenti procedure per concedere e revocare i privilegi per controllare l’accesso al database.
Queste procedure utilizzano IBM Db2 CLP in esecuzione su un computer locale per connettersi a un’istanza database RDS per Db2. Assicurati di catalogare il nodo TCPIP e il database per connetterti all’istanza database RDS per Db2 in esecuzione sul tuo computer locale. Per ulteriori informazioni, consulta [Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 CLP](db2-connecting-with-clp-client.md).
**Topics**
+ [Concessione dell’accesso al database a un utente](#db2-granting-user-access)
+ [Modifica della password di un utente](#db2-changing-user-password)
+ [Aggiunta di gruppi a un utente](#db2-adding-group-to-user)
+ [Rimozione di gruppi da un utente](#db2-removing-groups-from-user)
+ [Rimozione di un utente](#db2-removing-user)
+ [Elencare gli utenti](#db2-listing-users-database)
+ [Creazione di un ruolo](#db2-creating-role)
+ [Concessione di un ruolo](#db2-granting-role)
+ [Revoca di un ruolo](#db2-revoking-role)
+ [Eliminazione di un ruolo](#db2-dropping-role)
+ [Concessione dell’autorizzazione per il database](#db2-granting-dbadmin-auth)
+ [Revoca dell’autorizzazione per il database](#db2-revoking-dbadmin-auth)
## Concessione dell’accesso al database a un utente
**Per concedere a un utente l’accesso al tuo database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
Questo comando genera un output simile all’esempio seguente:
```
Database Connection Information
Database server = DB2/LINUXX8664 11.5.8.0
SQL authorization ID = ADMIN
Local database alias = RDSADMIN
```
1. Aggiungi un utente all’elenco di autorizzazioni chiamando `rdsadmin.add_user`. Per ulteriori informazioni, consulta [rdsadmin.add\$1user](db2-sp-granting-revoking-privileges.md#db2-sp-add-user).
```
db2 "call rdsadmin.add_user(
'username',
'password',
'group_name,group_name')"
```
1. (Facoltativo) Aggiungi altri gruppi all’utente chiamando `rdsadmin.add_groups`. Per ulteriori informazioni, consulta [rdsadmin.add\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-add-groups).
```
db2 "call rdsadmin.add_groups(
'username',
'group_name,group_name')"
```
1. Conferma le autorità disponibili per l’utente. Nell'esempio seguente *rds\$1database\$1alias**master\$1user*, sostituisci e *master\$1password* con le tue informazioni. Inoltre, *username* sostituiscilo con il nome utente dell'utente.
```
db2 terminate
db2 connect to rds_database_alias user master_user using master_password
db2 "SELECT SUBSTR(AUTHORITY,1,20) AUTHORITY, D_USER, D_GROUP, D_PUBLIC
FROM TABLE (SYSPROC.AUTH_LIST_AUTHORITIES_FOR_AUTHID ('username', 'U') ) AS T
ORDER BY AUTHORITY"
```
Questo comando genera un output simile all’esempio seguente:
```
AUTHORITY D_USER D_GROUP D_PUBLIC
-------------------- ------ ------- --------
ACCESSCTRL N N N
BINDADD N N N
CONNECT N N N
CREATETAB N N N
CREATE_EXTERNAL_ROUT N N N
CREATE_NOT_FENCED_RO N N N
CREATE_SECURE_OBJECT N N N
DATAACCESS N N N
DBADM N N N
EXPLAIN N N N
IMPLICIT_SCHEMA N N N
LOAD N N N
QUIESCE_CONNECT N N N
SECADM N N N
SQLADM N N N
SYSADM * N *
SYSCTRL * N *
SYSMAINT * N *
SYSMON * N *
WLMADM N N N
```
1. Concedi i ruoli `ROLE_NULLID_PACKAGES`, `ROLE_TABLESPACES` e `ROLE_PROCEDURES` di RDS per Db2 al gruppo a cui hai aggiunto l’utente. Per ulteriori informazioni, consulta [Ruoli predefiniti di Amazon RDS per Db2](db2-default-roles.md).
**Nota**
Le istanze database RDS per Db2 vengono create in modalità `RESTRICTIVE`. Pertanto, i ruoli `ROLE_NULLID_PACKAGES`, `ROLE_TABLESPACES` e `ROLE_PROCEDURES` di RDS per Db2 concedono privilegi di esecuzione sui pacchetti `NULLID` per IBM Db2 CLP e Dynamic SQL. Questi ruoli concedono anche privilegi utente sui tablespace.
1. Connettiti al tuo database Db2. Nell'esempio seguente *database\$1name**master\$1user*, sostituisci e *master\$1password* con le tue informazioni.
```
db2 connect to database_name user master_user using master_password
```
1. Assegna il ruolo `ROLE_NULLED_PACKAGES` a un gruppo. Nell'esempio seguente, sostituiscilo *group\$1name* con il nome del gruppo a cui desideri aggiungere il ruolo.
```
db2 "grant role ROLE_NULLID_PACKAGES to group group_name"
```
1. Assegna il ruolo `ROLE_TABLESPACES` allo stesso gruppo. Nell'esempio seguente, sostituiscilo *group\$1name* con il nome del gruppo a cui desideri aggiungere il ruolo.
```
db2 "grant role ROLE_TABLESPACES to group group_name"
```
1. Assegna il ruolo `ROLE_PROCEDURES` allo stesso gruppo. Nell'esempio seguente, sostituiscilo *group\$1name* con il nome del gruppo a cui desideri aggiungere il ruolo.
```
db2 "grant role ROLE_PROCEDURES to group group_name"
```
1. Concedi le autorità `connect`, `bindadd`, `createtab` e `IMPLICIT_SCHEMA` al gruppo a cui hai aggiunto l’utente. Nell'esempio seguente, *group\$1name* sostituiscilo con il nome del secondo gruppo a cui hai aggiunto l'utente.
```
db2 "grant usage on workload SYSDEFAULTUSERWORKLOAD to public"
db2 "grant connect, bindadd, createtab, implicit_schema on database to group group_name"
```
1. Ripeti i passaggi da 4 a 6 per ogni gruppo aggiuntivo a cui hai aggiunto l’utente.
1. Testa l’accesso dell’utente connettendoti come tale utente, creando una tabella, inserendo valori nella tabella e restituendo dati dalla tabella. Nell'esempio seguente, sostituisci *rds\$1database\$1alias**username*, e *password* con il nome del database e il nome utente e la password dell'utente.
```
db2 connect to rds_database_alias user username using password
db2 "create table t1(c1 int not null)"
db2 "insert into t1 values (1),(2),(3),(4)"
db2 "select * from t1"
```
## Modifica della password di un utente
**Per cambiare la password di un utente**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Cambia la password chiamando `rdsadmin.change_password`. Per ulteriori informazioni, consulta [rdsadmin.change\$1password](db2-sp-granting-revoking-privileges.md#db2-sp-change-password).
```
db2 "call rdsadmin.change_password(
'username',
'new_password')"
```
## Aggiunta di gruppi a un utente
**Per aggiungere gruppi a un utente**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Aggiungi gruppi a un utente chiamando `rdsadmin.add_groups`. Per ulteriori informazioni, consulta [rdsadmin.add\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-add-groups).
```
db2 "call rdsadmin.add_groups(
'username',
'group_name,group_name')"
```
## Rimozione di gruppi da un utente
**Per rimuovere gruppi da un utente**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Rimuovi i gruppi chiamando `rdsadmin.remove_groups`. Per ulteriori informazioni, consulta [rdsadmin.remove\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-remove-groups).
```
db2 "call rdsadmin.remove_groups(
'username',
'group_name,group_name')"
```
## Rimozione di un utente
**Per rimuovere un utente dall’elenco di autorizzazioni**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Rimuovi un utente dall’elenco di autorizzazioni chiamando `rdsadmin.remove_user`. Per ulteriori informazioni, consulta [rdsadmin.remove\$1user](db2-sp-granting-revoking-privileges.md#db2-sp-remove-user).
```
db2 "call rdsadmin.remove_user('username')"
```
## Elencare gli utenti
Per elencare gli utenti in un elenco di autorizzazioni, chiama la stored procedure `rdsadmin.list_users`. Per ulteriori informazioni, consulta [rdsadmin.list\$1users](db2-sp-granting-revoking-privileges.md#db2-sp-list-users).
```
db2 "call rdsadmin.list_users()"
```
## Creazione di un ruolo
È possibile utilizzare la stored procedure [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role) per creare un ruolo.
**Per creare un ruolo**
1. Connettiti al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Imposta Db2 in modo che restituisca il contenuto come output.
```
db2 set serveroutput on
```
1. Creare un ruolo. Per ulteriori informazioni, consulta [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role).
```
db2 "call rdsadmin.create_role(
'database_name',
'role_name')"
```
1. Imposta Db2 in modo che non restituisca il contenuto come output.
```
db2 set serveroutput off
```
## Concessione di un ruolo
È possibile utilizzare la stored procedure [rdsadmin.grant\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-grant-role) per assegnare un ruolo a un ruolo, utente o gruppo.
**Per assegnare un ruolo**
1. Connettiti al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Imposta Db2 in modo che restituisca il contenuto come output.
```
db2 set serveroutput on
```
1. Assegna un ruolo. Per ulteriori informazioni, consulta [rdsadmin.grant\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-grant-role).
```
db2 "call rdsadmin.grant_role(
'database_name',
'role_name',
'grantee',
'admin_option')"
```
1. Imposta Db2 in modo che non restituisca il contenuto come output.
```
db2 set serveroutput off
```
## Revoca di un ruolo
È possibile utilizzare la stored procedure [rdsadmin.revoke\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-revoke-role) per revocare un ruolo da un ruolo, utente o gruppo.
**Per revocare un ruolo**
1. Connettiti al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Revoca un ruolo. Per ulteriori informazioni, consulta [rdsadmin.revoke\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-revoke-role).
```
db2 "call rdsadmin.revoke_role(
?,
'database_name',
'role_name',
'grantee')"
```
## Eliminazione di un ruolo
È possibile utilizzare la stored procedure [rdsadmin.drop\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-drop-role) per eliminare un ruolo.
**Per eliminare un ruolo**
1. Connettiti al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Elimina un ruolo. Per ulteriori informazioni, consulta [rdsadmin.drop\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-drop-role).
```
db2 "call rdsadmin.drop_role(
?,
'database_name',
'role_name')"
```
## Concessione dell’autorizzazione per il database
L’utente principale, che dispone dell’autorizzazione `DBADM`, può concedere l’autorizzazione `DBADM`, `ACCESSCTRL` o `DATAACCESS` a un ruolo, utente o gruppo.
**Per concedere l’autorizzazione per il database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Concedi l’accesso a un utente chiamando `rdsadmin.dbadm_grant`. Per ulteriori informazioni, consulta [rdsadmin.dbadm\$1grant](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-grant).
```
db2 "call rdsadmin.dbadm_grant(
?,
'database_name,
'authorization',
'grantee')"
```
**Esempio di caso d’uso**
La procedura seguente illustra come creare un ruolo, concedere l’autorizzazione `DBADM` al ruolo, assegnare il ruolo a un utente e concedere il ruolo a un gruppo.
****
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Crea un ruolo denominato `PROD_ROLE` per un database denominato `TESTDB`. Per ulteriori informazioni, consulta [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role).
```
db2 "call rdsadmin.create_role(
'TESTDB',
'PROD_ROLE')"
```
1. Assegna il ruolo a un utente denominato `PROD_USER`. All’utente `PROD_USER` viene concessa l’autorizzazione di amministrazione per assegnare ruoli. Per ulteriori informazioni, consulta [rdsadmin.grant\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-grant-role).
```
db2 "call rdsadmin.grant_role(
?,
'TESTDB',
'PROD_ROLE',
'USER PROD_USER',
'Y')"
```
1. (Facoltativo) Fornisci ulteriori autorizzazioni o privilegi. Nell’esempio seguente viene concessa l’autorizzazione `DBADM` a un ruolo denominato `PROD_ROLE` per un database denominato `FUNDPROD`. Per ulteriori informazioni, consulta [rdsadmin.dbadm\$1grant](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-grant).
```
db2 "call rdsadmin.dbadm_grant(
?,
'FUNDPROD',
'DBADM',
'ROLE PROD_ROLE')"
```
1. Termina la sessione.
```
db2 terminate
```
1. Connettiti al database `TESTDB` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to TESTDB user master_username using master_password
```
1. Aggiungi altre autorizzazioni al ruolo.
```
db2 "grant connect, implicit_schema on database to role PROD_ROLE"
```
1. Assegna il ruolo `PROD_ROLE` a un gruppo.
```
db2 "grant role PROD_ROLE to group PRODGRP"
```
Gli utenti che appartengono al gruppo `PRODGRP` possono ora eseguire azioni come la connessione al database `TESTDB`, la creazione di tabelle o la creazione di schemi.
## Revoca dell’autorizzazione per il database
L’utente principale, che dispone dell’autorizzazione `DBADM`, può revocare l’autorizzazione `DBADM`, `ACCESSCTRL` o `DATAACCESS` a un ruolo, utente o gruppo.
**Per revocare l’autorizzazione per il database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Revoca l’accesso utente chiamando `rdsadmin.dbadm_revoke`. Per ulteriori informazioni, consulta [rdsadmin.dbadm\$1revoke](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-revoke).
```
db2 "call rdsadmin.dbadm_revoke(
?,
'database_name,
'authorization',
'grantee')"
```
# Collegamento all’istanza database RDS per Db2 remota
Per collegarti all’istanza database RDS per Db2 remota ed eseguire le operazioni `get snapshot`, utilizza i passaggi descritti di seguito.
**Per collegarti all’istanza database RDS per Db2 remota**
1. Esegui una sessione IBM Db2 CLP lato client. Per informazioni su come catalogare l’istanza database RDS per Db2 e il database, consulta [Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 CLP](db2-connecting-with-clp-client.md). Prendi nota del nome utente e della password principale per l’istanza database RDS per Db2.
1. Effettua il collegamento all’istanza database RDS per Db2. Nell'esempio seguente *node\$1name**master\$1username*, sostituisci e *master\$1password* con il nome del nodo TCPIP che hai catalogato e il nome utente e la password principale per l'istanza DB RDS for Db2.
```
db2 attach to node_name user master_username using master_password
```
Dopo il collegamento all’istanza database RDS per Db2 remota, puoi eseguire i seguenti comandi e altri comandi `get snapshot`. Per ulteriori informazioni, consulta [GET SNAPSHOT command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-get-snapshot) nella documentazione di IBM Db2.
```
db2 list applications
db2 get snapshot for all databases
db2 get snapshot for database manager
db2 get snapshot for all applications
```
# Esecuzione di attività di database comuni per le istanze database Amazon RDS per Db2
Nelle istanze database Amazon RDS per Db2 è possibile eseguire determinate attività DBA comuni relative ai database. Per offrire un'esperienza di servizio gestito, Amazon RDS non fornisce accesso shell alle istanze database. Inoltre, l’utente master non può eseguire comandi o utilità che richiedono autorità `SYSADM`, `SYSMAINT` o `SYSCTRL`.
Per informazioni sulle attività comuni relative a pool di buffer, database e tablespace, fai riferimento agli argomenti elencati di seguito.
**Argomenti**
+ [Attività comuni per i pool di buffer](db2-managing-buffer-pools.md)
+ [Attività comuni per i database](db2-managing-databases.md)
+ [Attività comuni per i tablespace](db2-managing-tablespaces.md)
# Attività comuni per i pool di buffer
Puoi creare, modificare o eliminare i pool di buffer per un database RDS per Db2. La creazione, la modifica o l’eliminazione di pool di buffer richiede un’autorità `SYSADM` o `SYSCTRL` di livello superiore, di cui l’utente principale non dispone. Puoi invece utilizzare le stored procedure di Amazon RDS.
Puoi anche svuotare i pool di buffer.
**Topics**
+ [Creazione di un pool di buffer](#db2-creating-buffer-pool)
+ [Modifica di un pool di buffer](#db2-altering-buffer-pool)
+ [Eliminazione di un pool di buffer](#db2-dropping-buffer-pool)
+ [Svuotamento dei pool di buffer](#db2-flushing-buffer-pools)
## Creazione di un pool di buffer
Per creare un pool di buffer per il database RDS per Db2, chiama la stored procedure `rdsadmin.create_bufferpool`. Per ulteriori informazioni, consulta [CREATE BUFFERPOOL statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-create-bufferpool) nella documentazione di IBM Db2.
**Per creare un pool di buffer**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell’esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Crea un pool di buffer chiamando `rdsadmin.create_bufferpool`. Per ulteriori informazioni, consulta [rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool).
```
db2 "call rdsadmin.create_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
page_size,
number_block_pages,
block_size)"
```
## Modifica di un pool di buffer
Per modificare un pool di buffer per il database RDS per Db2, chiama la stored procedure `rdsadmin.alter_bufferpool`. Per ulteriori informazioni, consulta [ALTER BUFFERPOOL statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-alter-bufferpool) nella documentazione di IBM Db2.
**Per modificare un pool di buffer**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell’esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Modifica un pool di buffer chiamando `rdsadmin.alter_bufferpool`. Per ulteriori informazioni, consulta [rdsadmin.alter\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-alter-buffer-pool).
```
db2 "call rdsadmin.alter_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
change_number_blocks,
number_block_pages,
block_size)"
```
## Eliminazione di un pool di buffer
Per eliminare un pool di buffer per il database RDS per Db2, chiama la stored procedure `rdsadmin.drop_bufferpool`. Per ulteriori informazioni, consulta [Dropping buffer pools](https://www.ibm.com/docs/en/db2/11.5?topic=pools-dropping-buffer) nella documentazione di IBM Db2.
**Importante**
Assicurati che al pool di buffer da eliminare non sia assegnato alcun tablespace.
**Per eliminare un pool di buffer**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell’esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Elimina un pool di buffer chiamando `rdsadmin.drop_bufferpool`. Per ulteriori informazioni, consulta [rdsadmin.drop\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-drop-buffer-pool).
```
db2 "call rdsadmin.drop_bufferpool(
'database_name',
'buffer_pool_name')"
```
## Svuotamento dei pool di buffer
È possibile svuotare i pool di buffer per forzare un checkpoint in modo che RDS per Db2 scriva pagine dalla memoria all’archiviazione.
**Nota**
Non è necessario svuotare i pool di buffer. Db2 scrive i log in modo sincrono prima di eseguire il commit delle transazioni. È possibile che le pagine sporche si trovino ancora in un pool di buffer, ma Db2 le scrive nell’archiviazione in modo asincrono. Anche in caso di spegnimento imprevisto del sistema, al riavvio del database, Db2 esegue automaticamente il ripristino da arresto anomalo. Durante il ripristino da arresto anomalo, Db2 scrive nel database le modifiche di cui è stato eseguito il commit oppure esegue il rollback delle modifiche per le transazioni di cui non è stato eseguito il commit.
**Per svuotare i pool di buffer**
1. Connettiti al database Db2 utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell’esempio seguente, sostituisci *rds\$1database\$1alias*, *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Svuota i pool di buffer.
```
db2 flush bufferpools all
```
# Attività comuni per i database
Puoi creare, eliminare o ripristinare i database sulla tua istanza database RDS per Db2. La creazione, l’eliminazione o il ripristino di database richiede un’autorità `SYSADM` di livello superiore, di cui l’utente principale non dispone. Puoi invece utilizzare le stored procedure di Amazon RDS.
Puoi anche eseguire attività di gestione comuni come il monitoraggio, la manutenzione e la raccolta di informazioni sui tuoi database.
**Topics**
+ [Creazione di un database](#db2-creating-database)
+ [Configurazione delle impostazioni per un database](#db2-configuring-database)
+ [Modifica dei parametri del database](#db2-modifying-db-parameters)
+ [Configurazione della conservazione dei log](#db2-configuring-log-retention)
+ [Elencare le informazioni relative ai log](#db2-listing-log-information)
+ [Utilizzo del controllo degli accessi a grana fine (FGAC)](#db2-using-fine-grained-access-control)
+ [Disattivazione di un database](#db2-deactivating-database)
+ [Attivazione di un database](#db2-activating-database)
+ [Riattivazione di un database](#db2-reactivating-database)
+ [Eliminazione di un database.](#db2-dropping-database)
+ [Backup di un database](#db2-backing-up-database)
+ [Copiare i log di archivio su Amazon S3](#db2-copying-archive-logs-to-s3)
+ [Ripristino di un database](#db2-restoring-database)
+ [Elencare i database](#db2-listing-databases)
+ [Raccolta di informazioni sui database](#db2-collecting-info-db)
+ [Forzare la disconnessione di applicazioni dai database](#db2-forcing-application-off-db)
+ [Generazione di report sulle prestazioni](#db2-generating-performance-reports)
## Creazione di un database
Per creare un database sulla tua istanza database RDS per Db2, chiama la stored procedure `rdsadmin.create_database`. Per ulteriori informazioni, consulta [CREATE DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-create-database) nella documentazione di IBM Db2.
**Nota**
Se intendi modificare il parametro `db2_compatibility_vector`, modificalo prima di creare un database. Per ulteriori informazioni, consulta [Impostazione del parametro db2\$1compatibility\$1vector](db2-known-issues-limitations.md#db2-known-issues-limitations-db2-compatibility-vector).
**Come creare un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Crea un database chiamando `rdsadmin.create_database`. Per ulteriori informazioni, consulta [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
```
db2 "call rdsadmin.create_database(
'database_name',
'database_page_size',
'database_code_set',
'database_territory',
'database_collation',
'database_autoconfigure_str',
'database_non-restrictive')"
```
1. (Facoltativo) Crea database aggiuntivi chiamando `rdsadmin.create_database` per ogni database che desideri creare. Ogni istanza database Db2 può contenere fino a 50 database. Per ulteriori informazioni, consulta [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
```
db2 "call rdsadmin.create_database('database_name')"
```
1. (Facoltativo) Assicurati che il database sia stato creato utilizzando uno dei metodi seguenti:
+ Chiama `rdsadmin.list_databases`. Per ulteriori informazioni, consulta [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases).
+ Esegui il seguente comando SQL:
```
db2 "select varchar(r.task_type,25) as task_type, r.database_name,
varchar(r.lifecycle,15) as lifecycle, r.created_at, r.database_name,
varchar(bson_to_json(task_input_params),256) as input_params,
varchar(r.task_output,1024) as task_output
from table(rdsadmin.get_task_status(null,null,'create_database'))
as r order by created_at desc"
```
## Configurazione delle impostazioni per un database
Per configurare le impostazioni per un database sulla tua istanza database RDS per Db2, chiama la stored procedure `rdsadmin.set_configuration`. Ad esempio, puoi configurare il numero di buffer o manipolatori di buffer da creare durante un’operazione di ripristino.
**Per configurare le impostazioni per un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. (Facoltativo) Controlla le impostazioni di configurazione correnti chiamando `rdsadmin.show_configuration`. Per ulteriori informazioni, consulta [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration).
```
db2 "call rdsadmin.show_configuration('name')"
```
1. Configura le impostazioni per il database chiamando `rdsadmin.set_configuration`. Per ulteriori informazioni, consulta [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration).
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
## Modifica dei parametri del database
Amazon RDS per Db2 utilizza tre tipi di parametri: parametri di configurazione del gestore di database, variabili di registro e parametri di configurazione del database. È possibile aggiornare i primi due tipi tramite gruppi di parametri e l’ultimo tipo tramite la stored procedure [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).
**Nota**
È possibile modificare solo i valori di parametri esistenti. Non è possibile aggiungere nuovi parametri non supportati da RDS per Db2.
Per ulteriori informazioni su questi parametri e su come modificarne i valori, consulta [Parametri di Amazon RDS per Db2](db2-supported-parameters.md).
## Configurazione della conservazione dei log
Per configurare il tempo per cui Amazon RDS mantiene i file di log per il tuo database RDS per Db2, chiama la stored procedure `rdsadmin.set_archive_log_retention`.
**Per configurare la conservazione dei log per un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. (Facoltativo) Controlla la configurazione corrente per la conservazione dei log chiamando `rdsadmin.show_archive_log_retention`. Per ulteriori informazioni, consulta [rdsadmin.show\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-show-archive-log-retention).
```
db2 "call rdsadmin.show_archive_log_retention(
?,
'database_name')"
```
1. Configura la conservazione dei log per il database chiamando `rdsadmin.set_archive_log_retention`. Per ulteriori informazioni, consulta [rdsadmin.set\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-set-archive-log-retention).
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'database_name',
'archive_log_retention_hours')"
```
## Elencare le informazioni relative ai log
Per elencare i dettagli sui file di log di archivio, ad esempio la dimensione totale di archiviazione utilizzata, chiama la stored procedure `rdsadmin.list_archive_log_information`.
**Per elencare le informazioni relative ai log per un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Chiama `rdsadmin.list_archive_log_information` per ottenere un elenco di informazioni sui file di log. Per ulteriori informazioni, consulta [rdsadmin.list\$1archive\$1log\$1information](db2-sp-managing-databases.md#db2-sp-list-archive-log-information).
```
db2 "call rdsadmin.list_archive_log_information(
?,
'database_name')"
```
## Utilizzo del controllo degli accessi a grana fine (FGAC)
Per utilizzare comandi di controllo di accesso granulari per controllare l'accesso ai dati delle tabelle in un database su un'istanza DB RDS for Db2, chiamate la stored procedure. `rdsadmin.fgac_command` Potresti voler utilizzare FGAC per limitare l'accesso ai dati in base ai ruoli utente o agli attributi dei dati. Ad esempio, è possibile limitare l'accesso ai dati sanitari dei pazienti in base al tipo di dati o a determinati fornitori di assistenza medica.
**Utilizzare un controllo di accesso granulare per controllare l'accesso ai dati delle tabelle in un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Esegui vari comandi di controllo degli accessi dettagliati chiamando. `rdsadmin.fgac_command` Per ulteriori informazioni, consulta [rdsadmin.fgac\$1commandParameters](db2-sp-managing-databases.md#db2-sp-fgac-command).
```
db2 "call rdsadmin.fgac_command(
?,
'database_name',
'fgac_command')"
```
## Disattivazione di un database
Per disattivare un database sulla tua istanza database RDS per Db2, chiama la stored procedure `rdsadmin.deactivate_database`.
Per impostazione predefinita, Amazon RDS attiva un database quando si crea un database su un’istanza database RDS per Db2. È possibile disattivare i database di uso meno frequente per risparmiare risorse di memoria.
**Per disattivare un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Disattiva un database chiamando `rdsadmin.deactivate_database`. Per ulteriori informazioni, consulta [rdsadmin.deactivate\$1database](db2-sp-managing-databases.md#db2-sp-deactivate-database).
```
db2 "call rdsadmin.deactivate_database(
?,
'database_name')"
```
## Attivazione di un database
Per attivare un database su un’istanza database RDS per Db2 autonoma, chiama la stored procedure `rdsadmin.activate_database`.
Per impostazione predefinita, Amazon RDS attiva un database quando si crea un database su un’istanza database RDS per Db2. È possibile disattivare i database di uso meno frequente per risparmiare risorse di memoria, quindi attivare in seguito un database disattivato.
**Per attivare un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Attiva un database chiamando `rdsadmin.activate_database`. Per ulteriori informazioni, consulta [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database).
```
db2 "call rdsadmin.activate_database(
?,
'database_name')"
```
## Riattivazione di un database
Per riattivare un database su un’istanza database RDS per Db2 di origine replica, chiama la stored procedure `rdsadmin.reactivate_database`. Dopo aver apportato modifiche alle configurazioni del database, potrebbe essere necessario riattivare un database su un’istanza database RDS per Db2. Per stabilire se è necessario riattivare un database, connettiti al database ed esegui `db2 get db cfg show detail`.
Puoi anche chiamare questa stored procedure per riattivare un database su un’istanza database RDS per Db2 autonoma dopo aver apportato modifiche alla configurazione del database. In alternativa, è possibile riattivare un database su un’istanza database RDS per Db2 autonoma chiamando prima la stored procedure `rdsadmin.deactivate_database` e poi la stored procedure `rdsadmin.activate_database`. Per ulteriori informazioni, consultare [Disattivazione di un database](#db2-deactivating-database) e [Attivazione di un database](#db2-activating-database).
**Per riattivare un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Riattiva un database chiamando `rdsadmin.reactivate_database`. Per ulteriori informazioni, consulta [rdsadmin.reactivate\$1database](db2-sp-managing-databases.md#db2-sp-reactivate-database).
```
db2 "call rdsadmin.reactivate_database(
?,
'database_name')"
```
## Eliminazione di un database.
Per eliminare un database dalla tua istanza database RDS per Db2, chiama la stored procedure `rdsadmin.drop_database`. Per ulteriori informazioni, consulta [Dropping databases](https://www.ibm.com/docs/en/db2/11.5?topic=databases-dropping) nella documentazione di IBM Db2.
**Nota**
È possibile eliminare un database chiamando la stored procedure solo se sono soddisfatte determinate condizioni. Per ulteriori informazioni, consulta [Note per l’utilizzo](db2-sp-managing-databases.md#db2-sp-drop-database-usage-notes) per `rdsadmin.drop_database`.
**Per eliminare un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Elimina un database chiamando `rdsadmin.drop_database`. Per ulteriori informazioni, consulta [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database).
```
db2 "call rdsadmin.drop_database('database_name')"
```
## Backup di un database
Per eseguire il backup di un database nella tua istanza DB RDS for Db2 su Amazon S3, richiama `rdsadmin.backup_database` la stored procedure. Per ulteriori informazioni, consulta il [comando BACKUP DATABASE nella documentazione](https://www.ibm.com/docs/en/db2/11.5.x?topic=commands-backup-database). IBM Db2
**Nota**
Questa procedura memorizzata utilizza l'integrazione con Amazon S3. Assicurati di aver configurato l'integrazione prima di procedere. Per ulteriori informazioni, consulta [Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3](db2-s3-integration.md).
**Per eseguire il backup di un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Crea un endpoint gateway VPC per S3. Se disponi già di un endpoint gateway VPC per S3, vai al passaggio 4.
Affinché un'istanza DB RDS for Db2 sia in grado di interagire con Amazon S3, è necessario disporre di un VPC e di un endpoint gateway Amazon S3 per l'utilizzo di sottoreti private. Per ulteriori informazioni, consulta [Fase 1: creare un endpoint gateway VPC per Amazon S3](db2-troubleshooting.md#db2-creating-endpoint).
1. Conferma l'endpoint del gateway VPC per S3. Per ulteriori informazioni, consulta [Fase 2: verificare l’esistenza dell’endpoint gateway VPC per Amazon S3](db2-troubleshooting.md#db2-confirming-endpoint).
1. Esegui il backup di un database chiamando. `rdsadmin.backup_database` Per ulteriori informazioni, consulta [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database).
```
db2 "call rdsadmin.backup_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
'backup_type',
'compression_option',
'util_impact_priority',
'num_files',
'parallelism',
'num_buffers')"
```
1. Termina la connessione.
```
terminate
```
1. (Facoltativo) Verifica che i file di backup siano stati caricati nel tuo bucket Amazon S3 sotto. *s3\$1prefix/dbi\$1resource\$1id/db\$1name* Se i file non vengono visualizzati in*s3\$1prefix/dbi\$1resource\$1id/db\$1name*, controlla lo stato del backup del database per identificare eventuali problemi. Per ulteriori informazioni, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). Se non riesci a risolvere i problemi identificati, contatta l'[AWS assistenza](https://aws.amazon.com/premiumsupport/).
1. (Facoltativo) Una volta completato il backup su Amazon S3, puoi ripristinare il backup su un'istanza DB RDS for Db2 o in un'altra posizione, ad esempio un server locale. Per informazioni sul ripristino su un'istanza DB RDS for Db2, consulta. [Ripristino di un database](#db2-restoring-database)
## Copiare i log di archivio su Amazon S3
I log di archivio Db2 possono ora essere copiati dall'istanza DB RDS per Db2 su Amazon S3. I log di archivio combinati con il backup nativo creato utilizzando `rdsadmin.backup_database` possono essere utilizzati per ripristinare e riportare il database in modo che sia point-in-time su un'altra istanza RDS for Db2 o su un database EC2.
Prima di configurare questa funzionalità, utilizza la stored procedure per configurare il database RDS for `rdsadmin.backup_database` Db2.
Questa funzionalità funziona a livello di istanza DB RDS for Db2, sebbene la copia dei log di archivio possa essere abilitata o disabilitata per database.
**Per configurare la copia dei log di archivio su Amazon S3**
1. Connect al `rdsadmin` database utilizzando il nome utente principale e la password principale per l'istanza database RDS for Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Imposta il backup del registro degli archivi su S3 [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration) chiamando.
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
**Esempio**:
```
db2 "call rdsadmin.set_configuration('ARCHIVE_LOG_COPY_TARGET_S3_ARN', 'arn:aws:s3:::my_rds_db2_backups/archive-log-copy/')"
```
1. Abilita la copia del registro di archivio per un database chiamando. `rdsadmin.enable_archive_log_copy` *database\$1name*Sostituiscilo con il nome del tuo database.
```
db2 "call rdsadmin.enable_archive_log_copy(?, 'database_name')"
```
1. Allo stesso modo, per disabilitare la copia dei registri di archivio per un database, chiama`rdsadmin.disable_archive_log_copy`.
```
db2 "call rdsadmin.disable_archive_log_copy(?, 'database_name')"
```
1. Conferma lo stato della copia del registro di archivio `rdsadmin.list_databases` chiamando.
```
db2 "select * from table(rdsadmin.list_databases())"
```
**Output di esempio**:
```
DATABASE_NAME CREATE_TIME DATABASE_UNIQUE_ID ARCHIVE_LOG_RETENTION_HOURS ARCHIVE_LOG_COPY ARCHIVE_LOG_LAST_UPLOAD_FILE ARCHIVE_LOG_LAST_UPLOAD_FILE_TIME ARCHIVE_LOG_COPY_STATUS
--------------- -------------------------- -------------------------------------------------- --------------------------- ---------------- ---------------------------- --------------------------------- ------------------------------
RDSADMIN 2026-01-06-02.03.42.569069 RDSADMIN 0 DISABLED - - -
FOO 2026-01-06-02.13.42.885650 F0D81C7E-7213-4565-B376-4F33FCF420E3 7 ENABLED S0006536.LOG 2026-01-28-19.15.10.000000 UPLOADING
CODEP 2026-01-14-19.42.42.508476 106EEF95-6E30-4FFF-85AE-B044352DF095 0 DISABLED - - -
...
```
## Ripristino di un database
Per spostare un database da un bucket Amazon S3 alla tua istanza database RDS per Db2, chiama la stored procedure `rdsadmin.restore_database`. Per ulteriori informazioni, consulta [RESTORE DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-database) nella documentazione di IBM Db2.
**Per ripristinare un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. (Facoltativo) Controlla le impostazioni di configurazione correnti per ottimizzare l’operazione di ripristino chiamando `rdsadmin.show_configuration`. Per ulteriori informazioni, consulta [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration).
```
db2 "call rdsadmin.show_configuration('name')"
```
1. Configura le impostazioni per ottimizzare l’operazione di ripristino chiamando `rdsadmin.set_configuration`. L’impostazione esplicita di questi valori può migliorare le prestazioni durante il ripristino di database con grandi volumi di dati. Per ulteriori informazioni, consulta [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration).
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
1. Ripristina il database chiamando `rdsadmin.restore_database`. Per ulteriori informazioni, consulta [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database).
```
db2 "call rdsadmin.restore_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
restore_timestamp,
'backup_type')"
```
1. (Facoltativo) Assicurati che il database sia stato ripristinato chiamando `rdsadmin.list_databases` e controllando che il database ripristinato sia elencato. Per ulteriori informazioni, consulta [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases).
1. Riporta online il database e applica ulteriori log delle transazioni chiamando `rdsadmin.rollforward_database`. Per ulteriori informazioni, consulta [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database).
```
db2 "call rdsadmin.rollforward_database(
?,
'database_name',
's3_bucket_name',
s3_prefix,
'rollforward_to_option',
'complete_rollforward')"
```
1. (Facoltativo) Controlla lo stato della stored procedure `rdsadmin.rollforward_database` chiamando la stored procedure [rdsadmin.rollforward\$1status](db2-sp-managing-databases.md#db2-sp-rollforward-status).
1. Se hai impostato `complete_rollforward` su `FALSE` nel passaggio precedente, devi terminare di riportare online il database chiamando `rdsadmin.complete_rollforward`. Per ulteriori informazioni, consulta [rdsadmin.complete\$1rollforward](db2-sp-managing-databases.md#db2-sp-complete-rollforward).
```
db2 "call rdsadmin.complete_rollforward(
?,
'database_name')"
```
1. (Facoltativo) Controlla lo stato della stored procedure `rdsadmin.complete_rollforward` chiamando la stored procedure [rdsadmin.rollforward\$1status](db2-sp-managing-databases.md#db2-sp-rollforward-status).
## Elencare i database
Puoi elencare tutti i database in esecuzione su Amazon RDS per Db2 chiamando la funzione definita dall’utente `rdsadmin.list_databases`.
**Per elencare i tuoi database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Elenca i tuoi database chiamando `rdsadmin.list_databases`. Per ulteriori informazioni, consulta [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases).
```
db2 "select * from table(rdsadmin.list_databases())"
```
## Raccolta di informazioni sui database
Per raccogliere informazioni su un database su un’istanza database RDS per Db2, chiama la stored procedure `rdsadmin.db2pd_command`. Queste informazioni possono essere utili per il monitoraggio dei database o per la risoluzione dei problemi.
**Per raccogliere informazioni su un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Raccogli informazioni sul database chiamando `rdsadmin.db2pd_command`. Per ulteriori informazioni, consulta [rdsadmin.db2pd\$1command](db2-sp-managing-databases.md#db2-sp-db2pd-command).
```
db2 "call rdsadmin.db2pd_command('db2pd_cmd')"
```
## Forzare la disconnessione di applicazioni dai database
Per forzare la disconnessione di applicazioni da un database su un’istanza database RDS per Db2, chiama la stored procedure `rdsadmin.force_application`. Prima di eseguire la manutenzione dei database, forza la disconnessione delle applicazioni dai database.
**Per forzare la disconnessione delle applicazioni da un database**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Forza la disconnessione delle applicazioni da un database chiamando `rdsadmin.force_application`. Per ulteriori informazioni, consulta [rdsadmin.force\$1application](db2-sp-managing-databases.md#db2-sp-force-application).
```
db2 "call rdsadmin.force_application(
?,
'applications')"
```
## Generazione di report sulle prestazioni
È possibile generare report sulle prestazioni con una procedura o uno script. Per informazioni sull’utilizzo di una procedura, consulta [DBSUMMARY procedure ‐ Generate a summary report of system and application performance metrics](https://www.ibm.com/docs/en/db2/11.5?topic=mm-dbsummary-procedure-generate-summary-report-system-application-performance-metrics) nella documentazione di IBM Db2.
Db2 include un file `db2mon.sh` nella sua directory `~sqllib/sample/perf`. L’esecuzione dello script produce un report completo e a basso costo sulle metriche SQL. Per scaricare il file `db2mon.sh` e i file di script correlati, consulta la directory [https://github.com/IBM/db2-samples/tree/master/perf](https://github.com/IBM/db2-samples/tree/master/perf) nel repository GitHub IBM db2-samples.
**Per generare report sulle prestazioni con lo script**
1. Connettiti al database Db2 utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Crea un pool di buffer denominato `db2monbp` con una dimensione di pagina 4096 chiamando `rdsadmin.create_bufferpool`. Per ulteriori informazioni, consulta [rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool).
```
db2 "call rdsadmin.create_bufferpool('database_name','db2monbp',4096)"
```
1. Crea un tablespace temporaneo denominato `db2montmptbsp` che utilizza il pool di buffer `db2monbp` chiamando `rdsadmin.create_tablespace`. Per ulteriori informazioni, consulta [rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace).
```
db2 "call rdsadmin.create_tablespace('database_name',\
'db2montmptbsp','db2monbp',4096,1000,100,'T')"
```
1. Apri lo script `db2mon.sh` e modifica la riga relativa alla connessione a un database.
1. Rimuovi la seguente riga.
```
db2 -v connect to $dbName
```
1. Sostituisci la riga del passaggio precedente con la riga seguente. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con il nome utente principale e la password principale per l'istanza DB RDS for Db2.
```
db2 -v connect to $dbName user master_username using master_password
```
1. Rimuovi le seguenti righe.
```
db2 -v create bufferpool db2monbp
db2 -v create user temporary tablespace db2montmptbsp bufferpool db2monbp
db2 -v drop tablespace db2montmptbsp
db2 -v drop bufferpool db2monbp
```
1. Esegui lo script `db2mon.sh` per generare un report a determinati intervalli. Nell'esempio seguente, sostituitelo *absolute\$1path* con il percorso completo del file di script, *rds\$1database\$1alias* con il nome del database e *seconds* con il numero di secondi (da 0 a 3600) tra la generazione del report.
```
absolute_path/db2mon.sh rds_database_alias seconds | tee -a db2mon.out
```
**Esempi**
L’esempio seguente mostra che il file di script si trova nella directory `perf` sotto la directory `home`.
```
/home/db2inst1/sqllib/samples/perf/db2mon.sh rds_database_alias seconds | tee -a db2mon.out
```
1. Elimina il pool di buffer e il tablespace creati per il file `db2mon.sh`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con il nome utente principale e la password principale per l'istanza DB RDS for Db2. *database\$1name*Sostituiscilo con il nome del tuo database. Per ulteriori informazioni, consultare [rdsadmin.drop\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-drop-tablespace) e [rdsadmin.drop\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-drop-buffer-pool).
```
db2 connect to rdsadmin user master_username using master_password
db2 "call rdsadmin.drop_tablespace('database_name','db2montmptbsp')"
db2 "call rdsadmin.drop_bufferpool('database_name','db2monbp')"
```
## Gestione dello storage
Db2 utilizza l’archiviazione automatica per gestire l’archiviazione fisica degli oggetti del database quali tabelle, indici e file temporanei. Anziché allocare manualmente lo spazio di archiviazione e tenere traccia dei percorsi di archiviazione utilizzati, è possibile utilizzare l’archiviazione automatica che consente al sistema Db2 di creare e gestire i percorsi di archiviazione in base alle necessità. Ciò può semplificare l’amministrazione dei database Db2 e ridurre la probabilità di errori dovuti a errori umani. Per ulteriori informazioni, consulta [Automatic storage](https://www.ibm.com/docs/en/db2/11.5?topic=overview-automatic-storage) nella documentazione di IBM Db2.
Con RDS per Db2, è possibile aumentare dinamicamente le dimensioni di archiviazione con l’espansione automatica dei volumi logici e del file system. Per ulteriori informazioni, consulta [Uso dello storage per istanze database di Amazon RDS](USER_PIOPS.StorageTypes.md).
# Attività comuni per i tablespace
È possibile creare, modificare, rinominare o eliminare tablespace per un database RDS per Db2. La creazione, la modifica, la ridenominazione o l’eliminazione di tablespace richiede un’autorità `SYSADM` di livello superiore, di cui l’utente principale non dispone. Puoi invece utilizzare le stored procedure di Amazon RDS.
**Topics**
+ [Creazione di un tablespace](#db2-creating-tablespace)
+ [Modifica di un tablespace](#db2-altering-tablespace)
+ [Ridenominazione di un tablespace](#db2-renaming-tablespace)
+ [Eliminazione di un tablespace](#db2-dropping-tablespace)
+ [Controllo dello stato di un tablespace](#db2-checking-tablespaces-procedure)
+ [Restituzione di informazioni dettagliate sui tablespace](#db2-tablespaces-info-db2pd)
+ [Elencare lo stato e il gruppo di archiviazione per un tablespace](#db2-state-storage-group-tablespace-sql)
+ [Elencare i tablespace di una tabella](#db2-return-tablespaces-sql)
+ [Elencare i container di tablespace](#db2-listing-tablespace-containers)
## Creazione di un tablespace
Per creare un tablespace per il database RDS per Db2, chiama la stored procedure `rdsadmin.create_tablespace`. Per ulteriori informazioni, consulta [CREATE TABLESPACE statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-create-tablespace) nella documentazione di IBM Db2.
**Importante**
Per creare un tablespace, è necessario disporre di un pool di buffer della stessa dimensione di pagina da associare al tablespace. Per ulteriori informazioni, consulta [Attività comuni per i pool di buffer](db2-managing-buffer-pools.md).
**Per creare un tablespace**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Crea un tablespace chiamando `rdsadmin.create_tablespace`. Per ulteriori informazioni, consulta [rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace).
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type')"
```
## Modifica di un tablespace
Per modificare un tablespace per il database RDS per Db2, chiama la stored procedure `rdsadmin.alter_tablespace`. Questa stored procedure consente di modificare il pool di buffer di un tablespace, abbassare il livello più alto o portare online un tablespace. Per ulteriori informazioni, consulta [ALTER TABLESPACE statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-alter-tablespace) nella documentazione di IBM Db2.
**Per modificare un tablespace**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Modifica un tablespace chiamando `rdsadmin.alter_tablespace`. Per ulteriori informazioni, consulta [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace).
```
db2 "call rdsadmin.alter_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
buffer_pool_size,
tablespace_increase_size,
'max_size', 'reduce_max',
'reduce_stop',
'reduce_value',
'lower_high_water',
'lower_high_water_stop',
'switch_online')"
```
## Ridenominazione di un tablespace
Per cambiare il nome di un tablespace per il database RDS per Db2, chiama la stored procedure `rdsadmin.rename_tablespace`. Per ulteriori informazioni, consulta [RENAME TABLESPACE statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-rename-tablespace) nella documentazione di IBM Db2.
**Per rinominare un tablespace**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Rinomina un tablespace chiamando `rdsadmin.rename_tablespace`. Per ulteriori informazioni, incluse le restrizioni che riguardano il nome che è possibile assegnare a un tablespace, consulta [rdsadmin.rename\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-rename-tablespace).
```
db2 "call rdsadmin.rename_tablespace(
'database_name',
'source_tablespace_name',
'target_tablespace_name')"
```
## Eliminazione di un tablespace
Per eliminare un tablespace per il database RDS per Db2, chiama la stored procedure `rdsadmin.drop_tablespace`. Prima di eliminare una tablespace, rilasciate prima tutti gli oggetti nella tablespace, ad esempio tabelle, indici o oggetti di grandi dimensioni (). LOBs Per ulteriori informazioni, consulta [Dropping table spaces](https://www.ibm.com/docs/en/db2/11.5?topic=spaces-dropping-table) nella documentazione di IBM Db2.
**Per eliminare un tablespace**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, *master\$1username* sostituite e con le vostre informazioni. *master\$1password*
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Elimina un tablespace chiamando `rdsadmin.drop_tablespace`. Per ulteriori informazioni, consulta [rdsadmin.drop\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-drop-tablespace).
```
db2 "call rdsadmin.drop_tablespace(
'database_name',
'tablespace_name')"
```
## Controllo dello stato di un tablespace
È possibile controllare lo stato di un tablespace utilizzando la funzione `cast`.
**Per controllare lo stato di un tablespace**
1. Connettiti al database Db2 utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente *rds\$1database\$1alias**master\$1username*, sostituisci e *master\$1password* con le tue informazioni.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Ottieni un output di riepilogo.
Per un output di riepilogo:
```
db2 "select cast(tbsp_id as smallint) as tbsp_id,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(tbsp_type as varchar(3)) as tbsp_type,
cast(tbsp_state as varchar(10)) as state,
cast(tbsp_content_type as varchar(8)) as contents from table(mon_get_tablespace(null,-1)) order by tbsp_id"
```
## Restituzione di informazioni dettagliate sui tablespace
È possibile restituire informazioni su un tablespace per uno o tutti i membri utilizzando la funzione `cast`.
**Per restituire informazioni dettagliate sui tablespace**
1. Connettiti al database Db2 utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente *rds\$1database\$1alias**master\$1username*, sostituisci e *master\$1password* con le tue informazioni.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Ottieni informazioni dettagliate su tutti i tablespace nel database per un membro o per tutti i membri.
Per un membro:
```
db2 "select cast(member as smallint) as member,
cast(tbsp_id as smallint) as tbsp_id,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(tbsp_type as varchar(3)) as tbsp_type,
cast(tbsp_state as varchar(10)) as state,
cast(tbsp_content_type as varchar(8)) as contents,
cast(tbsp_total_pages as integer) as total_pages,
cast(tbsp_used_pages as integer) as used_pages,
cast(tbsp_free_pages as integer) as free_pages,
cast(tbsp_page_top as integer) as page_hwm,
cast(tbsp_page_size as integer) as page_sz,
cast(tbsp_extent_size as smallint) as extent_sz,
cast(tbsp_prefetch_size as smallint) as prefetch_sz,
cast(tbsp_initial_size as integer) as initial_size,
cast(tbsp_increase_size_percent as smallint) as increase_pct,
cast(storage_group_name as varchar(12)) as stogroup from table(mon_get_tablespace(null,-1)) order by member, tbsp_id "
```
Per tutti i membri:
```
db2 "select cast(member as smallint) as member
cast(tbsp_id as smallint) as tbsp_id,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(tbsp_type as varchar(3)) as tbsp_type,
cast(tbsp_state as varchar(10)) as state,
cast(tbsp_content_type as varchar(8)) as contents,
cast(tbsp_total_pages as integer) as total_pages,
cast(tbsp_used_pages as integer) as used_pages,
cast(tbsp_free_pages as integer) as free_pages,
cast(tbsp_page_top as integer) as page_hwm,
cast(tbsp_page_size as integer) as page_sz,
cast(tbsp_extent_size as smallint) as extent_sz,
cast(tbsp_prefetch_size as smallint) as prefetch_sz,
cast(tbsp_initial_size as integer) as initial_size,
cast(tbsp_increase_size_percent as smallint) as increase_pct,
cast(storage_group_name as varchar(12)) as stogroup from table(mon_get_tablespace(null,-2)) order by member, tbsp_id "
```
## Elencare lo stato e il gruppo di archiviazione per un tablespace
È possibile elencare lo stato e il gruppo di archiviazione per un tablespace eseguendo un’istruzione SQL.
Per elencare lo stato e il gruppo di archiviazione di un tablespace, esegui la seguente istruzione SQL:
```
db2 "SELECT varchar(tbsp_name, 30) as tbsp_name,
varchar(TBSP_STATE, 30) state,
tbsp_type,
varchar(storage_group_name,30) storage_group
FROM TABLE(MON_GET_TABLESPACE('',-2)) AS t"
```
## Elencare i tablespace di una tabella
È possibile elencare i tablespace di una tabella eseguendo un’istruzione SQL.
Per elencare i tablespace di una tabella, esegui la seguente istruzione SQL. Nell'esempio seguente, sostituisci *SCHEMA\$1NAME* e *TABLE\$1NAME* con i nomi dello schema e della tabella:
```
db2 "SELECT
VARCHAR(SD.TBSPACE,30) AS DATA_SPACE,
VARCHAR(SL.TBSPACE,30) AS LONG_SPACE,
VARCHAR(SI.TBSPACE,30) AS INDEX_SPACE
FROM
SYSCAT.DATAPARTITIONS P
JOIN SYSCAT.TABLESPACES SD ON SD.TBSPACEID = P.TBSPACEID
LEFT JOIN SYSCAT.TABLESPACES SL ON SL.TBSPACEID = P.LONG_TBSPACEID
LEFT JOIN SYSCAT.TABLESPACES SI ON SI.TBSPACEID = P.INDEX_TBSPACEID
WHERE
TABSCHEMA = 'SCHEMA_NAME'
AND TABNAME = 'TABLE_NAME'"
```
## Elencare i container di tablespace
È possibile elencare tutti i container di tablespace o specifici container di tablespace utilizzando il comando `cast`.
**Per elencare i container di tablespace per un tablespace**
1. Connettiti al database Db2 utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente *rds\$1database\$1alias**master\$1username*, sostituisci e *master\$1password* con le tue informazioni:
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Ottieni un elenco di tutti i container di tablespace nel database o specifici container di tablespace.
Per tutti i container di tablespace:
```
db2 "select cast(member as smallint) as member,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(container_id as smallint) as id,
cast(container_name as varchar(60)) as container_path, container_type as type from table(mon_get_container(null,-2)) order by member,tbsp_id,container_id"
```
Per container di tablespace specifici:
```
db2 "select cast(member as smallint) as member,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(container_id as smallint) as id,
cast(container_name as varchar(60)) as container_path, container_type as type from table(mon_get_container('TBSP_1',-2)) order by member, tbsp_id,container_id"
```
# Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3
È possibile trasferire i file tra l’istanza database Amazon RDS per Db2 e un bucket Amazon Simple Storage Service (Amazon S3) utilizzando le stored procedure di Amazon RDS. Per ulteriori informazioni, consulta [Informazioni di riferimento sulle stored procedure di Amazon RDS per Db2](db2-stored-procedures.md).
**Nota**
L'istanza database e il bucket Amazon S3 devono trovarsi nella stessa Regione AWS.
Per l’integrazione di RDS per Db2 con Amazon S3, è necessario che l’istanza database abbia accesso a un bucket Amazon S3 in cui si trova RDS per Db2. Se al momento non è disponibile un bucket S3, [creane uno](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket-overview.html).
**Topics**
+ [Fase 1: Creazione di una policy IAM](#db2-creating-iam-policy)
+ [Fase 2: creazione di un ruolo IAM e collegamento della policy IAM](#db2-creating-iam-role)
+ [Fase 3: aggiunta del ruolo IAM all’istanza database RDS per Db2](#db2-adding-iam-role)
## Fase 1: Creazione di una policy IAM
In questo passaggio, crei una policy AWS Identity and Access Management (IAM) con le autorizzazioni necessarie per trasferire file dal bucket Amazon S3 all'istanza DB RDS. Questo passaggio presuppone che tu abbia già creato un bucket S3. Per ulteriori informazioni, consulta [Creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) nella *Guida per l’utente di Amazon S3*.
Prima di creare la policy, prendi nota delle seguenti informazioni:
+ L'Amazon Resource Name (ARN) del bucket
+ L'ARN per la tua chiave AWS Key Management Service (AWS KMS), se il tuo bucket utilizza SSE-KMS la crittografia o. SSE-S3
La policy IAM che crei dovrebbe contenere le seguenti informazioni. Sostituiscilo *\$1amzn-s3-demo-bucket\$1* con il nome del tuo bucket S3.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowS3BucketAccess",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt",
"s3:PutObject",
"s3:GetObject",
"s3:AbortMultipartUpload",
"s3:ListBucket",
"s3:GetObjectVersion",
"s3:ListMultipartUploadParts",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::${amzn-s3-demo-bucket}/*",
"arn:aws:s3:::${amzn-s3-demo-bucket}"
]
},
{
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": [
"*"
]
}
]
}
```
------
Puoi creare una policy IAM utilizzando Console di gestione AWS o il AWS Command Line Interface ()AWS CLI.
### Console
**Per creare una policy IAM per consentire ad Amazon RDS l'accesso a un bucket Amazon S3**
1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel riquadro di navigazione, scegli **Policy**.
1. Scegli **Crea policy**, quindi **JSON**.
1. Aggiungi azioni per ogni servizio. Per trasferire i file da un bucket Amazon S3 ad Amazon RDS, devi selezionare le autorizzazioni per bucket e oggetti.
1. Espandi **Risorse**. Specifica le risorse bucket e oggetti.
1. Scegli **Next (Successivo)**.
1. In **Nome policy**, inserisci un nome per la policy.
1. (Facoltativo) In **Descrizione**, inserisci una descrizione per la policy.
1. Scegli **Crea policy**.
### AWS CLI
**Per creare una policy IAM per consentire ad Amazon RDS l'accesso a un bucket Amazon S3**
1. Crea un file JSON che contenga il seguente documento di policy JSON. *\$1amzn-s3-demo-bucket\$1*Sostituiscilo con il nome del tuo bucket S3.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowS3BucketAccess",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt",
"s3:PutObject",
"s3:GetObject",
"s3:AbortMultipartUpload",
"s3:ListBucket",
"s3:GetObjectVersion",
"s3:ListMultipartUploadParts",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::${amzn-s3-demo-bucket}/*",
"arn:aws:s3:::${amzn-s3-demo-bucket}"
]
},
{
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": [
"*"
]
}
]
}
```
------
1. Esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html). Nell'esempio seguente, sostituisci *iam\$1policy\$1name* e *iam\$1policy\$1file\$1name* con un nome per la tua policy IAM e il nome del file JSON che hai creato nel passaggio 1.
Per Linux, macOS o Unix:
```
aws iam create-policy \
--policy-name iam_policy_name \
--policy-document '{
"Version": "2012-10-17" ,
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt",
"s3:PutObject",
"s3:GetObject",
"s3:AbortMultipartUpload",
"s3:ListBucket",
"s3:DeleteObject",
"s3:GetObjectVersion",
"s3:ListMultipartUploadParts"
],
"Resource": [
"arn:aws:s3:::s3_bucket_name/*",
"arn:aws:s3:::s3_bucket_name"
]
}
]
}'
```
Per Windows:
```
aws iam create-policy ^
--policy-name iam_policy_name ^
--policy-document '{
"Version": "2012-10-17" ,
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:AbortMultipartUpload",
"s3:ListBucket",
"s3:DeleteObject",
"s3:GetObjectVersion",
"s3:ListMultipartUploadParts"
],
"Resource": [
"arn:aws:s3:::s3_bucket_name/*",
"arn:aws:s3:::s3_bucket_name"
]
}
]
}'
```
1. Una volta creata la policy, prendi nota del relativo ARN. L’ARN servirà per [Fase 2: creazione di un ruolo IAM e collegamento della policy IAM](#db2-creating-iam-role).
Per informazioni sulla creazione di una policy IAM, consulta [Creazione di policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) nella Guida per l’utente di IAM.
## Fase 2: creazione di un ruolo IAM e collegamento della policy IAM
Questo passaggio presuppone che tu abbia creato la policy IAM in [Fase 1: Creazione di una policy IAM](#db2-creating-iam-policy). In questa fase, si crea un ruolo IAM per l’istanza database RDS per Db2 e quindi si collega la policy IAM al ruolo.
Puoi creare un ruolo IAM per la tua istanza DB utilizzando Console di gestione AWS o il AWS CLI.
### Console
**Per creare un ruolo IAM e collegare la policy IAM al ruolo**
1. Accedi a Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel pannello di navigazione, seleziona **Roles** (Ruoli).
1. Selezionare **Create role (Crea ruolo)**.
1. Per **Tipo di entità attendibile**, seleziona **Servizio AWS**.
1. Per **Servizio o caso d’uso**, seleziona **RDS**, quindi **RDS ****– ****Aggiungi ruolo al database**.
1. Scegli **Next (Successivo)**.
1. In **Policy di autorizzazione**, cerca e seleziona il nome della policy IAM che hai creato.
1. Scegli **Next (Successivo)**.
1. In **Role name**, (Nome ruolo), inserisci un nome.
1. (Facoltativo) In **Descrizione**, inserisci una descrizione per il nuovo ruolo.
1. Scegli **Crea ruolo**.
### AWS CLI
**Per creare un ruolo IAM e collegare la policy IAM al ruolo**
1. Crea un file JSON che contenga il seguente documento di policy JSON:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. Esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html). Nell'esempio seguente, sostituisci *iam\$1role\$1name* e *iam\$1assume\$1role\$1policy\$1file\$1name* con un nome per il tuo ruolo IAM e il nome del file JSON che hai creato nel passaggio 1.
Per Linux, macOS o Unix:
```
aws iam create-role \
--role-name iam_role_name \
--assume-role-policy-document '{
"Version": "2012-10-17" ,
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
Per Windows:
```
aws iam create-role ^
--role-name iam_role_name ^
--assume-role-policy-document '{
"Version": "2012-10-17" ,
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
1. Una volta creato il ruolo, annota l'ARN del ruolo. L’ARN servirà per [Fase 3: aggiunta del ruolo IAM all’istanza database RDS per Db2](#db2-adding-iam-role).
1. Esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html). Nell'esempio seguente, sostituisci *iam\$1policy\$1arn* con l'ARN della policy IAM in cui hai creato. [Fase 1: Creazione di una policy IAM](#db2-creating-iam-policy) Sostituiscilo *iam\$1role\$1name* con il nome del ruolo IAM che hai appena creato.
Per Linux, macOS o Unix:
```
aws iam attach-role-policy \
--policy-arn iam_policy_arn \
--role-name iam_role_name
```
Per Windows:
```
aws iam attach-role-policy ^
--policy-arn iam_policy_arn ^
--role-name iam_role_name
```
Per ulteriori informazioni, consulta la pagina relativa alla [creazione di un ruolo per delegare le autorizzazioni a un utente IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html) nella *Guida per l'utente IAM*.
## Fase 3: aggiunta del ruolo IAM all’istanza database RDS per Db2
In questa fase, si aggiunge il ruolo IAM all’istanza database RDS per Db2. Si notino i requisiti seguenti:
+ Devi disporre dell'accesso a un ruolo a cui sono collegate le policy di autorizzazione di Amazon S3.
+ È possibile associare un solo ruolo IAM alla volta all’istanza database RDS per Db2.
+ Lo stato dell’istanza database RDS per Db2 deve essere **Disponibile**.
Puoi aggiungere un ruolo IAM alla tua istanza DB utilizzando Console di gestione AWS o il AWS CLI.
### Console
**Per aggiungere un ruolo IAM all’istanza database RDS per Db2**
1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Nel pannello di navigazione, seleziona **Database**.
1. Scegli il nome dell’istanza database RDS per Db2.
1. Sulla scheda **Connettività e sicurezza**, scorri verso il basso fino alla sezione **Gestisci i ruoli IAM** in fondo alla pagina.
1. Per **Aggiungi i ruoli IAM a questa istanza**, scegli il ruolo creato in [Fase 2: creazione di un ruolo IAM e collegamento della policy IAM](#db2-creating-iam-role).
1. Per **Feature (Caratteristica)**, selezionare **S3\$1INTEGRATION**.
1. Scegliere **Add role (Aggiungi ruolo)**.
![\[La funzionalità S3_INTEGRATION aggiunta al ruolo IAM per un’istanza database.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/db2-s3-integration-role.png)
### AWS CLI
Per aggiungere un ruolo IAM all’istanza database RDS per Db2, esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/add-role-to-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/add-role-to-db-instance.html). Nell'esempio seguente *region**db\$1instance\$1name*, sostituisci e *iam\$1role\$1arn* con il nome dell'istanza DB Regione AWS in cui esiste, il nome dell'istanza DB e l'ARN del ruolo IAM in cui hai creato. [Fase 2: creazione di un ruolo IAM e collegamento della policy IAM](#db2-creating-iam-role)
Per Linux, macOS o Unix:
```
aws rds add-role-to-db-instance \
--region $region \
--db-instance-identifier $db_instance_name \
--feature-name S3_INTEGRATION \
--role-arn $iam_role_arn \
```
Per Windows:
```
aws rds add-role-to-db-instance ^
--region $region \
--db-instance-identifier db_instance_name ^
--feature-name S3_INTEGRATION ^
--role-arn iam_role_arn ^
```
Per verificare che il ruolo sia stato aggiunto correttamente all’istanza database RDS per Db2, esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). Nell'esempio seguente, sostituiscilo *db\$1instance\$1name* con il nome dell'istanza DB.
Per Linux, macOS o Unix:
```
aws rds describe-db-instances \
--filters "Name=db-instance-id,Values=db_instance_name" \
--query 'DBInstances[].AssociatedRoles'
```
Per Windows:
```
aws rds describe-db-instances ^
--filters "Name=db-instance-id,Values=db_instance_name" ^
--query 'DBInstances[].AssociatedRoles'
```
Questo comando genera un output simile all’esempio seguente:
```
[
[
{
"RoleArn": "arn:aws:iam::0123456789012:role/rds-db2-s3-role",
"FeatureName": "S3_INTEGRATION",
"Status": "ACTIVE"
}
]
]
```
# Migrazione di dati in Amazon RDS per Db2
Puoi migrare i database Db2 autogestiti ad Amazon RDS per Db2 utilizzando gli strumenti AWS o strumenti Db2 nativi.
Per informazioni sulla migrazione dal database Db2 ad Amazon RDS per Db2 utilizzando i servizi AWS, consulta [Utilizzo dei servizi AWS per migrare i dati da Db2 ad Amazon RDS per Db2](db2-migration-approaches.md).
Per informazioni sulla migrazione dal database Db2 ad Amazon RDS per Db2 utilizzando gli strumenti Db2 nativi, consulta [Utilizzo degli strumenti Db2 nativi per la migrazione di dati da Db2 ad Amazon RDS per Db2](db2-native-db2-tools.md).
# Utilizzo dei servizi AWS per migrare i dati da Db2 ad Amazon RDS per Db2
In Amazon RDS, esistono diversi modi per migrare i dati da un database Db2 ad Amazon RDS per Db2. Puoi eseguire una migrazione unica del tuo database Db2 da Linux, Windows o AIX ad Amazon RDS per Db2. Per ridurre al minimo il tempo di inattività, puoi eseguire una migrazione con un tempo di inattività quasi nullo. Puoi migrare i tuoi dati salvandoli su Amazon S3 e caricandoli una tabella alla volta nel tuo database Db2. Puoi anche eseguire una migrazione sincrona tramite replica o utilizzare AWS Database Migration Service.
Per le migrazioni uniche per i database Db2 basati su Linux, Amazon RDS supporta solo i backup offline e online. Amazon RDS non supporta i backup incrementali e Delta. Per migrazioni con tempo di inattività quasi nullo per i database Db2 basati su Linux, Amazon RDS richiede backup online. È consigliabile utilizzare i backup online per le migrazioni con tempo di inattività quasi nullo e i backup offline per le migrazioni in grado di gestire un tempo di inattività.
**Topics**
+ [Migrazione da Linux a Linux per Amazon RDS per Db2](db2-one-time-migration-linux.md)
+ [Migrazione da Linux a Linux con tempo di inattività quasi nullo per Amazon RDS per Db2](db2-near-zero-downtime-migration.md)
+ [Migrazione sincrona da Linux a Linux per Amazon RDS per Db2](db2-synchronous-migration-linux.md)
+ [Migrazione da AIX o Windows a Linux per Amazon RDS per Db2](db2-one-time-migration-aix-windows-linux.md)
+ [Migrazione dei dati Db2 ad Amazon RDS per Db2 tramite Amazon S3](db2-migration-load-from-s3.md)
+ [Migrazione ad Amazon RDS per Db2 con AWS Database Migration Service (AWS DMS)](db2-migration-amazon-dms.md)
# Migrazione da Linux a Linux per Amazon RDS per Db2
Con questo approccio alla migrazione, si esegue il backup del database Db2 autogestito in un bucket Amazon S3. Quindi, si utilizzano le stored procedure di Amazon RDS per ripristinare il database Db2 in un’istanza database Amazon RDS per Db2. Per ulteriori informazioni sull’utilizzo di Amazon S3, consulta [Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3](db2-s3-integration.md).
Il backup e il ripristino per RDS per Db2 seguono i percorsi e le restrizioni di aggiornamento supportati da IBM Db2. Per ulteriori informazioni, consulta [Supported upgrade paths for Db2 servers](https://www.ibm.com/docs/en/db2/11.5?topic=servers-supported-upgrade-paths-db2) e [Upgrade restrictions for Db2 servers](https://www.ibm.com/docs/en/db2/11.5?topic=servers-upgrade-restrictions) nella documentazione di IBM Db2.
**Topics**
+ [Limitazioni e consigli per l’utilizzo del ripristino nativo](#db2-linux-migration-limitations)
+ [Backup del database in Amazon S3](#db2-linux-backing-up-database)
+ [Creazione di un gruppo di archiviazione automatica predefinito](#db2-linux-creating-auto-storage-group)
+ [Ripristino del database Db2](#db2-linux-restoring-db2-database)
## Limitazioni e consigli per l’utilizzo del ripristino nativo
Le limitazioni e i consigli riportati di seguito si applicano all’utilizzo del ripristino nativo:
+ Amazon RDS supporta solo la migrazione di versioni on-premises di Db2 che corrispondono alle versioni di RDS per Db2 supportate. Per ulteriori informazioni sulle versioni supportate, consulta [Gestione degli upgrade per le istanze Amazon RDS Db2](Db2.Concepts.VersionMgmt.Supported.md).
+ Amazon RDS supporta solo backup offline e online per il ripristino nativo. I backup incrementali e Delta non sono supportati.
+ Non puoi eseguire il ripristino da un bucket Amazon S3 in un Regione AWS ambiente diverso dalla regione in cui si trova l'istanza DB RDS for Db2.
+ Amazon S3 limita la dimensione dei file caricati in un bucket Amazon S3 a 5 TB. Se il backup del database supera i 5 TB, dividilo in file più piccoli.
+ Amazon RDS non supporta routine esterne non recintate, ripristini incrementali o ripristini Delta.
+ Non puoi eseguire il ripristino da un database di origine crittografato, ma puoi eseguire il ripristino in un'istanza database di Amazon RDS crittografata.
Il processo di ripristino varia a seconda della configurazione.
Se lo hai `USE_STREAMING_RESTORE` impostato`TRUE`, Amazon RDS trasmette direttamente il backup dal tuo bucket S3 durante il ripristino. Lo streaming riduce in modo significativo i requisiti di archiviazione. È sufficiente fornire uno spazio di archiviazione uguale o superiore alla dimensione del backup o alla dimensione del database originale, a seconda di quale delle due sia maggiore.
Se lo `USE_STREAMING_RESTORE` imposti`FALSE`, Amazon RDS scarica prima il backup sulla tua istanza DB RDS for Db2 e poi estrae il backup. L'estrazione richiede spazio di archiviazione aggiuntivo. È necessario fornire uno spazio di archiviazione uguale o superiore alla somma delle dimensioni del backup e delle dimensioni del database originale.
La dimensione massima del database ripristinato è uguale alla dimensione massima supportata del database meno lo spazio necessario per l'archiviazione temporanea durante il processo di ripristino.
## Backup del database in Amazon S3
Per eseguire il backup del database su Amazon S3, sono necessari i seguenti componenti: AWS
+ *Un bucket Amazon S3 per archiviare i file di backup*: carica tutti i file di backup da migrare ad Amazon RDS. Consigliamo di utilizzare i backup offline per le migrazioni in grado di gestire il tempo di inattività. Se disponi già di un bucket S3, puoi utilizzarlo. Se non disponi di un bucket S3, consulta [Creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) nella *Guida per l’utente di Amazon S3*.
**Nota**
Se il database è di grandi dimensioni e il trasferimento su un bucket S3 richiederebbe molto tempo, puoi ordinare un AWS Snow Family dispositivo e chiedere di AWS eseguire il backup. Dopo aver copiato i file sul dispositivo e averlo restituito al team Famiglia Snow, il team trasferisce le immagini di backup nel bucket S3. Per ulteriori informazioni, consulta la [documentazione relativa ad AWS Snow Family](https://docs.aws.amazon.com/snowball/).
+ *Un ruolo IAM per accedere al bucket S3*: se disponi già di un ruolo IAM, puoi utilizzarlo. Se non disponi di un ruolo, consulta [Fase 2: creazione di un ruolo IAM e collegamento della policy IAM](db2-s3-integration.md#db2-creating-iam-role).
+ *Una policy IAM con relazioni di trust e autorizzazioni associate al tuo ruolo IAM*: per ulteriori informazioni, consulta [Fase 1: Creazione di una policy IAM](db2-s3-integration.md#db2-creating-iam-policy).
+ *Il ruolo IAM aggiunto alla tua istanza database RDS per Db2*: per ulteriori informazioni, consulta [Fase 3: aggiunta del ruolo IAM all’istanza database RDS per Db2](db2-s3-integration.md#db2-adding-iam-role).
## Creazione di un gruppo di archiviazione automatica predefinito
Il database di origine deve avere un gruppo di archiviazione automatica predefinito. Se il database non dispone di un gruppo di archiviazione automatica predefinito, è necessario crearne uno.
**Per creare un gruppo di archiviazione automatica predefinito**
1. Connettiti al tuo database di origine; Nell'esempio seguente, sostituiscilo *source\$1database* con il nome del tuo database.
```
db2 connect to source_database
```
1. Crea un gruppo di archiviazione automatica e impostalo come predefinito. Nell'esempio seguente, sostituiscilo *storage\$1path* con il percorso assoluto in cui si trova il gruppo di archiviazione.
```
db2 "create stogroup IBMSTOGROUP ON storage_path set as default"
```
1. Termina i processi backend.
```
db2 terminate
```
1. Disattiva il database e arresta tutti i servizi del database. Nell'esempio seguente, *source\$1database* sostituiscilo con il nome del database per cui hai creato il gruppo di archiviazione.
```
db2 deactivate db source_database
```
1. Esegui il backup del database. Nell'esempio seguente, *source\$1database* sostituiscilo con il nome del database per cui hai creato il gruppo di archiviazione. Sostituisci *file\$1system\$1path* con il percorso assoluto in cui desideri eseguire il backup del database.
```
db2 backup database source_database to file_system_path
```
## Ripristino del database Db2
Dopo aver eseguito il backup del database in Amazon S3 e creato un gruppo di archiviazione automatica, puoi eseguire il ripristino del database Db2 nell’istanza database RDS per Db2.
**Per ripristinare il database Db2 dal bucket Amazon S3 all'istanza DB RDS per Db2**
1. Connettiti all’istanza database Amazon RDS per Db2. Per ulteriori informazioni, consulta [Connessione all’istanza database Db2](USER_ConnectToDb2DBInstance.md).
1. (Facoltativo) Per assicurarti che il database sia configurato con le impostazioni ottimali, controlla i valori dei seguenti parametri chiamando: [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration)
+ `RESTORE_DATABASE_NUM_BUFFERS`
+ `RESTORE_DATABASE_PARALLELISM`
+ `RESTORE_DATABASE_NUM_MULTI_PATHS`
+ `USE_STREAMING_RESTORE`
[rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration)Utilizzateli per modificare questi valori in base alle esigenze. La corretta configurazione di questi parametri può migliorare significativamente le prestazioni durante il ripristino di database con grandi volumi di dati. Per la maggior parte degli scenari di migrazione, si consiglia di `USE_STREAMING_RESTORE` impostare su, in `TRUE` quanto riduce i requisiti di archiviazione e può migliorare la velocità di ripristino.
1. Ripristina il database chiamando `rdsadmin.restore_database`. Per ulteriori informazioni, consulta [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database).
# Migrazione da Linux a Linux con tempo di inattività quasi nullo per Amazon RDS per Db2
Con questo approccio si esegue la migrazione di un database Db2 basato su Linux da un database Db2 autogestito (origine) ad Amazon RDS per Db2. Questo approccio comporta interruzioni o tempi di inattività minimi o nulli per l’applicazione o gli utenti. Questo approccio esegue il backup del database e lo ripristina con la riproduzione dei log, contribuendo a evitare interruzioni delle operazioni in corso e garantendo un’elevata disponibilità del database.
Per ottenere una migrazione con tempo di inattività quasi nullo, RDS per Db2 implementa il ripristino con riproduzione dei log. Questo approccio acquisisce un backup del database Db2 autogestito basato su Linux e lo ripristina sul server RDS per Db2. Con le stored procedure di Amazon RDS, applichi quindi i log delle transazioni successivi per aggiornare il database.
**Topics**
+ [Limitazioni e suggerimenti per una migrazione con tempo di inattività quasi nullo](#db2-near-zero-downtime-migration-limitations)
+ [Backup del database in Amazon S3](#db2-near-zero-downtime-backing-up-database)
+ [Creazione di un gruppo di archiviazione automatica predefinito](#db2-near-zero-migration-creating-auto-storage-group)
+ [Migrazione del database Db2](#db2-migrating-db2-database)
## Limitazioni e suggerimenti per una migrazione con tempo di inattività quasi nullo
Di seguito sono indicate le limitazioni e le raccomandazioni applicabili alla migrazione con tempo di inattività quasi nullo:
+ Amazon RDS richiede un backup online per le migrazioni con tempo di inattività quasi nullo. Questo perché Amazon RDS mantiene il database in uno stato di attesa di rollforward durante il caricamento dei log delle transazioni archiviati. Per ulteriori informazioni, consulta [Migrazione del database Db2](#db2-migrating-db2-database).
+ Non puoi eseguire il ripristino da un bucket Amazon S3 in un Regione AWS ambiente diverso dalla regione in cui si trova l'istanza DB RDS for Db2.
+ Amazon S3 limita la dimensione dei file caricati in un bucket S3 a 5 TB. Se il backup del database supera i 5 TB, dividilo in file più piccoli.
+ Amazon RDS non supporta routine esterne non recintate, ripristini incrementali o ripristini Delta.
+ Non puoi eseguire il ripristino da un database di origine crittografato, ma puoi eseguire il ripristino in un'istanza database di Amazon RDS crittografata.
Il processo di ripristino varia a seconda della configurazione.
Se lo hai `USE_STREAMING_RESTORE` impostato`TRUE`, Amazon RDS trasmette direttamente il backup dal tuo bucket S3 durante il ripristino. Lo streaming riduce in modo significativo i requisiti di archiviazione. È sufficiente fornire uno spazio di archiviazione uguale o superiore alla dimensione del backup o alla dimensione del database originale, a seconda di quale sia la maggiore.
Se lo `USE_STREAMING_RESTORE` imposti`FALSE`, Amazon RDS scarica prima il backup sulla tua istanza DB RDS for Db2 e poi estrae il backup. L'estrazione richiede spazio di archiviazione aggiuntivo. È necessario fornire uno spazio di archiviazione uguale o superiore alla somma delle dimensioni del backup e delle dimensioni del database originale.
La dimensione massima del database ripristinato è uguale alla dimensione massima supportata del database meno lo spazio necessario per l'archiviazione temporanea durante il processo di ripristino.
## Backup del database in Amazon S3
Per eseguire il backup del database su Amazon S3, sono necessari i seguenti componenti: AWS
+ *Un bucket Amazon S3 per archiviare i file di backup*: carica tutti i file di backup da migrare ad Amazon RDS. Amazon RDS richiede un backup online per le migrazioni con tempo di inattività quasi nullo. Se disponi già di un bucket S3, puoi utilizzarlo. Se non disponi di un bucket S3, consulta [Creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) nella *Guida per l’utente di Amazon S3*.
**Nota**
Se il database è di grandi dimensioni e il trasferimento su un bucket S3 richiederebbe molto tempo, puoi ordinare un AWS Snow Family dispositivo e chiedere di AWS eseguire il backup. Dopo aver copiato i file sul dispositivo e averlo restituito al team Famiglia Snow, il team trasferisce le immagini di backup nel bucket S3. Per ulteriori informazioni, consulta la [documentazione relativa ad AWS Snow Family](https://docs.aws.amazon.com/snowball/).
+ *Un ruolo IAM per accedere al bucket S3*: se disponi già di un ruolo AWS Identity and Access Management (IAM), puoi utilizzare quel ruolo. Se non disponi di un ruolo, consulta [Fase 2: creazione di un ruolo IAM e collegamento della policy IAM](db2-s3-integration.md#db2-creating-iam-role).
+ *Una policy IAM con relazioni di trust e autorizzazioni associate al tuo ruolo IAM*: per ulteriori informazioni, consulta [Fase 1: Creazione di una policy IAM](db2-s3-integration.md#db2-creating-iam-policy).
+ *Il ruolo IAM aggiunto alla tua istanza database RDS per Db2*: per ulteriori informazioni, consulta [Fase 3: aggiunta del ruolo IAM all’istanza database RDS per Db2](db2-s3-integration.md#db2-adding-iam-role).
## Creazione di un gruppo di archiviazione automatica predefinito
Il database di origine deve avere un gruppo di archiviazione automatica predefinito. Se il database non dispone di un gruppo di archiviazione automatica predefinito, è necessario crearne uno.
**Per creare un gruppo di archiviazione automatica predefinito**
1. Connettiti al tuo database di origine; Nell'esempio seguente, sostituiscilo *source\$1database* con il nome del tuo database.
```
db2 connect to source_database
```
1. Crea un gruppo di archiviazione automatica e impostalo come predefinito. Nell'esempio seguente, sostituiscilo *storage\$1path* con il percorso assoluto in cui si trova il gruppo di archiviazione.
```
db2 "create stogroup IBMSTOGROUP ON storage_path set as default"
```
1. Termina i processi backend.
```
db2 terminate
```
## Migrazione del database Db2
Dopo aver configurato una migrazione con tempi di inattività quasi pari a zero, sei pronto per migrare il database Db2 dal bucket Amazon S3 all'istanza DB RDS for Db2.
**Per eseguire una migrazione con tempi di inattività quasi nulli dei file di backup dal bucket Amazon S3 all'istanza DB RDS for Db2**
1. Esegui un backup online del database di origine. Per ulteriori informazioni, consulta [BACKUP DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-backup-database) nella documentazione di IBM Db2.
1. Copia il backup del database in un bucket Amazon S3. Per ulteriori informazioni su Amazon S3, consulta la [Guida per l’utente di Amazon Simple Storage Service](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html).
1. Connect al `rdsadmin` server con *master\$1username* e *master\$1password* per l'istanza DB RDS for Db2.
```
db2 connect to rdsadmin user master_username using master_password
```
1. (Facoltativo) Per assicurarti che il database sia configurato con le impostazioni ottimali, controlla i valori dei seguenti parametri chiamando: [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration)
+ `RESTORE_DATABASE_NUM_BUFFERS`
+ `RESTORE_DATABASE_PARALLELISM`
+ `RESTORE_DATABASE_NUM_MULTI_PATHS`
+ `USE_STREAMING_RESTORE`
[rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration)Utilizzateli per modificare questi valori secondo necessità. La corretta configurazione di questi parametri può migliorare significativamente le prestazioni durante il ripristino di database con grandi volumi di dati. Per la maggior parte degli scenari di migrazione, si consiglia di `USE_STREAMING_RESTORE` impostare su, in `TRUE` quanto riduce i requisiti di archiviazione e può migliorare la velocità di ripristino.
1. Ripristina il backup sul server RDS per Db2 chiamando `rdsadmin.restore_database`. Imposta `backup_type` su `ONLINE`. Per ulteriori informazioni, consulta [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database).
1. Copia i log di archivio dal server di origine al bucket S3. Per ulteriori informazioni, consulta [Archive logging](https://www.ibm.com/docs/en/db2/11.5?topic=logging-archive) nella documentazione di IBM Db2.
1. Applica i log di archivio tutte le volte che è necessario chiamando `rdsadmin.rollforward_database`. Imposta `complete_rollforward` su `FALSE` per mantenere il database in uno stato `ROLL-FORWARD PENDING`. Per ulteriori informazioni, consulta [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database).
1. Dopo aver applicato tutti i log di archivio, porta online il database chiamando `rdsadmin.complete_rollforward`. Per ulteriori informazioni, consulta [rdsadmin.complete\$1rollforward](db2-sp-managing-databases.md#db2-sp-complete-rollforward).
1. Passa le connessioni delle applicazioni al server RDS per Db2 aggiornando gli endpoint dell’applicazione per il database o aggiornando gli endpoint DNS per reindirizzare il traffico al server RDS per Db2. Puoi anche utilizzare la funzionalità di reindirizzamento automatico del client Db2 sul database Db2 autogestito con l’endpoint del database RDS per Db2. Per ulteriori informazioni, consulta [Automatic client reroute description and setup](https://www.ibm.com/docs/en/db2/11.5?topic=reroute-configuring-automatic-client) nella documentazione IBM Db2.
1. (Facoltativo) Arresta il database di origine.
# Migrazione sincrona da Linux a Linux per Amazon RDS per Db2
Questo approccio alla migrazione prevede la configurazione della replica tra il database Db2 autogestito e l’istanza database Amazon RDS per Db2. Le modifiche apportate al database autogestito vengono replicate nell’istanza database RDS per Db2 quasi in tempo reale. Questo approccio può garantire una disponibilità continua e ridurre al minimo il tempo di inattività durante il processo di migrazione.
# Migrazione da AIX o Windows a Linux per Amazon RDS per Db2
Con questo approccio alla migrazione, si utilizzano strumenti Db2 nativi per eseguire il backup del database Db2 autogestito in un bucket Amazon S3. Gli strumenti Db2 nativi includono l’utilità `export` e il comando di sistema `db2move` o `db2look`. Il database Db2 può essere gestito autonomamente o in Amazon Elastic Compute Cloud (Amazon EC2). È possibile spostare i dati dal sistema AIX o Windows nel bucket Amazon S3. Quindi, si utilizza un client Db2 per caricare i dati direttamente dal bucket S3 nel database RDS per Db2. Il tempo di inattività dipende dalle dimensioni del database. Per maggiori informazioni sull'utilizzo di Amazon S3, consulta [Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3](db2-s3-integration.md).
**Per eseguire la migrazione del database Db2 a RDS per Db2**
1. Esegui le attività preliminari al backup del database. Configura una quantità di archiviazione sufficiente per il backup sul sistema Db2 autogestito.
1. Esegui il backup del database.
1. Esegui il [comando di sistema db2look](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2look-db2-statistics-ddl-extraction-tool) per estrarre il file DDL (Data Definition Language) per tutti gli oggetti.
1. Esegui l’[utilità di esportazione Db2](https://www.ibm.com/docs/en/db2/11.5?topic=utility-exporting-data), il [comando di sistema db2move](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2move-database-movement-tool) o un’[istruzione CREATE EXTERNAL TABLE](https://www.ibm.com/docs/en/db2/11.5?topic=statements-create-table-external) per scaricare i dati della tabella Db2 nello spazio di archiviazione del sistema Db2.
1. Sposta il backup in un bucket Amazon S3. Per ulteriori informazioni, consulta [Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3](db2-s3-integration.md).
**Nota**
Se il database è di grandi dimensioni e il trasferimento in un bucket S3 richiederebbe molto tempo, puoi ordinare un dispositivo AWS Snow Family e chiedere ad AWS di eseguire il backup. Dopo che hai copiato i file nel dispositivo e li hai restituiti al team di Snow Family, il team trasferisce le immagini di backup nel bucket S3. Per ulteriori informazioni, consulta la [documentazione relativa ad AWS Snow Family](https://docs.aws.amazon.com/snowball/).
1. Utilizza un client Db2 per caricare i dati direttamente nel database RDS per Db2 dal bucket S3. Per ulteriori informazioni, consulta [Migrazione con Amazon S3](db2-migration-load-from-s3.md).
# Migrazione dei dati Db2 ad Amazon RDS per Db2 tramite Amazon S3
Con questo approccio, devi prima di tutto salvare i dati da una singola tabella in un file di dati da inserire in un bucket Amazon S3. Quindi, devi usare il [comando LOAD](https://www.ibm.com/docs/en/db2/11.5?topic=commands-load) per caricare i dati da quel file di dati in una tabella nel tuo database Amazon RDS per Db2. Per ulteriori informazioni sull’utilizzo di Amazon S3, consulta [Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3](db2-s3-integration.md).
**Topics**
+ [Salvataggio dei dati in Amazon S3](#db2-migration-load-from-s3-saving-data-file)
+ [Caricamento dei dati nelle tabelle RDS per Db2](#db2-migration-load-from-s3-into-db-table)
## Salvataggio dei dati in Amazon S3
Per salvare i dati da una singola tabella in Amazon S3, utilizza un’utilità di database per estrarre i dati dal tuo sistema di gestione del database (DBMS) in un file CSV. Carica quindi il file di dati in Amazon S3.
Per archiviare file di dati su Amazon S3, sono necessari i seguenti componenti: AWS
+ *Un bucket Amazon S3 per archiviare i file di backup*: se disponi già di un bucket S3, puoi utilizzarlo. Se non disponi di un bucket S3, consulta [Creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) nella *Guida per l’utente di Amazon S3*.
+ *Un ruolo IAM per accedere al bucket S3*: se disponi già di un ruolo IAM, puoi utilizzarlo. Se non disponi di un ruolo, consulta [Fase 2: creazione di un ruolo IAM e collegamento della policy IAM](db2-s3-integration.md#db2-creating-iam-role).
+ *Una policy IAM con relazioni di trust e autorizzazioni associate al tuo ruolo IAM*: per ulteriori informazioni, consulta [Fase 1: Creazione di una policy IAM](db2-s3-integration.md#db2-creating-iam-policy).
+ *Il ruolo IAM aggiunto alla tua istanza database RDS per Db2*: per ulteriori informazioni, consulta [Fase 3: aggiunta del ruolo IAM all’istanza database RDS per Db2](db2-s3-integration.md#db2-adding-iam-role).
## Caricamento dei dati nelle tabelle RDS per Db2
Dopo aver salvato i file di dati su Amazon S3, puoi caricare i dati da questi file in singole tabelle sulla tua istanza database RDS per Db2.
**Per caricare i dati della tabella Db2 nella tabella del database RDS per Db2**
1. Connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Cataloga un alias di accesso all’archiviazione che punti al bucket Amazon S3 in cui sono archiviati i file salvati. Annota il nome di questo alias per utilizzarlo nel passaggio successivo. È sufficiente eseguire questo passaggio una sola volta se prevedi di caricare più tabelle da file di dati memorizzati nello stesso bucket Amazon S3.
L'esempio seguente cataloga un alias denominato *my\$1s3\$1alias* che concede a un utente denominato l'*jorge\$1souza*accesso a un bucket denominato. *amzn-s3-demo-bucket*
```
db2 "call rdsadmin.catalog_storage_access(?, 'my_s3_alias', 'amzn-s3-demo-bucket', 'USER', 'jorge_souza')"
```
Per ulteriori informazioni su questa stored procedure, consulta [rdsadmin.catalog\$1storage\$1access](db2-sp-managing-storage-access.md#db2-sp-catalog-storage-access).
1. Esegui il comando `LOAD` utilizzando l’alias di accesso all’archiviazione che punta al tuo bucket Amazon S3.
**Nota**
Se il comando `LOAD` restituisce un errore, potrebbe essere necessario creare un endpoint gateway VPC per Amazon S3 e aggiungere regole in uscita al gruppo di sicurezza. Per ulteriori informazioni, consulta [I/O Errore nel file](db2-troubleshooting.md#db2-file-input-output-error).
L'esempio seguente carica i dati da un file di dati denominato in una tabella *my\$1s3\$1datafile.csv* denominata. *my\$1db2\$1table* L'esempio presuppone che il file di dati si trovi nel bucket Amazon S3 a cui punta l'alias *my\$1s3\$1alias* denominato.
```
db2 "load from db2remote://my_s3_alias//my_s3_datafile.csv of DEL insert into my_db2_table";
```
L'esempio seguente viene caricato LOBs da un file di dati denominato in una tabella *my\$1table1\$1export.ixf* denominata. *my\$1db2\$1table* L'esempio presuppone che il file di dati si trovi nel bucket Amazon S3 a cui punta l'alias *my\$1s3\$1alias* denominato.
```
db2 "call sysproc.admin_cmd('load from "db2remote://my_s3_alias//my_table1_export.ixf" of ixf
lobs from "db2remote://my_s3_alias//" xml from "db2remote://my_s3_alias//"
modified by lobsinfile implicitlyhiddeninclude identityoverride generatedoverride periodoverride transactionidoverride
messages on server
replace into "my_schema"."my_db2_table"
nonrecoverable
indexing mode incremental allow no access')"
```
Ripeti questo passaggio per ogni file di dati nel bucket Amazon S3 da caricare in una tabella nella tua istanza database RDS per Db2.
Per ulteriori informazioni sul comando `LOAD`, consulta [LOAD command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-load).
# Migrazione ad Amazon RDS per Db2 con AWS Database Migration Service (AWS DMS)
Puoi utilizzare AWS DMS per migrazioni uniche e quindi effettuare la sincronizzazione da Db2 su Linux, Unix (come AIX) e Windows ad Amazon RDS per Db2. Per ulteriori informazioni, consulta [Cos'è AWS Database Migration Service?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html)
# Utilizzo degli strumenti Db2 nativi per la migrazione di dati da Db2 ad Amazon RDS per Db2
È possibile utilizzare diversi strumenti Db2 nativi, utilità e comandi per spostare i dati direttamente da un database Db2 a un database Amazon RDS per Db2. Per utilizzare questi strumenti Db2 nativi, deve essere possibile connettere il computer client a un’istanza database RDS per Db2. Per ulteriori informazioni, consulta [Connessione di un computer client a un’istanza database Amazon RDS per Db2](db2-connecting-client-rds.md).
**Nota**
Un altro modo per spostare i dati consiste nel salvarli prima in un bucket Amazon S3, quindi utilizzare il comando `LOAD` per trasferire i dati in una tabella nel database RDS per Db2. Questo metodo assicura le prestazioni migliori durante la migrazione di grandi quantità di dati grazie alla buona connettività di rete tra RDS per Db2 e S3. Per ulteriori informazioni, consulta [Migrazione dei dati Db2 ad Amazon RDS per Db2 tramite Amazon S3](db2-migration-load-from-s3.md).
| Nome dello strumento | Caso d'uso | Limitazioni |
| --- | --- | --- |
| [db2look](db2-native-db2-tools-db2look.md) | Copia di metadati da un database Db2 autogestito a un database RDS per Db2. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [Comando IMPORT](db2-native-db2-tools-import.md) | Migrazione di tabelle piccole e tabelle con oggetti di grandi dimensioni (LOB) da un computer client a un’istanza database RDS per Db2. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [Utilità INGEST](db2-native-db2-tools-ingest.md) | Streaming continuo di dati da file e pipe *senza* oggetti di grandi dimensioni (LOB) sul computer client a un’istanza database RDS per Db2. Supporta le operazioni `INSERT` e `MERGE`. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [Comando INSERT](db2-native-db2-tools-insert.md) | Copia di dati in tabelle di piccole dimensioni da un database Db2 autogestito a un database RDS per Db2. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [Comando LOAD CLIENT](db2-native-db2-tools-load.md) | Migrazione di tabelle di piccole dimensioni *senza* oggetti di grandi dimensioni (LOB) da un computer client a un’istanza database RDS per Db2. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
# Connessione di un computer client a un’istanza database Amazon RDS per Db2
Per utilizzare uno degli strumenti Db2 nativi per spostare i dati da un database Db2 a un database Amazon RDS per Db2, devi prima connettere il computer client a un’istanza database RDS per Db2.
Il computer client può essere:
+ Un’istanza Amazon Elastic Compute Cloud (Amazon EC2) su Linux, Windows o macOS. Questa istanza deve trovarsi nello stesso cloud privato virtuale (VPC) dell'istanza DB RDS for Db2, oppure. AWS Cloud9 AWS CloudShell
+ Un’istanza Db2 autogestita in un’istanza Amazon EC2. Le istanze devono trovarsi nello stesso VPC.
+ Un’istanza Db2 autogestita in un’istanza Amazon EC2. Le istanze possono essere diverse VPCs se hai abilitato il peering VPC. Per ulteriori informazioni, consulta [Creazione di una connessione peering VPC](https://docs.aws.amazon.com/vpc/latest/peering/create-vpc-peering-connection.html) nella *Guida al peering VPC di Amazon Virtual Private Cloud*.
+ Un computer locale che esegue Linux, Windows o macOS in un ambiente autogestito. È necessario disporre di connettività pubblica a RDS per Db2 o abilitare la connettività VPN tra le istanze Db2 autogestite e AWS.
Per connettere il computer client all’istanza database RDS per Db2, accedi al computer client con IBM Db2 Data Management Console. Per ulteriori informazioni, consultare [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md) e [IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md).
È possibile utilizzare AWS Database Migration Service (AWS DMS) per eseguire query sul database, eseguire un piano di esecuzione SQL e monitorare il database. Per ulteriori informazioni, consulta [Cos'è il AWS Database Migration Service?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html) nella *Guida AWS Database Migration Service per l'utente*.
Dopo aver collegato correttamente il computer client all’istanza database RDS per Db2, puoi utilizzare qualsiasi strumento Db2 nativo per copiare i dati. Per ulteriori informazioni, consulta [Utilizzo degli strumenti Db2 nativi per la migrazione di dati da Db2 ad Amazon RDS per Db2](db2-native-db2-tools.md).
# Copia dei metadati del database da Db2 ad Amazon RDS per Db2 con db2look
`db2look` è uno strumento Db2 nativo che estrae file DDL (Data Definition Language), oggetti, autorizzazioni, configurazioni, WLM e layout di database. Puoi utilizzare `db2look` per copiare i metadati del database da un database Db2 autogestito a un database Amazon RDS per Db2. Per ulteriori informazioni, consulta [Mimicking databases using db2look](https://www.ibm.com/docs/en/db2/11.5?topic=tools-db2look) nella documentazione di IBM Db2.
**Per copiare i metadati di database**
1. Esegui lo strumento `db2look` sul tuo sistema Db2 autogestito per estrarre il file DDL. Nell’esempio seguente, sostituisci *database\$1name* con il nome del tuo database Db2.
```
db2look -d database_name -e -l -a -f -wlm -cor -createdb -printdbcfg -o db2look.sql
```
1. Se il computer client ha accesso al database di origine (Db2 autogestito) e all’istanza database RDS per Db2, puoi creare il file `db2look.sql` sul computer client collegandolo direttamente all’istanza remota. Quindi cataloga l’istanza Db2 autogestita remota.
1. Cataloga il nodo. Nell’esempio seguente, sostituisci *dns\$1ip\$1address* e *port* con il nome DNS o l’indirizzo IP e il numero di porta del database Db2 autogestito.
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. Cataloga il database. Nell’esempio seguente, sostituisci *source\$1database\$1name* e *source\$1database\$1alias* con il nome del database Db2 autogestito e l’alias da utilizzare per il database.
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. Collega al database di origine. Nell’esempio seguente, sostituisci *source\$1database\$1alias*, *user\$1id* e *user\$1password* con l’alias creato nel passaggio precedente e l’ID e la password dell’utente per il database Db2 autogestito.
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. Se non riesci ad accedere al database Db2 remoto autogestito dal computer client, copia il file `db2look.sql` nel computer client. Quindi cataloga l’istanza database RDS per Db2.
1. Cataloga il nodo. Nell’esempio seguente, sostituisci *dns\$1ip\$1address* e *port* con il nome DNS o l’indirizzo IP e il numero di porta dell’istanza database RDS per Db2.
```
db2 catalog tcpip node remnode REMOTE dns_ip_address server port
```
1. Cataloga il database. Nell’esempio seguente, sostituisci *rds\$1database\$1name* e *rds\$1database\$1alias* con il nome del database RDS per Db2 e l’alias da utilizzare per il database.
```
db2 catalog database rds_database_name as rds_database_alias at node remnode \
authentication server_encrypt
```
1. Cataloga il database di amministrazione che gestisce RDS per Db2. Non è possibile utilizzare questo database per archiviare dati.
```
db2 catalog database rdsadmin as rdsadmin at node remnode authentication server_encrypt
```
1. Crea pool di buffer e tablespace. L’amministratore non dispone dei privilegi per creare pool di buffer o tablespace. Tuttavia, puoi utilizzare le stored procedure di Amazon RDS a questo scopo.
1. Trova i nomi e le definizioni dei pool di buffer e dei tablespace nel file `db2look.sql`.
1. Connettiti ad Amazon RDS utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell’esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Crea un pool di buffer chiamando `rdsadmin.create_bufferpool`. Per ulteriori informazioni, consulta [rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool).
```
db2 "call rdsadmin.create_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
page_size,
number_block_pages,
block_size)"
```
1. Crea un tablespace chiamando `rdsadmin.create_tablespace`. Per ulteriori informazioni, consulta [rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace).
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type')"
```
1. Ripeti i passaggi c o d per ogni altro pool di buffer o tablespace da aggiungere.
1. Termina la connessione.
```
db2 terminate
```
1. Crea tabelle e oggetti.
1. Connettiti al database RDS per Db2 utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell’esempio seguente, sostituisci *rds\$1database\$1name*, *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rds_database_name user master_username using master_password
```
1. Esegui il file `db2look.sql`.
```
db2 -tvf db2look.sql
```
1. Termina la connessione.
```
db2 terminate
```
# Importazione di dati da un computer client in Amazon RDS per Db2 con il comando IMPORT
Puoi utilizzare il comando `IMPORT` da un computer client per importare i dati nel server Amazon RDS per Db2.
**Importante**
Il metodo del comando `IMPORT` è utile per la migrazione di tabelle di piccole dimensioni e tabelle che includono oggetti di grandi dimensioni (LOB). Il comando `IMPORT` è più lento dell’utilità `LOAD` a causa delle operazioni di registrazione di log `INSERT` e `DELETE`. Se la larghezza di banda della rete tra il computer client e RDS per Db2 è limitata, è consigliabile utilizzare un approccio diverso per la migrazione. Per ulteriori informazioni, consulta [Utilizzo degli strumenti Db2 nativi per la migrazione di dati da Db2 ad Amazon RDS per Db2](db2-native-db2-tools.md).
**Per importare dati nel server RDS per Db2**
1. Accedi al tuo computer client con IBM Db2 Data Management Console. Per ulteriori informazioni, consulta [Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md).
1. Cataloga il database RDS per Db2 sul computer client.
1. Cataloga il nodo. Nell’esempio seguente, sostituisci *dns\$1ip\$1address* e *port* con il nome DNS o l’indirizzo IP e il numero di porta del database Db2 autogestito.
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. Cataloga il database. Nell’esempio seguente, sostituisci *source\$1database\$1name* e *source\$1database\$1alias* con il nome del database Db2 autogestito e l’alias da utilizzare per il database.
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. Collega al database di origine. Nell’esempio seguente, sostituisci *source\$1database\$1alias*, *user\$1id* e *user\$1password* con l’alias creato nel passaggio precedente e l’ID e la password dell’utente per il database Db2 autogestito.
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. Genera il file di dati utilizzando il comando ` EXPORT` sul sistema Db2 autogestito. Nell’esempio seguente, sostituisci *directory* con la directory sul computer client in cui si trova il file di dati. Sostituisci *file\$1name* e *table\$1name* con il nome del file di dati e il nome della tabella.
```
db2 "export to /directory/file_name.txt of del lobs to /directory/lobs/ \
modified by coldel\| select * from table_name"
```
1. Connettiti al database RDS per Db2 utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell’esempio seguente, sostituisci **rds\$1database\$1alias**, *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Utilizza il comando `IMPORT` per importare dati da un file sul computer client al database remoto RDS per Db2. Per ulteriori informazioni, consulta [IMPORT command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-import) nella documentazione di IBM Db2. Nell’esempio seguente, sostituisci *directory* e *file\$1name* con la directory sul computer client in cui si trova il file di dati e il nome del file di dati. Sostituisci *SCHEMA\$1NAME* e *TABLE\$1NAME* con il nome dello schema e il nome della tabella.
```
db2 "IMPORT from /directory/file_name.tbl OF DEL LOBS FROM /directory/lobs/ \
modified by coldel\| replace into SCHEMA_NAME.TABLE_NAME"
```
1. Termina la connessione.
```
db2 terminate
```
# Importazione di dati da un computer client in Amazon RDS per Db2 con il comando LOAD
Puoi utilizzare il comando `LOAD CLIENT` per caricare dati da un file sul computer client nel server Amazon RDS per Db2. Poiché non esiste alcuna connettività SSH al server RDS per Db2, puoi utilizzare il comando `LOAD CLIENT` sul server Db2 autogestito o sul computer client Db2.
**Importante**
Il metodo del comando `LOAD CLIENT` è utile per la migrazione di tabelle di piccole dimensioni. Se la larghezza di banda della rete tra il client e RDS per Db2 è limitata, è consigliabile utilizzare un approccio diverso per la migrazione. Per ulteriori informazioni, consulta [Utilizzo degli strumenti Db2 nativi per la migrazione di dati da Db2 ad Amazon RDS per Db2](db2-native-db2-tools.md).
Se il file di dati include riferimenti a nomi di file di oggetti di grandi dimensioni, il comando `LOAD` non funzionerà perché gli oggetti di grandi dimensioni (LOB) devono risiedere sul server Db2. Se tenti di caricare LOB dal computer client al server RDS per Db2, verrà visualizzato un errore SQL3025N. Utilizza invece il [comando IMPORT](db2-native-db2-tools-import.md).
**Per caricare dati sul server RDS per Db2**
1. Accedi al tuo computer client con IBM Db2 Data Management Console. Per ulteriori informazioni, consulta [Connessione a un’istanza database Amazon RDS per Db2 con IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md).
1. Cataloga il database RDS per Db2 sul computer client.
1. Cataloga il nodo. Nell’esempio seguente, sostituisci *dns\$1ip\$1address* e *port* con il nome DNS o l’indirizzo IP e il numero di porta del database Db2 autogestito.
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. Cataloga il database. Nell’esempio seguente, sostituisci *source\$1database\$1name* e *source\$1database\$1alias* con il nome del database Db2 autogestito e l’alias da utilizzare per il database.
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. Collega al database di origine. Nell’esempio seguente, sostituisci *source\$1database\$1alias*, *user\$1id* e *user\$1password* con l’alias creato nel passaggio precedente e l’ID e la password dell’utente per il database Db2 autogestito.
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. Genera il file di dati utilizzando il comando `EXPORT` sul sistema Db2 autogestito. Nell’esempio seguente, sostituisci *directory* con la directory sul computer client in cui si trova il file di dati. Sostituisci *file\$1name* e *TABLE\$1NAME* con il nome del file di dati e il nome della tabella.
```
db2 "export to /directory/file_name.txt of del modified by coldel\| \
select * from TPCH.TABLE_NAME"
```
1. Connettiti al database RDS per Db2 utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Nell’esempio seguente, sostituisci **rds\$1database\$1alias**, *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Utilizza il comando `LOAD` per caricare dati da un file sul computer client al database remoto RDS per Db2. Per ulteriori informazioni, consulta [LOAD command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-load) nella documentazione di IBM Db2. Nell’esempio seguente, sostituisci *directory* con la directory sul computer client in cui si trova il file di dati. Sostituisci *file\$1name* e *TABLE\$1NAME* con il nome del file di dati e il nome della tabella.
```
db2 "LOAD CLIENT from /directory/file_name.txt \
modified by coldel\| replace into TPCH.TABLE_NAME \
nonrecoverable without prompting"
```
1. Termina la connessione.
```
db2 terminate
```
# Importazione di dati da Db2 ad Amazon RDS per Db2 con il comando INSERT
Puoi usare il comando `INSERT` da un server Db2 autogestito per inserire i tuoi dati in un database Amazon RDS per Db2. Questo approccio alla migrazione prevede l’utilizzo di un nickname per l’istanza database remota RDS per Db2. Il database Db2 autogestito (origine) deve essere in grado di connettersi al database RDS per Db2 (destinazione).
**Importante**
Il metodo del comando `INSERT` è utile per la migrazione di tabelle di piccole dimensioni. Se la larghezza di banda della rete tra il database Db2 autogestito e RDS per Db2 è limitata, è consigliabile utilizzare un approccio diverso per la migrazione. Per ulteriori informazioni, consulta [Utilizzo degli strumenti Db2 nativi per la migrazione di dati da Db2 ad Amazon RDS per Db2](db2-native-db2-tools.md).
**Per copiare dati da un database Db2 autogestito a un database Amazon RDS per Db2**
1. Cataloga l’istanza database RDS per Db2 sull’istanza Db2 autogestita.
1. Cataloga il nodo. Nell’esempio seguente, sostituisci *dns\$1ip\$1address* e *port* con il nome DNS o l’indirizzo IP e il numero di porta del database Db2 autogestito.
```
db2 catalog tcpip node remnode REMOTE dns_ip_address SERVER port
```
1. Cataloga il database. Nell’esempio seguente, sostituisci *rds\$1database\$1name* con il nome del database sull’istanza database RDS per Db2.
```
db2 catalog database rds_database_name as remdb at node remnode \
authentication server_encrypt
```
1. Abilita la federazione sull’istanza Db2 autogestita. Nell’esempio seguente, sostituisci *source\$1database\$1name* con il nome del database sull’istanza Db2 autogestita.
```
db2 update dbm cfg using FEDERATED YES source_database_name
```
1. Crea tabelle sull’istanza database RDS per Db2.
1. Cataloga il nodo. Nell’esempio seguente, sostituisci *dns\$1ip\$1address* e *port* con il nome DNS o l’indirizzo IP e il numero di porta del database Db2 autogestito.
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. Cataloga il database. Nell’esempio seguente, sostituisci *source\$1database\$1name* e *source\$1database\$1alias* con il nome del database Db2 autogestito e l’alias da utilizzare per il database.
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. Collega al database di origine. Nell’esempio seguente, sostituisci *source\$1database\$1alias*, *user\$1id* e *user\$1password* con l’alias creato nel passaggio precedente e l’ID e la password dell’utente per il database Db2 autogestito.
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. Imposta la federazione e crea un nickname per la tabella di database RDS per Db2 sull’istanza Db2 autogestita.
1. Connettiti al database locale. Nell’esempio seguente, sostituisci *source\$1database\$1name* con il nome del database sulla tua istanza Db2 autogestita.
```
db2 connect to source_database_name
```
1. Crea un wrapper per accedere alle origini dati Db2.
```
db2 create wrapper drda
```
1. Definisci un’origine dati su un database federato. Nell’esempio seguente, sostituisci *admin* e *admin\$1password* con le tue credenziali per l’istanza Db2 autogestita. Sostituisci *rds\$1database\$1name* con il nome del database sull’istanza database RDS per Db2.
```
db2 "create server rdsdb2 type DB2/LUW version '11.5.9.0' \
wrapper drda authorization "admin" password "admin_password" \
options( dbname 'rds_database_name', node 'remnode')"
```
1. Mappa gli utenti sui due database. Nell’esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue credenziali per l’istanza database RDS per Db2.
```
db2 "create user mapping for user server rdsdb2 \
options (REMOTE_AUTHID 'master_username', REMOTE_PASSWORD 'master_password')"
```
1. Verifica la connessione al server RDS per Db2.
```
db2 set passthru rdsdb2
```
1. Crea un nickname per la tabella nel database RDS per Db2 remoto. Nell’esempio seguente, sostituisci *NICKNAME* e *TABLE\$1NAME* con un nickname per la tabella e il nome della tabella.
```
db2 create nickname REMOTE.NICKNAME for RDSDB2.TABLE_NAME.NICKNAME
```
1. Inserisci dati nella tabella nel database RDS per Db2 remoto. Utilizza il nickname in un’istruzione `select` sulla tabella locale nell’istanza Db2 autogestita. Nell’esempio seguente, sostituisci *NICKNAME* e *TABLE\$1NAME* con un nickname per la tabella e il nome della tabella.
```
db2 "INSERT into REMOTE.NICKNAME select * from RDS2DB2.TABLE_NAME.NICKNAME"
```
# Importazione di dati da Db2 ad Amazon RDS per Db2 con l’utilità INGEST
Puoi utilizzare l’utilità `INGEST` per eseguire lo streaming continuo di dati da file e pipe da un computer client a un’istanza database Amazon RDS per Db2 di destinazione. L’utilità `INGEST` supporta le operazioni `INSERT` e `MERGE`. Per ulteriori informazioni, consulta [Ingest utility](https://www.ibm.com/docs/en/db2/11.1?topic=reference-ingest-utility) nella documentazione di IBM Db2.
Poiché l’utilità `INGEST` supporta i nickname, puoi utilizzarla per trasferire dati da un database Db2 autogestito a un database RDS per Db2. Questo approccio funziona a condizione che esista una connettività di rete tra i due database.
**Importante**
L’utilità `INGEST` non supporta gli oggetti di grandi dimensioni (LOB). Utilizza invece il [comando `IMPORT`](db2-native-db2-tools-import.md).
Per utilizzare la funzionalità `RESTARTABLE` dell’utilità `INGEST`, esegui il comando seguente nel database RDS per Db2.
```
db2 "call sysproc.sysinstallobjects(‘INGEST’,‘C’,NULL,NULL)"
```
# Federazione per Amazon RDS per Db2
Puoi usare il tuo database Amazon RDS per Db2 come database federato. Dopo aver configurato la federazione per RDS per Db2, potrai accedere ai dati in più database ed eseguire query su di essi dal tuo database RDS per Db2. La federazione evita la necessità di eseguire la migrazione dei dati nel database RDS per Db2 o di consolidare i dati in un unico database.
Utilizzando il database RDS for Db2 come database federato, è possibile continuare ad accedere a tutte le funzionalità di RDS for Db2 e trarne vantaggio Servizi AWS, il tutto mantenendo i dati in database diversi. È possibile impostare sia una federazione omogenea, che collega database dello stesso tipo, sia una federazione eterogenea, che collega database di tipi diversi.
Prima di tutto devi connettere il tuo database Db2 in RDS per Db2 ai database remoti. Quindi puoi eseguire query su tutti i database connessi. Ad esempio, è possibile eseguire un'istruzione SQL JOIN che unisce le tabelle del database RDS for Db2 con le tabelle di un database Db2 on remoto. z/OS
**Topics**
+ [Federazione omogenea](#db2-federation-homogeneous)
+ [Federazione eterogenea](#db2-federation-heterogeneous)
## Federazione omogenea
Puoi configurare una federazione omogenea tra il tuo database RDS per Db2 e la seguente famiglia di prodotti Db2:
+ Db2 per Linux, UNIX, Windows (LUW)
+ Db2 iSeries
+ Db2 per z/OS
La federazione omogenea di RDS per Db2 non supporta le seguenti azioni:
+ Esecuzione di comandi `CATALOG` per configurare una directory di nodi e un database remoto su un database host RDS per Db2
+ Configurazione del bilanciamento del carico di lavoro (WLB) per la federazione con Db2 su z/OS
+ Configurazione del file di configurazione driver del server di dati IBM (`db2dsdriver.cfg`)
La federazione omogenea in RDS per Db2 prevede i seguenti requisiti:
+ È necessario creare il wrapper DRDA in modalità `UNFENCED`. In caso contrario, la federazione non funzionerà in RDS per Db2.
+ È necessario consentire il traffico in entrata e in uscita dal database host RDS per Db2 ai database host remoti. Per ulteriori informazioni, consulta [Fornisci accesso alla istanza database nel VPC creando un gruppo di sicurezza](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup).
**Topics**
+ [Fase 1: creare un wrapper DRDA e un server federato](#db2-federation-homogeneous-create)
+ [Fase 2: creare una mappatura degli utenti](#db2-federation-homogeneous-map)
+ [Fase 3: controllare la connessione](#db2-federation-homogeneous-check)
### Fase 1: creare un wrapper DRDA e un server federato
Per la federazione omogenea, crea un wrapper DRDA e un server federato. La connessione all’host remoto utilizza `HOST`, `PORT` e `DBNAME`.
Scegli uno dei seguenti metodi a seconda del tipo di database Db2 remoto:
+ **Database Db2 per Linux, UNIX e Windows (LUX)**: esegui i seguenti comandi SQL. Nell'esempio seguente, sostituiscilo *server\$1name* con il nome del server che utilizzerai per la federazione. Sostituiscilo *db2\$1version* con la versione del tuo database Db2 remoto. Sostituisci *username* e *password* con le tue credenziali per il database Db2 remoto a cui desideri connetterti. Sostituisci *db\$1name* e *port* con i valori appropriati per il database Db2 remoto a cui desideri connetterti. *dns\$1name*
```
create wrapper drda options(DB2_FENCED 'N');
create server server_name type DB2/LUW wrapper drda version 'db2_version' authorization "master_username" password "master_password" options (add DBNAME 'db_name',add HOST 'dns_name',add PORT 'port');
```
**Esempio**
```
create wrapper drda options(DB2_FENCED 'N');
create server SERVER1 type DB2/LUW wrapper drda version '11.5' authorization "sysuser" password "******" options (add DBNAME 'TESTDB2',add HOST 'ip-123-45-67-899.us-west-1.compute.internal',add PORT '25010');
```
+ **Db2 iSeries**: esegui i seguenti comandi SQL. [Nell'esempio seguente, sostituite *wrapper\$1name* e *library\$1name* con un nome per il wrapper DRDA e il file della libreria wrapper.](https://www.ibm.com/docs/en/db2/11.5?topic=wrapper-db2-library-files) *server\$1name*Sostituiscilo con il nome del server che utilizzerai per la federazione. Sostituiscilo *db2\$1version* con la versione del tuo database Db2 remoto. Sostituisci *username* e *password* con le tue credenziali per il database Db2 remoto a cui desideri connetterti. Sostituisci *dns\$1name* e *db\$1name* con i valori appropriati per il database Db2 remoto a cui desideri connetterti. *port*
```
create wrapper wrapper_name library 'library name' options(DB2_FENCED 'N');
create server server_name type db2/mvs version db2_version wrapper wrapper_name authorization "sername" password "password" options (HOST 'dns_name', PORT 'port', DBNAME 'db_name');
```
**Esempio**
```
create wrapper WRAPPER1 library 'libdb2drda.so' options(DB2_FENCED 'N');
create server SERVER1 type db2/mvs version 11 wrapper WRAPPER1 authorization "sysuser" password "******" options (HOST 'test1.123.com', PORT '446', DBNAME 'STLEC1');
```
+ **Db2 per z/OS**: esegui i seguenti comandi SQL. [Nell'esempio seguente, sostituite *wrapper\$1name* e *library\$1name* con un nome per il wrapper DRDA e il file della libreria wrapper.](https://www.ibm.com/docs/en/db2/11.5?topic=wrapper-db2-library-files) *server\$1name*Sostituiscilo con il nome del server che utilizzerai per la federazione. Sostituiscilo *db2\$1version* con la versione del tuo database Db2 remoto. Sostituisci *username* e *password* con le tue credenziali per il database Db2 remoto a cui desideri connetterti. Sostituisci *dns\$1name* e *db\$1name* con i valori appropriati per il database Db2 remoto a cui desideri connetterti. *port*
```
create wrapper wrapper_name library 'library_name' options(DB2_FENCED 'N');
create server server_name type db2/mvs version db2_version wrapper wrapper_name authorization "username" password "password" options (HOST 'dns_name', PORT 'port', DBNAME 'db_name');
```
**Esempio**
```
create wrapper WRAPPER1 library 'libdb2drda.so' OPTIONS(DB2_FENCED 'N');
create server SERVER1 type db2/mvs version 11 wrapper WRAPPER1 authorization "sysuser" password "******" options (HOST 'test1.123.com', PORT '446', DBNAME 'STLEC1');
```
### Fase 2: creare una mappatura degli utenti
Crea una mappatura degli utenti per associare il server federato al server di origine dati eseguendo il seguente comando SQL. Nell'esempio seguente, *server\$1name* sostituitelo con il nome del server remoto su cui desiderate eseguire le operazioni. Si tratta del server che hai creato nella [fase 1](#db2-federation-homogeneous-create). Sostituisci *username* e *password* con le tue credenziali per questo server remoto.
```
create user mapping for user server server_name options (REMOTE_AUTHID 'username', REMOTE_PASSWORD 'password');
```
Per ulteriori informazioni, consulta [User mappings](https://www.ibm.com/docs/en/db2/11.5?topic=systems-user-mappings) nella documentazione di IBM Db2.
### Fase 3: controllare la connessione
Verifica che la configurazione della federazione sia avvenuta correttamente controllando la connessione. Apri una sessione per inviare comandi SQL nativi all’origine dati remota utilizzando il comando SET PASSTHRU, quindi crea una tabella sul server di dati remoto.
1. Apri e chiudi una sessione per inviare SQL a un’origine dati. Nell'esempio seguente, *server\$1name* sostituiscilo con il nome del server creato per la federazione nel passaggio 1.
```
set passthru server_name;
```
1. Creare una nuova tabella . Nell'esempio seguente *column\$1name**data\$1type*, sostituisci e *value* con gli elementi appropriati per la tua tabella.
```
create table table_name ( column_name data_type(value), column_name data_type(value);
```
Per ulteriori informazioni, consulta [CREATE TABLE statement](https://www.ibm.com/docs/en/db2-event-store/2.0.0?topic=statements-create-table) nella documentazione di IBM Db2.
1. Crea un indice, inserisci i valori per le righe nella tabella e reimposta la connessione. La reimpostazione della connessione interrompe la connessione ma mantiene i processi di backend. Nell'esempio seguente, sostituisci*index\$1name*, *table\$1name**column\$1name*, e *columnx\$1value* con le tue informazioni.
```
create index index_name on table_name(column_name);
insert into table_name values(column1_value,column2_value,column3_value);
insert into table_name values(column1_value,column2_value,column3_value);
set passthru reset;
connect reset;
```
1. Connettiti al tuo database Db2 remoto, crea un nickname per il server remoto ed esegui le operazioni. Quando non ti serve più l’accesso ai dati nel database Db2 remoto, reimposta e quindi termina la connessione. Nell'esempio seguente, sostituiscilo *database\$1name* con il nome del tuo database Db2 remoto. Sostituisci *nickname* con un nome. Sostituisci *server\$1name* e *table\$1name* con il nome del server remoto e della tabella sul server su cui desideri eseguire le operazioni. Sostituiscilo *username* con le informazioni relative al tuo server remoto. Sostituire *sql\$1command* con l'operazione da eseguire sul server remoto.
```
connect to database_name;
create nickname nickname for server_name."username"."table_name";
select sql_command from nickname;
connect reset;
terminate;
```
**Esempio**
Nell’esempio seguente viene creata una sessione pass-through per consentire le operazioni sul server federato `testdb10`.
Viene poi creata la tabella `t1` con tre colonne con diversi tipi di dati.
Quindi, viene creato l’indice `i1_t1` su tre colonne della tabella `t1`. Successivamente, vengono inserite due righe con valori per queste tre colonne e quindi viene effettuata la disconnessione.
Infine, viene effettuata la connessione al database Db2 remoto `testdb2` e viene creato un nickname per la tabella ` t1` nel server federato `testdb10`. Viene creato il nickname con il nome utente `TESTUSER` per quella origine dati. Un comando SQL restituisce tutti i dati della tabella `t1`. Viene effettuata la disconnessione e la sessione viene terminata.
```
set passthru testdbl0;
create table t1 ( c1 decimal(13,0), c2 char(200), c3 int);
create index i1_t1 on t1(c3);
insert into t1 values(1,'Test',1);
insert into t1 values(2,'Test 2',2);
connect reset;
connect to testdb2;
create nickname remote_t1 for testdbl0."TESTUSER"."T1";
select * from remote_t1;
connect reset;
terminate;
```
## Federazione eterogenea
È possibile configurare una federazione eterogenea tra il database RDS per Db2 e altre origini dati come Oracle e Microsoft SQL Server. Per un elenco completo delle origini dati supportate da Db2 LUW, consulta [Data Source Support Matrix of Federation Bundled in Db2 LUW V11.5](https://www.ibm.com/support/pages/data-source-support-matrix-federation-bundled-db2-luw-v115) sul sito IBM Support.
La Federazione eterogenea di RDS per Db2 non supporta quanto segue:
+ Wrapper nativi per le altre origini dati
+ Wrapper JDBC per le altre origini dati
+ Federazione a origini dati Sybase, Informix e Teradata perché queste origini dati richiedono l’installazione del software client su RDS per Db2
La federazione eterogenea in RDS per Db2 prevede i seguenti requisiti:
+ RDS per Db2 supporta solo il metodo wrapper ODBC.
+ Se crei una definizione esplicita di un wrapper, devi impostare l’opzione `DB2_FENCED` su `'N'`. Per un elenco delle opzioni wrapper valide per ODBC, consulta [ODBC options](https://www.ibm.com/docs/en/db2/11.5?topic=options-odbc) nella documentazione di IBM Db2.
+ È necessario consentire il traffico in entrata e in uscita dal database host RDS per Db2 al database host remoto. Per ulteriori informazioni, consulta [Fornisci accesso alla istanza database nel VPC creando un gruppo di sicurezza](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup).
Per informazioni sulla federazione con Oracle, consulta [How to query Oracle by using Db2 Federation and the ODBC driver?](https://www.ibm.com/support/pages/node/6431133) sul sito IBM Support.
Per ulteriori informazioni sulle origini dati che supportano la federazione, consulta [Data Source Support Matrix of Federation Bundled in Db2 LUW V11.5](https://www.ibm.com/support/pages/node/957245) sul sito IBM Support.
**Topics**
+ [Fase 1: creare un wrapper ODBC](#db2-federation-heteogenous-define-wrapper)
+ [Fase 2: creare un server federato](#db2-federation-heterogeneous-create)
+ [Fase 3: creare una mappatura degli utenti](#db2-federation-heterogeneous-map)
+ [Fase 4: controllare la connessione](#db2-federation-heterogeneous-check)
### Fase 1: creare un wrapper ODBC
Crea un wrapper eseguendo il seguente comando:
```
db2 "create wrapper odbc options( module '/home/rdsdb/sqllib/federation/odbc/lib/libodbc.so')"
```
### Fase 2: creare un server federato
Crea un server federato eseguendo il seguente comando: Nell'esempio seguente, *server\$1name* sostituiscilo con il nome del server che utilizzerai per la federazione. Sostituire *wrapper\$1type* con il wrapper appropriato. Sostituisci *db\$1version* con la versione del tuo database remoto. Sostituisci *dns\$1name* e *service\$1name* con i valori appropriati per il database remoto a cui desideri connetterti. *port*
```
db2 "create server server_name type wrapper_type version db_version options (HOST 'dns_name', PORT 'port', SERVICE_NAME 'service_name')“
```
Per informazioni sui tipi di wrapper, consulta [Data Source Support Matrix of Federation Bundled in Db2 LUW V11.5](https://www.ibm.com/support/pages/node/957245) sul sito IBM Support.
**Esempio**
Nell’esempio seguente viene creato un server federato per un database Oracle remoto.
```
db2 "create server server1 type oracle_odbc version 12.1 options (HOST 'test1.amazon.com', PORT '1521', SERVICE_NAME 'pdborcl.amazon.com')“
```
### Fase 3: creare una mappatura degli utenti
Crea una mappatura degli utenti per associare il server federato al server di origine dati eseguendo il seguente comando SQL. Nell'esempio seguente, *server\$1name* sostituitelo con il nome del server remoto su cui desiderate eseguire le operazioni. Si tratta del server che hai creato nella [fase 2](#db2-federation-heterogeneous-create). Sostituisci *username* e *password* con le tue credenziali per questo server remoto.
```
create user mapping for user server server_name options (REMOTE_AUTHID 'username', REMOTE_PASSWORD 'password');
```
Per ulteriori informazioni, consulta [User mappings](https://www.ibm.com/docs/en/db2/11.5?topic=systems-user-mappings) nella documentazione di IBM Db2.
### Fase 4: controllare la connessione
Verifica che la configurazione della federazione sia avvenuta correttamente controllando la connessione. Apri una sessione per inviare comandi SQL nativi all’origine dati remota utilizzando il comando SET PASSTHRU, quindi crea una tabella sul server di dati remoto.
1. Apri e chiudi una sessione per inviare SQL a un’origine dati. Nell'esempio seguente, *server\$1name* sostituiscilo con il nome del server creato per la federazione nel [passaggio 2](#db2-federation-heterogeneous-create).
```
set passthru server_name;
```
1. Creare una nuova tabella . Nell'esempio seguente *column\$1name**data\$1type*, sostituisci e *value* con gli elementi appropriati per la tua tabella.
```
create table table_name ( column_name data_type(value), column_name data_type(value);
```
Per ulteriori informazioni, consulta [CREATE TABLE statement](https://www.ibm.com/docs/en/db2-event-store/2.0.0?topic=statements-create-table) nella documentazione di IBM Db2.
1. Crea un indice, inserisci i valori per le righe nella tabella e reimposta la connessione. La reimpostazione della connessione interrompe la connessione ma mantiene i processi di backend. Nell'esempio seguente, sostituisci*index\$1name*, *table\$1name**column\$1name*, e *columnx\$1value* con le tue informazioni.
```
create index index_name on table_name(column_name);
insert into table_name values(column1_value,column2_value,column3_value);
insert into table_name values(column1_value,column2_value,column3_value);
set passthru reset;
connect reset;
```
1. Connettiti al tuo database Db2 remoto, crea un nickname per il server remoto ed esegui le operazioni. Quando non ti serve più l’accesso ai dati nel database Db2 remoto, reimposta e quindi termina la connessione. Nell'esempio seguente, sostituiscilo *database\$1name* con il nome del tuo database Db2 remoto. Sostituisci *nickname* con un nome. Sostituisci *server\$1name* e *table\$1name* con il nome del server remoto e della tabella sul server su cui desideri eseguire le operazioni. Sostituiscilo *username* con le informazioni relative al tuo server remoto. Sostituire *sql\$1command* con l'operazione da eseguire sul server remoto.
```
connect to database_name;
create nickname nickname for server_name."username"."table_name";
select sql_command from nickname;
connect reset;
terminate;
```
**Esempio**
Nell’esempio seguente viene creata una sessione pass-through per consentire le operazioni sul server federato `testdb10`.
Viene poi creata la tabella `t1` con tre colonne con diversi tipi di dati.
Quindi, viene creato l’indice `i1_t1` su tre colonne della tabella `t1`. Successivamente, vengono inserite due righe con valori per queste tre colonne e quindi viene effettuata la disconnessione.
Infine, viene effettuata la connessione al database Db2 remoto `testdb2` e viene creato un nickname per la tabella ` t1` nel server federato `testdb10`. Viene creato il nickname con il nome utente `TESTUSER` per quella origine dati. Un comando SQL restituisce tutti i dati della tabella `t1`. Viene effettuata la disconnessione e la sessione viene terminata.
```
set passthru testdbl0;
create table t1 ( c1 decimal(13,0), c2 char(200), c3 int);
create index i1_t1 on t1(c3);
insert into t1 values(1,'Test',1);
insert into t1 values(2,'Test 2',2);
connect reset;
connect to testdb2;
create nickname remote_t1 for testdbl0."TESTUSER"."T1";
select * from remote_t1;
connect reset;
terminate;
```
# Utilizzo delle repliche in Amazon RDS per Db2
RDS per Db2 supporta la creazione di database di replica per fornire funzionalità di dimensionamento di lettura e disaster recovery. È possibile creare repliche in due modalità: modalità di sola lettura, per ridurre i carichi di lavoro di lettura, e modalità in standby, per il disaster recovery multi-Regione. Per il processo di replica, RDS per Db2 utilizza la tecnologia High Availability Disaster Recovery (HADR) di IBM Db2. Per ulteriori informazioni, consulta [High availability disaster recovery (HADR)](https://www.ibm.com/docs/en/db2/11.5?topic=server-high-availability-disaster-recovery-hadr) nella documentazione di IBM Db2.
Un database di *replica Db2* è una copia fisica del database primario. Se è in modalità di sola lettura, una replica Db2 viene chiamata *replica di lettura*. Se invece è in modalità standby, viene chiamata *replica in standby*. Db2 non consente operazioni di scrittura in una replica, ma è possibile promuovere una replica per renderla scrivibile. La replica promossa contiene i dati replicati fino al momento in cui è stata effettuata la richiesta di promozione. Per ulteriori informazioni, consulta [Promozione di una replica di lettura a istanza database standalone](USER_ReadRepl.Promote.md).
Per un riepilogo delle funzionalità e dei comportamenti delle repliche RDS per Db2, consulta [Differenze tra repliche di lettura per i motori di database](USER_ReadRepl.Overview.Differences.md).
## Repliche di sola lettura e in standby
Durante la creazione e la modifica di una replica Db2, è possibile impostare una delle seguenti modalità:
**Sola lettura**
Questa è l’impostazione predefinita. HADR trasmette e applica le modifiche dal database di origine a tutti i database di replica di lettura. Per le repliche di sola lettura, la variabile di ambiente Db2 `DB2_HADR_ROS` è impostata su `ON`. Il livello di isolamento per le query di lettura sul database di replica è `Uncommitted Read`. Per ulteriori informazioni, consulta [Isolation level on the active standby database](https://www.ibm.com/docs/en/db2/11.5?topic=standby-isolation-level-active-database) nella documentazione di IBM Db2.
Per informazioni generali sulle repliche di lettura applicabili a tutti i motori DB, consulta [Uso delle repliche di lettura dell'istanza database](USER_ReadRepl.md). Per ulteriori informazioni su Db2 HADR, consulta [High availability disaster recovery (HADR)](https://www.ibm.com/docs/en/db2/11.5?topic=server-high-availability-disaster-recovery-hadr) nella documentazione di IBM Db2.
**Standby**
Per le repliche in standby, la variabile di ambiente Db2 `DB2_HADR_ROS` è impostata su `OFF` per evitare che i database di replica accettino connessioni utente. L’utilizzo primario delle repliche in standby è il disaster recovery multi-Regione.
Una replica in standby non può gestire un carico di lavoro di sola lettura. Per la replica in standby non è previsto alcun log di archivio.
È possibile creare fino a tre repliche di lettura da una sola istanza database di origine. È possibile creare una combinazione di repliche di database di sola lettura e in standby per la stessa istanza database di origine. Dopo aver creato una replica, è possibile modificarne la modalità. Per ulteriori informazioni, consulta [Modifica della modalità di replica RDS per Db2](db2-replicas-changing-replica-mode.md).
Prima di creare repliche, assicurati che siano soddisfatti tutti i requisiti. Per ulteriori informazioni, consulta [Requisiti e considerazioni sulle repliche RDS per Db2](db2-read-replicas.limitations.md).
## Attivazioni di database
Db2 HADR è configurato a livello di database. Dopo aver creato le repliche, HADR viene impostato per tutti i database Db2, incluso `rdsadmin`, che RDS gestisce completamente. Prima di creare repliche Db2, è necessario attivare in modo esplicito tutti i database. In caso contrario, la creazione di repliche non riesce e Amazon RDS genera un evento. Quando una o più repliche sono state create in un’istanza database, non è possibile attivare o disattivare alcun database sull’istanza database utilizzando la stored procedure `rdsadmin.activate_database` o `rdsadmin.deactivate_database`. Per ulteriori informazioni, consulta [Stored procedure relative ai database per RDS per Db2](db2-sp-managing-databases.md).
## Configurazioni di HADR
È possibile visualizzare tutte le configurazioni di HADR per un database connettendosi al database ed eseguendo `db2 get db cfg`.
## Conservazione dei log di archivio
Amazon RDS rimuove i log da un’istanza database primaria dopo che risultano soddisfatte le seguenti condizioni:
+ I log risalgono ad almeno due ore prima.
+ L’impostazione relativa alle ore di conservazione dei log di archivio è scaduta.
+ I log di archivio sono stati replicati correttamente su tutte le istanze database di replica. Questa condizione si applica sia alle istanze DB nella stessa che alle Regione AWS istanze DB interregionali.
Per informazioni sull'impostazione delle ore di conservazione dei log di archivio, consulta [rdsadmin.set\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-set-archive-log-retention).
Amazon RDS controlla e pulisce ogni database singolarmente. Se un database perde la connessione HADR o se le informazioni sulla connessione non sono disponibili, Amazon RDS ignora il database e non rimuove i log di archivio.
## Interruzioni durante la replica Db2
Durante la creazione di una replica di lettura, Amazon RDS acquisisce uno snapshot di database dell’istanza database di origine e avvia la replica. Quando inizia l'operazione di snapshot DB, l'istanza DB di origine subisce una sospensione molto breve. I/O La I/O sospensione dura in genere circa un secondo. Tuttavia, se l'istanza DB di origine è una distribuzione Multi-AZ, l'istanza DB di origine non subisce alcuna I/O sospensione. Questo è possibile perché con le implementazioni Multi-AZ, lo snapshot viene acquisito dall’istanza database secondaria.
Lo snapshot di database diventa la replica Db2. Amazon RDS imposta i parametri e le autorizzazioni necessari per il database di origine e la replica di lettura senza alcuna interruzione del servizio. Analogamente, se si elimina una replica, non si verifica alcuna interruzione.
# Requisiti e considerazioni sulle repliche RDS per Db2
I requisiti per le repliche Db2 rientrano in diverse categorie: licenze e controllo delle versioni, considerazioni sul backup e il ripristino, comportamento delle repliche e considerazioni operative generali. Prima di creare una replica Db2, esamina i requisiti e le considerazioni riportati di seguito.
## Requisiti di versione e licenza per le repliche RDS per Db2
Prima di creare una replica RDS per Db2, consulta le seguenti informazioni sulle versioni e sui modelli di licenza:
+ **Versioni supportate**: tutte le versioni di Db2 11.5 supportano istanze database di replica.
Le istanze database di origine e di replica devono utilizzare la stessa versione principale. Le repliche Db2 supportano gli aggiornamenti delle versioni minori ma non quelli delle versioni principali. Per informazioni sull’aggiornamento delle istanze database, consulta [Aggiornamento della versione del motore di di un'istanza database](USER_UpgradeDBInstance.Upgrading.md).
**Nota**
In caso di aggiornamento di un’istanza database di origine, tutte le repliche vengono aggiornate automaticamente per mantenere la compatibilità delle versioni.
+ **Modelli di licenza e modalità di replica validi**: sia Db2 Advanced Edition (AE) che Standard Edition (SE) possono creare repliche in modalità di sola lettura o standby sia per il modello Bring Your Own License (BYOL) che per il modello con licenza Db2. Marketplace AWS
+ **Gruppo di parametri personalizzato**: per la replica è necessario specificare un gruppo di parametri personalizzato.
Nel caso di repliche che utilizzano il modello BYOL, questo gruppo di parametri personalizzato deve includere IBM Site ID e IBM Customer ID. Per ulteriori informazioni, consulta [IBM IDs per portare la propria licenza (BYOL) per Db2](db2-licensing.md#db2-prereqs-ibm-info). È possibile specificare questo gruppo di parametri personalizzato per la replica utilizzando l'API, the o RDS. Console di gestione AWS AWS CLI
+ Il **numero di vCPU** varia in base alla modalità di replica e al modello di licenza:
+ Le **repliche in standby** utilizzano sempre due v CPUs indipendentemente dalla dimensione dell'istanza DB.
+ **Modello BYOL**: AWS License Manager le configurazioni mostrano che RDS per le istanze DB Db2 utilizza due v. CPUs
+ **Db2 licenza tramite Marketplace AWS modello**: le fatture riflettono i costi di licenza per due v. CPUs
+ Le **repliche di sola lettura** utilizzano lo stesso numero di vCPU delle dimensioni dell’istanza database.
+ **Modello BYOL**: AWS License Manager le configurazioni mostrano che RDS per le istanze DB Db2 utilizza lo stesso numero di v che corrisponde alla dimensione dell'istanza DB. CPUs
+ **Db2 licenza tramite Marketplace AWS modello**: le fatture riflettono i costi di licenza per lo stesso numero di v corrispondenti alla dimensione dell'istanza DB. CPUs
## Considerazioni sul backup e il ripristino per le repliche RDS per Db2
I backup di repliche hanno un comportamento diverso rispetto ai backup del database primario. Considera i seguenti requisiti di backup e ripristino:
+ Per creare snapshot delle repliche RDS per Db2 o attivare i backup automatici, assicurati di impostare manualmente il periodo di conservazione dei backup. Per impostazione predefinita, i backup automatici non sono attivati.
+ Quando si ripristina un backup di repliche, si esegue il ripristino corrispondente all'ora del database e non al momento in cui il backup è stato eseguito. L'ora del database si riferisce all'ora dell'ultima transazione applicata ai dati nel backup. La differenza è significativa perché una replica può essere in ritardo rispetto al database primario in termini di ore o minuti. In presenza di più database, RDS per Db2 utilizza l’ora del database meno recente.
[Per trovare la differenza, esegui il AWS CLI[describe-db-snapshots](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-snapshots.html)comando o chiama l'operazione RDS API Descrive. DBSnapshots](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBSnapshots.html) Confronta il valore di `SnapshotDatabaseTime` rispetto a quello di `OriginalSnapshotCreateTime`. Il valore di `SnapshotDatabaseTime` corrisponde all’ora del database del backup di replica. Il valore di `OriginalSnapshotCreateTime` corrisponde alla transazione più recente applicata al database primario.
Per ulteriori informazioni sui backup e sul ripristino di backup, consulta [Utilizzo dei backup di repliche RDS per Db2](db2-read-replicas.backups.md).
## Considerazioni sul processo di replica per le repliche RDS per Db2
Le repliche Db2 utilizzano la tecnologia HADR con limitazioni e comportamenti specifici. Esamina le seguenti considerazioni sul processo di replica:
+ Il processo di replica utilizza la funzione Db2 HADR per tutti i database sull’istanza database RDS per Db2.
+ La replica non supporta il comando `LOAD`. Se esegui il comando `LOAD` dall’istanza database di origine, riceverai dati non coerenti.
+ RDS per Db2 non replica i seguenti elementi:
+ Accesso all’archiviazione. Fai attenzione ai dati, come le tabelle esterne, che si basano su account di accesso all’archiviazione.
+ Non in linea LOBs che non sono registrati.
+ File binari di stored procedure esterne (in C o Java).
+ Per le repliche in standby, RDS per Db2 replica i seguenti elementi:
+ Utenti locali, tranne gli utenti master
+ Parametri di configurazione del database
+ Per le repliche di sola lettura, RDS per Db2 replica i seguenti elementi:
+ Utenti locali, tranne gli utenti master
+ Mappature dei gruppi SID
## Considerazioni varie sulle repliche RDS per Db2
Di seguito sono riportate alcune considerazioni operative aggiuntive che si applicano alle repliche Db2. Esamina quanto segue:
+ RDS per Db2 replica le configurazioni dei database nelle repliche. Quando RDS per Db2 promuove una replica, disattiva e attiva ogni database.
+ RDS per Db2 replica gli utenti locali, ma non l’utente master, e le mappature dei gruppi SID nelle repliche. È possibile modificare l’utente master direttamente sulla replica. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
+ Tutti i database devono essere in stato attivo. Per informazioni sull’attivazione di database, consulta [Stored procedure relative ai database per RDS per Db2](db2-sp-managing-databases.md).
+ Tutte le stored procedure per la creazione, l’eliminazione, il ripristino o il roll-forward dei database devono essere completate prima della creazione di una replica. Per informazioni su queste stored procedure, consulta [Stored procedure relative ai database per RDS per Db2](db2-sp-managing-databases.md).
+ Quando viene creata la replica, Amazon RDS imposta il parametro a livello di database `blocknonlogged` per tutti i database sull’istanza database di origine su `YES`. Quando la replica di origine diventa nuovamente un’istanza autonoma, Amazon RDS reimposta il valore su `NO`. Per ulteriori informazioni, consulta [blocknonlogged - Block creation of tables that allow non-logged activity configuration parameter](https://www.ibm.com/docs/en/db2/11.1?topic=dcp-blocknonlogged-block-creation-tables-that-allow-non-logged-activity) nella documentazione di IBM Db2.
+ Quando viene creata la replica, Amazon RDS imposta il parametro a livello di database `logindexbuild` per tutti i database sull’istanza database di origine su `YES`. Quando la replica di origine diventa nuovamente un’istanza autonoma, Amazon RDS reimposta il valore su `NO`. Per ulteriori informazioni, consulta [logindexbuild - Log index pages created configuration parameter](https://www.ibm.com/docs/en/db2/11.1?topic=parameters-logindexbuild-log-index-pages-created) nella documentazione di IBM Db2.
# Preparazione alla creazione di una replica RDS per Db2
Prima di creare una replica RDS per Db2, è necessario completare le seguenti attività per assicurarsi che la replica venga eseguita correttamente. Queste attività aiutano a prevenire problemi comuni e a garantire prestazioni ottimali.
## Attività 1: abilitare i backup automatici
Prima di poter utilizzare un'istanza database come istanza database di origine, devi abilitare i backup automatici sull'istanza database di origine. Questo è un prerequisito per tutte le operazioni di creazione di repliche. Per informazioni su come eseguire questa procedura, consulta [Abilitazione dei backup automatici](USER_WorkingWithAutomatedBackups.Enabling.md).
Per informazioni sui backup specifici delle repliche Db2, consulta [Utilizzo dei backup di repliche RDS per Db2](db2-read-replicas.backups.md).
## Attività 2: pianificare le risorse di calcolo e archiviazione
Assicurati che l'istanza database di origine e le sue repliche siano dimensionate correttamente, in termini di capacità di calcolo e storage, per adattarsi al loro carico operativo. Se una replica di lettura raggiunge la massima capacità di risorse calcolo, rete o archiviazione, smette di ricevere o applicare modifiche dalla sua origine. Per informazioni sul monitoraggio delle prestazioni delle repliche e dell’utilizzo delle risorse, consulta [Monitoraggio della replica di lettura](USER_ReadRepl.Monitoring.md).
RDS per Db2 non interviene per attenuare un elevato ritardo di replica tra un’istanza database di origine e le relative repliche. Se si verifica un ritardo di replica elevato, consulta [Monitoraggio del ritardo di replica Db2](db2-troubleshooting-replicas.md#db2-troubleshooting-replicas-lag) per una guida alla risoluzione dei problemi.
Puoi modificare le risorse di storage e CPU di una replica in modo indipendente dalla sua origine e dalle altre repliche. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
## Attività 3: preparare i database
Prima di creare una replica, verifica che i database siano pronti in base ai seguenti criteri:
+ L’istanza database contiene tutti i database che desideri includere nell’istanza. Dopo la creazione della replica, non puoi eseguire operazioni di creazione, eliminazione o ripristino nativo di un database sull’istanza database. Qualsiasi chiamata a stored procedure [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database), [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) o [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database) ha esito negativo.
+ Tutti i database nell’istanza database sono in stato attivo. Se un database è in stato inattivo, la creazione della replica ha esito negativo. Per informazioni sull’attivazione di database, consulta [Stored procedure relative ai database per RDS per Db2](db2-sp-managing-databases.md).
## Fasi successive
Dopo aver completato tutte le attività di preparazione, è possibile creare una replica Db2.
+ Per creare una replica di sola lettura, consulta [Creazione di una replica di lettura](USER_ReadRepl.Create.md).
+ Per creare una replica in standby, consulta [Creazione di una replica Db2 in standby](db2-read-replicas.creating-in-standby-mode.md).
# Creazione di una replica RDS per Db2 in modalità standby
Per impostazione predefinita, le repliche Db2 vengono create in modalità di sola lettura. È possibile creare una replica in modalità standby per scopi di disaster recovery. Le repliche in standby non accettano connessioni utente, ma forniscono funzionalità di failover più rapide per scenari multi-Regione.
Prima di creare una replica in standby, assicurati di aver completato le attività di preparazione. Per ulteriori informazioni, consulta [Preparazione alla creazione di una replica RDS per Db2](db2-read-replicas.Configuration.md). Dopo aver creato una replica in standby, puoi modificare la modalità di replica. Per ulteriori informazioni, consulta [Modifica della modalità di replica RDS per Db2](db2-replicas-changing-replica-mode.md).
È possibile creare una replica in standby utilizzando l' Console di gestione AWS API AWS CLI, the o RDS. Per ulteriori informazioni sulla creazione di una replica di sola lettura, consulta [Creazione di una replica di lettura](USER_ReadRepl.Create.md).
## Console
**Per creare una replica in standby da un’istanza database RDS per Db2 di origine**
1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Nel pannello di navigazione, seleziona **Database**.
1. Scegli l’istanza database RDS per Db2 da utilizzare come origine per la replica in standby.
1. Per **Actions (Operazioni)**, scegliere **Create replica (Crea replica)**.
1. Per **Modalità di replica**, scegli **Standby**.
1. Scegliere le impostazioni che si desiderano usare. Per **Identificatore di istanza database**, inserisci un nome per la replica in standby. Modificare le altre impostazioni nel modo necessario.
1. Per **le regioni**, scegli Regione AWS dove verrà lanciata la replica in standby.
1. Scegli la dimensione e il tipo di archiviazione dell'istanza. È consigliabile utilizzare la stessa classe di istanza database e lo stesso tipo di archiviazione dell’istanza database di origine per la replica in standby.
1. Per **Implementazione Multi-AZ**, scegli **Crea un’istanza in standby** per creare una versione in standby della replica in un’altra zona di disponibilità per il supporto del failover per la replica in standby.
1. Scegliere le altre impostazioni che si desiderano usare.
1. Scegliere **Crea replica**.
Nella pagina **Database**, la replica in standby ha il ruolo **Replica**.
## AWS CLI
[Per creare una replica Db2 in modalità standby, usa il AWS CLI comando create-db-instance-read -replica con set to.](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) `--replica-mode` `mounted`
**Example**
Per Linux, macOS o Unix:
```
aws rds create-db-instance-read-replica \
--db-instance-identifier my_standby_replica \
--source-db-instance-identifier my_db_instance \
--replica-mode mounted
```
Per Windows:
```
aws rds create-db-instance-read-replica ^
--db-instance-identifier my_standby_replica ^
--source-db-instance-identifier my_db_instance ^
--replica-mode mounted
```
## API RDS
[Per creare una replica Db2 in modalità standby, specificare nell'operazione Create dell'API RDS. `ReplicaMode=mounted` DBInstance ReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html)
# Modifica della modalità di replica RDS per Db2
È possibile modificare la modalità di replica di una replica Db2 esistente da sola lettura a standby e viceversa. Questa flessibilità consente di adattare la configurazione della replica in base ai mutevoli requisiti per i carichi di lavoro di lettura o alle necessità di disaster recovery.
Può essere opportuno modificare le modalità di replica nei seguenti scenari:
+ **Da sola lettura a standby**: quando non è più necessaria la capacità di lettura ma si desidera mantenere le funzionalità di disaster recovery
+ **Da standby a sola lettura**: quando è necessario aggiungere capacità di lettura per carichi di lavoro di reporting o analisi
Prima di modificare le modalità di replica, assicurati che le seguenti condizioni siano soddisfatte:
+ Lo stato della replica è disponibile.
+ Nessuna operazione di manutenzione attiva è in esecuzione sulla replica.
+ Disponi delle autorizzazioni necessarie per modificare l’istanza database.
L'operazione di modifica può richiedere alcuni minuti. Durante l'operazione, lo stato dell'istanza database cambia in **modifying (modifica)**. Per ulteriori informazioni sulle modifiche di stato, consulta [Visualizzazione dello stato dell'istanza database Amazon RDS ](accessing-monitoring.md#Overview.DBInstance.Status). Quando passi dalla modalità di sola lettura alla modalità standby, la replica disconnette tutte le connessioni attive.
**Importante**
Poiché con la modifica della modalità di replica il servizio viene interrotto temporaneamente, pianifica la modifica durante una finestra di manutenzione per ridurre al minimo l’impatto sulle applicazioni.
È possibile modificare la modalità di replica utilizzando Console di gestione AWS AWS CLI, the o l'API RDS.
## Console
**Per modificare la modalità di replica di una replica Db2**
1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Nel pannello di navigazione, seleziona **Database**.
1. Scegli il database di replica che vuoi modificare.
1. Scegli **Modifica**.
1. Per **Modalità di replica**, scegli la modalità desiderata:
+ **Sola lettura**: per i carichi di lavoro di lettura
+ **Standby**: per il disaster recovery
1. Scegliere le altre impostazioni che si desiderano usare.
1. Scegli **Continue (Continua)**.
1. In **Scheduling of Modifications (Pianificazione delle modifiche)**, scegliere **Apply immediately (Applica immediatamente)**.
1. Scegliere **Modify DB Instance (Modifica istanza database)**.
1. Al termine della modifica, verifica la variazione della modalità di replica nella pagina **Database**. Quando l’operazione di modifica è completata, lo stato della replica dovrebbe risultare **Disponibile**.
## AWS CLI
Per modificare una replica Db2 dalla modalità di sola lettura alla modalità standby, imposta nel comando. `--replica-mode` `mounted` AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) Per modificare la modalità da standby a sola lettura per una replica Db2, imposta `--replica-mode` su `open-read-only`.
L’esempio seguente modifica la modalità da sola lettura a standby per una replica:
**Example**
Per Linux, macOS o Unix:
```
aws rds modify-db-instance \
--db-instance-identifier my_db2_replica \
--replica-mode mounted
```
Per Windows:
```
aws rds modify-db-instance ^
--db-instance-identifier my_db2_replica ^
--replica-mode mounted
```
L’esempio seguente modifica la modalità da standby a sola lettura per una replica:
**Example**
Per Linux, macOS o Unix:
```
aws rds modify-db-instance \
--db-instance-identifier my_db2_replica \
--replica-mode open-read-only
```
Per Windows:
```
aws rds modify-db-instance ^
--db-instance-identifier my_db2_replica ^
--replica-mode open-read-only
```
## API RDS
[Per modificare una replica Db2 dalla modalità di sola lettura alla modalità standby, impostatela in Modifica. `ReplicaMode=mounted` DBInstance](AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) Per modificare la modalità da standby a sola lettura per una replica Db2, imposta `ReplicaMode=open-read-only`.
Di seguito è riportato un esempio di chiamata API per modificare la modalità di replica da sola lettura a standby:
```
{
"DBInstanceIdentifier": "my_db2_replica",
"ReplicaMode": "mounted",
"ApplyImmediately": true
}
```
Di seguito è riportato un esempio di chiamata API per modificare la modalità di replica da standby a sola lettura:
```
{
"DBInstanceIdentifier": "my_db2_replica",
"ReplicaMode": "open-read-only",
"ApplyImmediately": true
}
```
Per informazioni sulle differenze tra le modalità di replica, consulta [Utilizzo delle repliche in Amazon RDS per Db2](db2-replication.md). Per la risoluzione dei problemi relativi alle repliche, consulta [Risoluzione dei problemi relativi alle repliche RDS per Db2](db2-troubleshooting-replicas.md).
# Utilizzo dei backup di repliche RDS per Db2
È possibile creare e ripristinare i backup di una replica RDS per Db2 proprio come per un database primario. Esistono tuttavia differenze importanti nel funzionamento dei backup di repliche, soprattutto per quanto riguarda i tempi di ripristino e le impostazioni di conservazione dei backup.
In RDS per Db2 sono supportati sia i backup automatici sia gli snapshot manuali delle repliche. RDS per Db2 non supporta il point-in-time ripristino. Per ulteriori informazioni sui backup di RDS, consulta [Backup, ripristino ed esportazione dei dati](CHAP_CommonTasks.BackupRestore.md).
## Principali differenze per i backup di repliche
I backup di repliche differiscono dai backup del database primario per diversi aspetti importanti:
+ Per impostazione predefinita, i backup automatici non sono abilitati per le repliche.
+ Le operazioni di ripristino si basano sull’ora del database anziché su quella di creazione del backup.
+ Il ritardo di replica può influire sui dati effettivamente ripristinati. Per informazioni sul monitoraggio del ritardo di replica, consulta [Monitoraggio del ritardo di replica Db2](db2-troubleshooting-replicas.md#db2-troubleshooting-replicas-lag).
## Abilitazione dei backup automatici per le repliche RDS per Db2
A differenza dei database primari, le repliche RDS per Db2 non hanno i backup automatici abilitati per impostazione predefinita. Per abilitare i backup automatici, devi configurare manualmente il periodo di conservazione dei backup. Abilita i backup automatici impostando il periodo di conservazione dei backup su un valore positivo diverso da zero.
### Console
**Per abilitare immediatamente i backup automatici**
1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Nel riquadro di navigazione, scegliere **Databases (Database)** e selezionare l'istanza database da modificare.
1. Scegliere **Modify (Modifica)**.
1. In **Periodo di conservazione dei backup**, scegli un valore positivo diverso da zero, ad esempio tre giorni.
1. Scegli **Continue (Continua)**.
1. Scegliere **Apply immediately** (Applica immediatamente).
1. Scegli **Modifica istanza database** per salvare le modifiche e abilitare i backup automatici.
### AWS CLI
Per abilitare i backup automatici, usa il AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)comando.
Includere i seguenti parametri:
+ `--db-instance-identifier`
+ `--backup-retention-period`
+ `--apply-immediately` o `--no-apply-immediately`
L’esempio seguente abilita i backup automatici impostando il periodo di conservazione dei backup su tre giorni. Le modifiche vengono applicate immediatamente.
**Example**
Per Linux, macOS o Unix:
```
aws rds modify-db-instance \
--db-instance-identifier my_db_instance \
--backup-retention-period 3 \
--apply-immediately
```
Per Windows:
```
aws rds modify-db-instance ^
--db-instance-identifier my_db_instance ^
--backup-retention-period 3 ^
--apply-immediately
```
### API RDS
Per abilitare i backup automatici, utilizza l'DBInstanceoperazione RDS API [Modify](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) con i seguenti parametri richiesti:
+ `DBInstanceIdentifier`
+ `BackupRetentionPeriod`
## Ripristino di un backup di replica RDS per Db2
È possibile ripristinare un backup di replica RDS per Db2 nello stesso modo in cui si ripristina un backup del database primario. Per ulteriori informazioni, consulta [Ripristino in un’istanza database](USER_RestoreFromSnapshot.md).
La considerazione più importante da tenere presente quando si ripristinano i backup di repliche riguarda la differenza tra l’ora del database e l’ora di creazione del backup, soprattutto in caso di ritardo di replica.
È possibile monitorare il ritardo di replica e assicurarsi che i backup contengano i dati previsti. Per informazioni sulla ReplicaLag metrica, consulta. [CloudWatch Parametri Amazon per Amazon RDS](rds-metrics.md)
### Informazioni sulle differenze di orario
Durante il ripristino di un backup di replica, è importante determinare il momento in cui viene eseguito il ripristino. L'ora del database si riferisce all'ora dell'ultima transazione applicata ai dati nel backup. Quando si ripristina un backup di repliche, si esegue il ripristino corrispondente all'ora del database e non al momento in cui il backup è stato completato. La differenza è significativa perché una replica può essere in ritardo rispetto al database primario in termini di ore o minuti. Pertanto, l’ora del database di un backup di replica potrebbe essere molto precedente al momento in cui viene creato lo snapshot.
Per trovare la differenza tra l'ora del database e l'ora di creazione, esegui il AWS CLI [describe-db-snapshots](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-snapshots.html)comando o chiama l'operazione RDS API [DBSnapshotsDescrivi](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBSnapshots.html). Confronta il valore di `SnapshotDatabaseTime` rispetto a quello di `OriginalSnapshotCreateTime`. Il valore di `SnapshotDatabaseTime` corrisponde all’ora meno recente del database tra tutti i database del backup di replica. Il valore di `OriginalSnapshotCreateTime` corrisponde alla transazione più recente applicata al database primario. Tieni presente che i ritardi di replica potrebbero essere diversi per più database e che l’ora del database potrebbe essere compreso tra questi due tempi.
L' AWS CLI esempio seguente mostra la differenza tra i due orari:
Per Linux, macOS o Unix:
```
aws rds describe-db-snapshots \
--db-instance-identifier my_db2_replica \
--db-snapshot-identifier my_replica_snapshot
```
Per Windows:
```
aws rds describe-db-snapshots ^
--db-instance-identifier my_db2_replica ^
--db-snapshot-identifier my_replica_snapshot
```
Questo comando genera un output simile all’esempio seguente.
```
{
"DBSnapshots": [
{
"DBSnapshotIdentifier": "my_replica_snapshot",
"DBInstanceIdentifier": "my_db2_replica",
"SnapshotDatabaseTime": "2022-07-26T17:49:44Z",
...
"OriginalSnapshotCreateTime": "2021-07-26T19:49:44Z"
}
]
}
```
# Risoluzione dei problemi relativi alle repliche RDS per Db2
Questo argomento descrive i problemi comuni relativi alle repliche RDS per Db2 e fornisce indicazioni per la risoluzione dei problemi sia per le repliche di sola lettura sia per quelle in standby. Oltre a esaminare le seguenti informazioni sulla risoluzione dei problemi, prima di creare repliche Db2 assicurati di aver seguito [i requisiti e le considerazioni](db2-read-replicas.limitations.md) e di aver completato le [fasi di preparazione](db2-read-replicas.Configuration.md).
## Errori di creazione delle repliche
La creazione di repliche può non riuscire per diversi motivi:
+ **Database inattivi**: prima della creazione di repliche, tutti i database sull’istanza database di origine devono essere attivi.
Per informazioni sull’attivazione di database, consulta [Stored procedure relative ai database per RDS per Db2](db2-sp-managing-databases.md).
+ **Backup automatici mancanti**: l’istanza database di origine deve avere i backup automatici abilitati.
Per informazioni sull’abilitazione dei backup, consulta [Abilitazione dei backup automatici per le repliche RDS per Db2](db2-read-replicas.backups.md#db2-read-replicas.backups.turning-on).
+ **Problemi relativi ai gruppi di parametri**: per le repliche devono essere configurati gruppi di parametri personalizzati. Per le licenze BYOL, il gruppo di parametri deve includere IBM Site ID e IBM Customer ID.
Per ulteriori informazioni, consulta [IBM IDs per portare la propria licenza (BYOL) per Db2](db2-licensing.md#db2-prereqs-ibm-info).
## Monitoraggio del ritardo di replica Db2
Per monitorare il ritardo di replica in Amazon CloudWatch, visualizza la metrica Amazon `ReplicaLag` RDS. Per ulteriori informazioni sul ritardo della replica, consulta [Monitoraggio della replica di lettura](USER_ReadRepl.Monitoring.md) e [CloudWatch Parametri Amazon per Amazon RDS](rds-metrics.md). Per informazioni sulla configurazione degli CloudWatch allarmi per il ritardo di replica, consulta. [Monitoraggio dei parametri di Amazon RDS Aurora con Amazon CloudWatch](monitoring-cloudwatch.md)
Per una replica di sola lettura, se il ritardo è troppo lungo, esegui una query sulla tabella `MON_GET_HADR` per verificare lo stato dell’istanza database di replica.
Per una replica in standby, se il ritardo è troppo lungo, esegui una query sulla tabella `MON_GET_HADR` per verificare lo stato dell’istanza database di origine. Non eseguire query sull’istanza database di replica perché le istanze di questo tipo non accettano connessioni utente.
Di seguito sono elencate le cause comuni di un elevato ritardo di replica:
+ Risorse di calcolo insufficienti sulla replica
+ Problemi di connettività di rete tra l’origine e la replica
+ Intensa attività di scrittura sul database di origine
+ Limitazioni delle prestazioni di archiviazione sulla replica
Se l’elevato ritardo di replica persiste, prendi in considerazione la possibilità di dimensionamento delle risorse di replica. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
## Errori del processo di replica Db2
Il processo di replica Db2 può essere in stato di errore per diversi motivi. Esegui le seguenti azioni:
+ Monitora gli eventi e lo stato dell’istanza database per assicurarti che il processo di replica sia in corso.
Per ulteriori informazioni, consulta [Utilizzo della notifica degli eventi di Amazon RDS](USER_Events.md).
+ Controlla i log di diagnostica per la replica Db2 nella console Amazon RDS. Nei log, cerca gli errori nei messaggi HADR. Confronta il numero di sequenza di log con il numero di sequenza primario.
Per informazioni sull’accesso ai log di diagnostica Db2 e sulla relativa interpretazione, consulta [File di log del database Amazon RDS per Db2](USER_LogAccess.Concepts.Db2.md). Per informazioni sulla configurazione e sulla risoluzione dei problemi di Db2 HADR, consulta [Utilizzo delle repliche in Amazon RDS per Db2](db2-replication.md).
Se gli errori di replica persistono, potrebbe essere necessario creare nuovamente la replica.
## Problemi di connessione
Se non riesci a connetterti alla replica, consulta le seguenti informazioni sulle modalità di replica:
+ **Repliche in standby**: non accettano connessioni utente per impostazione predefinita. Utilizza le repliche di sola lettura per i carichi di lavoro di lettura.
+ **Repliche di sola lettura: controlla le** impostazioni del gruppo di sicurezza, la rete ACLs e le configurazioni dei gruppi di parametri.
Per ulteriori informazioni, consulta [Controlla il traffico verso le tue risorse AWS utilizzando gruppi di sicurezza](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) nella *Guida per l’utente di Amazon VPC* e [Controllo del traffico della sottorete con le liste di controllo degli accessi alla rete](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) nella *Guida per l’utente di Amazon VPC* e [Gruppi di parametri per Amazon RDS](USER_WorkingWithParamGroups.md).
## Problemi di prestazioni
Se le prestazioni della replica sono scadenti, consulta i seguenti suggerimenti:
+ Assicurati che la replica disponga di risorse di calcolo e archiviazione adeguate.
+ Monitora la `ReplicaLag` metrica in Amazon CloudWatch.
+ Valuta la possibilità di dimensionamento della classe dell’istanza database di replica.
Per informazioni sulla modifica delle risorse o delle classi di istanza, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
Per informazioni sul monitoraggio del ritardo di replica, consulta [Monitoraggio del ritardo di replica](USER_ReadRepl.Monitoring.md#USER_ReadRepl.Monitoring.Lag) e [CloudWatch Parametri Amazon per Amazon RDS](rds-metrics.md). Per informazioni sulla configurazione degli CloudWatch allarmi per il ritardo della replica, consulta. [Monitoraggio dei parametri di Amazon RDS Aurora con Amazon CloudWatch](monitoring-cloudwatch.md)
# Opzioni per le istanze database Amazon RDS per Db2
Di seguito sono riportate le opzioni o le funzionalità aggiuntive disponibili per le istanze Amazon RDS che eseguono il motore di database Db2. Per abilitare queste opzioni, puoi aggiungerle a un gruppo di opzioni personalizzato e quindi associare il gruppo di opzioni all'istanza database. Per ulteriori informazioni sull'utilizzo di gruppi di opzioni, consulta [Uso di gruppi di opzioni](USER_WorkingWithOptionGroups.md).
Amazon RDS supporta le seguenti opzioni per Db2:
| Opzione | ID opzione |
| --- | --- |
| [Registrazione di log di audit Db2](Db2.Options.Audit.md) | `DB2_AUDIT` |
# Registrazione di log di audit Db2
Con la funzionalità per la registrazione di log di audit Db2, Amazon RDS registrare le attività del database, inclusi gli utenti che accedono al database e le query eseguite su di esso. RDS carica i log di controllo completati nel tuo bucket Amazon S3, utilizzando il ruolo AWS Identity and Access Management (IAM) che fornisci.
**Topics**
+ [Configurazione della registrazione di log di audit Db2](#db2-audit-setting-up)
+ [Gestione della registrazione di log di audit Db2](#db2-audit-managing)
+ [Visualizzazione dei log di audit](#db2-audit-viewing-logs)
+ [Risoluzione dei problemi relativi alla registrazione di log di audit Db2](#db2-audit-troubleshooting)
## Configurazione della registrazione di log di audit Db2
Per abilitare la registrazione di log di audit per un database Amazon RDS per Db2, si abilita l’opzione `DB2_AUDIT` nell’istanza database RDS per Db2. Quindi, si configura una policy di audit in modo da abilitare la funzionalità per il database specifico. Per abilitare l’opzione `DB2_AUDIT` nell’istanza database RDS per Db2, è necessario configurarne le impostazioni. A tale scopo, fornisci ad Amazon Resource Names (ARNs) per il tuo bucket Amazon S3 e al ruolo IAM le autorizzazioni per accedere al tuo bucket.
Per configurare la registrazione di log di audit Db2 per un database RDS per Db2, completa le seguenti fasi.
**Topics**
+ [Fase 1: creazione di un bucket Amazon S3](#db2-audit-create-s3-bucket)
+ [Fase 2: creazione di una policy IAM](#db2-audit-create-iam-policy)
+ [Fase 3: creazione di un ruolo IAM e collegamento della policy IAM](#db2-audit-create-iam-role)
+ [Fase 4: configurazione di un gruppo di opzioni per la registrazione di log di audit Db2](#db2-audit-configure-options-group)
+ [Fase 5: configurazione della policy di audit](#db2-audit-configure-audit-policy)
+ [Fase 6: verifica della configurazione di audit](#db2-audit-check-config-status)
### Fase 1: creazione di un bucket Amazon S3
Se non lo hai già fatto, crea un bucket Amazon S3 in cui Amazon RDS possa caricare i file di log di audit del database RDS per Db2. Per il bucket S3 utilizzato come destinazione dei file dell’audit valgono le seguenti restrizioni:
+ Deve essere uguale Regione AWS all'istanza DB RDS for Db2.
+ Non deve essere aperto al pubblico.
+ Il proprietario del bucket deve essere anche il proprietario del ruolo IAM.
Per informazioni su come creare un bucket Amazon S3, consulta [Creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) nella *Guida per l’utente di Amazon S3*.
Una volta abilitata la registrazione di log di audit, Amazon RDS invia automaticamente i log dell’istanza database nelle seguenti posizioni:
+ Log a livello di istanza database: `bucket_name/db2-audit-logs/dbi_resource_id/date_time_utc/`
+ Log a livello di database: `bucket_name/db2-audit-logs/dbi_resource_id/date_time_utc/db_name/`
Prendi nota dell’ARN del bucket. Questa informazione è necessaria per completare le fasi successive.
### Fase 2: creazione di una policy IAM
Crea una policy IAM con le autorizzazioni necessarie per trasferire i file di log di audit dall’istanza database al bucket Amazon S3. Questa fase presuppone che sia disponibile un bucket S3.
Prima di creare la policy, raccogli le seguenti informazioni:
+ L’ARN del bucket.
+ L'ARN per la tua chiave AWS Key Management Service (AWS KMS), se il tuo bucket utilizza la crittografia. SSE-KMS
Crea una policy IAM che includa le seguenti autorizzazioni:
```
"s3:ListBucket",
"s3:GetBucketAcl",
"s3:GetBucketLocation",
"s3:PutObject",
"s3:ListMultipartUploadParts",
"s3:AbortMultipartUpload",
"s3:ListAllMyBuckets"
```
**Nota**
Amazon RDS necessita dell'`s3:ListAllMyBuckets`azione interna per verificare che lo stesso sia Account AWS proprietario sia del bucket S3 che dell'istanza DB RDS for Db2.
Se il tuo bucket utilizza la SSE-KMS crittografia, includi anche le seguenti autorizzazioni per il ruolo e la chiave IAM. AWS KMS
Per la policy del ruolo IAM aggiungi le seguenti autorizzazioni.
```
"kms:GenerateDataKey",
"kms:Decrypt"
```
Includi le seguenti autorizzazioni nella policy chiave per la tua chiave. AWS KMS *111122223333*Sostituiscila con il tuo numero di account e *AROA123456789EXAMPLE* con il nome del tuo ruolo IAM.
```
{
"Sid": "Allow RDS role to use the key",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:sts::111122223333:assumed-role/AROA123456789EXAMPLE/RDS-Db2Audit",
"arn:aws:iam::111122223333:role/AROA123456789EXAMPLE"
]
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
```
Puoi creare una policy IAM utilizzando Console di gestione AWS o il AWS Command Line Interface (AWS CLI).
#### Console
**Per creare una policy IAM per consentire ad Amazon RDS l'accesso a un bucket Amazon S3**
1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel riquadro di navigazione, scegli **Policy**.
1. Scegli **Crea policy**, quindi **JSON**.
1. In **Aggiungi azioni**, filtra in base a **S3**. Aggiungi accesso **ListBucket**GetBucketAcl****e **GetBucketLocation**.
1. Per **Aggiungi una risorsa**, scegli **Aggiungi**. Per **Tipo di risorsa**, scegli **bucket** e inserisci il nome del bucket. Quindi, scegli **Aggiungi risorsa**.
1. Scegli **Aggiungi nuova istruzione**.
1. In **Aggiungi azioni**, filtra in base a **S3**. Aggiungi accesso **PutObject**ListMultipartUploadParts****, e **AbortMultipartUpload**.
1. Per **Aggiungi una risorsa**, scegli **Aggiungi**. Per **Tipo di risorsa**, scegliete **oggetto** e immettete*your bucket name/\$1*. Quindi, scegli **Aggiungi risorsa**.
1. Scegli **Aggiungi nuova istruzione**.
1. In **Aggiungi azioni**, filtra in base a **S3**. Aggiungi accesso **ListAllMyBuckets**.
1. Per **Aggiungi una risorsa**, scegli **Aggiungi**. Per **Tipo di risorsa**, scegli **Tutte le risorse**. Quindi, scegli **Aggiungi risorsa**.
1. Se utilizzi le chiavi KMS personali per crittografare i dati:
1. Scegli **Aggiungi nuova istruzione**.
1. In **Aggiungi azioni**, filtra in base a KMS. Aggiungi accesso **GenerateDataKey**e **decrittografa**.
1. Per **Aggiungi una risorsa**, scegli **Aggiungi**. Per **Tipo di risorsa**, scegli **Tutte le risorse**. Quindi, scegli **Aggiungi risorsa**.
1. Scegli **Next (Successivo)**.
1. In **Nome policy**, inserisci un nome per la policy.
1. (Facoltativo) In **Descrizione**, inserisci una descrizione per la policy.
1. Scegli **Crea policy**.
#### AWS CLI
**Per creare una policy IAM per consentire ad Amazon RDS l'accesso a un bucket Amazon S3**
1. Esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html). Nell'esempio seguente, sostituisci *iam\$1policy\$1name* e *amzn-s3-demo-bucket* con un nome per la tua policy IAM e il nome del bucket Amazon S3 di destinazione.
Per Linux, macOS o Unix:
```
aws iam create-policy \
--policy-name iam_policy_name \
--policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket"
]
},
{
"Sid": "Statement2",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:ListMultipartUploadParts",
"s3:AbortMultipartUpload"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
},
{
"Sid": "Statement3",
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": [
"*"
]
},
{
"Sid": "Statement4",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": [
"*"
]
}
]
}'
```
Per Windows:
```
aws iam create-policy ^
--policy-name iam_policy_name ^
--policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket"
]
},
{
"Sid": "Statement2",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:ListMultipartUploadParts",
"s3:AbortMultipartUpload"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
},
{
"Sid": "Statement3",
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": [
"*"
]
},
{
"Sid": "Statement4",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": [
"*"
]
}
]
}'
```
1. Una volta creata la policy, prendi nota del relativo ARN. L’ARN servirà per [Fase 3: creazione di un ruolo IAM e collegamento della policy IAM](#db2-audit-create-iam-role).
Per informazioni sulla creazione di una policy IAM, consulta [Creazione di policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) nella Guida per l’utente di IAM.
### Fase 3: creazione di un ruolo IAM e collegamento della policy IAM
Questa fase presuppone che tu abbia creato la policy IAM in [Fase 2: creazione di una policy IAM](#db2-audit-create-iam-policy). In questa fase, si crea un ruolo IAM per l’istanza database RDS per Db2 e quindi si collega la policy IAM al ruolo.
Puoi creare un ruolo IAM per l’istanza database utilizzando la console o la AWS CLI.
#### Console
**Per creare un ruolo IAM e collegare la policy IAM al ruolo**
1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Nel pannello di navigazione, seleziona **Roles** (Ruoli).
1. Selezionare **Create role (Crea ruolo)**.
1. Per **Tipo di entità attendibile**, seleziona **Servizio AWS**.
1. Per **Servizio o caso d’uso**, seleziona **RDS**, quindi **RDS – Aggiungi ruolo al database**.
1. Scegli **Next (Successivo)**.
1. In **Policy di autorizzazione**, cerca e seleziona il nome della policy IAM che hai creato.
1. Scegli **Next (Successivo)**.
1. In **Role name**, (Nome ruolo), inserisci un nome.
1. (Facoltativo) In **Descrizione**, inserisci una descrizione per il nuovo ruolo.
1. Scegli **Crea ruolo**.
#### AWS CLI
**Per creare un ruolo IAM e collegare la policy IAM al ruolo**
1. Esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html). Nell'esempio seguente, sostituiscilo *iam\$1role\$1name* con un nome per il tuo ruolo IAM.
Per Linux, macOS o Unix:
```
aws iam create-role \
--role-name iam_role_name \
--assume-role-policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
Per Windows:
```
aws iam create-role ^
--role-name iam_role_name ^
--assume-role-policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
1. Una volta creato il ruolo, prendi nota del relativo ARN. Questa informazione è necessaria per la fase successiva, [Fase 4: configurazione di un gruppo di opzioni per la registrazione di log di audit Db2](#db2-audit-configure-options-group).
1. Esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html). Nell'esempio seguente, sostituisci *iam\$1policy\$1arn* con l'ARN della policy IAM in cui hai creato. [Fase 2: creazione di una policy IAM](#db2-audit-create-iam-policy) Sostituiscilo *iam\$1role\$1name* con il nome del ruolo IAM che hai appena creato.
Per Linux, macOS o Unix:
```
aws iam attach-role-policy \
--policy-arn iam_policy_arn \
--role-name iam_role_name
```
Per Windows:
```
aws iam attach-role-policy ^
--policy-arn iam_policy_arn ^
--role-name iam_role_name
```
Per ulteriori informazioni, consulta la pagina relativa alla [creazione di un ruolo per delegare le autorizzazioni a un utente IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html) nella *Guida per l'utente IAM*.
### Fase 4: configurazione di un gruppo di opzioni per la registrazione di log di audit Db2
La procedura per aggiungere le opzioni relative alla registrazione di log di audit Db2 a un’istanza database RDS per Db2 è la seguente:
1. Creare un nuovo gruppo di opzioni oppure copiare o modificare un gruppo di opzioni esistente.
1. Aggiungere e configurare tutte le opzioni necessarie.
1. Associare il gruppo di opzioni a questa istanza database.
Una volta aggiunte le opzioni per la registrazione di log di audit Db2, non è necessario riavviare l’istanza database. Non appena il gruppo di opzioni diventa attivo, è possibile creare audit e archiviarne i log nel bucket S3.
**Per aggiungere e configurare la registrazione di log di audit Db2 in un gruppo di opzioni di un’istanza database**
1. Seleziona una delle seguenti opzioni:
+ Utilizzare un gruppo di opzioni esistente.
+ Creare un gruppo di opzioni database personalizzato e utilizzarlo. Per ulteriori informazioni, consulta [Creazione di un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create).
1. Aggiungi l'opzione **DB2\$1AUDIT** al gruppo di opzioni e configura le impostazioni delle opzioni. Per ulteriori informazioni sull'aggiunta di opzioni, consulta [Aggiunta di un'opzione a un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).
+ Per **IAM\$1ROLE\$1ARN**, inserisci l’ARN del ruolo IAM creato in [Fase 3: creazione di un ruolo IAM e collegamento della policy IAM](#db2-audit-create-iam-role).
+ Per **S3\$1BUCKET\$1ARN**, inserisci l’ARN del bucket S3 da utilizzare per i log di audit Db2. Il bucket deve trovarsi nella stessa Regione dell’istanza database RDS per Db2. La policy associata al ruolo IAM che hai inserito deve consentire le operazioni necessarie su questa risorsa.
1. Applicare il gruppo di opzioni a un’istanza database nuova o esistente. Scegliere una delle seguenti opzioni:
+ Se si sta creando una nuova istanza database, applicare il gruppo di opzioni quando viene avviata l'istanza.
+ In un’istanza database esistente, applicare il gruppo di opzioni modificando l’istanza e poi collegando il nuovo gruppo di opzioni. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
### Fase 5: configurazione della policy di audit
Per configurare la policy di audit per il database RDS per Db2, connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Quindi, chiama la stored procedure `rdsadmin.configure_db_audit` con il nome del database e i valori dei parametri applicabili.
L’esempio seguente si connette al database e configura una policy di audit per `testdb` con le categorie AUDIT, CHECKING, OBJMAINT, SECMAINT, SYSADMIN e VALIDATE. Il valore di stato `BOTH` registra gli esiti positivi e negativi e `ERROR TYPE` ha come valore predefinito `NORMAL`. Per ulteriori informazioni su come utilizzare questa stored procedure, consulta [rdsadmin.configure\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-configure-db-audit).
```
db2 "connect to rdsadmin user master_user using master_password"
db2 "call rdsadmin.configure_db_audit('testdb', 'ALL', 'BOTH', ?)"
```
### Fase 6: verifica della configurazione di audit
Per assicurarti che la policy di audit sia configurata correttamente, verifica lo stato della configurazione di audit.
A tale scopo, connettiti al database `rdsadmin` utilizzando il nome utente e la password principali dell’istanza database RDS per Db2. Quindi, esegui l’istruzione SQL seguente con il nome del database. Nell'esempio seguente, il nome del DB è*testdb*.
```
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
from table(rdsadmin.get_task_status(null,'testdb','CONFIGURE_DB_AUDIT'))"
Sample Output
TASK_ID TASK_TYPE DATABASE_NAME LIFECYCLE
-------------------- -------------------- --------------- -------------
2 CONFIGURE_DB_AUDIT DB2DB SUCCESS
... continued ...
TASK_PARAMS
--------------------------------------------------------
{ "AUDIT_CATEGORY" : "ALL", "CATEGORY_SETTING" : "BOTH" }
... continued ...
TASK_OUTPUT
---------------------------------------------------
2023-12-22T20:27:03.029Z Task execution has started.
2023-12-22T20:27:04.285Z Task execution has completed successfully.
```
## Gestione della registrazione di log di audit Db2
Dopo aver configurato la registrazione di log di audit Db2, è possibile modificare la policy di audit per un database specifico oppure disabilitare la registrazione di log di audit a livello di database o per l’intera istanza database. È inoltre possibile cambiare il bucket Amazon S3 in cui vengono caricati i file di log.
**Topics**
+ [Modifica di una policy di audit Db2](#db2-audit-modifying-policy)
+ [Modifica della posizione dei file di log](#db2-audit-modifying-location)
+ [Disabilitazione della registrazione di log di audit Db2](#db2-audit-disabling)
### Modifica di una policy di audit Db2
Per modificare la policy di audit relativa a un determinato database RDS per Db2, è possibile eseguire la stored procedure `rdsadmin.configure_db_audit`. Con questa stored procedure, si possono modificare le categorie, le relative impostazioni e la configurazione del tipo di errore della policy di audit. Per ulteriori informazioni, consulta [rdsadmin.configure\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-configure-db-audit).
### Modifica della posizione dei file di log
Per cambiare il bucket Amazon S3 in cui vengono caricati i file di log, è possibile procedere in uno dei seguenti modi:
+ Modificare il gruppo di opzioni corrente collegato all’istanza database RDS per Db2 – Aggiornare l’impostazione `S3_BUCKET_ARN` dell’opzione `DB2_AUDIT` in modo che punti al nuovo bucket. Assicurarsi inoltre di aggiornare la policy IAM collegata al ruolo IAM specificato dall’impostazione `IAM_ROLE_ARN` nel gruppo di opzioni collegato. La policy IAM deve fornire al nuovo bucket le autorizzazioni di accesso necessarie. Per informazioni sulle autorizzazioni necessarie nella policy IAM, consulta [Creazione di una policy IAM](#db2-audit-create-iam-policy).
+ Collegare l’istanza database RDS per Db2 a un gruppo di opzioni diverso – Modificare l’istanza database per cambiare il gruppo di opzioni collegato. Assicurarsi che il nuovo gruppo di opzioni sia configurato con le impostazioni `S3_BUCKET_ARN` e `IAM_ROLE_ARN` corrette. Per informazioni su come configurare queste impostazioni per l’opzione `DB2_AUDIT`, consulta [Configurazione di un gruppo di opzioni](#db2-audit-configure-options-group).
Quando si modifica il gruppo di opzioni, assicurarsi di applicare immediatamente le modifiche. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
### Disabilitazione della registrazione di log di audit Db2
Per disabilitare la registrazione di log di audit Db2, è possibile procedere in uno dei seguenti modi:
+ Disabilitare la registrazione di log di audit per l’istanza database RDS per Db2 – Modificare l’istanza database e rimuovere il gruppo di opzioni in cui è inclusa l’opzione `DB2_AUDIT`. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
+ Disabilitare la registrazione di log di audit per un database specifico – Interrompere la registrazione di log di audit e rimuovere la policy di audit chiamando `rdsadmin.disable_db_audit` con il nome del database. Per ulteriori informazioni, consulta [rdsadmin.disable\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-disable-db-audit).
```
db2 "call rdsadmin.disable_db_audit(
'db_name',
?)"
```
## Visualizzazione dei log di audit
Una volta abilitata la registrazione di log di audit Db2, è necessario attendere almeno un’ora prima che i dati di audit siano visibili nel bucket Amazon S3. Amazon RDS invia automaticamente i log dell’istanza database RDS per Db2 nelle seguenti posizioni:
+ Log a livello di istanza database: `bucket_name/db2-audit-logs/dbi_resource_id/date_time_utc/`
+ Log a livello di database: `bucket_name/db2-audit-logs/dbi_resource_id/date_time_utc/db_name/`
La seguente schermata di esempio della console Amazon S3 mostra un elenco di cartelle per i file di log a livello di istanza database RDS per Db2.
![\[Console Amazon S3 con la scheda Oggetti selezionata, che mostra un elenco di cartelle per i file di log a livello di istanza database RDS per Db2.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/db2-instance-level-audit-logs.png)
La seguente schermata di esempio della console Amazon S3 mostra i file di log a livello di database per l’istanza database RDS per Db2.
![\[Console Amazon S3 con la scheda Oggetti selezionata, che mostra i file di log a livello di database per l’istanza database RDS per Db2.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/db2-database-level-audit-logs.png)
## Risoluzione dei problemi relativi alla registrazione di log di audit Db2
Le informazioni riportate di seguito consentono di risolvere i problemi più comuni relativi alla registrazione di log di audit Db2.
### Impossibile configurare la policy di audit
Se la chiamata alla stored procedure `rdsadmin.configure_db_audit` restituisce un errore, è possibile che il gruppo di opzioni con `DB2_AUDIT` non sia associato all’istanza database RDS per Db2. Modifica l’istanza database in modo da aggiungere il gruppo di opzioni, quindi prova a chiamare nuovamente la stored procedure. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md).
### Nessun dato nel bucket Amazon S3
Se nel bucket Amazon S3 non sono presenti dati relativi alla registrazione di log, controlla quanto segue:
+ Il bucket Amazon S3 deve trovarsi nella stessa Regione dell’istanza database RDS per Db2.
+ Il ruolo specificato nell’impostazione dell’opzione `IAM_ROLE_ARN` deve essere configurato con le autorizzazioni necessarie per caricare i log nel bucket Amazon S3. Per ulteriori informazioni, consulta [Creazione di una policy IAM](#db2-audit-create-iam-policy).
+ Le impostazioni ARNs for the `IAM_ROLE_ARN` and `S3_BUCKET_ARN` option sono corrette nel gruppo di opzioni associato all'istanza DB RDS for Db2. Per ulteriori informazioni, consulta [Configurazione di un gruppo di opzioni](#db2-audit-configure-options-group).
È possibile controllare lo stato di attività della configurazione della registrazione di log di audit collegandosi al database ed eseguendo un’istruzione SQL. Per ulteriori informazioni, consulta [Verifica della configurazione di audit](#db2-audit-check-config-status).
È inoltre possibile controllare gli eventi per scoprire le cause dell’eventuale assenza di log. Per informazioni su come visualizzare gli eventi, consulta [Visualizzazione di registri, eventi e flussi nella console Amazon RDS](logs-events-streams-console.md).
# Stored procedure esterne per Amazon RDS per Db2
Puoi creare routine esterne e registrarle nei tuoi database Amazon RDS per Db2 come stored procedure esterne. Attualmente, RDS per Db2 supporta solo routine basate su Java per le stored procedure esterne.
## Stored procedure esterne basate su Java
Le stored procedure esterne basate su Java sono routine Java esterne registrate nel database RDS per Db2 come stored procedure esterne.
**Topics**
+ [Limitazioni per le stored procedure esterne basate su Java](#db2-external-stored-procedures-java-limitations)
+ [Configurazione di stored procedure esterne basate su Java](#db2-external-stored-procedures-java-configuring)
### Limitazioni per le stored procedure esterne basate su Java
Prima di sviluppare una routine esterna, considera le seguenti limitazioni e restrizioni.
Per creare una routine esterna, assicurati di utilizzare il Java Development Kit (JDK) fornito da Db2. Per ulteriori informazioni, consulta [Java software support for Db2 database products](https://www.ibm.com/docs/en/db2/11.5?topic=servers-java-software-support-db2-database-products).
Il tuo programma Java può creare file solo nella directory `/tmp` e Amazon RDS non supporta l’abilitazione delle autorizzazioni di esecuzione o Set User ID (SUID) su questi file. Inoltre, il tuo programma Java non può utilizzare le chiamate di sistema socket o le seguenti chiamate di sistema:
+ \$1sysctl
+ acct
+ afs\$1syscall
+ bpf
+ capset
+ chown
+ chroot
+ create\$1module
+ delete\$1module
+ fanotify\$1init
+ fanotify\$1mark
+ finit\$1module
+ fsconfig
+ fsopen
+ fspick
+ get\$1kernel\$1syms
+ getpmsg
+ init\$1module
+ mount
+ move\$1mount
+ nfsservctl
+ open\$1by\$1handle\$1at
+ open\$1tree
+ pivot\$1root
+ putpmsg
+ query\$1module
+ quotactl
+ reboot
+ security
+ setdomainname
+ setfsuid
+ sethostname
+ sysfs
+ tuxcall
+ umount2
+ uselib
+ ustat
+ vhangup
+ vserver
Per ulteriori restrizioni sulle routine esterne per Db2, consulta [Restrictions on external routines](https://www.ibm.com/docs/en/db2/11.5?topic=routines-restrictions-external) nella documentazione di IBM Db2.
### Configurazione di stored procedure esterne basate su Java
Per configurare una stored procedure esterna, crea un file .jar con la routine esterna, installalo nel database RDS per Db2, quindi registralo come stored procedure esterna.
**Topics**
+ [Fase 1: abilitare le stored procedure esterne](#db2-external-stored-procedures-java-enable)
+ [Fase 2: installare il file .jar con la routine esterna](#db2-external-stored-procedures-java-install-jar)
+ [Fase 3: registrare la stored procedure esterna](#db2-external-stored-procedures-java-register)
+ [Fase 4: convalidare la stored procedure esterna](#db2-external-stored-procedures-java-validate)
#### Fase 1: abilitare le stored procedure esterne
Per abilitare le stored procedure esterne, in un gruppo di parametri associato all’istanza database, imposta il parametro `db2_alternate_authz_behaviour` su uno dei seguenti valori:
+ `EXTERNAL_ROUTINE_DBADM`: concede implicitamente l’autorizzazione `CREATE_EXTERNAL_ROUTINE` a qualsiasi utente, gruppo o ruolo con l’autorità `DBADM`.
+ `EXTERNAL_ROUTINE_DBAUTH`: consente a un utente con l’autorità `DBADM` di concedere l’autorizzazione `CREATE_EXTERNAL_ROUTINE` a qualsiasi utente, gruppo o ruolo. In questo caso, a nessun utente, gruppo o ruolo viene implicitamente concessa questa autorizzazione, nemmeno a un utente con l’autorità`DBADM`.
Per ulteriori informazioni su questa impostazione, consulta [GRANT (database authorities) statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-grant-database-authorities) nella documentazione di IBM Db2.
Puoi creare e modificare un’istanza database utilizzando la Console di gestione AWS, la AWS CLI o l’API Amazon RDS.
##### Console
**Per configurare il parametro db2\$1alternate\$1authz\$1behaviour in un gruppo di parametri personalizzato**
1. Se desideri utilizzare un gruppo di parametri di database personalizzato diverso da quello utilizzato dall’istanza database, crea un nuovo gruppo di parametri di database. Se utilizzi il modello BYOL (bring your own license), assicurati che il nuovo gruppo di parametri personalizzati includa il. IBM IDs Per informazioni su questi IDs, consulta. [IBM IDs per portare la propria licenza (BYOL) per Db2](db2-licensing.md#db2-prereqs-ibm-info) Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Imposta il valore per il parametro `db2_alternate_authz_behaviour` nel tuo gruppo di parametri personalizzato. Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
##### AWS CLI
**Per configurare il parametro db2\$1alternate\$1authz\$1behaviour in un gruppo di parametri personalizzato**
1. Se desideri utilizzare un gruppo di parametri di database personalizzato diverso da quello utilizzato dall’istanza database, crea un gruppo di parametri di database eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html). Se utilizzi il modello Bring your own license (BYOL), assicurati che il nuovo gruppo di parametri personalizzati includa il. IBM IDs Per informazioni su questi IDs, consulta. [IBM IDs per portare la propria licenza (BYOL) per Db2](db2-licensing.md#db2-prereqs-ibm-info)
Includi le seguenti opzioni obbligatorie:
+ `--db-parameter-group-name`: un nome per il gruppo di parametri che stai creando.
+ `--db-parameter-group-family`: l’edizione e la versione principale del motore Db2. I valori validi sono `db2-se-11.5` e `db2-ae-11.5`.
+ `--description`: una descrizione di questo gruppo di parametri.
Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
L’esempio seguente mostra come creare un gruppo di parametri personalizzato denominato `MY_EXT_SP_PARAM_GROUP` per la famiglia di gruppi di parametri`db2-se-11.5`.
Per Linux, macOS o Unix:
```
aws rds create-db-parameter-group \
--region us-east-1 \
--db-parameter-group-name MY_EXT_SP_PARAM_GROUP \
--db-parameter-group-family db2-se-11.5 \
--description "test db2 external routines"
```
Per Windows:
```
aws rds create-db-parameter-group ^
--region us-east-1 ^
--db-parameter-group-name MY_EXT_SP_PARAM_GROUP ^
--db-parameter-group-family db2-se-11.5 ^
--description "test db2 external routines"
```
1. Modifica il parametro `db2_alternate_authz_behaviour` nel gruppo di parametri personalizzato eseguendo il comando [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html).
Includi le seguenti opzioni obbligatorie:
+ `--db-parameter-group-name`: il nome del gruppo di parametri creato.
+ `--parameters`: un array di nomi di parametri, valori e metodi di applicazione per l’aggiornamento del parametro.
Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
L’esempio seguente mostra come modificare il gruppo di parametri `MY_EXT_SP_PARAM_GROUP` impostando il valore di `db2_alternate_authz_behaviour` su `EXTERNAL_ROUTINE_DBADM`.
Per Linux, macOS o Unix:
```
aws rds modify-db-parameter-group \
--db-parameter-group-name MY_EXT_SP_PARAM_GROUP \
--parameters "ParameterName='db2_alternate_authz_behaviour',ParameterValue='EXTERNAL_ROUTINE_DBADM',ApplyMethod=immediate"
```
Per Windows:
```
aws rds modify-db-parameter-group ^
--db-parameter-group-name MY_EXT_SP_PARAM_GROUP ^
--parameters "ParameterName='db2_alternate_authz_behaviour',ParameterValue='EXTERNAL_ROUTINE_DBADM',ApplyMethod=immediate"
```
##### API RDS
**Per configurare il parametro db2\$1alternate\$1authz\$1behaviour in un gruppo di parametri personalizzato**
1. Se desideri utilizzare un gruppo di parametri di database personalizzato diverso da quello utilizzato dall’istanza database, crea un nuovo gruppo di parametri di database utilizzando l’operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) dell’API Amazon RDS. Se utilizzi il modello Bring your own license (BYOL), assicurati che il nuovo gruppo di parametri personalizzati includa il. IBM Db2 IDs Per informazioni su questi IDs, consulta. [IBM IDs per portare la propria licenza (BYOL) per Db2](db2-licensing.md#db2-prereqs-ibm-info)
Includi i parametri obbligatori seguenti:
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
Per ulteriori informazioni sulla creazione di un gruppo di parametri database, consulta [Creazione di un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Modifica il parametro `db2_alternate_authz_behaviour` nel gruppo di parametri personalizzato che hai creato utilizzando l’operazione [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) dell’API RDS.
Includi i parametri obbligatori seguenti:
+ `DBParameterGroupName`
+ `Parameters`
Per ulteriori informazioni sulla modifica di un gruppo di parametri, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
#### Fase 2: installare il file .jar con la routine esterna
Dopo aver creato la routine Java, crea il file .jar ed esegui `db2 "call sqlj.install_jar('file:file_path',jar_ID)"` per installarlo nel database RDS per Db2.
L’esempio seguente mostra come creare una routine Java e installarla su un database RDS per Db2. L’esempio include un codice di esempio per una semplice routine da utilizzare per testare il processo. In questo esempio si presume quanto segue:
+ Il codice Java viene compilato su un server in cui è installato Db2. Si tratta di una best practice perché la mancata compilazione con il JDK fornito da IBM può causare errori imprevisti.
+ Il database RDS per Db2 è catalogato localmente sul server.
Se desideri provare il processo con il seguente codice di esempio, copialo e salvalo in un file denominato `MYJAVASP.java`.
```
import java.sql.*;
public class MYJAVASP
{
public static void my_JAVASP (String inparam) throws SQLException, Exception
{
try
{
// Obtain the calling context's connection details.
Connection myConn = DriverManager.getConnection("jdbc:default:connection");
String myQuery = "INSERT INTO TEST.TEST_TABLE VALUES (?, CURRENT DATE)";
PreparedStatement myStmt = myConn.prepareStatement(myQuery);
myStmt.setString(1, inparam);
myStmt.executeUpdate();
}
catch (SQLException sql_ex)
{
throw sql_ex;
}
catch (Exception ex)
{
throw ex;
}
}
```
Il comando seguente compila la routine Java.
```
~/sqllib/java/jdk64/bin/javac MYJAVASP.java
```
Il comando seguente crea il file .jar.
```
~/sqllib/java/jdk64/bin/jar cvf MYJAVASP.jar MYJAVASP.class
```
I comandi seguenti effettuano la connessione al database denominato `MY_DB2_DATABASE` e installano il file .jar.
```
db2 "connect to MY_DB2_DATABASE user master_username using master_password"
db2 "call sqlj.install_jar('file:/tmp/MYJAVASP.jar','MYJAVASP')"
db2 "call sqlj.refresh_classes()"
```
#### Fase 3: registrare la stored procedure esterna
Dopo aver installato il file .jar nel database RDS per Db2, registralo come stored procedure eseguendo il comando `db2 CREATE PROCEDURE` o `db2 REPLACE PROCEDURE`.
L’esempio seguente mostra come connettersi al database e registrare la routine Java creata nel passaggio precedente come stored procedure.
```
db2 "connect to MY_DB2_DATABASE user master_username using master_password"
create procedure TESTSP.MYJAVASP (in input char(6))
specific myjavasp
dynamic result sets 0
deterministic
language java
parameter style java
no dbinfo
fenced
threadsafe
modifies sql data
program type sub
external name 'MYJAVASP!my_JAVASP';
```
#### Fase 4: convalidare la stored procedure esterna
Utilizza la procedura seguente per testare la stored procedure esterna di esempio che è stata registrata nel passaggio precedente.
**Per convalidare la stored procedure esterna**
1. Crea una tabella come `TEST.TEST_TABLE` nell’esempio seguente.
```
db2 "create table TEST.TEST_TABLE(C1 char(6), C2 date)"
```
1. Chiama la nuova stored procedure esterna. La chiamata restituisce lo stato `0`.
```
db2 "call TESTSP.MYJAVASP('test')"
Return Status = 0
```
1. Esegui una query sulla tabella creata nel passaggio 1 per verificare i risultati della chiamata alla stored procedure.
```
db2 "SELECT * from TEST.TEST_TABLE"
```
La query produce un output simile all’esempio seguente:
```
C1 C2
------ ----------
test 02/05/2024
```
# Problemi noti e limitazioni per Amazon RDS per Db2
Di seguito sono indicati i problemi e le limitazioni per l’utilizzo di Amazon RDS per Db2:
**Topics**
+ [Limitazione dell’autenticazione](#db2-known-issues-limitations-authentication-limit)
+ [Routine non recintate](#db2-known-issues-limitations-non-fenced-routines)
+ [Tablespace di archiviazione non automatici durante la migrazione](#db2-known-issues-limitations-non-automatic-storage-tablespaces)
+ [Impostazione del parametro db2\$1compatibility\$1vector](#db2-known-issues-limitations-db2-compatibility-vector)
+ [Migrazione di database che contengono pacchetti INVALID](#db2-known-issues-limitations-invalid-packages-migrating)
## Limitazione dell’autenticazione
Amazon RDS imposta `db2auth` su `JCC_ENFORCE_SECMEC` per impostazione predefinita. Tuttavia, se non vuoi applicare la crittografia di ID utente e password, puoi sostituire questa impostazione impostando il parametro `db2auth` su `CLEAR_TEXT` nel gruppo di parametri. Per ulteriori informazioni, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
## Routine non recintate
RDS per Db2 non supporta la creazione di routine non recintate e la migrazione di tali routine mediante il backup e il ripristino dei dati. Per verificare se il database contiene routine non recintate, esegui il seguente comando SQL:
```
SELECT 'COUNT:' || count(*) FROM SYSCAT.ROUTINES where fenced='N' and routineschema not in ('SQLJ','SYSCAT','SYSFUN','SYSIBM','SYSIBMADM','SYSPROC','SYSTOOLS')
```
## Tablespace di archiviazione non automatici durante la migrazione
RDS per Db2 non supporta la creazione di nuovi tablespace di archiviazione non automatici. Quando si utilizza il ripristino nativo per una migrazione una tantum del database, RDS per Db2 converte automaticamente i tablespace di archiviazione non automatici in tablespace di archiviazione automatici, quindi ripristina il database su RDS per Db2. Per informazioni sulle migrazioni una tantum, consulta [Migrazione da Linux a Linux per Amazon RDS per Db2](db2-one-time-migration-linux.md) e [Migrazione da AIX o Windows a Linux per Amazon RDS per Db2](db2-one-time-migration-aix-windows-linux.md).
## Impostazione del parametro db2\$1compatibility\$1vector
Con Amazon RDS, puoi creare un database iniziale quando crei l’istanza database e quindi modificare i parametri in un gruppo di parametri associato. Tuttavia, per Db2, se desideri impostare il parametro `db2_compatibility_vector` in un gruppo di parametri, devi prima modificare il parametro in un gruppo di parametri personalizzato, creare l’istanza database senza un database e quindi creare un database utilizzando la stored procedure `rdsadmin.create_database`.
**Per impostare il parametro `db2_compatibility_vector`**
1. [Crea un gruppo parametri personalizzato](USER_WorkingWithParamGroups.Creating.md). Non è possibile modificare parametri nei gruppi di parametri predefiniti.
1. [Modifica il parametro](USER_WorkingWithParamGroups.Modifying.md).
1. [Crea un’istanza database](USER_CreateDBInstance.md).
1. [Crea un database](db2-managing-databases.md#db2-creating-database) utilizzando la stored procedure `rdsadmin.create_database`.
1. [Associa il nuovo gruppo di parametri](USER_WorkingWithParamGroups.Associating.md) all’istanza database che contiene il database.
## Migrazione di database che contengono pacchetti INVALID
Se si esegue la migrazione di database Db2 che contengono pacchetti `INVALID` a RDS per Db2 utilizzando il comando `RESTORE`, è possibile che si verifichino problemi quando si inizia a utilizzare i database. I pacchetti `INVALID` possono causare problemi dovuti alla configurazione dell’autorizzazione per l’utente dell’istanza database `rdsdb` e alla rimozione dell’autorizzazione da `PUBLIC`. I pacchetti `INVALID` causano l’esito negativo dei seguenti comandi:
+ `db2updv115`
+ `db2 "call SYSPROC.ADMIN_REVALIDATE_DB_OBJECTS()"`
Prima di eseguire la migrazione del database con il comando `RESTORE`, assicurati che il database non contenga pacchetti `INVALID` eseguendo il comando seguente:
```
db2 "SELECT 'COUNT:' || count(*) FROM SYSCAT.INVALIDOBJECTS"
```
Se il comando restituisce un conteggio maggiore di zero, chiama il comando seguente:
```
db2 "call SYSPROC.ADMIN_REVALIDATE_DB_OBJECTS()"
```
Successivamente, chiama il comando precedente per verificare che il database non contenga più pacchetti `INVALID`.
```
db2 "SELECT 'COUNT:' || count(*) FROM SYSCAT.INVALIDOBJECTS"
```
A questo punto puoi eseguire il backup del tuo database e ripristinarlo nell’istanza database RDS per Db2.
# Informazioni di riferimento sulle stored procedure di Amazon RDS per Db2
È possibile gestire le istanze database Amazon RDS per Db2 che eseguono il motore Db2 chiamando le stored procedure integrate.
| Stored procedure | Categoria | Description |
| --- | --- | --- |
| [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database) | Database | La stored procedure `rdsadmin.activate_database` consente di attivare un database su un’istanza database RDS per Db2 autonoma. |
| [rdsadmin.add\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-add-groups) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.add_groups` consente di aggiungere uno o più gruppi a un utente per un database su un’istanza database RDS per Db2. |
| [rdsadmin.add\$1user](db2-sp-granting-revoking-privileges.md#db2-sp-add-user) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.add_user` consente di aggiungere un utente a un elenco di autorizzazioni per un database su un’istanza database RDS per Db2. |
| [rdsadmin.alter\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-alter-buffer-pool) | Pool di buffer | La stored procedure `rdsadmin.alter_bufferpool` consente di modificare un pool di buffer per un database su un’istanza database RDS per Db2. |
| [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace) | Tablespace | La stored procedure `rdsadmin.alter_tablespace` consente di modificare un tablespace per un database su un’istanza database RDS per Db2. |
| [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database) | Database | Utilizza la `rdsadmin.backup_database` stored procedure per eseguire il backup di un database su un'istanza DB RDS for Db2 su un bucket Amazon S3. Quindi puoi ripristinare il backup da Amazon S3 su un'istanza DB RDS for Db2 o in un'altra posizione, ad esempio un server locale. |
| [rdsadmin.catalog\$1storage\$1access](db2-sp-managing-storage-access.md#db2-sp-catalog-storage-access) | Accesso all’archiviazione | La stored procedure `rdsadmin.catalog_storage_access` consente di catalogare un alias di archiviazione per l’accesso a un bucket Amazon S3 con file di dati Db2 per un database su un’istanza database RDS per Db2. |
| [rdsadmin.change\$1password](db2-sp-granting-revoking-privileges.md#db2-sp-change-password) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.change_password` consente di modificare la password di un utente per un database su un’istanza database RDS per Db2. |
| [rdsadmin.complete\$1rollforward](db2-sp-managing-databases.md#db2-sp-complete-rollforward) | Database | La stored procedure `rdsadmin.complete_rollforward` consente di portare online un database su un’istanza database RDS per Db2 da uno stato `ROLL-FORWARD PENDING`. Lo stato `ROLL-FORWARD PENDING` si verifica quando si chiama [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database) ma il parametro `complete_rollforward` è impostato su `FALSE`. |
| [rdsadmin.configure\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-configure-db-audit) | Policy di audit | La stored procedure `rdsadmin.configure_db_audit` consente di modificare una policy di audit per un database su un’istanza database RDS per Db2. Se non esiste alcuna policy di audit, l’esecuzione di questa stored procedure ha l’effetto di crearne una. |
| [rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool) | Pool di buffer | La stored procedure `rdsadmin.create_bufferpool` consente di creare un pool di buffer per un database su un’istanza database RDS per Db2. |
| [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) | Database | La stored procedure `rdsadmin.create_database` consente di creare un database su un’istanza database RDS per Db2. |
| [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.create_role` consente di creare un ruolo da collegare a un database su un’istanza database RDS per Db2. |
| [rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace) | Tablespace | La stored procedure `rdsadmin.create_tablespace` consente di creare un tablespace per un database su un’istanza database RDS per Db2. |
| [rdsadmin.db2pd\$1command](db2-sp-managing-databases.md#db2-sp-db2pd-command) | Database | La stored procedure `rdsadmin.db2pd_command` consente di raccogliere informazioni su un database su un’istanza database RDS per Db2. Queste informazioni possono aiutare a monitorare e risolvere i problemi relativi ai database in RDS per Db2. |
| [rdsadmin.db2support\$1command](db2-sp-managing-databases.md#db2-sp-db2support-command) | Database | Utilizza la procedura `rdsadmin.db2support_command` memorizzata per raccogliere informazioni diagnostiche su un database su un'istanza DB RDS for Db2 e caricarle in un bucket Amazon S3. |
| [rdsadmin.dbadm\$1grant](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-grant) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.dbadm_grant` consente di concedere uno o più tipi di autorizzazione (`DBADM`, `ACCESSCTRL` o `DATAACCESS`) a uno o più ruoli, utenti o gruppi per un database su un’istanza database RDS per Db2. |
| [rdsadmin.dbadm\$1revoke](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-revoke) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.dbadm_revoke` consente di revocare uno o più tipi di autorizzazione (`DBADM`, `ACCESSCTRL` o `DATAACCESS`) a uno o più ruoli, utenti o gruppi per un database su un’istanza database RDS per Db2. |
| [rdsadmin.deactivate\$1database](db2-sp-managing-databases.md#db2-sp-deactivate-database) | Database | La stored procedure `rdsadmin.deactivate_database` consente di disattivare un database su un’istanza database RDS per Db2. È possibile disattivare i database per risparmiare risorse di memoria. |
| [rdsadmin.disable\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-disable-db-audit) | Policy di audit | La stored procedure `rdsadmin.disable_db_audit` consente di arrestare la registrazione di log di audit e rimuovere una policy di audit da un database su un’istanza database RDS per Db2. |
| [rdsadmin.drop\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-drop-buffer-pool) | Pool di buffer | La stored procedure `rdsadmin.drop_bufferpool` consente di rimuovere un pool di buffer da un database su un’istanza database RDS per Db2. |
| [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) | Database | La stored procedure `rdsadmin.drop_database` consente di rimuovere un database da un’istanza database RDS per Db2. |
| [rdsadmin.drop\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-drop-role) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.drop_role` consente di eliminare un ruolo da un database su un’istanza database RDS per Db2. |
| [rdsadmin.drop\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-drop-tablespace) | Tablespace | La stored procedure `rdsadmin.drop_tablespace` consente di rimuovere un tablespace da un database su un’istanza database RDS per Db2. |
| [rdsadmin.fgac\$1command](db2-sp-managing-databases.md#db2-sp-fgac-command) | Database | Utilizza la `rdsadmin.fgac_command` stored procedure per controllare l'accesso a livello di riga o colonna ai dati di tabella nel tuo database su un'istanza DB RDS for Db2. |
| [rdsadmin.force\$1application](db2-sp-managing-databases.md#db2-sp-force-application) | Database | La stored procedure `rdsadmin.force_application` consente di forzare la disconnessione delle applicazioni da un database su un’istanza database RDS per Db2 al fine di eseguire attività di manutenzione. |
| [rdsadmin.grant\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-grant-role) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.grant_role` consente di assegnare un ruolo a un ruolo, a un utente o a un gruppo in un database su un’istanza database RDS per Db2. È possibile utilizzare questa stored procedure anche per concedere a un ruolo l’autorizzazione `DBADM` per assegnare ruoli. |
| [rdsadmin.list\$1archive\$1log\$1information](db2-sp-managing-databases.md#db2-sp-list-archive-log-information) | Database | La stored procedure `rdsadmin.list_archive_log_information` consente di restituire informazioni sui log di archivio per un database su un’istanza database RDS per Db2. Le informazioni restituite includono dettagli quali la dimensione e la data di creazione di singoli file di log e l’archiviazione totale utilizzata dai file di log di archivio. |
| [rdsadmin.list\$1sid\$1group\$1mapping](db2-sp-granting-revoking-privileges.md#db2-sp-list-sid-group-mapping) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.list_sid_group_mapping` consente di restituire un elenco di tutte le mappature di ID di sicurezza (SID) e gruppi di Active Directory configurate su un’istanza database RDS per Db2. |
| [rdsadmin.list\$1users](db2-sp-granting-revoking-privileges.md#db2-sp-list-users) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.list_users` consente di restituire un elenco di utenti su un elenco di autorizzazioni per un database su un’istanza database RDS per Db2. |
| [rdsadmin.reactivate\$1database](db2-sp-managing-databases.md#db2-sp-reactivate-database) | Database | La stored procedure `rdsadmin.reactivate_database` consente di riattivare un database su un’istanza database RDS per Db2 dopo aver apportato modifiche alla configurazione del database. Per un database su un’istanza database autonoma, è possibile utilizzare questa stored procedure o la stored procedure [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database). Per un database su un’istanza database di origine replica, è necessario utilizzare la stored procedure `rdsadmin.reactivate_database`. |
| [rdsadmin.remove\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-remove-groups) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.remove_groups` consente di rimuovere uno o più gruppi da un utente per un database su un’istanza database RDS per Db2. |
| [rdsadmin.remove\$1sid\$1group\$1mapping](db2-sp-granting-revoking-privileges.md#db2-sp-remove-sid-group-mapping) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.remove_sid_group_mapping` consente di rimuovere una mappatura di ID di sicurezza (SID) e gruppo di Active Directory corrispondente da un’istanza database RDS per Db2. |
| [rdsadmin.remove\$1user](db2-sp-granting-revoking-privileges.md#db2-sp-remove-user) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.remove_user` consente di rimuovere un utente da un elenco di autorizzazioni per un database su un’istanza database RDS per Db2. |
| [rdsadmin.rename\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-rename-tablespace) | Tablespace | La stored procedure `rdsadmin.rename_tablespace` consente di rinominare un tablespace per un database su un’istanza database RDS per Db2. |
| [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database) | Database | La stored procedure `rdsadmin.restore_database` consente di ripristinare un database su un’istanza database RDS per Db2 da un bucket Amazon S3. |
| [rdsadmin.revoke\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-revoke-role) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.revoke_role` consente di revocare un ruolo a un ruolo, a un utente o a un gruppo assegnatario in un database su un’istanza database RDS per Db2. |
| [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database) | Database | La stored procedure `rdsadmin.rollforward_database` consente di portare online un database su un’istanza database RDS per Db2 e di applicare i log delle transazioni dopo aver ripristinato un database su un’istanza database RDS per Db2 tramite una chiamata a [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database). |
| [rdsadmin.rollforward\$1status](db2-sp-managing-databases.md#db2-sp-rollforward-status) | Database | La stored procedure `rdsadmin.rollforward_status` consente di interrogare lo stato di rollforward della chiamata alla stored procedure [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database) o [rdsadmin.complete\$1rollforward](db2-sp-managing-databases.md#db2-sp-complete-rollforward) su un’istanza database RDS per Db2. |
| [rdsadmin.set\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-set-archive-log-retention) | Database | La stored procedure `rdsadmin.set_archive_log_retention` consente di configurare il periodo di tempo di conservazione dei file di log di archivio per un database su un’istanza database RDS per Db2. È possibile utilizzare questa stored procedure anche per disabilitare la conservazione dei log di archivio. |
| [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration) | Database | La stored procedure `rdsadmin.set_configuration` consente di configurare determinate impostazioni per un database su un’istanza database RDS per Db2. |
| [rdsadmin.set\$1sid\$1group\$1mapping](db2-sp-granting-revoking-privileges.md#db2-sp-set-sid-group-mapping) | Concessione e revoca dei privilegi | La stored procedure `rdsadmin.set_sid_group_mapping` consente di creare una mappatura di ID di sicurezza (SID) e gruppo di Active Directory corrispondente su un’istanza database RDS per Db2. |
| [rdsadmin.show\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-show-archive-log-retention) | Database | La stored procedure rdsadmin.show\$1archive\$1log\$1retention consente di restituire l’impostazione corrente relativa alla conservazione dei file di log di archivio per un database su un’istanza database RDS per Db2. |
| [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration) | Database | La stored procedure rdsadmin.show\$1configuration consente di restituire una o più impostazioni modificabili per un database su un’istanza database RDS per Db2. |
| [rdsadmin.uncatalog\$1storage\$1access](db2-sp-managing-storage-access.md#db2-sp-uncatalog-storage-access) | Accesso all’archiviazione | La stored procedure `rdsadmin.uncatalog_storage_access` consente di rimuovere un alias di archiviazione per l’accesso a un bucket Amazon S3 con file di dati Db2. |
| [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param) | Database | La stored procedure rdsadmin.update\$1db\$1param consente di aggiornare i parametri per un database su un’istanza database RDS per Db2. |
| [rdsadmin.enable\$1archive\$1log\$1copy](db2-sp-managing-databases.md#db2-sp-enable_archive_log_copy) | Database | Utilizza la rdsadmin.enable\$1archive\$1log\$1copy stored procedure per abilitare la copia del log di archivio del database RDS Db2 su Amazon S3. |
| [rdsadmin.disable\$1archive\$1log\$1copy](db2-sp-managing-databases.md#db2-sp-disable_archive_log_copy) | Database | Utilizza la rdsadmin.disable\$1archive\$1log\$1copy stored procedure per disabilitare la copia del log di archivio del database RDS Db2 su Amazon S3. |
**Topics**
+ [Considerazioni per le stored procedure di Amazon RDS per Db2](db2-stored-procedures-considerations.md)
+ [Stored procedure per la concessione e la revoca dei privilegi per RDS per Db2](db2-sp-granting-revoking-privileges.md)
+ [Stored procedure relative alle policy di audit per RDS per Db2](db2-sp-managing-audit-policies.md)
+ [Stored procedure relative a pool di buffer per RDS per Db2](db2-sp-managing-buffer-pools.md)
+ [Stored procedure relative ai database per RDS per Db2](db2-sp-managing-databases.md)
+ [Stored procedure per l’accesso all’archiviazione per RDS per Db2](db2-sp-managing-storage-access.md)
+ [Stored procedure relative ai tablespace per RDS per Db2](db2-sp-managing-tablespaces.md)
# Considerazioni per le stored procedure di Amazon RDS per Db2
Prima di utilizzare le stored procedure di sistema di Amazon RDS per le istanze database RDS per Db2 che eseguono il motore Db2, esamina le seguenti informazioni:
+ Prima di eseguire le stored procedure, devi prima connetterti al database `rdsadmin` come utente master per l’istanza database RDS per Db2. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le tue informazioni.
```
db2 "connect to rdsadmin user master_username using master_password"
```
+ Le stored procedure restituiscono il parametro `ERR_MESSAGE`, che indica se la stored procedure ha avuto esito positivo o negativo e il motivo dell’eventuale esito negativo.
**Esempi**
L’esempio seguente indica che la stored procedure ha avuto esito positivo.
```
Parameter Name : ERR_MESSAGE
Parameter Value : -
Return Status = 0
```
L’esempio seguente indica che la stored procedure ha avuto esito negativo perché il nome del bucket Amazon S3 utilizzato nella stored procedure non era valido.
```
Parameter Name : ERR_MESSAGE
Parameter Value : Invalid S3 bucket name
Return Status = -1006
```
Per i messaggi di errore restituiti durante le chiamate alle stored procedure, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
Per informazioni su come verificare lo stato di una stored procedure, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
# Stored procedure per la concessione e la revoca dei privilegi per RDS per Db2
Le stored procedure integrate descritte in questo argomento gestiscono utenti, ruoli, gruppi e autorizzazioni per i database Amazon RDS per Db2. Per eseguire queste procedure, l’utente master deve prima connettersi al database `rdsadmin`.
Per le attività che utilizzano queste stored procedure, consulta [Concessione e revoca dei privilegi](db2-granting-revoking-privileges.md) e [Configurazione dell’autenticazione Kerberos](db2-kerberos-setting-up.md).
Fai riferimento alle seguenti stored procedure integrate per informazioni sulla sintassi, i parametri, le note per l’utilizzo e gli esempi.
**Topics**
+ [rdsadmin.create\$1role](#db2-sp-create-role)
+ [rdsadmin.grant\$1role](#db2-sp-grant-role)
+ [rdsadmin.revoke\$1role](#db2-sp-revoke-role)
+ [rdsadmin.drop\$1role](#db2-sp-drop-role)
+ [rdsadmin.add\$1user](#db2-sp-add-user)
+ [rdsadmin.change\$1password](#db2-sp-change-password)
+ [rdsadmin.list\$1users](#db2-sp-list-users)
+ [rdsadmin.remove\$1user](#db2-sp-remove-user)
+ [rdsadmin.add\$1groups](#db2-sp-add-groups)
+ [rdsadmin.remove\$1groups](#db2-sp-remove-groups)
+ [rdsadmin.dbadm\$1grant](#db2-sp-dbadm-grant)
+ [rdsadmin.dbadm\$1revoke](#db2-sp-dbadm-revoke)
+ [rdsadmin.set\$1sid\$1group\$1mapping](#db2-sp-set-sid-group-mapping)
+ [rdsadmin.list\$1sid\$1group\$1mapping](#db2-sp-list-sid-group-mapping)
+ [rdsadmin.remove\$1sid\$1group\$1mapping](#db2-sp-remove-sid-group-mapping)
## rdsadmin.create\$1role
Crea un ruolo.
### Sintassi
```
db2 "call rdsadmin.create_role(
'database_name',
'role_name')"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui verrà eseguito il comando. Il tipo di dati è `varchar`.
*role\$1name*
Il nome del ruolo da creare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della creazione di un ruolo, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente crea un ruolo denominato `MY_ROLE` per il database `DB2DB`.
```
db2 "call rdsadmin.create_role(
'DB2DB',
'MY_ROLE')"
```
## rdsadmin.grant\$1role
Assegna un ruolo a un ruolo, a un utente o a un gruppo.
### Sintassi
```
db2 "call rdsadmin.grant_role(
?,
'database_name',
'role_name',
'grantee',
'admin_option')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che restituisce l’identificatore univoco dell’attività. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui verrà eseguito il comando. Il tipo di dati è `varchar`.
*role\$1name*
Il nome del ruolo da creare. Il tipo di dati è `varchar`.
*grantee*
Il ruolo, l’utente o il gruppo che riceverà l’autorizzazione. Il tipo di dati è `varchar`. Valori validi: `ROLE`, `USER`, `GROUP`, `PUBLIC`.
Il formato deve essere un valore seguito dal nome. Per separare più valori e nomi, utilizza le virgole. Esempio: '`USER user1, user2, GROUP group1, group2`'. Sostituisci i nomi con le tue informazioni.
Il parametro di input seguente è facoltativo:
*admin\$1option*
Specifica se l’assegnatario `ROLE` dispone dell’autorizzazione `DBADM` per assegnare ruoli. Il tipo di dati è `char`. Il valore predefinito è `N`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato dell’assegnazione di un ruolo, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: assegnazione di un ruolo a un ruolo, a un utente e a un gruppo e concessione dell’autorizzazione**
L’esempio seguente assegna un ruolo denominato `ROLE_TEST` per il database `TESTDB` al ruolo `role1`, all’utente `user1` e al gruppo `group1`. `ROLE_TEST` riceve l’autorizzazione di amministratore per l’assegnazione di ruoli.
```
db2 "call rdsadmin.grant_role(
?,
'TESTDB',
'ROLE_TEST',
'ROLE role1, USER user1, GROUP group1',
'Y')"
```
**Esempio 2: assegnazione di un ruolo a `PUBLIC` senza concessione dell’autorizzazione**
L’esempio seguente assegna un ruolo denominato `ROLE_TEST` per il database `TESTDB` a `PUBLIC`. `ROLE_TEST` non riceve l’autorizzazione di amministratore per l’assegnazione di ruoli.
```
db2 "call rdsadmin.grant_role(
?,
'TESTDB',
'ROLE_TEST',
'PUBLIC')"
```
## rdsadmin.revoke\$1role
Revoca un ruolo a un ruolo, a un utente o a un gruppo.
### Sintassi
```
db2 "call rdsadmin.revoke_role(
?,
'database_name',
'role_name',
'grantee')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che restituisce l’identificatore univoco dell’attività. Questo parametro accetta solo ?.
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui verrà eseguito il comando. Il tipo di dati è `varchar`.
*role\$1name*
Il nome del ruolo da revocare. Il tipo di dati è `varchar`.
*grantee*
Il ruolo, l’utente o il gruppo che perderà l’autorizzazione. Il tipo di dati è `varchar`. Valori validi: `ROLE`, `USER`, `GROUP`, `PUBLIC`.
Il formato deve essere un valore seguito dal nome. Per separare più valori e nomi, utilizza le virgole. Esempio: '`USER user1, user2, GROUP group1, group2`'. Sostituisci i nomi con le tue informazioni.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della revoca di un ruolo, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: revoca di un ruolo a un ruolo, a un utente e a un gruppo**
L’esempio seguente revoca un ruolo denominato `ROLE_TEST` per il database `TESTDB` al ruolo `role1`, all’utente `user1` e al gruppo `group1`.
```
db2 "call rdsadmin.revoke_role(
?,
'TESTDB',
'ROLE_TEST',
'ROLE role1, USER user1, GROUP group1')"
```
**Esempio 2: revoca del ruolo a `PUBLIC`**
L’esempio seguente revoca un ruolo denominato `ROLE_TEST` per il database `TESTDB` a `PUBLIC`.
```
db2 "call rdsadmin.revoke_role(
?,
'TESTDB',
'ROLE_TEST',
'PUBLIC')"
```
## rdsadmin.drop\$1role
Elimina un ruolo.
### Sintassi
```
db2 "call rdsadmin.drop_role(
?,
'database_name',
'role_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che restituisce l’identificatore univoco dell’attività. Questo parametro accetta solo ?.
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui verrà eseguito il comando. Il tipo di dati è `varchar`.
*role\$1name*
Il nome del ruolo da eliminare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato dell’eliminazione di un ruolo, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente elimina un ruolo denominato `ROLE_TEST` per il database `TESTDB`.
```
db2 "call rdsadmin.drop_role(
?,
'TESTDB',
'ROLE_TEST')"
```
## rdsadmin.add\$1user
Aggiunge un utente a un elenco di autorizzazioni.
### Sintassi
```
db2 "call rdsadmin.add_user(
'username',
'password',
'group_name,group_name')"
```
### Parameters
I parametri seguenti sono obbligatori:
*username*
Il nome utente dell’utente. Il tipo di dati è `varchar`.
*password*
La password dell’utente. Il tipo di dati è `varchar`.
Il parametro seguente è facoltativo:
*group\$1name*
Il nome di un gruppo a cui aggiungere l’utente. Il tipo di dati è `varchar`. L’impostazione predefinita è una stringa vuota o null.
### Note per l’utilizzo
Per aggiungere un utente a uno o più gruppi, separa i nomi dei gruppi con virgole.
Puoi creare un gruppo quando crei un nuovo utente o quando [aggiungi un gruppo a un utente esistente](db2-granting-revoking-privileges.md#add-group-to-user). Non puoi creare un gruppo da solo.
**Nota**
Il numero massimo di utenti che puoi aggiungere chiamando `rdsadmin.add_user` è 5.000.
Per informazioni su come verificare lo stato dell’aggiunta di un utente, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente crea un utente denominato `jorge_souza` e assegna l’utente ai gruppi `sales` e `inside_sales`.
```
db2 "call rdsadmin.add_user(
'jorge_souza',
'*******',
'sales,inside_sales')"
```
## rdsadmin.change\$1password
Modifica la password di un utente.
### Sintassi
```
db2 "call rdsadmin.change_password(
'username',
'new_password')"
```
### Parameters
I parametri seguenti sono obbligatori:
*username*
Il nome utente dell’utente. Il tipo di dati è `varchar`.
*new\$1password*
La nuova password per l’utente. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della modifica di una password, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente modifica la password per `jorge_souza`.
```
db2 "call rdsadmin.change_password(
'jorge_souza',
'*******')"
```
## rdsadmin.list\$1users
Inserisce gli utenti in un elenco di autorizzazioni.
### Sintassi
```
db2 "call rdsadmin.list_users()"
```
### Note per l’utilizzo
Per informazioni su come verificare lo stato dell’inserimento di utenti in un elenco, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## rdsadmin.remove\$1user
Rimuove un utente dall’elenco di autorizzazioni.
### Sintassi
```
db2 "call rdsadmin.remove_user('username')"
```
### Parameters
Il parametro seguente è obbligatorio:
*username*
Il nome utente dell’utente. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della rimozione di un utente, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente impedisce a `jorge_souza` di accedere ai database nelle istanze database RDS per Db2.
```
db2 "call rdsadmin.remove_user('jorge_souza')"
```
## rdsadmin.add\$1groups
Aggiunge gruppi a un utente.
### Sintassi
```
db2 "call rdsadmin.add_groups(
'username',
'group_name,group_name')"
```
### Parameters
I parametri seguenti sono obbligatori:
*username*
Il nome utente dell’utente. Il tipo di dati è `varchar`.
*group\$1name*
Il nome di un gruppo a cui aggiungere l’utente. Il tipo di dati è `varchar`. L'impostazione predefinita è una stringa vuota.
### Note per l’utilizzo
Per aggiungere uno o più gruppi a un utente, separa i nomi dei gruppi con virgole. Per informazioni su come verificare lo stato dell’aggiunta di gruppi, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente aggiunge i gruppi `direct_sales` e `b2b_sales` all’utente `jorge_souza`.
```
db2 "call rdsadmin.add_groups(
'jorge_souza',
'direct_sales,b2b_sales')"
```
## rdsadmin.remove\$1groups
Rimuove gruppi da un utente.
### Sintassi
```
db2 "call rdsadmin.remove_groups(
'username',
'group_name,group_name')"
```
### Parameters
I parametri seguenti sono obbligatori:
*username*
Il nome utente dell’utente. Il tipo di dati è `varchar`.
*group\$1name*
Il nome di un gruppo da cui rimuovere l’utente. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per rimuovere uno o più gruppi da un utente, separa i nomi dei gruppi con virgole.
Per informazioni su come verificare lo stato della rimozione di gruppi, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente rimuove i gruppi `direct_sales` e `b2b_sales` dall’utente `jorge_souza`.
```
db2 "call rdsadmin.remove_groups(
'jorge_souza',
'direct_sales,b2b_sales')"
```
## rdsadmin.dbadm\$1grant
Concede l’autorizzazione `DBADM`, `ACCESSCTRL` o `DATAACCESS` a un ruolo, a un utente o a un gruppo.
### Sintassi
```
db2 "call rdsadmin.dbadm_grant(
?,
'database_name',
'authorization',
'grantee')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che restituisce l’identificatore univoco dell’attività. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui verrà eseguito il comando. Il tipo di dati è `varchar`.
*authorization*
Il tipo di autorizzazione da concedere. Il tipo di dati è `varchar`. Valori validi: `DBADM`, `ACCESSCTRL`, `DATAACCESS`.
Per separare più tipi, utilizza le virgole.
*grantee*
Il ruolo, l’utente o il gruppo che riceverà l’autorizzazione. Il tipo di dati è `varchar`. Valori validi: `ROLE`, `USER`, `GROUP`.
Il formato deve essere un valore seguito dal nome. Per separare più valori e nomi, utilizza le virgole. Esempio: '`USER user1, user2, GROUP group1, group2`'. Sostituisci i nomi con le tue informazioni.
### Note per l’utilizzo
Il ruolo che riceverà l’autorizzazione di accesso deve essere già presente.
Per informazioni su come verificare lo stato della concessione dell’autorizzazione di accesso come amministratore del database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: concessione dell’autorizzazione di accesso come amministratore del database a un ruolo**
L’esempio seguente concede l’autorizzazione di accesso come amministratore del database `TESTDB` al ruolo `ROLE_DBA`.
```
db2 "call rdsadmin.dbadm_grant(
?,
'TESTDB',
'DBADM',
'ROLE ROLE_DBA')"
```
**Esempio 2: concessione dell’autorizzazione di accesso come amministratore del database a un utente e a un gruppo**
L’esempio seguente concede l’autorizzazione di accesso come amministratore del database `TESTDB` a `user1` e `group1`.
```
db2 "call rdsadmin.dbadm_grant(
?,
'TESTDB',
'DBADM',
'USER user1, GROUP group1')"
```
**Esempio 3: concessione dell’autorizzazione di accesso come amministratore del database a più utenti e gruppi**
L’esempio seguente concede l’autorizzazione di accesso come amministratore del database `TESTDB` a `user1`, `user2`, `group1` e `group2`.
```
db2 "call rdsadmin.dbadm_grant(
?,
'TESTDB',
'DBADM',
'USER user1, user2, GROUP group1, group2')"
```
## rdsadmin.dbadm\$1revoke
Revoca l’autorizzazione `DBADM`, `ACCESSCTRL` o `DATAACCESS` a un ruolo, a un utente o a un gruppo.
### Sintassi
```
db2 "call rdsadmin.dbadm_revoke(
?,
'database_name',
'authorization',
'grantee')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Identificatore univoco dell'attività. Questo parametro accetta solo `?`.
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui verrà eseguito il comando. Il tipo di dati è `varchar`.
*authorization*
Il tipo di autorizzazione da revocare. Il tipo di dati è `varchar`. Valori validi: `DBADM`, `ACCESSCTRL`, `DATAACCESS`.
Per separare più tipi, utilizza le virgole.
*grantee*
Il ruolo, l’utente o il gruppo a cui revocare l’autorizzazione. Il tipo di dati è `varchar`. Valori validi: `ROLE`, `USER`, `GROUP`.
Il formato deve essere un valore seguito dal nome. Per separare più valori e nomi, utilizza le virgole. Esempio: '`USER user1, user2, GROUP group1, group2`'. Sostituisci i nomi con le tue informazioni.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della revoca dell’autorizzazione di accesso come amministratore del database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: revoca dell’autorizzazione di accesso come amministratore del database a un ruolo**
L’esempio seguente revoca l’autorizzazione di accesso come amministratore del database `TESTDB` al ruolo `ROLE_DBA`.
```
db2 "call rdsadmin.dbadm_revoke(
?,
'TESTDB',
'DBADM',
'ROLE ROLE_DBA')"
```
**Esempio 2: revoca dell’autorizzazione di accesso come amministratore del database a un utente e a un gruppo**
L’esempio seguente revoca l’autorizzazione di accesso come amministratore del database `TESTDB` a `user1` e `group1`.
```
db2 "call rdsadmin.dbadm_revoke(
?,
'TESTDB',
'DBADM',
'USER user1, GROUP group1')"
```
**Esempio 3: revoca dell’autorizzazione di accesso come amministratore del database a più utenti e gruppi**
L’esempio seguente revoca l’autorizzazione di accesso come amministratore del database `TESTDB` a `user1`, `user2`, `group1` e `group2`.
```
db2 "call rdsadmin.dbadm_revoke(
?,
'TESTDB',
'DBADM',
'USER user1, user2, GROUP group1, group2')"
```
## rdsadmin.set\$1sid\$1group\$1mapping
Crea una mappatura tra un ID di sicurezza (SID) e il gruppo Active Directory corrispondente.
### Sintassi
```
db2 "call rdsadmin.set_sid_group_mapping(
?,
'SID',
'group_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*SID*
L’ID di sicurezza. Il tipo di dati è `varchar`.
*group\$1name*
Il nome del gruppo Active Directory da mappare al SID. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Utilizza questa stored procedure per abilitare l’autenticazione Kerberos con i gruppi Active Directory. Se il valore di `SID` o `group_name` è già presente nella mappatura, questa stored procedure ha esito negativo.
Per informazioni su come trovare il SID per un gruppo, consulta [Fase 8: Recuperare il SID del gruppo Active Directory in PowerShellPassaggio 8: Recuperare il SID del gruppo Active Directory in PowerShell](db2-kerberos-setting-up.md#db2-kerberos-setting-up-retrieve-ad-group-sid).
Per informazioni su come verificare lo stato della creazione di una mappatura, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente mappa un SID a un gruppo denominato `my_group`.
```
db2 "call rdsadmin.set_sid_group_mapping(
?,
'S-1-5-21-9146495592-531070549-834388463-513',
'my_group')"
```
## rdsadmin.list\$1sid\$1group\$1mapping
Elenca tutte le mappature di SID e gruppi Active Directory configurate sull’istanza database.
### Sintassi
```
db2 "call rdsadmin.list_sid_group_mapping()"
```
### Note per l’utilizzo
Per informazioni su come verificare lo stato della creazione di un elenco di mappature, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## rdsadmin.remove\$1sid\$1group\$1mapping
Rimuove una mappatura tra un SID e il gruppo Active Directory corrispondente da un’istanza database.
### Sintassi
```
db2 "call rdsadmin.remove_sid_group_mapping(
?,
'SID')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*SID*
L’ID di sicurezza. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come trovare il SID per un gruppo, consulta [Fase 8: Recuperare il SID del gruppo Active Directory in PowerShellPassaggio 8: Recuperare il SID del gruppo Active Directory in PowerShell](db2-kerberos-setting-up.md#db2-kerberos-setting-up-retrieve-ad-group-sid).
Per informazioni su come verificare lo stato della rimozione di mappature, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente rimuove la mappatura di un SID dal gruppo per cui è stata creata.
```
db2 "call rdsadmin.remove_sid_group_mapping(
?,
'S-1-5-21-9146495592-531070549-834388463-513')"
```
# Stored procedure relative alle policy di audit per RDS per Db2
Le stored procedure integrate descritte in questo argomento gestiscono le policy di audit per i database Amazon RDS per Db2. Per ulteriori informazioni, consulta [Registrazione di log di audit Db2](Db2.Options.Audit.md). Per eseguire queste procedure, l’utente master deve prima connettersi al database `rdsadmin`.
Fai riferimento alle seguenti stored procedure integrate per informazioni sulla sintassi, i parametri, le note per l’utilizzo e gli esempi.
**Topics**
+ [rdsadmin.configure\$1db\$1audit](#db2-sp-configure-db-audit)
+ [rdsadmin.disable\$1db\$1audit](#db2-sp-disable-db-audit)
## rdsadmin.configure\$1db\$1audit
Configura la politica di controllo per il database RDS for Db2 specificato da. *db\$1name* Se la policy da configurare non esiste, viene creata automaticamente al momento della chiamata a questa stored procedure. Se invece la policy esiste, la chiamata a questa stored procedure ne determina la modifica in base ai valori dei parametri specificati.
### Sintassi
```
db2 "call rdsadmin.configure_db_audit(
'db_name',
'category',
'category_setting',
'?')"
```
### Parameters
I parametri seguenti sono obbligatori.
*db\$1name*
Il nome del database RDS per Db2 per cui configurare la policy di audit. Il tipo di dati è `varchar`.
*category*
Il nome della categoria per cui configurare la policy di audit. Il tipo di dati è `varchar`. Di seguito sono elencati i valori validi per questo parametro:
+ `ALL`: con `ALL`, Amazon RDS non include le categorie `CONTEXT`, `EXECUTE` e `ERROR`.
+ `AUDIT`
+ `CHECKING`
+ `CONTEXT`
+ `ERROR`
+ `EXECUTE`: è possibile configurare questa categoria con o senza dati. La configurazione con dati significa che vengono registrati anche i valori dei dati di input del log specificati per qualsiasi variabile host e indicatore di parametro. Per impostazione predefinita, viene eseguita la configurazione senza dati. Per ulteriori informazioni, vedere la descrizione del *category\$1setting* parametro e il. [Esempi](#db2-sp-configure-db-audit-examples)
+ `OBJMAINT`
+ `SECMAINT`
+ `SYSADMIN`
+ `VALIDATE`
Per ulteriori informazioni su queste categorie, consulta la [documentazione di IBM Db2](https://www.ibm.com/docs/en/db2/11.1?topic=statements-create-audit-policy).
*category\$1setting*
L’impostazione relativa alla categoria di audit specificata. Il tipo di dati è `varchar`.
Nella tabella seguente sono illustrati i valori validi delle impostazioni per ogni categoria.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/db2-sp-managing-audit-policies.html)
### Note per l’utilizzo
Prima di chiamare `rdsadmin.configure_db_audit`, assicurati che l’istanza database RDS per Db2 con il database per cui stai configurando la policy di audit sia associata a un gruppo di opzioni che include l’opzione `DB2_AUDIT`. Per ulteriori informazioni, consulta [Configurazione della registrazione di log di audit Db2](Db2.Options.Audit.md#db2-audit-setting-up).
Dopo aver configurato la policy di audit, puoi verificare lo stato della configurazione di audit per il database seguendo le istruzioni riportate in [Verifica della configurazione di audit](Db2.Options.Audit.md#db2-audit-check-config-status).
L’impostazione di `ALL` per il parametro `category` non include le categorie `CONTEXT`, `EXECUTE` e `ERROR`. Per aggiungere queste categorie alla policy di audit, chiama `rdsadmin.configure_db_audit` separatamente per ogni categoria da aggiungere. Per ulteriori informazioni, consulta [Esempi](#db2-sp-configure-db-audit-examples).
### Esempi
I seguenti esempi creano o modificano la policy di audit per un database denominato `TESTDB`. Negli esempi da 1 a 5, se la categoria `ERROR` non è stata configurata in precedenza, viene impostata su `NORMAL` (impostazione predefinita). Per modificare questa impostazione in `AUDIT`, segui le istruzioni riportate in [Example 6: Specifying the ERROR category](#example-6).
**Esempio 1: specifica della categoria `ALL`**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'ALL', 'BOTH', ?)"
```
In questo esempio, la chiamata configura le categorie `AUDIT`, `CHECKING`, `OBJMAINT`, `SECMAINT`, `SYSADMIN` e `VALIDATE` nella policy di audit. La specifica di `BOTH` significa che gli eventi con esito sia positivo che negativo verranno sottoposti a audit per ciascuna di queste categorie.
**Esempio 2: specifica della categoria `EXECUTE` con dati**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'EXECUTE', 'SUCCESS,WITH', ?)"
```
In questo esempio, la chiamata configura la categoria `EXECUTE` nella policy di audit. La specifica di `SUCCESS,WITH` significa che i log relativi a questa categoria includeranno solo gli eventi con esito positivo insieme ai valori dei dati di input specificati per le variabili host e gli indicatori dei parametri.
**Esempio 3: specifica della categoria `EXECUTE` senza dati**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'EXECUTE', 'FAILURE,WITHOUT', ?)"
```
In questo esempio, la chiamata configura la categoria `EXECUTE` nella policy di audit. La specifica di `FAILURE,WITHOUT` significa che i log relativi a questa categoria includeranno solo gli eventi con esito negativo senza i valori dei dati di input specificati per le variabili host e gli indicatori dei parametri.
**Esempio 4: specifica della categoria `EXECUTE` senza eventi di stato**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'EXECUTE', 'NONE', ?)"
```
In questo esempio, la chiamata configura la categoria `EXECUTE` nella policy di audit. La specifica di `NONE` significa che nessun evento in questa categoria verrà sottoposto a audit.
**Esempio 5: specifica della categoria `OBJMAINT`**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'OBJMAINT', 'NONE', ?)"
```
In questo esempio, la chiamata configura la categoria `OBJMAINT` nella policy di audit. La specifica di `NONE` significa che nessun evento in questa categoria verrà sottoposto a audit.
**Esempio 6: specifica della categoria `ERROR`**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'ERROR', 'AUDIT', ?)"
```
In questo esempio, la chiamata configura la categoria `ERROR` nella policy di audit. La specifica di `AUDIT` significa che tutti gli errori, inclusi quelli che si verificano nell’ambito della registrazione di log di audit, vengono registrati nei log. Il tipo di errore predefinito è `NORMAL`. Con `NORMAL`, vengono ignorati gli errori generati dall’audit e vengono acquisiti soltanto i codici `SQLCODE` per gli errori associati all’operazione eseguita.
## rdsadmin.disable\$1db\$1audit
Interrompe la registrazione di controllo per il database RDS for Db2 specificato da *db\$1name* e rimuove la politica di controllo configurata per tale database.
**Nota**
Questa stored procedure rimuove solo le policy di audit configurate tramite una chiamata a [rdsadmin.configure\$1db\$1audit](#db2-sp-configure-db-audit).
### Sintassi
```
db2 "call rdsadmin.disable_db_audit('db_name', ?)"
```
### Parameters
I parametri seguenti sono obbligatori.
*db\$1name*
Il nome del database RDS per Db2 per cui disabilitare la registrazione di log di audit. Il tipo di dati è `varchar`.
### Note per l’utilizzo
La chiamata a `rdsadmin.disable_db_audit` non disabilita la registrazione di log di audit per l’istanza database RDS per Db2. Per disabilitare la registrazione di log di audit a livello di istanza database, rimuovi il gruppo di opzioni dall’istanza database. Per ulteriori informazioni, consulta [Disabilitazione della registrazione di log di audit Db2](Db2.Options.Audit.md#db2-audit-disabling).
### Esempi
L’esempio seguente disabilita la registrazione di log di audit per un database denominato `TESTDB`.
```
db2 "call rdsadmin.disable_db_audit('TESTDB', ?)"
```
# Stored procedure relative a pool di buffer per RDS per Db2
Le stored procedure integrate descritte in questo argomento gestiscono i pool di buffer per i database Amazon RDS per Db2. Per eseguire queste procedure, l’utente master deve prima connettersi al database `rdsadmin`.
Queste stored procedure vengono utilizzate in diverse attività. L'elenco non è completo.
+ [Attività comuni per i pool di buffer](db2-managing-buffer-pools.md)
+ [Generazione di report sulle prestazioni](db2-managing-databases.md#db2-generating-performance-reports)
+ [Copia dei metadati del database con db2look](db2-native-db2-tools-db2look.md)
+ [Creazione di un database di repository per IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)
Fai riferimento alle seguenti stored procedure integrate per informazioni sulla sintassi, i parametri, le note per l’utilizzo e gli esempi.
**Topics**
+ [rdsadmin.create\$1bufferpool](#db2-sp-create-buffer-pool)
+ [rdsadmin.alter\$1bufferpool](#db2-sp-alter-buffer-pool)
+ [rdsadmin.drop\$1bufferpool](#db2-sp-drop-buffer-pool)
## rdsadmin.create\$1bufferpool
Crea un pool di buffer.
### Sintassi
```
db2 "call rdsadmin.create_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
page_size,
number_block_pages,
block_size)"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui eseguire il comando. Il tipo di dati è `varchar`.
*buffer\$1pool\$1name*
Il nome del pool di buffer da creare. Il tipo di dati è `varchar`.
I parametri seguenti sono facoltativi:
*buffer\$1pool\$1size*
La dimensione del pool di buffer espressa in numero di pagine. Il tipo di dati è `integer`. Il valore predefinito è `-1`.
*immediate*
Specifica se il comando viene eseguito immediatamente. Il tipo di dati è `char`. Il valore predefinito è `Y`.
*automatic*
Specifica se impostare il pool di buffer in modalità automatica. Il tipo di dati è `char`. Il valore predefinito è `Y`.
*page\$1size*
Aumenta la dimensione di pagina del pool di buffer. Il tipo di dati è `integer`. Valori validi: `4096`, `8192`, `16384`, `32768`. Il valore predefinito è `8192`.
*number\$1block\$1pages*
Il numero di pagine di blocco nei pool di buffer. Il tipo di dati è `integer`. Il valore predefinito è `0`.
*block\$1size*
La dimensione di blocco per le pagine di blocco. Il tipo di dati è `integer`. Valori validi: da `2` a `256`. Il valore predefinito è `32`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della creazione di un pool di buffer, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: creazione di un pool di buffer con parametri predefiniti**
L’esempio seguente crea un pool di buffer denominato `BP8` per il database `TESTDB` con parametri predefiniti, pertanto il pool di buffer utilizza una dimensione di pagina pari a 8 KB.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP8')"
```
**Esempio 2: creazione di un pool di buffer da eseguire immediatamente con allocazione automatica**
L’esempio seguente crea un pool di buffer denominato `BP16` per il database `TESTDB` che utilizza una dimensione di pagina di 16 KB con un numero iniziale di pagine pari a 1.000 ed è impostato in modalità automatica. Db2 esegue il comando immediatamente. Se il numero iniziale di pagine è pari a -1, Db2 utilizzerà l’allocazione automatica delle pagine.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP16',
1000,
'Y',
'Y',
16384)"
```
**Esempio 3: creazione di un pool di buffer da eseguire immediatamente utilizzando pagine di blocco**
L’esempio seguente crea un pool di buffer denominato `BP16` per il database `TESTDB`. Questo pool di buffer ha una dimensione di pagina di 16 KB con un numero iniziale di pagine pari a 10.000. Db2 esegue immediatamente il comando utilizzando 500 pagine di blocco con una dimensione di blocco pari a 512.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP16',
10000,
'Y',
'Y',
16384,
500,
512)"
```
## rdsadmin.alter\$1bufferpool
Modifica un pool di buffer.
### Sintassi
```
db2 "call rdsadmin.alter_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
change_number_blocks,
number_block_pages,
block_size)"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui eseguire il comando. Il tipo di dati è `varchar`.
*buffer\$1pool\$1name*
Il nome del pool di buffer da modificare. Il tipo di dati è `varchar`.
*buffer\$1pool\$1size*
La dimensione del pool di buffer espressa in numero di pagine. Il tipo di dati è `integer`.
I parametri seguenti sono facoltativi:
*immediate*
Specifica se il comando viene eseguito immediatamente. Il tipo di dati è `char`. Il valore predefinito è `Y`.
*automatic*
Specifica se impostare il pool di buffer in modalità automatica. Il tipo di dati è `char`. Il valore predefinito è `N`.
*change\$1number\$1blocks*
Specifica se è stata apportata una modifica al numero di pagine di blocco nel pool di buffer. Il tipo di dati è `char`. Il valore predefinito è `N`.
*number\$1block\$1pages*
Il numero di pagine di blocco nei pool di buffer. Il tipo di dati è `integer`. Il valore predefinito è `0`.
*block\$1size*
La dimensione di blocco per le pagine di blocco. Il tipo di dati è `integer`. Valori validi: da `2` a `256`. Il valore predefinito è `32`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della modifica di un pool di buffer, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente modifica un pool di buffer denominato `BP16` per il database `TESTDB` impostando la modalità automatica e la dimensione pari a 10.000 pagine. Db2 esegue il comando immediatamente.
```
db2 "call rdsadmin.alter_bufferpool(
'TESTDB',
'BP16',
10000,
'Y',
'N')"
```
## rdsadmin.drop\$1bufferpool
Elimina un pool di buffer.
### Sintassi
```
db2 "call rdsadmin.drop_bufferpool(
'database_name',
'buffer_pool_name'"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database a cui appartiene il pool di buffer. Il tipo di dati è `varchar`.
*buffer\$1pool\$1name*
Il nome del pool di buffer da eliminare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato dell’eliminazione di un pool di buffer, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente elimina un pool di buffer denominato `BP16` per il database `TESTDB`.
```
db2 "call rdsadmin.drop_bufferpool(
'TESTDB',
'BP16')"
```
# Stored procedure relative ai database per RDS per Db2
Le stored procedure integrate descritte in questo argomento gestiscono i database per Amazon RDS per Db2. Per eseguire queste procedure, l’utente master deve prima connettersi al database `rdsadmin`.
Queste stored procedure vengono utilizzate in diverse attività. L'elenco non è completo.
+ [Attività comuni per i database](db2-managing-databases.md)
+ [Creazione di database con regole di confronto EBCDIC](db2-ebcdic.md)
+ [Raccolta di informazioni sui database](db2-supported-parameters.md#db2-modifying-parameters-db2-commands)
+ [Modifica dei parametri di configurazione del database](db2-supported-parameters.md#db2-modifying-parameters-db2-commands)
+ [Migrazione da Linux a Linux](db2-one-time-migration-linux.md)
+ [Migrazione da Linux a Linux con tempo di inattività quasi nullo](db2-near-zero-downtime-migration.md)
Per informazioni sulla sintassi, i parametri, le note per l’utilizzo e gli esempi, fai riferimento alle seguenti stored procedure integrate.
**Topics**
+ [rdsadmin.create\$1database](#db2-sp-create-database)
+ [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database)
+ [rdsadmin.activate\$1database](#db2-sp-activate-database)
+ [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database)
+ [rdsadmin.drop\$1database](#db2-sp-drop-database)
+ [rdsadmin.update\$1db\$1param](#db2-sp-update-db-param)
+ [rdsadmin.set\$1configuration](#db2-sp-set-configuration)
+ [rdsadmin.show\$1configuration](#db2-sp-show-configuration)
+ [rdsadmin.backup\$1database](#db2-sp-backup-database)
+ [rdsadmin.restore\$1database](#db2-sp-restore-database)
+ [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database)
+ [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status)
+ [rdsadmin.complete\$1rollforward](#db2-sp-complete-rollforward)
+ [rdsadmin.db2pd\$1command](#db2-sp-db2pd-command)
+ [rdsadmin.force\$1application](#db2-sp-force-application)
+ [rdsadmin.set\$1archive\$1log\$1retention](#db2-sp-set-archive-log-retention)
+ [rdsadmin.show\$1archive\$1log\$1retention](#db2-sp-show-archive-log-retention)
+ [rdsadmin.list\$1archive\$1log\$1information](#db2-sp-list-archive-log-information)
+ [rdsadmin.enable\$1archive\$1log\$1copy](#db2-sp-enable_archive_log_copy)
+ [rdsadmin.disable\$1archive\$1log\$1copy](#db2-sp-disable_archive_log_copy)
+ [rdsadmin.fgac\$1command](#db2-sp-fgac-command)
+ [rdsadmin.db2support\$1command](#db2-sp-db2support-command)
## rdsadmin.create\$1database
Crea un database.
### Sintassi
```
db2 "call rdsadmin.create_database(
'database_name',
'database_page_size',
'database_code_set',
'database_territory',
'database_collation',
'database_autoconfigure_str',
'database_non-restrictive')"
```
### Parameters
**Nota**
Questa stored procedure non convalida la combinazione dei parametri richiesti. Quando si chiama [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status), la funzione definita dall’utente potrebbe restituire un errore a causa di una combinazione di `database_codeset`, `database_territory` e `database_collation` non valida. Per ulteriori informazioni, consulta [Choosing the code page, territory, and collation for your database](https://www.ibm.com/docs/en/db2/11.5?topic=support-choosing-code-page-territory-collation-your-database) nella documentazione di IBM Db2.
Il parametro seguente è obbligatorio:
*database\$1name*
Il nome del database da creare. Il tipo di dati è `varchar`.
I parametri seguenti sono facoltativi:
*database\$1page\$1size*
La dimensione predefinita della pagina del database. Valori validi: `4096`, `8192`, `16384`, `32768`. Il tipo di dati è `integer`. Il valore predefinito è `8192`.
Amazon RDS supporta l’atomicità di scrittura per pagine da 4, 8 e 16 KiB. Al contrario, le pagine da 32 KB rischiano *scritture strappate* o la scrittura di dati parziali sul disco. Se utilizzi pagine da 32 KiB, ti consigliamo di abilitare il point-in-time ripristino e i backup automatici. Altrimenti, corri il rischio di non riuscire a recuperare le pagine danneggiate. Per ulteriori informazioni, consultare [Introduzione ai backup](USER_WorkingWithAutomatedBackups.md) e [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
*database\$1code\$1set*
Il set di codici per il database. Il tipo di dati è `varchar`. Il valore predefinito è `UTF-8`.
*database\$1territory*
Il codice di due lettere del paese per il database. Il tipo di dati è `varchar`. Il valore predefinito è `US`.
*database\$1collation*
La sequenza di regole di confronto che determina il modo in cui le stringhe di caratteri archiviate nel database vengono ordinate e confrontate. Il tipo di dati è `varchar`.
Valori validi:
+ `COMPATIBILITY`: una sequenza di regole di confronto IBM Db2 versione 2.
+ `EBCDIC_819_037`: tabella codici ISO alfabeto latino, regole di confronto; CCSID 037 (EBCDIC inglese statunitense).
+ `EBCDIC_819_500`: tabella codici ISO alfabeto latino, regole di confronto; CCSID 500 (EBCDIC internazionale).
+ `EBCDIC_850_037`: tabella codici ASCII alfabeto latino, regole di confronto; CCSID 037 (EBCDIC inglese statunitense).
+ `EBCDIC_850_500`: tabella codici ASCII alfabeto latino, regole di confronto; CCSID 500 (EBCDIC internazionale).
+ `EBCDIC_932_5026`: tabella codici ASCII alfabeto giapponese, regole di confronto; CCSID 5026 (EBCDIC inglese statunitense).
+ `EBCDIC_932_5035`: tabella codici ASCII alfabeto giapponese, regole di confronto; CCSID 5035 (EBCDIC internazionale).
+ `EBCDIC_1252_037`: tabella codici Windows alfabeto latino, regole di confronto; CCSID 037 (EBCDIC inglese statunitense).
+ `EBCDIC_1252_500`: tabella codici Windows alfabeto latino, regole di confronto; CCSID 500 (EBCDIC internazionale).
+ `IDENTITY`: regole di confronto predefinite. Le stringhe vengono confrontate byte per byte.
+ `IDENTITY_16BIT`: lo schema di codifica di compatibilità per UTF-16: sequenza di regole di confronto a 8 bit (CESU-8). Per ulteriori informazioni, consulta l’[Unicode Technical Report \$126](https://www.unicode.org/reports/tr26/tr26-4.html) sul sito web Unicode Consortium.
+ `NLSCHAR`— Da utilizzare solo con la tabella codici thailandese (CP874).
+ `SYSTEM`: se utilizzi `SYSTEM`, il database applica automaticamente la sequenza di regole di confronto per `database_codeset` e `database_territory`.
Il valore predefinito è `IDENTITY`.
Inoltre, RDS per Db2 supporta i seguenti gruppi di regole di confronto: `language-aware-collation` e `locale-sensitive-collation`. Per ulteriori informazioni, consulta [Choosing a collation for a Unicode database](https://www.ibm.com/docs/en/db2/11.5?topic=collation-choosing-unicode-database) nella documentazione di IBM Db2.
*database\$1autoconfigure\$1str*
La sintassi del comando `AUTOCONFIGURE`, ad esempio `'AUTOCONFIGURE APPLY DB'`. Il tipo di dati è `varchar`. L’impostazione predefinita è una stringa vuota o null.
Per ulteriori informazioni, consulta [AUTOCONFIGURE command](https://www.ibm.com/docs/en/db2/11.5?topic=cc-autoconfigure) nella documentazione di IBM Db2.
*database\$1non-restrictive*
La concessione di autorità e privilegi predefiniti all'interno del database. Il tipo di dati è `varchar`. Il valore predefinito è `N`.
Valori validi:
+ `N`— Il database creato è restrittivo e non concede autorità o privilegi.
+ `Y`— Il database creato non è restrittivo e concede una serie di autorizzazioni al gruppo speciale. `PUBLIC` Per ulteriori informazioni, consulta [Privilegi predefiniti concessi per la creazione di un database](https://www.ibm.com/docs/en/db2/11.5.x?topic=ownership-default-privileges-granted-creating-database) nella documentazione. IBM Db2
### Note per l’utilizzo
Se intendi modificare il parametro `db2_compatibility_vector`, modificalo prima di creare un database. Per ulteriori informazioni, consulta [Impostazione del parametro db2\$1compatibility\$1vector](db2-known-issues-limitations.md#db2-known-issues-limitations-db2-compatibility-vector).
Considerazioni speciali:
+ Il comando `CREATE DATABASE` inviato all’istanza Db2 utilizza l’opzione `RESTRICTIVE`.
+ RDS per Db2 utilizza solo tablespace `AUTOMATIC STORAGE`.
+ RDS per Db2 utilizza i valori predefiniti per `NUMSEGS` e `DFT_EXTENT_SZ`.
+ RDS per Db2 utilizza la crittografia dell’archiviazione e non supporta la crittografia del database.
Per ulteriori informazioni su queste considerazioni, consulta [CREATE DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-create-database#:~:text=in%20the%20database.-,RESTRICTIVE,-If%20the%20RESTRICTIVE) nella documentazione di IBM Db2.
Prima di chiamare `rdsadmin.create_database`, è necessario connettersi al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le informazioni sull'istanza DB RDS for Db2:
```
db2 connect to rdsadmin user master_username using master_password
```
Per informazioni su come verificare lo stato della creazione di un database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante la chiamata di `rdsadmin.create_database`, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
L'esempio seguente crea un database chiamato `TESTJP` con una combinazione corretta di *database\$1code\$1set**database\$1territory*, e *database\$1collation* parametri per il Giappone:
```
db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"
```
## rdsadmin.deactivate\$1database
Disattiva un database.
### Sintassi
```
db2 "call rdsadmin.deactivate_database(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database da disattivare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
È possibile disattivare i database per risparmiare risorse di memoria o per apportare altre modifiche alla configurazione del database. Per riportare online i database disattivati, chiama la stored procedure [rdsadmin.activate\$1database](#db2-sp-activate-database).
Non è possibile disattivare un database su un’istanza database di origine durante la replica chiamando la stored procedure `rdsadmin.deactivate_database`.
Per informazioni su come verificare lo stato della disattivazione di un database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante la chiamata di `rdsadmin.deactivate_database`, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
Nell’esempio seguente viene disattivato un database denominato `TESTDB`.
```
db2 "call rdsadmin.deactivate_database(?, 'TESTDB')"
```
## rdsadmin.activate\$1database
Attiva un database.
Per ulteriori informazioni sulla differenza tra [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database) e `rdsadmin.activate_database`, consulta [Note per l’utilizzo](#db2-sp-activate-database-usage-notes).
### Sintassi
```
db2 "call rdsadmin.activate_database(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database da attivare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Tutti i database vengono attivati per impostazione predefinita al momento della creazione. Se per risparmiare risorse di memoria o apportare altre modifiche alla configurazione del database si [disattiva]() un database su un’istanza database autonoma, chiama la stored procedure `rdsadmin.activate_database` per riattivarlo.
Questa stored procedure attiva solo un database che si trova su un’istanza database autonoma e che è stato disattivato chiamando la stored procedure [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database). Per attivare un database su un’istanza database di origine di replica, è necessario chiamare la stored procedure [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database).
Per informazioni su come verificare lo stato dell’attivazione di un database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante la chiamata di `rdsadmin.activate_database`, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
Nell’esempio seguente viene attivato un database denominato `TESTDB`.
```
db2 "call rdsadmin.activate_database(?, 'TESTDB')"
```
## rdsadmin.reactivate\$1database
Riattiva un database.
Per informazioni sulle differenze tra [rdsadmin.activate\$1database](#db2-sp-activate-database) e `rdsadmin.reactivate_database`, consulta [Note per l’utilizzo](#db2-sp-reactivate-database-usage-notes).
### Sintassi
```
db2 "call rdsadmin.reactivate_database(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database da riattivare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Quando si chiama la stored procedure `rdsadmin.reactivate_database`, questa prima disattiva il database chiamando la stored procedure [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database), quindi lo attiva chiamando la stored procedure [rdsadmin.activate\$1database](#db2-sp-activate-database).
Dopo aver apportato modifiche alle configurazioni dei database, potrebbe essere necessario riattivare un database su un’istanza database RDS per Db2. Per stabilire se è necessario riattivare un database, connettiti al database ed esegui `db2 get db cfg show detail`.
Per un database su un’istanza database autonoma, per la riattivazione è possibile utilizzare la stored procedure `rdsadmin.reactivate_database`. Oppure, se hai già chiamato la stored procedure [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database), puoi invece chiamare la stored procedure [rdsadmin.activate\$1database](#db2-sp-activate-database).
Per un database su un’istanza database di origine di replica, per la riattivazione è necessario utilizzare la stored procedure `rdsadmin.reactivate_database`.
Per informazioni su come verificare lo stato della riattivazione di un database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante la chiamata di `rdsadmin.reactivate_database`, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
Nell’esempio seguente viene riattivato un database denominato `TESTDB`.
```
db2 "call rdsadmin.reactivate_database(?, 'TESTDB')"
```
## rdsadmin.drop\$1database
Rimuovi un database.
### Sintassi
```
db2 "call rdsadmin.drop_database('database_name')"
```
### Parameters
Il parametro seguente è obbligatorio:
*database\$1name*
Nome del database da rimuovere. Il tipo di dati è `varchar`.
### Note per l’utilizzo
È possibile eliminare un database chiamando `rdsadmin.drop_database` solo se sono soddisfatte le seguenti condizioni:
+ Non hai specificato il nome del database quando hai creato l’istanza database RDS per Db2 utilizzando la console Amazon RDS o la AWS CLI. Per ulteriori informazioni, consulta [Creazione di un'istanza database](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
+ Hai creato il database chiamando la stored procedure [rdsadmin.create\$1database](#db2-sp-create-database).
+ Hai ripristinato il database da un’immagine offline o di cui è stato eseguito il backup chiamando la stored procedure [rdsadmin.restore\$1database](#db2-sp-restore-database).
Prima di chiamare `rdsadmin.drop_database`, è necessario connettersi al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le informazioni sull'istanza DB RDS for Db2:
```
db2 connect to rdsadmin user master_username using master_password
```
Per informazioni su come verificare lo stato dell’eliminazione di un database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante la chiamata di `rdsadmin.drop_database`, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
Nell’esempio seguente viene rimosso un database denominato `TESTDB`.
```
db2 "call rdsadmin.drop_database('TESTDB')"
```
## rdsadmin.update\$1db\$1param
Aggiorna i parametri del database.
### Sintassi
```
db2 "call rdsadmin.update_db_param(
'database_name',
'parameter_to_modify',
'changed_value',
'restart_database')"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database per cui eseguire l’attività. Il tipo di dati è `varchar`.
*parameter\$1to\$1modify*
Il nome del parametro da modificare. Il tipo di dati è `varchar`. Per ulteriori informazioni, consulta [Parametri di Amazon RDS per Db2](db2-supported-parameters.md).
*changed\$1value*
Il valore in cui modificare il valore del parametro. Il tipo di dati è `varchar`.
Il parametro seguente è facoltativo:
*restart\$1database*
Specifica se RDS riavvia il database in caso fosse necessario un riavvio. Il tipo di dati è `varchar`. Per modificare `logprimary` e `logfilsiz`, imposta questo parametro su `'YES'`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato dell’aggiornamento dei parametri del database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante la chiamata di `rdsadmin.update_db_param`, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
**Esempio 1: aggiornamento di un parametro**
Nell’esempio seguente il parametro `archretrydelay` viene aggiornato a `100` per un database chiamato `TESTDB`:
```
db2 "call rdsadmin.update_db_param(
'TESTDB',
'archretrydelay',
'100')"
```
**Esempio 2: rinvio della convalida degli oggetti**
Nell’esempio seguente viene posticipata la convalida degli oggetti creati su un database denominato `TESTDB` per evitare il controllo delle dipendenze:
```
db2 "call rdsadmin.update_db_param(
'TESTDB',
'auto_reval',
'deferred_force')"
```
## rdsadmin.set\$1configuration
Configura impostazioni specifiche per il database.
### Sintassi
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
### Parameters
I parametri seguenti sono obbligatori:
*name*
Il nome dell’impostazione di configurazione. Il tipo di dati è `varchar`.
*value*
Il valore dell’impostazione di configurazione. Il tipo di dati è `varchar`.
### Note per l’utilizzo
La tabella riportata di seguito mostra le impostazioni di configurazione che è possibile controllare con `rdsadmin.set_configuration`.
| Nome | Description |
| --- | --- |
| `RESTORE_DATABASE_NUM_BUFFERS` | Il numero di buffer da creare durante un’operazione di ripristino. Questo valore deve essere inferiore alla dimensione totale della memoria della classe dell’istanza database. Se questa impostazione non è configurata, Db2 determina il valore da utilizzare durante l’operazione di ripristino. Per ulteriori informazioni, vedete il [comando RESTORE DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-database) nella IBM Db2 documentazione. |
| `RESTORE_DATABASE_PARALLELISM` | Il numero di manipolatori di buffer da creare durante un’operazione di ripristino. Questo valore deve essere inferiore al doppio del numero di v CPUs per l'istanza DB. Se questa impostazione non è configurata, Db2 determina il valore da utilizzare durante l’operazione di ripristino. Per ulteriori informazioni, vedete [il comando RESTORE DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-database) nella IBM Db2 documentazione. |
| `RESTORE_DATABASE_NUM_MULTI_PATHS` | Il numero di percorsi (o I/O stream) da utilizzare durante un ripristino da un'operazione di Amazon S3. Per utilizzare questa impostazione di configurazione, è necessario disporre di più file di backup. Questo valore può migliorare le prestazioni durante il ripristino di database con grandi volumi di dati perché ripristina più file di backup del database in parallelo. Si consiglia di impostare questo valore in modo che corrisponda al numero dei file di backup del database. Per ulteriori informazioni, vedere il [comando BACKUP DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-backup-database) nella IBM Db2 documentazione. |
| `USE_STREAMING_RESTORE` | Speciifica se eseguire lo streaming dei dati di backup direttamente durante il ripristino anziché scaricare prima l'intero backup sull'istanza DB RDS for Db2 e poi estrarlo. L'impostazione `USE_STREAMING_RESTORE` su riduce `TRUE` in modo significativo i requisiti di archiviazione e può migliorare le prestazioni di ripristino. Questa impostazione richiede la versione 11.5.9.0.sb00063198.r1 o successiva del motore IBM Db2 e la connettività Amazon S3 tramite l'elastic network interface (ENI) del database. Per ulteriori [informazioni](https://www.ibm.com/docs/en/db2/11.5.x?topic=databases-remote-storage), consulta IBM Db2 Storage remoto nella documentazione. |
### Esempi
**Esempio 1: Specificazione del numero di buffer da creare**
Nell’esempio seguente, la configurazione `RESTORE_DATABASE_NUM_BUFFERS` viene impostata su `150`.
```
db2 "call rdsadmin.set_configuration(
'RESTORE_DATABASE_NUM_BUFFERS',
'150')"
```
**Esempio 2: Specificazione del numero di manipolatori di buffer da creare**
Nell’esempio seguente, la configurazione `RESTORE_DATABASE_PARALLELISM` viene impostata su `8`.
```
db2 "call rdsadmin.set_configuration(
'RESTORE_DATABASE_PARALLELISM',
'8')"
```
**Esempio 3: Specificazione del numero di percorsi o I/O stream da utilizzare durante il ripristino**
Nell’esempio seguente, la configurazione `RESTORE_DATABASE_NUM_MULTI_PATHS` viene impostata su `5`.
```
db2 "call rdsadmin.set_configuration(
'RESTORE_DATABASE_NUM_MULTI_PATHS',
'5')"
```
**Esempio 4: impostazione del ripristino per lo streaming dei dati di backup**
Nell’esempio seguente, la configurazione `USE_STREAMING_RESTORE` viene impostata su `TRUE`.
```
db2 "call rdsadmin.set_configuration(
'USE_STREAMING_RESTORE',
'TRUE')"
```
## rdsadmin.show\$1configuration
Restituisce le impostazioni correnti che è possibile definire utilizzando la stored procedure `rdsadmin.set_configuration`.
### Sintassi
```
db2 "call rdsadmin.show_configuration(
'name')"
```
### Parameters
Il parametro seguente è facoltativo:
*name*
Il nome dell’impostazione di configurazione per cui restituire informazioni. Il tipo di dati è `varchar`.
Le opzioni di configurazione valide sono:
+ `RESTORE_DATABASE_NUM_BUFFERS`— Il numero di buffer da creare durante un'operazione di ripristino.
+ `RESTORE_DATABASE_PARALLELISM`— Il numero di manipolatori di buffer da creare durante un'operazione di ripristino.
+ `RESTORE_DATABASE_NUM_MULTI_PATHS`— Il numero di percorsi (o I/O stream) da utilizzare durante un ripristino da un'operazione di ripristino da Amazon S3.
+ `USE_STREAMING_RESTORE`— Speciifica se eseguire lo streaming dei dati di backup direttamente durante il ripristino anziché scaricare prima tutti i dati di backup sull'istanza DB RDS for Db2 e poi estrarli.
### Note per l’utilizzo
Se non si specifica il nome di un’impostazione di configurazione, `rdsadmin.show_configuration` restituisce informazioni per tutte le impostazioni di configurazione che è possibile definire utilizzando la stored procedure `rdsadmin.set_configuration`.
### Esempi
Nell’esempio seguente vengono restituite informazioni sulla configurazione `RESTORE_DATABASE_PARALLELISM` corrente.
```
db2 "call rdsadmin.show_configuration(
'RESTORE_DATABASE_PARALLELISM')"
```
## rdsadmin.backup\$1database
Esegue il backup di un database da un'istanza DB RDS for Db2 su un bucket Amazon S3.
### Sintassi
```
db2 "call rdsadmin.backup_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
'backup_type',
'compression_option',
'util_impact_priority',
'num_files',
'parallelism',
'num_buffers')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database di destinazione su un'istanza DB RDS for Db2 di cui eseguire il backup. Il tipo di dati è `varchar`.
Il database deve esistere nell'istanza DB. Non è possibile eseguire il backup del `rdsadmin` database.
*s3\$1bucket\$1name*
Il nome del bucket Amazon S3 in cui desideri che risieda il backup. Il tipo di dati è `varchar`.
Il bucket S3 deve esistere prima della chiamata`rdsadmin.backup_database`, trovarsi nello stesso database di destinazione nell'istanza DB RDS for Db2 di cui desideri eseguire il backup ed essere accessibile tramite il Regione AWS ruolo IAM collegato all'istanza DB.
*s3\$1prefix*
Il prefisso del percorso verso Amazon S3 in cui RDS per Db2 carica i file di backup. Il tipo di dati è `varchar`.
Il prefisso è limitato a 1024 caratteri. Non deve includere una barra iniziale o finale (/). A causa di una limitazione IBM dello streaming su Amazon S3, consigliamo che il prefisso includa le sottodirectory.
Per una migliore gestione dei file, RDS for Db2 crea directory aggiuntive in seguito. *s3\$1prefix* RDS for Db2 carica tutti i file di backup su. *s3\$1prefix/dbi\$1resource\$1id/db\$1name* Se si imposta un *num\$1files* valore superiore a`1`, la *db\$1name* directory conterrà più di un file di backup.
Di seguito è riportato un esempio di posizione Amazon S3 per i file di backup. Nell'esempio, `backups/daily` è il valore impostato per il *s3\$1prefix* parametro.
```
backups/daily/db-5N7FXOY4GDP7RG2NSH2ZTAI2W4/SAMPLEDB
```
*backup\$1type*
Il tipo di backup che determina se il database rimane disponibile durante il backup. Il tipo di dati è `varchar`.
Valori validi:
+ `OFFLINE`— Il database non è disponibile durante il backup. Questo tipo è più veloce, ma causa tempi di inattività.
+ `ONLINE`— Il database rimane disponibile durante il backup. Per impostazione predefinita, `ONLINE` è impostato su `INCLUDE LOGS`.
I parametri seguenti sono facoltativi:
*compression\$1option*
Il tipo di algoritmo di compressione utilizzato che influisce sui tempi di backup, sull'utilizzo della CPU e sui costi di archiviazione. Il tipo di dati è `varchar`. Il valore predefinito è `NONE`.
Valori validi:
+ `NONE`— La dimensione del file più grande, il minor utilizzo della CPU e i costi di archiviazione più bassi.
+ `STANDARD`— Compressione Db2 standard. Usi`libdb2compr.so`.
+ `ZLIB`— Compressione Db2 migliorata. Utilizza`libdb2zcompr.so`, ma richiede un uso più intensivo della CPU e il costo di archiviazione più costoso.
*util\$1impact\$1priority*
L'impostazione che controlla l'impatto del backup sulle risorse di sistema. Il tipo di dati è `integer`. Valori validi: `1` — `100` (dal più basso al più alto). Il valore predefinito è `50`.
Valori inferiori riducono l'impatto del backup sulle risorse di sistema, ma possono aumentare il tempo necessario per eseguire il backup del database. Valori più elevati potrebbero completare il backup del database più rapidamente, ma potrebbero influire su altre operazioni. L'impatto effettivo dipende dall'utilizzo complessivo del sistema e dall'`util_impact_lim`impostazione. È possibile visualizzare e modificare l'`util_impact_lim`impostazione in gruppi di parametri. Per ulteriori informazioni, consulta [Parametri di Amazon RDS per Db2](db2-supported-parameters.md).
*num\$1files*
Il numero di flussi di caricamento paralleli su Amazon S3. Il tipo di dati è `integer`. Valori validi: `1`-`256`.
Ti consigliamo di impostare questo parametro solo dopo aver osservato le prestazioni di backup predefinite calcolate automaticamente da Amazon RDS. Valori più alti potrebbero migliorare le prestazioni per i backup di grandi dimensioni, in particolare con connessioni a larghezza di banda elevata, ma a un certo punto, valori più alti peggiorano le prestazioni. Inoltre, assicurati di tenere conto delle risorse di sistema disponibili e della capacità di rete.
*parallelism*
Il numero di tablespace che l'utilità di backup può leggere in parallelo. Il tipo di dati è `integer`. Valori validi: `1`-`256`.
Si consiglia di impostare questo parametro solo dopo aver osservato le prestazioni di backup al valore predefinito che il motore Db2 calcola automaticamente come valore ottimale. Se imposti questo parametro, Amazon RDS esegue la convalida rispetto ai processori disponibili e non eseguirà la richiesta di backup se la potenza di elaborazione è insufficiente.
*num\$1buffers*
Il numero di buffer da utilizzare. Il tipo di dati è `integer`. Valori validi: `1`-`268435456`.
Ti consigliamo di impostare questo parametro solo dopo aver osservato le prestazioni di backup predefinite che Amazon RDS calcola automaticamente in base alla memoria. Se imposti questo parametro, Amazon RDS esegue la convalida in base alla memoria disponibile e non eseguirà la richiesta di backup se la memoria disponibile è insufficiente. Se esegui il backup su più posizioni (`num_files`è impostato su più di`1`), un numero maggiore di buffer potrebbe migliorare le prestazioni. Se non lo `compression_option` imposti`NONE`, puoi migliorare le prestazioni aumentando `num_buffers` e. `parallelism`
### Note per l’utilizzo
Questa procedura memorizzata crea attività di backup asincrone che trasmettono il backup del database direttamente al bucket Amazon S3 utilizzando l'integrazione Amazon S3. Puoi eseguire backup sia dal tuo server locale che da un'istanza DB RDS per Db2, trasmetterli in streaming su Amazon S3 e ripristinarli dove vuoi. Per informazioni sul ripristino di un database su un'istanza DB RDS for Db2, consulta. [rdsadmin.restore\$1database](#db2-sp-restore-database)
Prima di chiamare la stored procedure, esamina le seguenti considerazioni:
+ È possibile eseguire il backup di un solo database alla volta.
+ Non è possibile eseguire un backup e un ripristino contemporaneamente su un'istanza DB.
+ La crittografia lato server di Amazon S3 con AWS KMS (SSE-KMS) non è supportata. Anche se il bucket S3 è impostato su SSE-KMS, i file caricati nel bucket S3 non utilizzeranno la crittografia SSE-KMS.
+ Per eseguire lo streaming dei file di backup su Amazon S3, devi aver già configurato l'integrazione. Per ulteriori informazioni, consulta [Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3](db2-s3-integration.md).
+ Affinché un'istanza DB RDS for Db2 sia in grado di interagire con Amazon S3, è necessario disporre di un VPC e di un endpoint gateway Amazon S3 per l'utilizzo di sottoreti private. Per ulteriori informazioni, consultare [Fase 1: creare un endpoint gateway VPC per Amazon S3](db2-troubleshooting.md#db2-creating-endpoint) e [Fase 2: verificare l’esistenza dell’endpoint gateway VPC per Amazon S3](db2-troubleshooting.md#db2-confirming-endpoint).
Prima di chiamare `rdsadmin.backup_database`, è necessario connettersi al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le informazioni sull'istanza DB RDS for Db2:
```
db2 connect to rdsadmin user master_username using master_password
```
Dopo aver eseguito il backup del database, assicuratevi di terminare la connessione.
```
terminate
```
Per informazioni sulla verifica dello stato del backup di un database, consulta. [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)
Per i messaggi di errore restituiti durante la chiamata di `rdsadmin.backup_database`, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
Tutti gli esempi eseguono il backup di un database chiamato `MYDB` nel bucket Amazon S3 chiamato `amzn-s3-demo-bucket` e impostato su. *s3\$1prefix* `backups/daily`
**Esempio \$11: Specificazione del database offline e non disponibile con utilizzo medio e un singolo flusso di caricamento**
Nell'esempio seguente, il database è offline, il che è più veloce ma significa che il database non è disponibile durante il backup. L'esempio non esegue alcuna compressione dei file, ha un impatto mediano sulle risorse di sistema e utilizza un singolo flusso di caricamento su Amazon S3.
```
db2 call "rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE',
'NONE',
50,
1)"
```
**Esempio \$12: Specificazione del database online e disponibile con compressione avanzata, utilizzo mediano e pochi flussi di caricamento paralleli**
Nell'esempio seguente, il database è online e disponibile durante il backup. L'esempio esegue una compressione avanzata, che si traduce in file di dimensioni ridotte, ma richiede un uso intensivo della CPU. Ha un impatto leggermente superiore alla media sulle risorse di sistema e utilizza cinque flussi di caricamento su Amazon S3.
```
db2 call "rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'ONLINE',
'ZLIB',
60,
5)"
```
**Esempio \$13: Specificazione del database offline e non disponibile con impostazioni predefinite e calcoli di sistema**
Nell'esempio seguente, il database è offline, il che è più veloce ma significa che il database non è disponibile durante il backup. L'esempio utilizza la compressione predefinita dei file e l'impatto sulle risorse di sistema. Consente inoltre a RDS for Db2 di calcolare il numero di flussi di caricamento paralleli su Amazon S3, i tablespace da leggere in parallelo e i buffer da utilizzare.
```
db2 "call rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE')"
```
**Esempio \$14: Specificazione del database offline e non disponibile senza compressione, utilizzo elevato e calcoli personalizzati**
Nell'esempio seguente, il database è offline, il che è più veloce ma significa che il database non è disponibile durante il backup. L'esempio non esegue alcuna compressione dei file, ha un impatto elevato sulle risorse di sistema e utilizza 20 flussi di caricamento su Amazon S3. Imposta il numero massimo di tablespace da leggere in parallelo, il che può causare il fallimento della richiesta di backup se la potenza di elaborazione è insufficiente. Imposta inoltre il numero massimo di buffer da utilizzare, il che può causare il fallimento della richiesta di backup se la memoria è insufficiente.
```
db2 "call rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE',
'NONE',
90,
20,
256,
268435456)"
```
## rdsadmin.restore\$1database
Ripristina un database da un bucket Amazon S3 su un’istanza database RDS per Db2.
### Sintassi
```
db2 "call rdsadmin.restore_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
restore_timestamp,
'backup_type')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database di destinazione da ripristinare in RDS per Db2. Il tipo di dati è `varchar`.
Ad esempio, se il nome del database di origine era `TESTDB` impostato *database\$1name* su`NEWDB`, Amazon RDS esegue il ripristino `NEWDB` come database di origine.
*s3\$1bucket\$1name*
Il nome del bucket Amazon S3 in cui risiede il backup. Il tipo di dati è `varchar`.
*s3\$1prefix*
Il prefisso da utilizzare per la corrispondenza dei file durante il download. Il tipo di dati è `varchar`.
Se questo parametro è vuoto, verranno elaborati tutti i file nel bucket Amazon S3. Di seguito è riportato un prefisso di esempio.
```
backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101
```
*restore\$1timestamp*
Il timestamp dell’immagine di backup del database. Il tipo di dati è `varchar`.
Il timestamp è incluso nel nome del file di backup. Ad esempio, `20230615010101` è il timestamp del nome file `SAMPLE.0.rdsdb.DBPART000.20230615010101.001`.
*backup\$1type*
Il tipo di backup. Il tipo di dati è `varchar`. Valori validi: `OFFLINE`, `ONLINE`.
Utilizza `ONLINE` per migrazioni con tempo di inattività prossimo allo zero. Per ulteriori informazioni, consulta [Migrazione da Linux a Linux con tempo di inattività quasi nullo per Amazon RDS per Db2](db2-near-zero-downtime-migration.md).
### Note per l’utilizzo
È possibile utilizzare questa stored procedure per eseguire la migrazione di un’istanza database Db2 a un’istanza database RDS per Db2. Per ulteriori informazioni, consulta [Utilizzo dei servizi AWS per migrare i dati da Db2 ad Amazon RDS per Db2](db2-migration-approaches.md). È inoltre possibile utilizzare questa stored procedure per creare più copie dello stesso database con nomi di database diversi che utilizzano la stessa immagine di ripristino.
Prima di chiamare la stored procedure, esamina le seguenti considerazioni:
+ Prima di ripristinare un database, è necessario fornire uno spazio di archiviazione per l'istanza DB RDS for Db2 superiore a quello del database Db2 originale su disco. Se l'opzione è abilitata`USE_STREAMING_RESTORE`, quando ripristini il backup, Amazon RDS trasmette i file di backup direttamente dal bucket S3 all'istanza DB RDS for Db2. Se non lo abiliti`USE_STREAMING_RESTORE`, devi fornire uno spazio di archiviazione per l'istanza DB RDS for Db2 uguale o superiore alla somma delle dimensioni del backup più il database Db2 originale su disco. Per ulteriori informazioni, consulta [Insufficient disk space](db2-troubleshooting.md#restore-database-sp-insufficient-disk-space).
+ Quando ripristini il backup, Amazon RDS estrae il file di backup sulla tua istanza database RDS per Db2. Ogni file di backup deve avere una dimensione pari o inferiore a 5 TB. Se un file di backup supera i 5 TB, devi dividerlo in file più piccoli.
+ Per ripristinare tutti i file utilizzando la stored procedure `rdsadmin.restore_database`, non includere nei nomi dei file il suffisso numerico del file dopo il timestamp. Ad esempio, *s3\$1prefix* `backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101` ripristina i seguenti file:
```
SAMPLE.0.rdsdb.DBPART000.20230615010101.001
SAMPLE.0.rdsdb.DBPART000.20230615010101.002
SAMPLE.0.rdsdb.DBPART000.20230615010101.003
SAMPLE.0.rdsdb.DBPART000.20230615010101.004
SAMPLE.0.rdsdb.DBPART000.20230615010101.005
```
+ RDS per Db2 non supporta l’archiviazione non automatica. Per ulteriori informazioni, consulta [Tablespaces not restored](db2-troubleshooting.md#restore-database-sp-tablespaces-not-restored).
+ RDS per Db2 non supporta routine non recintate. Per ulteriori informazioni, consulta [Non-fenced routines not allowed](db2-troubleshooting.md#restore-database-sp-non-fenced-routines).
+ Per migliorare le prestazioni delle operazioni di ripristino del database, è possibile configurare il numero di buffer, di manipolatori di buffer e il numero di percorsi di backup multipli da utilizzare con RDS. Per ottimizzare l'utilizzo dello storage e migliorare potenzialmente le prestazioni, puoi anche eseguire lo streaming diretto di un backup da Amazon S3. Per controllare la configurazione corrente, utilizza [rdsadmin.show\$1configuration](#db2-sp-show-configuration). Per modificare la configurazione, utilizza [rdsadmin.set\$1configuration](#db2-sp-set-configuration).
Per portare il database online e applicare log delle transazioni aggiuntivi dopo il ripristino del database, consulta [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database).
Per informazioni su come verificare lo stato del ripristino del database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante la chiamata di `rdsadmin.restore_database`, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
L'esempio seguente ripristina un backup offline con un singolo file o più file con: *s3\$1prefix* `backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101`
```
db2 "call rdsadmin.restore_database(
?,
'SAMPLE',
'amzn-s3-demo-bucket',
'backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101',
20230615010101,
'OFFLINE')"
```
## rdsadmin.rollforward\$1database
Porta il database online e applica log delle transazioni aggiuntivi dopo aver ripristinato un database chiamando [rdsadmin.restore\$1database](#db2-sp-restore-database).
### Sintassi
```
db2 "call rdsadmin.rollforward_database(
?,
'database_name',
's3_bucket_name',
s3_prefix,
'rollforward_to_option',
'complete_rollforward')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui eseguire l’operazione. Il tipo di dati è `varchar`.
*s3\$1bucket\$1name*
Il nome del bucket Amazon S3 in cui risiede il backup. Il tipo di dati è `varchar`.
*s3\$1prefix*
Il prefisso da utilizzare per la corrispondenza dei file durante il download. Il tipo di dati è `varchar`.
Se questo parametro è vuoto, tutti i file verranno scaricati nel bucket S3. Di seguito è riportato un prefisso di esempio.
```
backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101
```
I parametri seguenti sono facoltativi:
*rollforward\$1to\$1option*
Il punto verso cui vuoi effettuare il roll forward. Il tipo di dati è `varchar`. Valori validi: `END_OF_LOGS`, `END_OF_BACKUP` con il timestamp nel formato `YYYY-MM-DD-HH.MM.SS`. Il valore predefinito è `END_OF_LOGS`.
*complete\$1rollforward*
Specifica se completare il processo di roll-forward. Il tipo di dati è `varchar`. Il valore predefinito è `TRUE`.
Se `TRUE`, dopo il completamento il database è online e accessibile. Se `FALSE`, allora il database rimane in uno stato `ROLL-FORWARD PENDING`.
### Note per l’utilizzo
È possibile utilizzare `rds.rollforward_database` per un backup online che includa i log prodotti on-premises in molti scenari diversi.
**Scenario 1: ripristino del database, roll forward dei log inclusi e messa online del database**
Al termine di `rdsadmin.restore_database()`, utilizza la sintassi indicata nell’[Esempio 1](#db2-sp-rollforward-database-examples) per portare online il database con i log delle transazioni.
**Scenario 2: messa online del database senza roll forward dei log inclusi.**
Al termine di `rdsadmin.restore_database()`, utilizza la sintassi indicata nell’[Esempio 2](#db2-sp-rollforward-database-examples) per portare online il database senza i log delle transazioni.
**Scenario 3: roll forward dei log inclusi nel backup e applicazione di log delle transazioni aggiuntivi man mano che vengono prodotti on-premises**
Al termine del `rdsadmin.restore_database()`, utilizza la sintassi indicata nell’[Esempio 3 o Esempio 4](#db2-sp-rollforward-database-examples) per effettuare il roll forward dei log senza portare online il database.
Se imposti `complete_rollforward` su `FALSE`, il database è in uno stato `ROLL-FORWARD PENDING` e offline. Per portare il database online, devi chiamare [rdsadmin.complete\$1rollforward](#db2-sp-complete-rollforward).
Per informazioni su come verificare lo stato del roll-forward del database, consulta [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status).
### Esempi
**Esempio 1: messa online del database con i log delle transazioni**
Nell’esempio seguente viene effettuato il roll forward a un backup online del database con i log delle transazioni con successiva messa online del database:
```
db2 "call rdsadmin.rollforward_database(
?,
null,
null,
'END_OF_LOGS',
'TRUE')"
```
**Esempio 2: messa online del database senza i log delle transazioni**
Nell’esempio seguente viene effettuato il roll forward a un backup online del database senza i log delle transazioni con successiva messa online del database:
```
db2 "call rdsadmin.rollforward_database(
?,
'TESTDB',
'amzn-s3-demo-bucket',
'logsfolder/,
'END_OF_BACKUP',
'TRUE')"
```
**Esempio 3: messa online del database con i log delle transazioni non eseguita**
Nell’esempio seguente viene effettuato il roll forward a un backup online del database con i log delle transazioni senza successiva messa online del database:
```
db2 "call rdsadmin.rollforward_database(
?,
'TESTDB',
null,
'onlinebackup/TESTDB',
'END_OF_LOGS',
'FALSE')"
```
**Esempio 4: messa online del database con log delle transazioni aggiuntivi non eseguita**
Nell’esempio seguente viene effettuato il roll forward a un backup online del database con i log delle transazioni aggiuntivi senza successiva messa online del database:
```
db2 "call rdsadmin.rollforward_database(
?,
'TESTDB',
'amzn-s3-demo-bucket',
'logsfolder/S0000155.LOG',
'END_OF_LOGS',
'FALSE')"
```
## rdsadmin.rollforward\$1status
Restituisce l’output di `ROLLFORWARD DATABASE database_name QUERY STATUS`.
### Sintassi
```
db2 "call rdsadmin.rollforward_status(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database su cui eseguire l’operazione. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Dopo aver chiamato [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database), puoi chiamare `rdsadmin.rollforward_status` per verificare lo stato del roll forward nel database.
Per informazioni su come verificare lo stato di questa stored procedure, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## rdsadmin.complete\$1rollforward
Porta il database online da uno stato `ROLL-FORWARD PENDING`.
### Sintassi
```
db2 "call rdsadmin.complete_rollforward(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database che desideri portare online. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Se hai chiamato [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database) con `complete_rollforward` impostato su `FALSE`, il tuo database è in uno stato `ROLL-FORWARD PENDING` e offline. Per completare il roll forward e portare il database online, chiama `rdsadmin.complete_rollforward`.
Per informazioni su come verificare lo stato del completamento del processo di roll-forward, consulta [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status).
### Esempi
Nell’esempio seguente il database TESTDB viene portato online:
```
db2 "call rdsadmin.complete_rollforward(
?,
'TESTDB')"
```
## rdsadmin.db2pd\$1command
Raccoglie informazioni su un database RDS per Db2.
### Sintassi
```
db2 "call rdsadmin.db2pd_command('db2pd_cmd')"
```
### Parameters
Il parametro di input seguente è obbligatorio:
*db2pd\$1cmd*
Il nome del comando `db2pd` che desideri eseguire. Il tipo di dati è `varchar`.
Il parametro deve iniziare con un trattino. Per un elenco di parametri, consulta [db2pd - Monitor and troubleshoot Db2 database command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2pd-monitor-troubleshoot-db2-engine-activities) nella documentazione di IBM Db2.
Le seguenti opzioni non sono supportate:
+ `-addnode`
+ `-alldatabases`
+ `-alldbp`
+ `-alldbs`
+ `-allmembers`
+ `-alm_in_memory`
+ `-cfinfo`
+ `-cfpool`
+ `-command`
+ `-dbpartitionnum`
+ `-debug`
+ `-dump`
+ `-everything`
+ `-file | -o`
+ `-ha`
+ `-interactive`
+ `-member`
+ `-pages`
**Nota**
`-pages summary` è supportato.
+ `-pdcollection`
+ `-repeat`
+ `-stack`
+ `-totalmem`
L’opzione secondaria `file` non è supportata, ad esempio `db2pd -db testdb -tcbstats file=tcbstat.out`.
L’utilizzo dell’opzione `stacks` non è supportato, ad esempio `db2pd -edus interval=5 top=10 stacks`.
### Note per l’utilizzo
Questa stored procedure raccoglie informazioni che possono contribuire al monitoraggio e alla risoluzione dei problemi dei database RDS per Db2.
La stored procedure ricorre all’utility IBM `db2pd` per eseguire vari comandi. L’utility `db2pd` richiede l’autorizzazione `SYSADM`, di cui l’utente master RDS per Db2 non dispone. Tuttavia, con la stored procedure di Amazon RDS, l’utente master è in grado di ricorrere all’utility per eseguire vari comandi. Per ulteriori informazioni sull’utility, consulta [db2pd - Monitor and troubleshoot Db2 database command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2pd-monitor-troubleshoot-db2-engine-activities) nella documentazione di IBM Db2.
L’output è limitato a un massimo di 2 GB.
Per informazioni su come verificare lo stato della raccolta delle informazioni sul database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: restituzione del tempo di attività dell’istanza database**
Nell’esempio seguente viene restituito il tempo di attività di un’istanza database RDS per Db2:
```
db2 "call rdsadmin.db2pd_command('-')"
```
**Esempio 2: restituzione del tempo di attività del database**
Nell’esempio seguente viene restituito il tempo di attività di un database denominato `TESTDB`:
```
db2 "call rdsadmin.db2pd_command('-db TESTDB -')"
```
**Esempio 3: restituzione dell’utilizzo della memoria di un’istanza database**
Nell’esempio seguente viene restituito l’utilizzo della memoria di un’istanza database RDS per Db2:
```
db2 "call rdsadmin.db2pd_command('-dbptnmem')"
```
**Esempio 4: restituzione di set di memoria dell’istanza database e del database**
Nell’esempio seguente vengono restituiti i set di memoria di un’istanza database RDS per Db2 e di un database denominato `TESTDB`:
```
db2 "call rdsadmin.db2pd_command('-inst -db TESTDB -memsets')"
```
## rdsadmin.force\$1application
Forza la disconnessione delle applicazioni da un database RDS per Db2.
### Sintassi
```
db2 "call rdsadmin.force_application(
?,
'applications')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*applications*
Le applicazioni che desideri disconnettere da un database RDS per Db2. Il tipo di dati è `varchar`. Valori validi: `ALL` o *application\$1handle*.
Separa i nomi di più applicazioni con virgole. Esempio: '*application\$1handle\$11*,*application\$1handle\$12*'.
### Note per l’utilizzo
Questa stored procedure forza la disconnessione tutte le applicazioni da un database in modo da poter eseguire la manutenzione.
La stored procedure utilizza il comando IBM `FORCE APPLICATION`. Il comando `FORCE APPLICATION` richiede l’autorizzazione `SYSADM`, `SYSMAINT` o `SYSCTRL`, di cui l’utente master RDS per Db2 non dispone. Tuttavia, con la stored procedure di Amazon RDS, l’utente master è in grado di utilizzare il comando. Per ulteriori informazioni, consulta [FORCE APPLICATION command](https://www.ibm.com/docs/en/db2/11.1?topic=commands-force-application) nella documentazione di IBM Db2.
Per informazioni sulla verifica dello stato dell’esclusione di applicazioni da un database, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: specifica di tutte le applicazioni**
Nell’esempio seguente viene forzata la disconnessione di tutte le applicazioni da un database RDS per Db2:
```
db2 "call rdsadmin.force_application(
?,
'ALL')"
```
**Esempio 2: specificazione di più applicazioni**
Nell’esempio seguente viene forzata la disconnessione degli handle `9991`, `8891` e `1192` da un database RDS per Db2:
```
db2 "call rdsadmin.force_application(
?,
'9991, 8891, 1192')"
```
## rdsadmin.set\$1archive\$1log\$1retention
Configura la quantità di tempo (in ore) della conservazione dei file di log archiviati per il database RDS per Db2 specificato.
### Sintassi
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'database_name',
'archive_log_retention_hours')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database per cui configurare la conservazione dei log archiviati. Il tipo di dati è `varchar`.
*archive\$1log\$1retention\$1hours*
Il numero di ore della conservazione dei file di log archiviati. Il tipo di dati è `smallint`. L'impostazione predefinita è `0` e il massimo è `840` (35 giorni).
Se il valore è `0`, Amazon RDS non conserva i file di log archiviati.
### Note per l’utilizzo
Per impostazione predefinita, RDS per Db2 conserva i log per 5 minuti. Si consiglia di utilizzare strumenti di replica come AWS DMS CDC (Change Data Capture) o IBM Q Replication di impostare la conservazione dei log in tali strumenti per più di 5 minuti.
Per visualizzare l’impostazione corrente di conservazione dei log archiviati, chiama [rdsadmin.show\$1archive\$1log\$1retention](#db2-sp-show-archive-log-retention).
Non è possibile configurare l’impostazione di conservazione dei log archiviati nel database `rdsadmin`.
### Esempi
**Esempio 1: impostazione del tempo di conservazione**
Nell’esempio seguente, il tempo di conservazione dei log archiviati per un database denominato `TESTDB` viene impostato su 24 ore.
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'TESTDB',
'24')"
```
**Esempio 2: disabilitazione del tempo di conservazione**
Nell’esempio seguente, il tempo di conservazione dei log archiviati per un database denominato `TESTDB` viene disabilitato.
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'TESTDB',
'0')"
```
## rdsadmin.show\$1archive\$1log\$1retention
Restituisce l’impostazione corrente di conservazione dei log archiviati per il database specificato.
### Sintassi
```
db2 "call rdsadmin.show_archive_log_retention(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database di cui visualizzare l’impostazione di conservazione dei log archiviati. Il tipo di dati è `varchar`.
### Esempi
Nell’esempio seguente viene mostrata l’impostazione del tempo di conservazione dei log archiviati per un database denominato `TESTDB`.
```
db2 "call rdsadmin.show_archive_log_retention(?,'TESTDB')"
```
## rdsadmin.list\$1archive\$1log\$1information
Restituisce dettagli sui file di log archiviati, come la dimensione, la data e l’ora di creazione e il nome dei singoli file di log, per il database specificato. Restituisce inoltre la quantità totale di archiviazione utilizzata dai file di log nel database.
### Sintassi
```
db2 "call rdsadmin.list_archive_log_information(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database di cui visualizzare le informazioni relative ai log archiviati. Il tipo di dati è `varchar`.
### Esempi
Nell’esempio seguente vengono restituite le informazioni relative ai log archiviati per un database denominato `TESTDB`.
```
db2 "call rdsadmin.list_archive_log_information(
?,
'TESTDB')"
```
## rdsadmin.enable\$1archive\$1log\$1copy
Abilita la copia del log di archivio del database RDS Db2 su Amazon S3.
### Sintassi
```
db2 "call rdsadmin.enable_archive_log_copy(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database per il quale abilitare la copia dei log di archivio su Amazon S3. Il tipo di dati è `varchar`.
### Esempi
L'esempio seguente abilita la copia del registro di archivio per un database chiamato`TESTDB`.
```
db2 "call rdsadmin.enable_archive_log_copy(
?,
'TESTDB')"
```
## rdsadmin.disable\$1archive\$1log\$1copy
Disattiva la copia del log di archivio del database RDS Db2 su Amazon S3.
### Sintassi
```
db2 "call rdsadmin.disable_archive_log_copy(
?,
'database_name')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
Il parametro di input seguente è obbligatorio:
*database\$1name*
Il nome del database per il quale disabilitare la copia dei log di archivio su Amazon S3. Il tipo di dati è `varchar`.
### Esempi
L'esempio seguente disabilita la copia del registro di archivio per un database chiamato. `TESTDB`
```
db2 "call rdsadmin.disable_archive_log_copy(
?,
'TESTDB')"
```
## rdsadmin.fgac\$1command
Esegue comandi di controllo degli accessi (FGAC) granulari.
### Sintassi
```
db2 "call rdsadmin.fgac_command(
?,
'database_name',
'fgac_cmd')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database su cui si desidera eseguire i comandi FGAC. Il tipo di dati è `varchar`.
*fgac\$1cmd*
Il comando di controllo degli accessi dettagliato che si desidera eseguire. Il tipo di dati è `varchar`.
I seguenti comandi sono validi:
+ `ALTER MASK`— Modifica una maschera di colonna esistente nel controllo dell'accesso a righe e colonne (RCAC).
+ `ALTER PERMISSION`— Modifica le proprietà di un'autorizzazione di riga esistente in RCAC.
+ `ALTER SECURITY POLICY`— Modifica una politica di sicurezza esistente per RCAC.
+ `ALTER SECURITY LABEL`— Modifica le proprietà di un'etichetta di sicurezza esistente nel controllo degli accessi basato su etichette (LBAC).
+ `ALTER TABLE`— Modifica la struttura della tabella, inclusa l'aggiunta di controlli RCAC o LBAC.
+ `CREATE MASK`— Crea una nuova maschera di colonna per RCAC.
+ `CREATE PERMISSION`— Crea una nuova autorizzazione di riga per RCAC.
+ `CREATE SECURITY LABEL`— Crea una nuova etichetta di sicurezza per LBAC.
+ `CREATE SECURITY POLICY`— Crea una nuova politica di sicurezza per RCAC.
+ `DROP MASK`— Elimina una maschera di colonna esistente.
+ `DROP PERMISSION`— Elimina l'autorizzazione di una riga esistente.
+ `DROP SECURITY LABEL`— Elimina un'etichetta di sicurezza da LBAC.
+ `DROP SECURITY POLICY`— Elimina una politica di sicurezza RCAC esistente.
+ `GRANT EXEMPTION ON RULE`— Consente a un utente di ignorare regole LBAC specifiche.
+ `GRANT SECURITY LABEL`— Assegna un'etichetta di sicurezza LBAC a un utente.
+ `REVOKE EXEMPTION ON RULE`— Rimuove l'esenzione di un utente dalle regole LBAC.
+ `REVOKE SECURITY LABEL`— Rimuove un'etichetta di sicurezza LBAC da un utente.
### Note per l’utilizzo
Questa stored procedure controlla l'accesso a livello di riga o colonna ai dati della tabella nel database su un'istanza DB RDS for Db2. RDS per Db2 supporta due tipi di FGAC sul database:
+ Controllo degli accessi basato su etichette (LBAC)
+ Controllo dell'accesso a righe e colonne (RCAC)
Prima di chiamare la stored procedure, esamina le seguenti considerazioni:
+ Per evitare una virgoletta singola ('), usa una virgoletta singola aggiuntiva. Gli esempi seguenti mostrano come fuggire `'apple'``'banana'`, e`'fruit'`.
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"
```
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITTREE TREE(''fruit'' ROOT, ''apple'' UNDER ''fruit'', ''banana'' UNDER ''fruit'')')"
```
+ Per evitare le parentesi ([]), usate una barra rovesciata (\$1). L'esempio seguente mostra come fuggire. `[''apple'',''banana'']`
```
db2 "call rdsadmin.fgac_command(
?, '
testdb',
'CREATE SECURITY LABEL COMPONENT FRUITARRAY ARRAY\[''apple'',''banana''\]')"
```
### Esempi
Gli esempi seguenti eseguono tutti i comandi FGAC su un database chiamato. `testdb`
**Esempio 1: creazione di una nuova etichetta di sicurezza denominata `FRUITSET`**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"
```
**Esempio 2: creazione di una nuova maschera per la `EMP_ID` colonna che è abilitata quando `EMP_ID` è impostata su meno di tre**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE MASK id_MASK ON EMPLOYEE FOR COLUMN EMP_ID RETURN CASE WHEN (EMP_ID < 3) THEN EMP_ID ELSE NULL END ENABLE')"
```
**Esempio 3: creazione di una nuova maschera per la `DEPARTMENT` colonna che è abilitata quando `SESSION_USER` è impostata su `security_user`**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE MASK DEPARTMENT_MASK ON EMPLOYEE FOR COLUMN DEPARTMENT RETURN CASE WHEN SESSION_USER = ''security_user'' THEN DEPARTMENT ELSE NULL END ENABLE')"
```
**Esempio 4: creazione di una nuova etichetta di sicurezza denominata `treelabel`**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT treelabel TREE(''COMPANY'' ROOT, ''HR'' UNDER ''COMPANY'', ''FINANCE'' UNDER ''COMPANY'', ''IT'' UNDER ''COMPANY'')')"
```
## rdsadmin.db2support\$1command
Raccoglie informazioni diagnostiche su un database RDS for Db2 e le carica in un bucket Amazon S3.
### Sintassi
```
db2 "call rdsadmin.db2support_command(
?,
'database_name',
's3_bucket_name',
's3_prefix')"
```
### Parameters
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo `?`
I parametri di input seguenti sono obbligatori:
*database\$1name*
Il nome del database per cui raccogliere informazioni diagnostiche. Il tipo di dati è `varchar`.
*s3\$1bucket\$1name*
Il nome del bucket Amazon S3 in cui desideri caricare le informazioni diagnostiche. Il tipo di dati è `varchar`.
*s3\$1prefix*
Il prefisso del percorso verso Amazon S3 in cui RDS per Db2 carica i file di diagnostica. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Questa procedura memorizzata raccoglie informazioni diagnostiche che possono aiutare nella risoluzione dei problemi RDS per i database Db2 e carica le informazioni in un bucket Amazon S3.
La procedura memorizzata utilizza l'utilità per raccogliere dati diagnostici. IBM `db2support` Per ulteriori informazioni sull'utilità, vedere [db2support - Comando dello strumento di analisi dei problemi e raccolta dell'ambiente](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2support-problem-analysis-environment-collection-tool) nella IBM Db2 documentazione.
Prima di chiamare la stored procedure, esamina le seguenti considerazioni:
+ Per caricare i file di diagnostica su Amazon S3, devi aver già configurato l'integrazione. Per ulteriori informazioni, consulta [Integrazione di un’istanza database Amazon RDS per Db2 con Amazon S3](db2-s3-integration.md).
+ Affinché un'istanza DB RDS for Db2 sia in grado di interagire con Amazon S3, è necessario disporre di un VPC e di un endpoint gateway Amazon S3 per l'utilizzo di sottoreti private. Per ulteriori informazioni, consultare [Fase 1: creare un endpoint gateway VPC per Amazon S3](db2-troubleshooting.md#db2-creating-endpoint) e [Fase 2: verificare l’esistenza dell’endpoint gateway VPC per Amazon S3](db2-troubleshooting.md#db2-confirming-endpoint).
Prima di chiamare `rdsadmin.db2support_command`, è necessario connettersi al database `rdsadmin`. Nell'esempio seguente, sostituisci *master\$1username* e *master\$1password* con le informazioni sull'istanza DB RDS for Db2:
```
db2 connect to rdsadmin user master_username using master_password
```
Per informazioni sulla verifica dello stato della raccolta delle informazioni diagnostiche, vedere. [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)
### Esempi
**Esempio 1: raccolta di informazioni diagnostiche per un database**
L'esempio seguente raccoglie informazioni diagnostiche per un database chiamato `TESTDB` e le carica nel bucket `amzn-s3-demo-bucket` Amazon S3 chiamato con il prefisso: `diagnostics/testdb`
```
db2 "call rdsadmin.db2support_command(
?,
'TESTDB',
'amzn-s3-demo-bucket',
'diagnostics/testdb')"
```
**Esempio 2: raccolta di informazioni diagnostiche con un prefisso basato sulla data**
L'esempio seguente raccoglie informazioni diagnostiche per un database chiamato `MYDB` e le carica nel bucket Amazon S3 `amzn-s3-demo-bucket` chiamato con un prefisso basato sulla data:
```
db2 "call rdsadmin.db2support_command(
?,
'MYDB',
'amzn-s3-demo-bucket',
'support/2024/01/15')"
```
# Stored procedure per l’accesso all’archiviazione per RDS per Db2
Le stored procedure integrate descritte in questo argomento gestiscono l’accesso all’archiviazione per i database RDS per Db2 che utilizzano Amazon S3 per la migrazione dei dati. Per ulteriori informazioni, consulta [Migrazione dei dati Db2 ad Amazon RDS per Db2 tramite Amazon S3](db2-migration-load-from-s3.md).
Fai riferimento alle seguenti stored procedure integrate per informazioni sulla sintassi, i parametri, le note per l’utilizzo e gli esempi.
**Topics**
+ [rdsadmin.catalog\$1storage\$1access](#db2-sp-catalog-storage-access)
+ [rdsadmin.uncatalog\$1storage\$1access](#db2-sp-uncatalog-storage-access)
## rdsadmin.catalog\$1storage\$1access
Cataloga un alias di archiviazione per l’accesso a un bucket Amazon S3 con file di dati Db2.
### Sintassi
```
db2 "call rdsadmin.catalog_storage_access(
?,
'alias',
's3_bucket_name',
'grantee_type',
'grantee'
)"
```
### Parametri
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Il tipo di dati è `varchar`.
I parametri di input seguenti sono obbligatori:
*alias*
Il nome alias per l’accesso all’archiviazione remota in un bucket Amazon S3. Il tipo di dati è `varchar`.
*s3\$1bucket\$1name*
Il nome del bucket Amazon S3 in cui risiedono i dati. Il tipo di dati è `varchar`.
*grantee\$1type*
Il tipo di assegnatario dell’autorizzazione. Il tipo di dati è `varchar`. Valori validi: `USER`, `GROUP`.
*grantee*
L’utente o il gruppo che riceverà l’autorizzazione. Il tipo di dati è `varchar`.
### Note per l'utilizzo
Amazon RDS include l’alias catalogato nel ruolo IAM aggiunto all’istanza database RDS per Db2. Se rimuovi il ruolo IAM dall’istanza database, Amazon RDS elimina l’alias. Per ulteriori informazioni, consulta [Migrazione dei dati Db2 ad Amazon RDS per Db2 tramite Amazon S3](db2-migration-load-from-s3.md).
Per informazioni su come verificare lo stato della catalogazione dell’alias, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente registra un alias denominato `SAMPLE`. All’utente `jorge_souza` viene concesso l’accesso al bucket Amazon S3 denominato `amzn-s3-demo-bucket`.
```
db2 "call rdsadmin.catalog_storage_access(
?,
'SAMPLE',
'amzn-s3-demo-bucket',
'USER',
'jorge_souza')"
```
## rdsadmin.uncatalog\$1storage\$1access
Rimuove un alias di accesso all’archiviazione.
### Sintassi
```
db2 "call rdsadmin.uncatalog_storage_access(
?,
'alias')"
```
### Parametri
Il parametro di output seguente è obbligatorio:
?
Un indicatore di parametro che genera un messaggio di errore. Il tipo di dati è `varchar`.
Il parametro di input seguente è obbligatorio:
*alias*
Il nome dell’alias di archiviazione da rimuovere. Il tipo di dati è `varchar`.
### Note per l'utilizzo
Per informazioni su come verificare lo stato della rimozione dell’alias, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente rimuove un alias denominato `SAMPLE`. L’alias non fornirà più l’accesso al bucket Amazon S3 a cui era associato.
```
db2 "call rdsadmin.uncatalog_storage_access(
?,
'SAMPLE')"
```
# Stored procedure relative ai tablespace per RDS per Db2
Le stored procedure integrate descritte in questo argomento gestiscono i tablespace per i database Amazon RDS per Db2. Per eseguire queste procedure, l’utente master deve prima connettersi al database `rdsadmin`.
Queste stored procedure vengono utilizzate in diverse attività. L'elenco non è completo.
+ [Attività comuni per i tablespace](db2-managing-tablespaces.md)
+ [Generazione di report sulle prestazioni](db2-managing-databases.md#db2-generating-performance-reports)
+ [Copia dei metadati del database con db2look](db2-native-db2-tools-db2look.md)
+ [Creazione di un database di repository per IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)
Fai riferimento alle seguenti stored procedure integrate per informazioni sulla sintassi, i parametri, le note per l’utilizzo e gli esempi.
**Topics**
+ [rdsadmin.create\$1tablespace](#db2-sp-create-tablespace)
+ [rdsadmin.alter\$1tablespace](#db2-sp-alter-tablespace)
+ [rdsadmin.rename\$1tablespace](#db2-sp-rename-tablespace)
+ [rdsadmin.drop\$1tablespace](#db2-sp-drop-tablespace)
## rdsadmin.create\$1tablespace
Crea un tablespace.
### Sintassi
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_page_size,
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type',
'tablespace_prefetch_size')"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database in cui creare il tablespace. Il tipo di dati è `varchar`.
*tablespace\$1name*
Il nome del tablespace da creare. Il tipo di dati è `varchar`.
Il nome del tablespace presenta le seguenti limitazioni:
+ Non può essere uguale al nome di un tablespace esistente nel database.
+ Può contenere solo i caratteri `_$#@a-zA-Z0-9`.
+ Non può iniziare con `_` o `$`.
+ Non può iniziare con `SYS`.
I parametri seguenti sono facoltativi:
*buffer\$1pool\$1name*
Il nome del pool di buffer a cui assegnare il tablespace. Il tipo di dati è `varchar`. L'impostazione predefinita è una stringa vuota.
È necessario disporre già di un pool di buffer della stessa dimensione di pagina da associare al tablespace.
*tablespace\$1page\$1size*
La dimensione di pagina del tablespace, espressa in byte. Il tipo di dati è `integer`. Valori validi: `4096`, `8192`, `16384`, `32768`. L’impostazione predefinita è la dimensione di pagina utilizzata al momento della creazione del database chiamando [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
Amazon RDS supporta l’atomicità di scrittura per pagine da 4 KiB, 8 KiB e 16 KiB. Per contro, le pagine da 32 KiB rischiano di causare scritture incomplete o la scrittura parziale dei dati sul desktop. Se utilizzi pagine da 32 KiB, ti consigliamo di abilitare il point-in-time ripristino e i backup automatici. Altrimenti, corri il rischio di non riuscire a recuperare le pagine danneggiate. Per ulteriori informazioni, consultare [Introduzione ai backup](USER_WorkingWithAutomatedBackups.md) e [Ripristino di un’istanza database a un punto temporale specifico per Amazon RDS](USER_PIT.md).
*tablespace\$1initial\$1size*
La dimensione iniziale del tablespace in kilobyte (KB). Il tipo di dati è `integer`. Valori validi: `48` o superiore. Il valore predefinito è null.
Se non imposti un valore, Db2 imposta automaticamente un valore appropriato.
Questo parametro non è applicabile per i tablespace temporanei poiché questi vengono gestiti dal sistema.
*tablespace\$1increase\$1size*
La percentuale in base alla quale aumentare la dimensione del tablespace quando è pieno. Il tipo di dati è `integer`. Valori validi: `1`-`100`. Il valore predefinito è null.
Se non imposti un valore, Db2 imposta automaticamente un valore appropriato.
Questo parametro non è applicabile per i tablespace temporanei poiché questi vengono gestiti dal sistema.
*tablespace\$1type*
Il tipo di tablespace. Il tipo di dati è `char`. Valori validi: `U` (per i dati dell’utente), `T` (per i dati temporanei dell’utente) o `S` (per i dati temporanei del sistema). Il valore predefinito è `U`.
*tablespace\$1prefetch\$1size*
La dimensione di pagina di prefetch del tablespace. Il tipo di dati è `char`. Valori validi: `AUTOMATIC` (senza distinzione tra maiuscole e minuscole) o numeri interi positivi diversi da zero minori o uguali a 32.767.
### Note per l’utilizzo
RDS per Db2 crea sempre un database di grandi dimensioni per i dati.
Per informazioni su come verificare lo stato della creazione di un tablespace, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
**Esempio 1: creazione di un tablespace e assegnazione di un pool di buffer**
L’esempio seguente crea un tablespace denominato `SP8` e assegna il pool di buffer `BP8` per il database `TESTDB`. Il tablespace ha una dimensione di pagina di 4.096 byte, una dimensione di pagina di 1.000 KB e una percentuale di incremento della dimensione di tabella del 50%.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
4096,
1000,
50)"
```
**Esempio 2: creazione di un tablespace temporaneo e assegnazione di un pool di buffer**
L’esempio seguente crea un tablespace temporaneo denominato `SP8`. Assegna un pool di buffer denominato `BP8` della dimensione di 8 KiB per il database `TESTDB`.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
8192,
NULL,
NULL,
'T')"
```
**Esempio 3: creazione di un tablespace e assegnazione di una dimensione di pagina di prefetch**
L’esempio seguente crea un tablespace denominato `SP8` per il database `TESTDB`. Il tablespace ha una dimensione di incremento iniziale pari a `50` e una dimensione di pagina di prefetch pari a `800`.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
NULL,
NULL,
NULL,
50,
NULL,
'800')"
```
## rdsadmin.alter\$1tablespace
Modifica un tablespace.
### Sintassi
```
db2 "call rdsadmin.alter_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_increase_size,
'max_size',
'reduce_max',
'reduce_stop',
'reduce_value',
'lower_high_water',
'lower_high_water_stop',
'switch_online',
'tablespace_prefetch_size')"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database che utilizza il tablespace. Il tipo di dati è `varchar`.
*tablespace\$1name*
Il nome del tablespace da modificare. Il tipo di dati è `varchar`.
I parametri seguenti sono facoltativi:
*buffer\$1pool\$1name*
Il nome del pool di buffer a cui assegnare il tablespace. Il tipo di dati è `varchar`. L'impostazione predefinita è una stringa vuota.
È necessario disporre già di un pool di buffer della stessa dimensione di pagina da associare al tablespace.
*tablespace\$1increase\$1size*
La percentuale in base alla quale aumentare la dimensione del tablespace quando è pieno. Il tipo di dati è `integer`. Valori validi: `1`-`100`. Il valore predefinito è `0`.
*max\$1size*
La dimensione massima per il tablespace. Il tipo di dati è `varchar`. Valori validi: *integer* `K` \$1 `M` \$1`G`, or`NONE`. Il valore predefinito è `NONE`.
*reduce\$1max*
Specifica se ridurre il limite massimo consentito. Il tipo di dati è `char`. Il valore predefinito è `N`.
*reduce\$1stop*
Specifica se interrompere un comando `reduce_max` o `reduce_value` precedente. Il tipo di dati è `char`. Il valore predefinito è `N`.
*reduce\$1value*
Il numero o la percentuale in base a cui ridurre il limite massimo per il tablespace. Il tipo di dati è `varchar`. Valori validi: *integer* `K` `M` \$1 \$1 `G` o `1` —`100`. Il valore predefinito è `N`.
*lower\$1high\$1water*
Specifica se eseguire il comando `ALTER TABLESPACE LOWER HIGH WATER MARK`. Il tipo di dati è `char`. Il valore predefinito è `N`.
*lower\$1high\$1water\$1stop*
Specifica se eseguire il comando `ALTER TABLESPACE LOWER HIGH WATER MARK STOP`. Il tipo di dati è `char`. Il valore predefinito è `N`.
*switch\$1online*
Specifica se eseguire il comando `ALTER TABLESPACE SWITCH ONLINE`. Il tipo di dati è `char`. Il valore predefinito è `N`.
*tablespace\$1prefetch\$1size*
La dimensione di pagina di prefetch del tablespace. Il tipo di dati è `char`. Valori validi: `AUTOMATIC` (senza distinzione tra maiuscole e minuscole) o numeri interi positivi diversi da zero minori o uguali a 32.767.
Questo parametro funziona solo con `buffer_pool_name`, `table_increase_size`, `max_size` e `switch_online`. Non funziona con `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water` e `lower_high_water_stop`.
### Note per l’utilizzo
Prima di chiamare la stored procedure, esamina le seguenti considerazioni:
+ La stored procedure `rdsadmin.alter_tablespace` non funziona su un tablespace con `tablespace_type` impostato su `T` per i dati temporanei dell’utente.
+ I parametri facoltativi `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water`, `lower_high_water_stop` e `switch_online` si escludono a vicenda. Non puoi combinarli con altri parametri facoltativi, ad esempio `buffer_pool_name`, nel comando `rdsadmin.alter_tablespace`. Per ulteriori informazioni, consulta [Statement not valid](db2-troubleshooting.md#alter-tablespace-sp-statement-not-valid).
Per informazioni su come verificare lo stato della modifica di un tablespace, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Per i messaggi di errore restituiti durante le chiamate alle stored procedure, consulta [Errori delle stored procedure](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Esempi
**Esempio 1: diminuzione del valore del limite massimo**
L’esempio seguente modifica un tablespace denominato `SP8` e assegna il pool di buffer `BP8` per il database `TESTDB` al fine di diminuire il valore del limite massimo.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'SP8',
'BP8',
NULL,
NULL,
'Y')"
```
**Esempio 2: riduzione del limite massimo**
L’esempio seguente esegue il comando `REDUCE MAX` su un tablespace denominato `TBSP_TEST` nel database `TESTDB`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
'Y')"
```
**Esempio 3: interruzione dei comandi per la riduzione del limite massimo**
L’esempio seguente esegue il comando `REDUCE STOP` su un tablespace denominato `TBSP_TEST` nel database `TESTDB`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
'Y')"
```
**Esempio 4: modifica della dimensione di pagina di prefetch esistente**
L’esempio seguente esegue il comando `ALTER TABLESPACE SWITCH ONLINE` su un tablespace denominato `TSBP_TEST` e modifica la dimensione di pagina di prefetch esistente in `64`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
‘Y’,
‘64’)"
```
## rdsadmin.rename\$1tablespace
Rinomina un tablespace.
### Sintassi
```
db2 "call rdsadmin.rename_tablespace(
?,
'database_name',
'source_tablespace_name',
'target_tablespace_name')"
```
### Parameters
I parametri seguenti sono obbligatori:
?
Un indicatore di parametro che genera un messaggio di errore. Questo parametro accetta solo ?.
*database\$1name*
Il nome del database a cui appartiene il tablespace. Il tipo di dati è `varchar`.
*source\$1tablespace\$1name*
Il nome del tablespace da rinominare. Il tipo di dati è `varchar`.
*target\$1tablespace\$1name*
Il nuovo nome del tablespace. Il tipo di dati è `varchar`.
Il nuovo nome presenta le seguenti limitazioni:
+ Non può essere uguale al nome di un tablespace esistente.
+ Può contenere solo i caratteri `_$#@a-zA-Z0-9`.
+ Non può iniziare con `_` o `$`.
+ Non può iniziare con `SYS`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato della ridenominazione di un tablespace, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Non è possibile rinominare i tablespace che appartengono al database `rdsadmin`.
### Esempi
L’esempio seguente rinomina in `SP9` un tablespace denominato `SP8` nel database `TESTDB`.
```
db2 "call rdsadmin.rename_tablespace(
?,
'TESTDB',
'SP8',
'SP9')"
```
## rdsadmin.drop\$1tablespace
Elimina un tablespace.
### Sintassi
```
db2 "call rdsadmin.drop_tablespace(
'database_name',
'tablespace_name')"
```
### Parameters
I parametri seguenti sono obbligatori:
*database\$1name*
Il nome del database a cui appartiene il tablespace. Il tipo di dati è `varchar`.
*tablespace\$1name*
Il nome del tablespace da eliminare. Il tipo di dati è `varchar`.
### Note per l’utilizzo
Per informazioni su come verificare lo stato dell’eliminazione di un tablespace, consulta [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Esempi
L’esempio seguente elimina un tablespace denominato `SP8` dal database `TESTDB`.
```
db2 "call rdsadmin.drop_tablespace(
'TESTDB',
'SP8')"
```
# Informazioni di riferimento sulle funzioni definite dall’utente di Amazon RDS per Db2
Le funzioni definite dall’utente descritte di seguito sono disponibili per le istanze database Amazon RDS che eseguono il motore Db2.
**Topics**
+ [rdsadmin.get\$1task\$1status](#db2-udf-get-task-status)
+ [rdsadmin.list\$1databases](#db2-udf-list-databases)
+ [rdsadmin.list\$1modifiable\$1db\$1params](#db2-udf-list-modi-db-params)
## rdsadmin.get\$1task\$1status
Restituisce lo stato di un’attività.
### Sintassi
```
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
from table(rdsadmin.get_task_status(task_id,'database_name','task_type'))"
```
### Parameters
I parametri seguenti sono facoltativi. Se non è specificato alcun parametro, la funzione definita dall’utente restituisce lo stato di tutte le attività per tutti i database. Amazon RDS mantiene la cronologia delle attività per 35 giorni.
*task\$1id*
L’ID dell’attività in esecuzione. Questo ID viene restituito durante l’esecuzione di un’attività. Default: `0`.
*database\$1name*
Il nome del database per cui viene eseguita l’attività.
*task\$1type*
Il tipo di attività su cui eseguire query. Valori validi: `ADD_GROUPS` `ADD_USER``ALTER_BUFFERPOOL`,`ALTER_TABLESPACE`,`CHANGE_PASSWORD`,`COMPLETE_ROLLFORWARD`,`CREATE_BUFFERPOOL`,`CREATE_DATABASE`,`CREATE_ROLE`,`CREATE_TABLESPACE`,`DROP_BUFFERPOOL`,`DROP_DATABASE`,`DROP_TABLESPACE`, `LIST_USERS``REMOVE_GROUPS`,`REMOVE_USER`,`RESTORE_DB`,`ROLLFORWARD_DB_LOG`,`ROLLFORWARD_STATUS`,`UPDATE_DB_PARAM`.
### Note per l’utilizzo
È possibile utilizzare la funzione `rdsadmin.get_task_status` definita dall’utente per verificare lo stato delle seguenti attività in Amazon RDS per Db2. Questo elenco non è completo.
+ Creazione, modifica o eliminazione di un pool di buffer
+ Creazione, modifica o eliminazione di un tablespace
+ Creazione o eliminazione di un database
+ Ripristino di un backup di database da Amazon S3
+ Roll forward dei log di database da Amazon S3
### Esempi
L’esempio seguente mostra le colonne restituite quando viene chiamata la funzione `rdsadmin.get_task_status`.
```
db2 "describe select * from table(rdsadmin.get_task_status())"
```
L’esempio seguente elenca lo stato di tutte le attività.
```
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
from table(rdsadmin.get_task_status(null,null,null))"
```
L’esempio seguente elenca lo stato di un’attività specifica.
```
db2 "select task_id, task_type, database_name,
varchar(bson_to_json(task_input_params), 500) as task_params
from table(rdsadmin.get_task_status(1,null,null))"
```
L’esempio seguente elenca lo stato di un’attività e di un database specifici.
```
db2 "select task_id, task_type, database_name,
varchar(bson_to_json(task_input_params), 500) as task_params
from table(rdsadmin.get_task_status(2,'SAMPLE',null))"
```
L’esempio seguente elenca lo stato di tutte le attività `ADD_GROUPS`.
```
db2 "select task_id, task_type, database_name,
varchar(bson_to_json(task_input_params), 500) as task_params
from table(rdsadmin.get_task_status(null,null,'add_groups'))"
```
L’esempio seguente elenca lo stato di tutte le attività per un database specifico.
```
db2 "select task_id, task_type, database_name,
varchar(bson_to_json(task_input_params), 500) as task_params
from table(rdsadmin.get_task_status(null,'testdb', null))"
```
L’esempio seguente restituisce i valori JSON come colonne.
```
db2 "select varchar(r.task_type,25) as task_type, varchar(r.lifecycle,10) as lifecycle, r.created_at, u.* from
table(rdsadmin.get_task_status(null,null,'restore_db')) as r, json_table(r.task_input_params, 'strict $' columns(s3_prefix varchar(500)
null on empty, s3_bucket_name varchar(500) null on empty) error on error ) as U"
```
### Risposta
La funzione `rdsadmin.get_task_status` definita dall’utente restituisce le seguenti colonne:
`TASK_ID`
L'ID dell'attività.
`TASK_TYPE`
Dipende dai parametri di input.
+ `ADD_GROUPS`: aggiunge gruppi.
+ `ADD_USER`: aggiunge un utente.
+ `ALTER_BUFFERPOOL`: modifica un pool di buffer.
+ `ALTER_TABLESPACE`: modifica un tablespace.
+ `CHANGE_PASSWORD `: modifica la password di un utente.
+ `COMPLETE_ROLLFORWARD`: completa un’attività `rdsadmin.rollforward_database` e attiva un database.
+ `CREATE_BUFFERPOOL`: crea un pool di buffer.
+ `CREATE_DATABASE`: crea un database.
+ `CREATE_ROLE`: crea un ruolo Db2 per un utente.
+ `CREATE_TABLESPACE`: crea un tablespace.
+ `DROP_BUFFERPOOL`: elimina un pool di buffer.
+ `DROP_DATABASE`: elimina un database.
+ `DROP_TABLESPACE`: elimina un tablespace.
+ `LIST_USERS`: elenca tutti gli utenti.
+ `REMOVE_GROUPS`: rimuove gruppi.
+ `REMOVE_USER`: rimuove un utente.
+ `RESTORE_DB`: ripristina un database completo.
+ `ROLLFORWARD_DB_LOG`: esegue un’attività `rdsadmin.rollforward_database` sui log del database.
+ `ROLLFORWARD_STATUS `: restituisce lo stato di un’attività `rdsadmin.rollforward_database`.
+ `UPDATE_DB_PARAM`: aggiorna i parametri dei dati.
`DATABASE_NAME`
Il nome del database a cui è associata l’attività.
`COMPLETED_WORK_BYTES`
Il numero di byte ripristinati dall’attività.
`DURATION_MINS`
Il tempo necessario per completare l’attività.
`LIFECYCLE`
Lo stato dell'attività. Stati possibili:
+ `CREATED`: dopo l’invio di un’attività ad Amazon RDS, lo stato viene impostato su `CREATED`.
+ `IN_PROGRESS`: dopo l’avvio di un’attività, lo stato viene impostato su `IN_PROGRESS`. Possono essere necessari fino a 5 minuti perché lo stato passi da `CREATED` a `IN_PROGRESS`.
+ `SUCCESS`: al termine di un’attività, lo stato viene impostato su `SUCCESS`.
+ `ERROR`: se un’attività di ripristino non riesce, lo stato viene impostato su `ERROR`. Per ulteriori informazioni sull’errore, consulta `TASK_OUPUT`.
`CREATED_BY`
L’`authid` che ha creato il comando.
`CREATED_AT`
La data e l’ora di creazione dell’attività.
`LAST_UPDATED_AT`
La data e l’ora dell’ultimo aggiornamento dell’attività.
`TASK_INPUT_PARAMS`
I parametri variano in base al tipo di attività. Tutti i parametri di input sono rappresentati come oggetto JSON. Ad esempio, le chiavi JSON per l’attività `RESTORE_DB` sono le seguenti:
+ `DBNAME`
+ `RESTORE_TIMESTAMP`
+ `S3_BUCKET_NAME`
+ `S3_PREFIX`
`TASK_OUTPUT`
Ulteriori informazioni sull'attività. Se si verifica un errore durante il ripristino nativo, questa colonna contiene informazioni sull’errore.
### Esempi di risposta
Il seguente esempio di risposta mostra l’esito positivo della creazione di un database denominato `TESTJP`. Per ulteriori informazioni, consulta la stored procedure [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
```
`1 SUCCESS CREATE_DATABASE RDSDB 2023-10-24-18.32.44.962689 2023-10-24-18.34.50.038523 1 TESTJP { "CODESET" : "IBM-437", "TERRITORY" : "JP", "COLLATION" : "SYSTEM", "AUTOCONFIGURE_CMD" : "", "PAGESIZE" : 4096 }
2023-10-24-18.33.30.079048 Task execution has started.
2023-10-24-18.34.50.038523 Task execution has completed successfully`.
```
Il seguente esempio di risposta illustra il motivo per cui l’eliminazione di un database non è riuscita. Per ulteriori informazioni, consulta la stored procedure [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database).
```
1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task.
Reason Dropping database created via rds CreateDBInstance api is not allowed.
Only database created using rdsadmin.create_database can be dropped
```
Il seguente esempio di risposta mostra l’esito positivo del ripristino di un database. Per ulteriori informazioni, consulta la stored procedure [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database).
```
1 RESTORE_DB SAMPLE SUCCESS
{ "S3_BUCKET_NAME" : "amzn-s3-demo-bucket", "S3_PREFIX" : "SAMPLE.0.rdsdb3.DBPART000.20230413183211.001", "RESTORE_TIMESTAMP" : "20230413183211", "BACKUP_TYPE" : "offline" }
2023-11-06-18.31.03.115795 Task execution has started.
2023-11-06-18.31.04.300231 Preparing to download
2023-11-06-18.31.08.368827 Download complete. Starting Restore
2023-11-06-18.33.13.891356 Task Completed Successfully
```
## rdsadmin.list\$1databases
Restituisce un elenco di tutti i database in esecuzione su un’istanza database RDS per Db2.
### Sintassi
```
db2 "select * from table(rdsadmin.list_databases())"
```
### Note per l’utilizzo
Questa funzione definita dall’utente non specifica se i database sono in stato attivato o disattivato.
Se i database non sono visualizzati nell’elenco, chiama la funzione [rdsadmin.get\$1task\$1status](#db2-udf-get-task-status) definita dall’utente e cerca i messaggi di errore.
### Risposta
La funzione `rdsadmin.list_databases` definita dall’utente restituisce le seguenti colonne:
`DATABASE_NAME`
Il nome di un database.
`CREATE_TIME`
La data e l’ora di creazione del database.
`DATABASE_UNIQUE_ID`
Il GUID creato da RDS per identificare in modo univoco il database Db2.
`ARCHIVE_LOG_RETENTION_HOUR`
Il numero di ore della conservazione dei file di log archiviati.
`ARCHIVE_LOG_COPY`
Indica se la funzionalità è ABILITATA o DISABILITATA per il database.
`ARCHIVE_LOG_LAST_UPLOAD_FILE `
Indica l'ultimo registro di archivio caricato su S3.
`ARCHIVE_LOG_LAST_UPLOAD_FILE_TIME`
Indica l'ora in cui il file di registro è stato archiviato.
`ARCHIVE_LOG_COPY_STATUS`
Visualizza lo stato della copia del registro di archivio.
CARICAMENTO: indica che i file di registro dell'archivio vengono caricati su S3.
CONFIGURATION\$1ERROR: indica che c'è un problema di configurazione che richiede la tua attenzione.
Per visualizzare l'errore dettagliato, consulta RDS Event Messages for you Db Instance. I messaggi relativi agli eventi possono essere visualizzati nella sezione [Visualizzazione degli eventi Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ListEvents.html).
### Esempi di risposta
Il seguente esempio di risposta mostra un elenco di database e l’ora in cui sono stati creati. `rdsadmin` è un database gestito da Amazon RDS e appare sempre nell’output.
```
DATABASE_NAME CREATE_TIME DATABASE_UNIQUE_ID ARCHIVE_LOG_RETENTION_HOURS ARCHIVE_LOG_COPY ARCHIVE_LOG_LAST_UPLOAD_FILE ARCHIVE_LOG_LAST_UPLOAD_FILE_TIME ARCHIVE_LOG_COPY_STATUS
--------------- -------------------------- -------------------------------------------------- --------------------------- ---------------- ---------------------------- --------------------------------- ------------------------------
RDSADMIN 2026-01-06-02.03.42.569069 RDSADMIN 0 DISABLED - - -
FOO 2026-01-06-02.13.42.885650 F0D81C7E-7213-4565-B376-4F33FCF420E3 0 ENABLED S0006536.LOG 2026-01-28-19.15.10.000000 UPLOADING
CODEP 2026-01-14-19.42.42.508476 106EEF95-6E30-4FFF-85AE-B044352DF095 0 DISABLED - - -
...
```
## rdsadmin.list\$1modifiable\$1db\$1params
Restituisce un elenco di tutti i parametri di configurazione modificabili del database.
### Sintassi
```
db2 "select * from table(rdsadmin.list_modifiable_db_params())"
```
### Note per l’utilizzo
Questa funzione definita dall'utente visualizza un elenco selezionato di parametri modificabili del database. Questi parametri possono essere aggiornati utilizzando la stored procedure. [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param)
Tutti i parametri del database non inclusi in questo elenco sono soggetti a restrizioni e non possono essere modificati.
### Risposta
La funzione `rdsadmin.list_modifiable_db_params` definita dall’utente restituisce le seguenti colonne:
`PARAM_NAME`
Il nome del parametro che può essere modificato.
`DEFAULT_VALUE`
Valore predefinito del parametro al momento della creazione del database.
`RESTART_REQUIRED`
Se è richiesto o meno il riciclo del database.
Y = Sì, è necessario riavviare il database.
N = No, il riavvio del database non è richiesto.
### Esempi di risposta
Di seguito è riportato un elenco di esempio (troncato) dell'output previsto.
```
PARAM_NAME DEFAULT_VALUE RESTART_REQUIRED
---------------------- ------------- ----------------
ACT_SORTMEM_LIMIT NONE N
ARCHRETRYDELAY 20 N
AUTHN_CACHE_DURATION 3 N
AUTHN_CACHE_USERS 0 N
AUTO_CG_STATS OFF N
...
```
# Risoluzione dei problemi relativi ad Amazon RDS per Db2
I contenuti seguenti sono utili per risolvere i problemi che possono verificarsi con RDS per Db2.
Per ulteriori informazioni sulla risoluzione dei problemi generali relativi ad Amazon RDS, consulta [Risoluzione dei problemi per Amazon RDS](CHAP_Troubleshooting.md).
**Topics**
+ [Errore di connessione al database](#db2-database-connection-error)
+ [I/O Errore nel file](#db2-file-input-output-error)
+ [Errori delle stored procedure](#db2-troubleshooting-stored-procedures)
## Errore di connessione al database
Il seguente messaggio di errore indica che la connessione al database non è riuscita perché il server non dispone di memoria sufficiente.
```
SQL1643C The database manager failed to allocate shared memory because the
database manager instance memory limit has been reached.
```
Aumenta la memoria per l’istanza database, quindi prova a connetterti nuovamente al database. Per informazioni sull’utilizzo della memoria e consigli per i database, consulta [Più database su un’istanza database Amazon RDS per Db2](db2-multiple-databases.md). Per informazioni su come aggiornare la memoria per un database RDS per Db2, consulta [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).
## I/O Errore nel file
È possibile che si verifichi un I/O errore di file per diversi motivi, ad esempio quando si utilizza il `LOAD` comando o si chiama la `rdsadmin.restore_database` stored procedure.
In questo esempio viene eseguito il seguente comando `LOAD`.
```
db2 "call sysproc.admin_cmd('load from "DB2REMOTE://s3test//public/datapump/t6.del" of del lobs from "DB2REMOTE://s3test/public/datapump/" modified by lobsinfile MESSAGES ON SERVER insert INTO RDSDB.t6 nonrecoverable ')"
```
Il comando `LOAD` restituisce il seguente messaggio:
```
Result set 1
--------------
ROWS_READ ROWS_SKIPPED ROWS_LOADED ROWS_REJECTED ROWS_DELETED ROWS_COMMITTED ROWS_PARTITIONED NUM_AGENTINFO_ENTRIES MSG_RETRIEVAL MSG_REMOVAL
-------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
- - - - - - - - SELECT SQLCODE, MSG FROM TABLE(SYSPROC.ADMIN_GET_MSGS('1594987316_285548770')) AS MSG CALL SYSPROC.ADMIN_REMOVE_MSGS('1594987316_285548770')
1 record(s) selected.
Return Status = 0
SQL20397W Routine "SYSPROC.ADMIN_CMD" execution has completed, but at least
one error, "SQL1652", was encountered during the execution. More information
is available. SQLSTATE=01H52
```
Per visualizzare il messaggio di errore, viene eseguito il comando SQL come suggerito nella risposta precedente. `SELECT SQLCODE, MSG FROM TABLE(SYSPROC.ADMIN_GET_MSGS('1594987316_285548770')) AS MSG` restituisce il seguente messaggio:
```
SQLCODE MSG
--------- ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
SQL2025N An I/O error occurred. Error code “438”. Media on which this error occurred: “DB2REMOTE://s3test//public/datapump/t6.del”
SQL3500W The utility is beginning the LOAD phase at time “07/05/2024 21:21:48.082954”
SQL1652N File I/O error occurred
```
I log di diagnostica di Db2 contengono un file di log simile al seguente:
```
2024-07-05-21.20.09.440609+000 I1191321E864 LEVEL: Error
PID : 2710 TID : 139619509200640 PROC : db2sysc 0
INSTANCE: rdsdb NODE : 000 DB : NTP
APPHDL : 0-12180 APPID: xxx.xx.x.xxx.xxxxx.xxxxxxxxxxxx
UOWID : 5 ACTID: 1
AUTHID : ADMIN HOSTNAME: ip-xx-xx-x-xx
EDUID : 147 EDUNAME: db2lmr 0
FUNCTION: DB2 UDB, oper system services, sqloS3Client_GetObjectInfo, probe:219
MESSAGE : ZRC=0x870F01B6=-2029059658=SQLO_FAILED
"An unexpected error is encountered"
DATA #1 : String, 29 bytes
S3:HeadObject request failed.
DATA #2 : signed integer, 4 bytes
99
DATA #3 : String, 0 bytes
Object not dumped: Address: 0x00007EFC08A9AE38 Size: 0 Reason: Zero-length data
DATA #4 : String, 33 bytes
curlCode: 28, Timeout was reached
```
Questo I/O errore di file potrebbe derivare da diversi scenari. Ad esempio, il VPC associato al gruppo di sicurezza utilizzato per creare l’istanza database RDS per Db2 potrebbe non avere un endpoint gateway per Amazon S3. Questo endpoint è essenziale per consentire a RDS per Db2 di accedere ad Amazon S3. Se l’istanza database RDS per Db2 si trova in sottoreti private, è necessario un endpoint gateway per Amazon S3. È possibile specificare se l’istanza database utilizza sottoreti private o pubbliche configurando gruppi di sottoreti Amazon RDS. Per ulteriori informazioni, consulta [Utilizzo di gruppi di sottoreti database](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets).
**Topics**
+ [Fase 1: creare un endpoint gateway VPC per Amazon S3](#db2-creating-endpoint)
+ [Fase 2: verificare l’esistenza dell’endpoint gateway VPC per Amazon S3](#db2-confirming-endpoint)
### Fase 1: creare un endpoint gateway VPC per Amazon S3
Per consentire all’istanza database RDS per Db2 di interagire con Amazon S3, crea un VPC e quindi un endpoint gateway per Amazon S3 da utilizzare per le sottoreti private.
**Per creare un endpoint gateway VPC per S3**
1. Crea un VPC. Per ulteriori informazioni, consulta [Crea un VPC](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html) nella *Guida per l’utente di Amazon Virtual Private Cloud*.
1. Crea un endpoint gateway per Amazon S3 da utilizzare per le sottoreti private. Per ulteriori informazioni, consulta [Endpoint gateway](https://docs.aws.amazon.com/vpc/latest/privatelink/gateway-endpoints.html) nella *Guida di AWS PrivateLink *.
### Fase 2: verificare l’esistenza dell’endpoint gateway VPC per Amazon S3
Verifica di aver creato correttamente un endpoint gateway per Amazon S3 utilizzando la Console di gestione AWS o la AWS CLI.
#### Console
**Per verificare l’esistenza di un endpoint gateway per Amazon S3**
1. Accedi Console di gestione AWS e apri la console Amazon VPC all'indirizzo. [https://console.aws.amazon.com/vpc](https://console.aws.amazon.com/vpc)
1. Nell’angolo superiore destro della console, scegli la Regione AWS del VPC.
1. Seleziona il VPC creato.
1. Nella scheda **Mappa delle risorse**, in **Connessioni di rete**, verifica che l’endpoint gateway per Amazon S3 sia incluso nell’elenco.
#### AWS CLI
Per verificare l’esistenza di un endpoint gateway per Amazon S3, esegui il comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html). Nell'esempio seguente, sostituiscilo *vpc\$1id* con l'ID VPC, *region* con il tuo e *profile* con il Regione AWS nome del tuo profilo.
Per Linux, macOS o Unix:
```
aws ec2 describe-vpc-endpoints \
--filters "Name=vpc-id,Values=$vpc_id" \
"Name=service-name,\
Values=com.amazonaws.${region}.s3" \
--region $region --profile=$profile \
--query "VpcEndpoints[*].VpcEndpointId" --output text
```
Per Windows:
```
aws ec2 describe-vpc-endpoints ^
--filters "Name=vpc-id,Values=$vpc_id" ^
"Name=service-name,^
Values=com.amazonaws.${region}.s3" ^
--region $region --profile=$profile ^
--query "VpcEndpoints[*].VpcEndpointId" --output text
```
Se esiste un endpoint gateway per Amazon S3, questo comando genera un output simile al seguente esempio.
```
[
"vpce-0ea810434ff0b97e4"
]
```
Se non esiste un endpoint gateway per Amazon S3, questo comando genera un output simile al seguente esempio.
```
[]
```
Se l’endpoint gateway per Amazon S3 non risulta incluso nell’elenco, torna alla [Fase 1: creare un endpoint gateway VPC per Amazon S3](#db2-creating-endpoint).
## Errori delle stored procedure
In questa sezione sono descritti i vari errori restituiti durante le chiamate alle stored procedure e viene illustrato come risolverli.
| Categoria | Errori delle stored procedure |
| --- | --- |
| Database | [Errori di rdsadmin.activate\$1database](#db2-troubleshooting-activate-database-sp-errors) |
| Database | [errori rdsadmin.backup\$1database](#db2-troubleshooting-backup-database-sp-errors) |
| Database | [Errori di rdsadmin.create\$1database](#db2-troubleshooting-create-database-sp-errors) |
| Database | [Errori di rdsadmin.deactivate\$1database](#db2-troubleshooting-deactivate-database-sp-errors) |
| Database | [Errori di rdsadmin.drop\$1database](#db2-troubleshooting-drop-database-sp-errors) |
| Database | [Errori di rdsadmin.reactivate\$1database](#db2-troubleshooting-reactivate-database-sp-errors) |
| Database | [Errori di rdsadmin.restore\$1database](#db2-troubleshooting-restore-database-sp-errors) |
| Database | [Errori di rdsadmin.update\$1db\$1param](#db2-troubleshooting-update-db-param-sp-errors) |
| Tablespace | [Errori di rdsadmin.alter\$1tablespace](#db2-troubleshooting-alter-tablespace-sp-errors) |
### Errori di rdsadmin.activate\$1database
Durante una chiamata alla stored procedure [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database) possono verificarsi i seguenti errori.
| Errore | Messaggio di errore |
| --- | --- |
| [Failed to allocate shared memory](#activate-database-sp-failed-to-allocate-shared-memory) | `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.` |
| [Unable to activate because of running processes](#activate-database-sp-unable-to-activate-processes) | `The database can’t be activated because it's in the process of being created or restored.` |
**Allocazione della memoria condivisa non riuscita**
Il seguente messaggio di errore indica che la stored procedure non è riuscita ad attivare un database perché l’istanza database non dispone di memoria sufficiente.
```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```
Aumenta la memoria per l’istanza database, quindi chiama nuovamente la stored procedure `rdsadmin.activate_database`. Per informazioni sull’utilizzo della memoria e consigli per i database, consulta [Più database su un’istanza database Amazon RDS per Db2](db2-multiple-databases.md).
**Impossibile attivare a causa di processi in esecuzione**
Il seguente messaggio di errore indica che la stored procedure non è riuscita ad attivare un database perché la stored procedure `rdsadmin.create_database` o `rdsadmin.restore_database` è in esecuzione.
```
The database can’t be activated because it's in the process of being created or restored.
```
Attendi qualche minuto, quindi chiama nuovamente la stored procedure `rdsadmin.activate_database`.
### Errori di rdsadmin.alter\$1tablespace
Durante una chiamata alla stored procedure [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace) possono verificarsi i seguenti errori.
| Errore | Messaggio di errore |
| --- | --- |
| [Statement not valid](#alter-tablespace-sp-statement-not-valid) | `DB21034E The command was processed as an SQL statement because it was not a valid Command Line Processor command. During SQL processing it returned: ` `SQL1763N Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"` |
| [tablespace_prefetch_size value not valid](#alter-tablespace-sp-prefetch-value-not-valid) | `Invalid tablespace_prefetch_size. Set value to AUTOMATIC or to a non-zero positive numerical value.` |
| [tablespace_prefetch_size numerical value not valid](#alter-tablespace-sp-prefetch-numerical-value-not-valid) | `Invalid tablespace_prefetch_size. The number of pages can't be greater than 32767.` |
| [Parameter can't be used with tablespace_prefetch_size](#alter-tablespace-sp-prefetch-incompatible-parameter) | `You can't use tablespace_prefetch_size with {parameter}.` |
| [Tablespace change failed](#alter-tablespace-sp-tablespace-change-failed) | `The change to tablespace {tablespace_name} failed because you can only alter LARGE or REGULAR tablespaces.` |
**Istruzione non valida**
Il seguente messaggio di errore indica che la stored procedure ha combinato parametri facoltativi che si escludono a vicenda con altri parametri facoltativi. I parametri facoltativi `reduce_max, reduce_stop`, `reduce_value`, `lower_high_water`, `lower_high_water_stop` e `switch_online` per la stored procedure `rdsadmin.alter_tablespace` si escludono a vicenda. Non è possibile combinarli con altri parametri facoltativi, ad esempio `buffer_pool_name`, nella stored procedure `rdsadmin.alter_tablespace`. Se si combinano tali parametri, quando si chiama la funzione definita dall’utente `rdsadmin.get_task_status`, Db2 restituisce questo messaggio di errore.
```
DB21034E The command was processed as an SQL statement because it was not a valid Command Line Processor command. During SQL processing it returned:
SQL1763N Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"
```
Chiama nuovamente la stored procedure `rdsadmin.alter_tablespace` senza combinare parametri facoltativi che si escludono a vicenda con altri parametri facoltativi. Quindi, chiama la funzione definita dall’utente `rdsadmin.get_task_status`. Per ulteriori informazioni, consulta [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace) e [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
**Valore di tablespace\$1prefetch\$1size non valido**
Il seguente messaggio di errore indica che il parametro `tablespace_prefetch_size` non è stato impostato su `AUTOMATIC` o su un valore numerico non positivo. Ad esempio, si è provato a impostarlo su `testinput`.
```
Invalid tablespace_prefetch_size. Set value to AUTOMATIC or to a non-zero positive numerical value.
```
Chiama nuovamente la stored procedure `rdsadmin.alter_tablespace` e imposta `tablespace_prefetch_size` su `AUTOMATIC` o su un valore numerico non positivo.
**Valore numerico di tablespace\$1prefetch\$1size non valido**
Il seguente messaggio di errore indica che il parametro `tablespace_prefetch_size` è stato impostato su un valore numerico maggiore di 32.767.
```
Invalid tablespace_prefetch_size. The number of pages can't be greater than 32767.
```
Chiama nuovamente la stored procedure `rdsadmin.alter_tablespace` e imposta `tablespace_prefetch_size` su un valore numerico positivo diverso da zero che sia minore o uguale a 32.767.
**Impossibile utilizzare il parametro con tablespace\$1prefetch\$1size**
Il seguente messaggio di errore indica che si è provato a utilizzare `tablespace_prefetch_size` con un parametro incompatibile.
```
You can't use tablespace_prefetch_size with {parameter}.
```
Chiama nuovamente la stored procedure `rdsadmin.alter_tablespace` e utilizza `tablespace_prefetch_size` solo con parametri compatibili. Per informazioni sui parametri che è possibile utilizzare con `tablespace_prefetch_size`, consulta [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace).
**Modifica del tablespace non riuscita**
Il seguente messaggio di errore indica che si è provato a modificare un tablespace.
```
The change to tablespace {tablespace_name} failed because you can only alter LARGE or REGULAR tablespaces.
```
### errori rdsadmin.backup\$1database
Durante una chiamata alla stored procedure [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database) possono verificarsi i seguenti errori.
| Errore | Messaggio di errore |
| --- | --- |
| [Insufficient disk space](#backup-database-sp-insufficient-disk-space) | `Aborting task. Reason Backing up your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.backup_database stored procedure.` |
| [Internal error](#backup-database-sp-internal-error) | `Caught exception during executing task id 104, Aborting task. Reason Internal Error` |
**Spazio su disco insufficiente**
Il seguente messaggio di errore indica che l'istanza DB dispone di spazio su disco insufficiente per eseguire il backup del database:
```
Aborting task. Reason Backing up your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.backup_database stored procedure.
```
Quando esegui il backup di un database su un dispositivo di archiviazione remoto, assicurati di disporre di spazio libero su disco sufficiente per la sessione di backup e i file di lavoro. Ogni sessione di backup elabora fino a 5 GB di dati, ma è necessario spazio aggiuntivo per i registri delle transazioni, i file temporanei e le operazioni continue del database.
Si consiglia di disporre del seguente spazio libero su disco per i backup in base alle dimensioni del database:
+ Per database inferiori a 5 GB: dimensione del database \$1 3 GB di buffer
+ Per database di dimensioni pari o superiori a 5 GB: almeno 10 GB di spazio libero
Questa quantità di spazio libero su disco tiene conto dell'elaborazione delle sessioni di backup, dell'accumulo dei log delle transazioni durante il backup, dei file di lavoro temporanei e dei flussi di backup paralleli, se configurati. Per ulteriori informazioni, consulta [Aumento della capacità di storage dell'istanza database](USER_PIOPS.ModifyingExisting.md).
Aumenta lo spazio su disco e chiama nuovamente la stored procedure [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database). Per confermare che il backup del database è stato eseguito correttamente, controlla lo stato dell'attività utilizzando[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). Puoi anche verificare che i file di backup esistano nel tuo bucket Amazon S3 sotto. *s3\$1prefix/dbi\$1resource\$1id/db\$1name*
**Errore interno**
Il seguente messaggio di errore indica che la stored procedure ha riscontrato un errore interno:
```
Caught exception during executing task id 104, Aborting task. Reason Internal Error
```
Contatta il [Supporto AWS](https://aws.amazon.com/premiumsupport/).
### Errori di rdsadmin.create\$1database
Durante una chiamata alla stored procedure [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) può verificarsi il seguente errore.
| Errore | Messaggio di errore |
| --- | --- |
| [Failed to allocate shared memory](#create-database-sp-failed-to-allocate-shared-memory) | `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.` |
**Allocazione della memoria condivisa non riuscita**
Il seguente messaggio di errore indica che la stored procedure non è riuscita a creare un database perché l’istanza database non dispone di memoria sufficiente.
```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```
Aumenta la memoria per l’istanza database, quindi chiama nuovamente la stored procedure `rdsadmin.create_database`. Per informazioni sull’utilizzo della memoria e consigli per i database, consulta [Più database su un’istanza database Amazon RDS per Db2](db2-multiple-databases.md).
Per verificare che il database sia stato creato, chiama la funzione definita dall’utente [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) e controlla che il nuovo database sia incluso nell’elenco.
### Errori di rdsadmin.deactivate\$1database
Durante una chiamata alla stored procedure [rdsadmin.deactivate\$1database](db2-sp-managing-databases.md#db2-sp-deactivate-database) può verificarsi il seguente errore.
| Errore | Messaggio di errore |
| --- | --- |
| [Unable to deactivate because of running processes](#deactivate-database-sp-unable-to-deactivate-processes) | `The database can’t be deactivated because it's in the process of being created or restored.` |
**Impossibile disattivare a causa di processi in esecuzione**
Il seguente messaggio di errore indica che la stored procedure non è riuscita a disattivare un database perché la stored procedure `rdsadmin.create_database` o `rdsadmin.restore_database` è in esecuzione.
```
The database can’t be deactivated because it's in the process of being created or restored.
```
Attendi qualche minuto, quindi chiama nuovamente la stored procedure `rdsadmin.deactivate_database`.
### Errori di rdsadmin.drop\$1database
Durante una chiamata alla stored procedure [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) possono verificarsi i seguenti errori.
| Errore | Messaggio di errore |
| --- | --- |
| [Database name doesn't exist](#drop-database-sp-database-name-not-exist) | `SQL0438N Application raised error or warning with diagnostic text: "Cannot drop database. Database with provided name does not exist". SQLSTATE=99993` |
| [Return status = 0](#drop-database-sp-return-status-zero) | `Return Status = 0` |
| [Dropping database not allowed](#drop-database-sp-not-allowed) | `1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started. 2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. Reason Dropping database created via rds CreateDBInstance api is not allowed. Only database created using rdsadmin.create_database can be dropped` |
**Il nome del database non esiste**
Il seguente messaggio di errore indica che è stato passato un nome di database errato nella stored procedure `rdsadmin.drop_database`.
```
SQL0438N Application raised error or warning with diagnostic text: "Cannot
drop database. Database with provided name does not exist". SQLSTATE=99993
```
Chiama nuovamente la stored procedure `rdsadmin.drop_database` con un nome di database corretto. Per verificare che il database sia stato rimosso, chiama la funzione definita dall’utente [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) e controlla che il database rimosso non sia incluso nell’elenco.
**Stato restituito = 0**
Il seguente messaggio di errore indica che non è stato possibile completare la stored procedure.
```
Return Status = 0
```
Dopo la ricezione di `Return Status = 0`, chiama la funzione definita dall’utente [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
**Rimozione del database non consentita**
Il seguente messaggio di errore indica che il database è stato creato utilizzando la console Amazon RDS o la AWS CLI. La stored procedure `rdsadmin.drop_database` può essere utilizzata solo se il database è stato creato chiamando la stored procedure [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
```
1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task.
Reason Dropping database created via rds CreateDBInstance api is not allowed.
Only database created using rdsadmin.create_database can be dropped
```
Per rimuovere un database creato tramite la console Amazon RDS o la AWS CLI, utilizza un client per connetterti al database, quindi esegui il comando appropriato.
### Errori di rdsadmin.reactivate\$1database
Durante una chiamata alla stored procedure [rdsadmin.reactivate\$1database](db2-sp-managing-databases.md#db2-sp-reactivate-database) può verificarsi il seguente errore.
| Errore | Messaggio di errore |
| --- | --- |
| [Failed to allocate shared memory](#reactivate-database-sp-failed-to-allocate-shared-memory) | `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.` |
| [Unable to reactivate because of running processes](#reactivate-database-sp-unable-to-reactivate-processes) | `The database can’t be reactivated because it's in the process of being created or restored.` |
**Allocazione della memoria condivisa non riuscita**
Il seguente messaggio di errore indica che la stored procedure non è riuscita ad attivare un database perché l’istanza database non dispone di memoria sufficiente.
```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```
Aumenta la memoria per l’istanza database, quindi chiama nuovamente la stored procedure `rdsadmin.activate_database`. Per informazioni sull’utilizzo della memoria e consigli per i database, consulta [Più database su un’istanza database Amazon RDS per Db2](db2-multiple-databases.md).
**Impossibile riattivare a causa di processi in esecuzione**
Il seguente messaggio di errore indica che la stored procedure non è riuscita a riattivare un database perché la stored procedure `rdsadmin.create_database` o `rdsadmin.restore_database` è in esecuzione.
```
The database can’t be reactivated because it's in the process of being created or restored.
```
Attendi qualche minuto, quindi chiama nuovamente la stored procedure `rdsadmin.reactivate_database`.
### Errori di rdsadmin.restore\$1database
Durante una chiamata alla stored procedure [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database) possono verificarsi i seguenti errori:
| Errore | Messaggio di errore |
| --- | --- |
| [Insufficient disk space](#restore-database-sp-insufficient-disk-space) | `Aborting task. Reason Restoring your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.restore_database stored procedure.` |
| [Internal error](#restore-database-sp-internal-error) | `Caught exception during executing task id 104, Aborting task. Reason Internal Error` |
| [Non-fenced routines not allowed](#restore-database-sp-non-fenced-routines) | `Caught exception during executing task id 2, Aborting task. Reason Non fenced routines are not allowed. Please delete the routines and retry the restore.` |
| [Tablespaces not restored](#restore-database-sp-tablespaces-not-restored) | `Reason SQL0970N The system attempted to write to a read-only file. Reason SQL2563W The Restore process has completed successfully. However one or more table spaces from the backup were not restored.` |
**Spazio su disco insufficiente**
Il seguente messaggio di errore indica che l’istanza database non dispone di spazio su disco sufficiente per ripristinare il database:
```
Aborting task. Reason Restoring your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.restore_database stored procedure.
```
Lo spazio libero sull’istanza database deve essere più del doppio della dimensione dell’immagine di backup. Se l’immagine di backup è compressa, lo spazio libero sull’istanza database deve essere più del triplo della dimensione dell’immagine di backup. Per ulteriori informazioni, consulta [Aumento della capacità di storage dell'istanza database](USER_PIOPS.ModifyingExisting.md).
Aumenta lo spazio su disco e chiama nuovamente la stored procedure `rdsadmin.restore_database`. Per verificare che il database sia stato ripristinato, chiama la funzione definita dall’utente [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) e controlla che il database ripristinato sia incluso nell’elenco.
**Errore interno**
Il seguente messaggio di errore indica che la stored procedure ha riscontrato un errore interno:
```
Caught exception during executing task id 104, Aborting task. Reason Internal Error
```
Contatta il [Supporto AWS](https://aws.amazon.com/premiumsupport/).
**Routine non recintate non consentite**
Il seguente messaggio di errore indica che il database contiene routine non recintate:
```
Caught exception during executing task id 2, Aborting task. Reason Non fenced routines are not allowed. Please delete the routines and retry the restore.
```
RDS per Db2 non supporta questo tipo di routine. Rimuovi le routine non recintate dal database di origine, quindi chiama nuovamente `rdsadmin.restore_database`. Per verificare che il database sia stato ripristinato, chiama la funzione definita dall’utente [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) e controlla che il database ripristinato sia incluso nell’elenco. Per ulteriori informazioni, consulta [Routine non recintate](db2-known-issues-limitations.md#db2-known-issues-limitations-non-fenced-routines).
**Tablespace non ripristinati**
Il seguente messaggio di errore indica che RDS per Db2 ha ripristinato correttamente il database, ma non è riuscito a ripristinare uno o più tablespace:
```
Reason SQL0970N The system attempted to write to a read-only file.
Reason SQL2563W The Restore process has completed successfully. However one or more table spaces from the backup were not restored.
```
RDS per Db2 non supporta l’archiviazione non automatica. Converti l’archiviazione non automatica in archiviazione automatica, quindi chiama nuovamente `rdsadmin.restore_database`. Per ulteriori informazioni, consulta [Converting a nonautomatic storage database to use automatic storage](https://www.ibm.com/docs/en/db2/11.5?topic=databases-converting-nonautomatic-storage-database-use-automatic-storage) nella documentazione di IBM Db2.
I database con archiviazione SMS non automatica richiedono il ripristino manuale. Se il database dispone di una funzionalità di archiviazione SMS non automatica, contatta il [Supporto AWS](https://aws.amazon.com/premiumsupport/).
Per informazioni sull’archiviazione non automatica e sulle migrazioni una tantum, consulta [Tablespace di archiviazione non automatici durante la migrazione](db2-known-issues-limitations.md#db2-known-issues-limitations-non-automatic-storage-tablespaces).
### Errori di rdsadmin.update\$1db\$1param
Durante una chiamata alla stored procedure [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param) può verificarsi il seguente errore.
| Errore | Messaggio di errore |
| --- | --- |
| [Parameter not supported or modifiable](#update-db-param-sp-parameter-not-supported-modifiable) | SQL0438N Application raised error or warning with diagnostic text: "Parameter is either not supported or not modifiable to customers". SQLSTATE=99993 |
**Parametro non supportato o non modificabile**
Il seguente messaggio di errore indica che si è provato a modificare un parametro di configurazione del database che non è supportato o non è modificabile.
```
SQL0438N Application raised error or warning with diagnostic text: "Parameter
is either not supported or not modifiable to customers". SQLSTATE=99993
```
Puoi vedere quali parametri sono modificabili visualizzando i gruppi di parametri. Per ulteriori informazioni, consulta [Visualizzazione dei valori dei parametri per un gruppo di parametri del database in Amazon RDS](USER_WorkingWithParamGroups.Viewing.md).