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

# Funzione COUNT in Amazon QLDB
<a name="ql-functions.count"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `COUNT` la funzione per restituire il numero di documenti definiti dall'espressione specificata. Questa funzione ha due varianti:
+ `COUNT(*)`— Conta tutti i documenti nella tabella di destinazione indipendentemente dal fatto che includano o meno valori nulli o mancanti.
+ `COUNT(expression)`— Calcola il numero di documenti con valori non nulli in un campo o un'espressione specifica ed esistente.

**avvertimento**  
La `COUNT` funzione non è ottimizzata, quindi non è consigliabile utilizzarla senza una ricerca indicizzata. Quando si esegue una query in QLDB senza una ricerca indicizzata, viene richiamata una scansione completa della tabella. Ciò può causare problemi di prestazioni su tabelle di grandi dimensioni, inclusi conflitti di concorrenza e timeout delle transazioni.  
Per evitare la scansione delle tabelle, è necessario eseguire istruzioni con una clausola di `WHERE` predicato utilizzando un operatore di *uguaglianza* (`=`o`IN`) su un campo indicizzato o un ID di documento. Per ulteriori informazioni, consulta [Ottimizzazione delle prestazioni delle query](working.optimize.md).

## Sintassi
<a name="ql-functions.count.syntax"></a>

```
COUNT ( * | expression )
```

## Argomenti
<a name="ql-functions.count.arguments"></a>

*expression*  
Il nome del campo o l'espressione su cui opera la funzione. Questo parametro può essere uno qualsiasi dei supportati[Tipi di dati](ql-reference.data-types.md).

## Tipo restituito
<a name="ql-functions.count.return-type"></a>

`int`

## Esempi
<a name="ql-functions.count.examples"></a>

```
SELECT COUNT(*) FROM VehicleRegistration r WHERE r.LicensePlateNumber = 'CA762X' -- 1
SELECT COUNT(r.VIN) FROM Vehicle r WHERE r.VIN = '1N4AL11D75C109151'             -- 1
SELECT COUNT(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >>                   -- 3
```

## Funzioni correlate
<a name="ql-functions.count.related"></a>
+ [AVG](ql-functions.avg.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)