

 Amazon Redshift non supporterà più la creazione di nuovi Python UDFs a partire dalla Patch 198. Python esistente UDFs continuerà a funzionare fino al 30 giugno 2026. Per ulteriori informazioni, consulta il [post del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

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

# HyperLogLog funzioni
<a name="hyperloglog-functions"></a>

Di seguito, puoi trovare le descrizioni delle HyperLogLog funzioni per SQL supportate da Amazon Redshift.

**Topics**
+ [Funzione HLL](r_HLL_function.md)
+ [Funzione HLL\$1CREATE\$1SKETCH](r_HLL_CREATE_SKETCH.md)
+ [Funzione HLL\$1CARDINALITY](r_HLL_CARDINALITY.md)
+ [Funzione HLL\$1COMBINE](r_HLL_COMBINE.md)
+ [Funzione HLL\$1COMBINE\$1SKETCHES](r_HLL_COMBINE_SKETCHES.md)

# Funzione HLL
<a name="r_HLL_function"></a>

La funzione HLL restituisce la HyperLogLog cardinalità dei valori delle espressioni di input. La funzione HLL funziona con qualsiasi tipo di dati ad eccezione del tipo di dati HLLSKETCH. La funzione HLL ignora i valori NULL. Quando non ci sono righe in una tabella o tutte le righe sono NULL, la cardinalità risultante è 0.

## Sintassi
<a name="r_HLL_function-synopsis"></a>

```
HLL (aggregate_expression)
```

## Argomento
<a name="r_HLL_function-argument"></a>

 *aggregate\$1expression*   
Qualsiasi espressione valida (come il nome di una colonna) che fornisce i valori da aggregare. Questa funzione supporta qualsiasi tipo di dati come input tranne HLLSKETCH, GEOMETRY, GEOGRAPHY e VARBYTE.

## Tipo restituito
<a name="r_HLL_function-return-type"></a>

La funzione HLL restituisce un BIGINT o un valore. INT8 

## Esempi
<a name="r_HLL_function-examples"></a>

L'esempio seguente restituisce la cardinalità della colonna `an_int` nella tabella `a_table`.

```
CREATE TABLE a_table(an_int INT);
INSERT INTO a_table VALUES (1), (2), (3), (4);

SELECT hll(an_int) AS cardinality FROM a_table;
cardinality
-------------
4
```

# Funzione HLL\$1CREATE\$1SKETCH
<a name="r_HLL_CREATE_SKETCH"></a>

La funzione HLL\$1CREATE\$1SKETCH restituisce un tipo di dati HLLSKETCH che incapsula i valori delle espressioni di input. La funzione HLL\$1CREATE\$1SKETCH funziona con qualsiasi tipo di dati e ignora i valori NULL. Quando non ci sono righe in una tabella o tutte le righe sono NULL, lo schizzo risultante non ha coppie indice-valore come `{"version":1,"logm":15,"sparse":{"indices":[],"values":[]}}`.

## Sintassi
<a name="r_HLL_CREATE_SKETCH-synopsis"></a>

```
HLL_CREATE_SKETCH (aggregate_expression)
```

## Argomento
<a name="r_HLL_CREATE_SKETCH-argument"></a>

 *aggregate\$1expression*   
Qualsiasi espressione valida (come il nome di una colonna) che fornisce i valori da aggregare. I valori NULL vengono ignorati. Questa funzione supporta qualsiasi tipo di dati come input tranne HLLSKETCH, GEOMETRY, GEOGRAPHY e VARBYTE.

## Tipo restituito
<a name="r_HLL_CREATE_SKETCH-return-type"></a>

La funzione HLL\$1CREATE\$1SKETCH restituisce un valore HLLSKETCH.

## Esempi
<a name="r_HLL_CREATE_SKETCH-examples"></a>

L'esempio seguente restituisce il tipo HLLSKETCH per la colonna `an_int` nella tabella `a_table`. Un oggetto JSON viene utilizzato per rappresentare uno schizzo sparso durante l'importazione, l'esportazione o la stampa di HyperLogLog schizzi. Una rappresentazione di stringa (in formato Base64) viene utilizzata per rappresentare uno schizzo denso. HyperLogLog 

```
CREATE TABLE a_table(an_int INT);
INSERT INTO a_table VALUES (1), (2), (3), (4);

SELECT hll_create_sketch(an_int) AS sketch FROM a_table;
sketch
-------------------------------------------------------------------------------------------------------
{"version":1,"logm":15,"sparse":{"indices":[20812342,20850007,22362299,47158030],"values":[1,2,1,1]}}
(1 row)
```

# Funzione HLL\$1CARDINALITY
<a name="r_HLL_CARDINALITY"></a>

La funzione HLL\$1CARDINALITY restituisce la cardinalità del tipo di dati HLLSKETCH di input.

## Sintassi
<a name="r_HLL_CARDINALITY-synopsis"></a>

```
HLL_CARDINALITY (hllsketch_expression)
```

## Argomento
<a name="r_HLL_CARDINALITY-argument"></a>

 *hllsketch\$1expression*   
Qualsiasi espressione valida che restituisce un tipo HLLSKETCH, come ad esempio un nome di colonna. Il valore di input è il tipo di dati HLLSKETCH.

## Tipo restituito
<a name="r_HLL_CARDINALITY-return-type"></a>

La funzione HLL\$1CARDINALITY restituisce un BIGINT o un valore. INT8 

## Esempi
<a name="r_HLL_CARDINALITY-examples"></a>

L'esempio seguente restituisce la cardinalità della colonna `sketch` nella tabella `hll_table`.

```
CREATE TABLE a_table(an_int INT, b_int INT);
INSERT INTO a_table VALUES (1,1), (2,1), (3,1), (4,1), (1,2), (2,2), (3,2), (4,2), (5,2), (6,2);

CREATE TABLE hll_table (sketch HLLSKETCH);
INSERT INTO hll_table select hll_create_sketch(an_int) from a_table group by b_int;

SELECT hll_cardinality(sketch) AS cardinality FROM hll_table;
cardinality
-------------
6
4
(2 rows)
```

# Funzione HLL\$1COMBINE
<a name="r_HLL_COMBINE"></a>

La funzione di aggregazione HLL\$1COMBINE restituisce un tipo di dati HLLSKETCH che combina tutti i valori HLLSKETCH di input. 

La combinazione di due o più HyperLogLog schizzi è un nuovo HLLSKETCH che incapsula le informazioni sull'unione dei valori distinti rappresentati da ogni schizzo di input. Dopo aver combinato gli schizzi, Amazon Redshift estrae la cardinalità dell'unione di due o più set di dati. Per ulteriori informazioni su come combinare più schizzi, consultare [Esempio: restituisci uno HyperLogLog schizzo combinando più schizzi](r_HLL-examples.md#hll-examples-multiple-sketches).

## Sintassi
<a name="r_HLL_COMBINE-synopsis"></a>

```
HLL_COMBINE (hllsketch_expression)
```

## Argomento
<a name="r_HLL_COMBINE-argument"></a>

 *hllsketch\$1expression*   
Qualsiasi espressione valida che restituisce un tipo HLLSKETCH, come ad esempio un nome di colonna. Il valore di input è il tipo di dati HLLSKETCH.

## Tipo restituito
<a name="r_HLL_COMBINE-return-type"></a>

La funzione HLL\$1COMBINE restituisce un tipo HLLSKETCH.

## Esempi
<a name="r_HLL_COMBINE-examples"></a>

L'esempio seguente restituisce i valori HLLSKETCH combinati nella tabella `hll_table`.

```
CREATE TABLE a_table(an_int INT, b_int INT);
INSERT INTO a_table VALUES (1,1), (2,1), (3,1), (4,1), (1,2), (2,2), (3,2), (4,2), (5,2), (6,2);

CREATE TABLE hll_table (sketch HLLSKETCH);
INSERT INTO hll_table select hll_create_sketch(an_int) from a_table group by b_int;

SELECT hll_combine(sketch) AS sketches FROM hll_table;
sketches
----------------------------------------------------------------------------------------------------------------------------
{"version":1,"logm":15,"sparse":{"indices":[20812342,20850007,22362299,40314817,42650774,47158030],"values":[1,2,1,3,2,1]}}
(1 row)
```

# Funzione HLL\$1COMBINE\$1SKETCHES
<a name="r_HLL_COMBINE_SKETCHES"></a>

HLL\$1COMBINE\$1SKETCHES è una funzione scalare che prende come input due valori HLLSKETCH e li combina in un singolo HLLSKETCH.

La combinazione di due o più HyperLogLog schizzi è un nuovo HLLSKETCH che incapsula le informazioni sull'unione dei valori distinti rappresentati da ogni schizzo di input.

## Sintassi
<a name="r_HLL_COMBINE_SKETCHES-synopsis"></a>

```
HLL_COMBINE_SKETCHES (hllsketch_expression1, hllsketch_expression2)
```

## Argomento
<a name="r_HLL_COMBINE_SKETCHES-argument"></a>

 *hllsketch\$1expression1* e *hllsketch\$1expression2*   
Qualsiasi espressione valida che restituisce un tipo HLLSKETCH, come ad esempio un nome di colonna.

## Tipo restituito
<a name="r_HLL_COMBINE_SKETCHES-return-type"></a>

La funzione HLL\$1COMBINE\$1SKETCHES restituisce un tipo HLLSKETCH.

## Esempi
<a name="r_HLL_COMBINE_SKETCHES-examples"></a>

L'esempio seguente restituisce i valori HLLSKETCH combinati nella tabella `hll_table`.

```
WITH tbl1(x, y)
     AS (SELECT Hll_create_sketch(1),
                Hll_create_sketch(2)
         UNION ALL
         SELECT Hll_create_sketch(3),
                Hll_create_sketch(4)
         UNION ALL
         SELECT Hll_create_sketch(5),
                Hll_create_sketch(6)
         UNION ALL
         SELECT Hll_create_sketch(7),
                Hll_create_sketch(8)),
     tbl2(x, y)
     AS (SELECT Hll_create_sketch(9),
                Hll_create_sketch(10)
         UNION ALL
         SELECT Hll_create_sketch(11),
                Hll_create_sketch(12)
         UNION ALL
         SELECT Hll_create_sketch(13),
                Hll_create_sketch(14)
         UNION ALL
         SELECT Hll_create_sketch(15),
                Hll_create_sketch(16)
         UNION ALL
         SELECT Hll_create_sketch(NULL),
                Hll_create_sketch(NULL)),
     tbl3(x, y)
     AS (SELECT *
         FROM   tbl1
         UNION ALL
         SELECT *
         FROM   tbl2)
SELECT Hll_combine_sketches(x, y)
FROM   tbl3;
```