

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à.

# Riferimento alle funzioni di rds\_tools
<a name="PostgreSQL_rds_tools-functions-reference"></a>

La `rds_tools` l'estensione fornisce una serie di funzioni di utilità per la gestione e il monitoraggio del RDS per PostgreSQL Istanza DB. Utilizzando queste funzioni, è possibile diagnosticare problemi di replica, vuoto e configurazione direttamente da SQL, senza strumenti di monitoraggio separati. Queste funzioni si aggiungono alle funzioni standard di PostgreSQL. Per ulteriori informazioni sulle funzioni standard di PostgreSQL, vedere [Funzioni e operatori](https://www.postgresql.org/docs/current/functions.html) nella documentazione di PostgreSQL.

Questa sezione descrive il `rds_tools` funzioni disponibili su RDS per PostgreSQL. Ogni descrizione della funzione indica il `rds_tools` versione di estensione in cui la funzione è diventata disponibile.

Per creare l'estensione, esegui il comando seguente.

```
postgres=> CREATE EXTENSION rds_tools;
CREATE EXTENSION
```

**Topics**
+ [rds\_tools.role\_password\_encryption\_type](#rds_tools.role_password_encryption_type)
+ [rds\_tools.blue\_green\_get\_status](#rds_tools.blue_green_get_status)
+ [rds\_tools.postgres\_get\_av\_diag](#rds_tools.postgres_get_av_diag)
+ [rds\_tools.rds\_version](#rds_tools.rds_version)
+ [rds\_tools.logical\_seed\_lsn](#rds_tools.logical_seed_lsn)
+ [rds\_tools.db\_instance\_identifier](#rds_tools.db_instance_identifier)
+ [rds\_tools.dbi\_resource\_id](#rds_tools.dbi_resource_id)
+ [rds\_tools.multi\_az\_db\_cluster\_source\_dbi\_resource\_id](#rds_tools.multi_az_db_cluster_source_dbi_resource_id)
+ [rds\_tools.show\_topology](#rds_tools.show_topology)
+ [rds\_tools.pg\_ls\_multixactdir](#rds_tools.pg_ls_multixactdir)

## rds\_tools.role\_password\_encryption\_type
<a name="rds_tools.role_password_encryption_type"></a>

Restituisce il metodo di crittografia della password utilizzato per ogni ruolo del database. Questa funzione di restituzione dei set esclude RDS-protected ruoli di sistema dall'output. Disponibile a partire da `rds_tools` versione di estensione 1.0.

Per un esempio di utilizzo di questa funzione per rivedere la crittografia delle password prima di migrare gli utenti del database su SCRAM, vedere [Utilizzo delle crittografia password SCRAM per PostgreSQL](PostgreSQL_Password_Encryption_configuration.md).

### Prototipo di funzione
<a name="rds_tools.role_password_encryption_type-prototype"></a>

```
rds_tools.role_password_encryption_type()
```

### Arguments (Argomenti)
<a name="rds_tools.role_password_encryption_type-arguments"></a>

Nessuna.

### Output
<a name="rds_tools.role_password_encryption_type-output"></a>

Questa funzione restituisce le seguenti colonne:
+ `rolname` — Il nome del ruolo del database.
+ `encryption_type` — Il metodo di crittografia della password utilizzato, ad esempio `md5` o `scram-sha-256`.

### Esempio di utilizzo
<a name="rds_tools.role_password_encryption_type-example"></a>

```
=> SELECT * FROM rds_tools.role_password_encryption_type();
    rolname    | encryption_type
---------------+-----------------
 postgres      | md5
 app_user      | md5
 readonly_user | scram-sha-256
(3 rows)
```

## rds\_tools.blue\_green\_get\_status
<a name="rds_tools.blue_green_get_status"></a>

Verifica la presenza di comandi limitati eseguiti durante blue/green operazioni di distribuzione. Durante blue/green nelle implementazioni che utilizzano la replica logica, non è possibile replicare i comandi DDL (Data Definition Language) o le operazioni con oggetti di grandi dimensioni (LO) tra gli ambienti blu e verde. Se viene rilevato un comando limitato, riavvia blue/green distribuzione, perché i dati non possono essere replicati correttamente nell'ambiente verde. Disponibile a partire da `rds_tools` versione di estensione 1.3.

### Prototipo di funzione
<a name="rds_tools.blue_green_get_status-prototype"></a>

```
rds_tools.blue_green_get_status(command_type)
```

### Arguments (Argomenti)
<a name="rds_tools.blue_green_get_status-arguments"></a>

Questa funzione accetta il seguente argomento:
+ `command_type` — Il tipo di comando limitato da controllare. I valori validi sono `'DDL'` (comandi del linguaggio per la definizione dei dati) e `'LO'` (operazioni su oggetti di grandi dimensioni).

### Output
<a name="rds_tools.blue_green_get_status-output"></a>

Un valore `boolean`. Restituisce `true` se durante la distribuzione è stato eseguito un comando limitato del tipo specificato, oppure `false` se non è stato rilevato alcun comando di questo tipo.

### Esempio di utilizzo
<a name="rds_tools.blue_green_get_status-example"></a>

```
=> SELECT rds_tools.blue_green_get_status('DDL');
 blue_green_get_status
-----------------------
 f
(1 row)
```

## rds\_tools.postgres\_get\_av\_diag
<a name="rds_tools.postgres_get_av_diag"></a>

Recupera informazioni diagnostiche sui processi di autovacuum che si bloccano o sono in ritardo, insieme a suggerimenti per la risoluzione di ogni problema. Esegui questa funzione di restituzione dei set nel database con l'ID di transazione più vecchio per risultati accurati. Per ulteriori informazioni, vedere [Identifica e risolvi gli aspirapolvere aggressivi](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.md).

Disponibile a partire da `rds_tools` versione di estensione 1.9.

### Prototipo di funzione
<a name="rds_tools.postgres_get_av_diag-prototype"></a>

```
rds_tools.postgres_get_av_diag()
```

### Arguments (Argomenti)
<a name="rds_tools.postgres_get_av_diag-arguments"></a>

Nessuna.

### Output
<a name="rds_tools.postgres_get_av_diag-output"></a>

Questa funzione restituisce le seguenti colonne:
+ `blocker` — La categoria di attività del database che blocca il vuoto. Il valore è uno dei seguenti:
  + Istruzione attiva
  + Inattivo in transazione
  + Transazione preparata
  + Slot di replica logica
  + Replica di lettura con slot di replica fisica
  + Replica di lettura con replica in streaming
  + Tabelle temporanee
+ `database` — Il nome del database in cui si verifica l'attività di blocco.
+ `blocker_identifier` — L'identificatore dell'attività di blocco. Il valore dipende dal tipo di blocco:
  + Per un'istruzione attiva o una sessione inattiva nella transazione, l'ID del processo con la relativa istruzione SQL.
  + Per una transazione preparata, il nome della transazione preparata.
  + Per una replica letta, l'indirizzo IP della replica.
  + Per uno slot di replica, il nome dello slot di replica.
+ `wait_event` — L'evento di attesa della sessione di blocco, se applicabile.
+ `autovacuum_lagging_by` — Il numero di transazioni rispetto alle quali autovacuum è in ritardo per la categoria.
+ `suggestion` — Un suggerimento per risolvere il blocco, incluso il nome del database, l'ID del processo e l'azione da intraprendere.
+ `suggested_action` — Una serie di azioni da intraprendere per risolvere il blocco.

### Esempio di utilizzo
<a name="rds_tools.postgres_get_av_diag-example"></a>

```
=> SELECT *
   FROM rds_tools.postgres_get_av_diag()
   ORDER BY autovacuum_lagging_by DESC;

blocker               | Active statement
database              | my_database
blocker_identifier    | SELECT pg_sleep(20000);
wait_event            | Timeout:PgSleep
autovacuum_lagging_by | 568600871
suggestion            | Connect to database "my_database", review carefully, and consider terminating the process using suggested_action.
suggested_action      | {"SELECT pg_terminate_backend(29621);"}
```

## rds\_tools.rds\_version
<a name="rds_tools.rds_version"></a>

Visualizza la versione del motore RDS per PostgreSQL per l'istanza DB. Questa funzione legge le informazioni sulla versione dai file di configurazione dell'istanza. Disponibile a partire da `rds_tools` versione di estensione 1.1.

### Prototipo di funzione
<a name="rds_tools.rds_version-prototype"></a>

```
rds_tools.rds_version()
```

### Arguments (Argomenti)
<a name="rds_tools.rds_version-arguments"></a>

Nessuna.

### Output
<a name="rds_tools.rds_version-output"></a>

Una stringa di caratteri che contiene la versione del motore.

### Esempio di utilizzo
<a name="rds_tools.rds_version-example"></a>

```
=> SELECT rds_tools.rds_version();
 rds_version
-------------
 18.1.R1
(1 row)
```

## rds\_tools.logical\_seed\_lsn
<a name="rds_tools.logical_seed_lsn"></a>

Restituisce il numero di sequenza del log di partenza logico (LSN) che rappresenta il punto in cui la replica logica diverge dall'istanza di origine. Utilizzate questa funzione per gestire le impostazioni di replica logica e comprendere i punti di coerenza della replica. Disponibile a partire da `rds_tools` versione di estensione 1.2.

### Prototipo di funzione
<a name="rds_tools.logical_seed_lsn-prototype"></a>

```
rds_tools.logical_seed_lsn()
```

### Arguments (Argomenti)
<a name="rds_tools.logical_seed_lsn-arguments"></a>

Nessuna.

### Output
<a name="rds_tools.logical_seed_lsn-output"></a>

Un valore `pg_lsn`.

### Esempio di utilizzo
<a name="rds_tools.logical_seed_lsn-example"></a>

```
=> SELECT rds_tools.logical_seed_lsn();
 logical_seed_lsn
------------------
 0/1677B68
(1 row)
```

## rds\_tools.db\_instance\_identifier
<a name="rds_tools.db_instance_identifier"></a>

Visualizza l'identificatore dell'istanza DB. Specifichi questo identificatore quando crei l'istanza DB e i servizi AWS lo utilizzano ovunque per identificare il database. Disponibile a partire da `rds_tools` versione di estensione 1.2.

### Prototipo di funzione
<a name="rds_tools.db_instance_identifier-prototype"></a>

```
rds_tools.db_instance_identifier()
```

### Arguments (Argomenti)
<a name="rds_tools.db_instance_identifier-arguments"></a>

Nessuna.

### Output
<a name="rds_tools.db_instance_identifier-output"></a>

Una stringa di caratteri che contiene l'identificatore dell'istanza DB.

### Esempio di utilizzo
<a name="rds_tools.db_instance_identifier-example"></a>

```
=> SELECT rds_tools.db_instance_identifier();
 db_instance_identifier
------------------------
 my-postgres-instance
(1 row)
```

## rds\_tools.dbi\_resource\_id
<a name="rds_tools.dbi_resource_id"></a>

Visualizza l'ID della risorsa dell'istanza DB (ID della risorsa DBI) dell'istanza DB. L'ID della risorsa DBI è un identificatore univoco e immutabile che AWS genera per l'istanza DB. Rimane costante per tutta la durata dell'istanza, anche se si rinomina l'istanza. Usa questo valore per correlare l'attività del database con AWS CloudTrail log o altri servizi di monitoraggio AWS. Questo valore corrisponde a `DbiResourceId` campo restituito da [DBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DBInstance.html) Comando API RDS. Disponibile a partire da `rds_tools` versione di estensione 1.4.

### Prototipo di funzione
<a name="rds_tools.dbi_resource_id-prototype"></a>

```
rds_tools.dbi_resource_id()
```

### Arguments (Argomenti)
<a name="rds_tools.dbi_resource_id-arguments"></a>

Nessuna.

### Output
<a name="rds_tools.dbi_resource_id-output"></a>

Una stringa di caratteri che contiene l'ID della risorsa DBI.

### Esempio di utilizzo
<a name="rds_tools.dbi_resource_id-example"></a>

```
=> SELECT rds_tools.dbi_resource_id();
          dbi_resource_id
-----------------------------------
 db-ABC123DEF456GHI789JKL012MNO345P
(1 row)
```

## rds\_tools.multi\_az\_db\_cluster\_source\_dbi\_resource\_id
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id"></a>

Visualizza l'ID della risorsa DBI dell'istanza di origine per un Multi-AZ Distribuzione del cluster DB. Usa questa funzione per comprendere la relazione tra le istanze in un Multi-AZ configurazione e per risolvere i problemi di replica o scenari di failover. Disponibile a partire da `rds_tools` versione di estensione 1.4.

### Prototipo di funzione
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id-prototype"></a>

```
rds_tools.multi_az_db_cluster_source_dbi_resource_id()
```

### Arguments (Argomenti)
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id-arguments"></a>

Nessuna.

### Output
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id-output"></a>

Una stringa di caratteri che contiene l'ID della risorsa DBI di origine. Restituisce NULL se l'istanza non fa parte di un Multi-AZ Cluster DB, il file di configurazione non esiste o `dbi_resource_id` il campo non esiste nella configurazione.

### Esempio di utilizzo
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id-example"></a>

```
=> SELECT rds_tools.multi_az_db_cluster_source_dbi_resource_id();
 multi_az_db_cluster_source_dbi_resource_id
--------------------------------------------
 db-XYZ789ABC123DEF456GHI012JKL345MNO678P
(1 row)
```

## rds\_tools.show\_topology
<a name="rds_tools.show_topology"></a>

Visualizza i metadati della topologia per RDS Multi-AZ cluster, che consente rapidi passaggi fornendo informazioni di connessione per tutte le istanze del cluster. Le librerie client come AWS Advanced JDBC Wrapper Driver utilizzano questa funzione di restituzione dei set per connettersi direttamente a tutte le istanze in un RDS Multi-AZ cluster. Per identificare l'ID della risorsa dell'istanza del writer, utilizzate questa funzione insieme a `rds_tools.multi_az_db_cluster_source_dbi_resource_id` funzione. Disponibile a partire da `rds_tools` versione di estensione 1.4.

### Prototipo di funzione
<a name="rds_tools.show_topology-prototype"></a>

```
rds_tools.show_topology([client_identifier])
```

### Arguments (Argomenti)
<a name="rds_tools.show_topology-arguments"></a>

Questa funzione accetta il seguente argomento:
+ `client_identifier` (opzionale) — Un identificatore per la libreria client o il proxy che sta interrogando la topologia. Questo parametro è facoltativo ma consigliato, perché consente ad Amazon RDS di tracciare quali client stanno interrogando attivamente la topologia e fornisce dati di telemetria per il supporto di client aggiuntivi.

### Output
<a name="rds_tools.show_topology-output"></a>

Questa funzione restituisce le seguenti colonne:
+ `id` — L'ID della risorsa DBI di ciascuna istanza nell'RDS Multi-AZ cluster.
+ `endpoint` — L'endpoint per ogni nodo del cluster.
+ `port` — Il numero di porta per ogni istanza nell'RDS Multi-AZ cluster.
+ `role` — Il ruolo del nodo nel cluster, ad esempio scrittore o lettore.
+ `status` — Lo stato del nodo.
+ `version` — La versione del record di topologia.

### Esempio di utilizzo
<a name="rds_tools.show_topology-example"></a>

```
=> SELECT id, endpoint, port, role FROM rds_tools.show_topology('my-jdbc-app');
       id        |                         endpoint                          | port | role
-----------------+-----------------------------------------------------------+------+--------
 db-IDENTIFIER-1 | somedb-instance-1.aaaaaaaaaaaa.us-west-2.rds.amazonaws.com | 5432 | writer
 db-IDENTIFIER-2 | somedb-instance-2.aaaaaaaaaaaa.us-west-2.rds.amazonaws.com | 5432 | reader
 db-IDENTIFIER-3 | somedb-instance-3.aaaaaaaaaaaa.us-west-2.rds.amazonaws.com | 5432 | reader
(3 rows)
```

## rds\_tools.pg\_ls\_multixactdir
<a name="rds_tools.pg_ls_multixactdir"></a>

Elenca il contenuto di `pg_multixact` directory, che memorizza i dati multitrasparenti in PostgreSQL. Usa questa funzione di restituzione dei set per monitorare l'utilizzo del multixact, risolvere i problemi relativi al multixact e comprendere i modelli di archiviazione del database. Disponibile a partire da `rds_tools` versione di estensione 1.7.

### Prototipo di funzione
<a name="rds_tools.pg_ls_multixactdir-prototype"></a>

```
rds_tools.pg_ls_multixactdir()
```

### Arguments (Argomenti)
<a name="rds_tools.pg_ls_multixactdir-arguments"></a>

Nessuna.

### Output
<a name="rds_tools.pg_ls_multixactdir-output"></a>

Questa funzione restituisce le seguenti colonne:
+ `name` — Il nome del file o della directory.
+ `size` — La dimensione in byte.
+ `modification` — Il timestamp dell'ultima modifica.

### Esempio di utilizzo
<a name="rds_tools.pg_ls_multixactdir-example"></a>

```
=> SELECT * FROM rds_tools.pg_ls_multixactdir();
           name            | size |      modification
---------------------------+------+------------------------
 pg_multixact/members/     | 4096 | 2026-10-01 19:17:29+00
 pg_multixact/members/0000 | 8192 | 2025-08-22 21:53:46+00
 pg_multixact/offsets/     | 4096 | 2026-10-01 19:17:29+00
 pg_multixact/offsets/0000 | 8192 | 2026-10-01 19:22:38+00
(4 rows)
```