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

# Suggerimenti
<a name="sql-commands-hints-spark"></a>

I suggerimenti per le analisi SQL forniscono direttive di ottimizzazione che guidano le strategie di esecuzione delle query AWS Clean Rooms, consentendoti di migliorare le prestazioni delle query e ridurre i costi di elaborazione. I suggerimenti suggeriscono come il motore di analisi Spark dovrebbe generare il suo piano di esecuzione.

## Sintassi
<a name="hints-syntax"></a>

```
SELECT /*+ {{hint_name}}({{parameters}}), {{hint_name}}({{parameters}}) */ {{column_list}}
FROM {{table_name}};
```

I suggerimenti sono incorporati nelle query SQL utilizzando una sintassi in stile commento e devono essere inseriti direttamente dopo la parola chiave SELECT.

## Tipi di suggerimenti supportati
<a name="supported-hint-types"></a>

AWS Clean Rooms supporta due categorie di suggerimenti: suggerimenti per il join e suggerimenti per il partizionamento.

**Topics**
+ [Join (suggerimenti)](join-hints.md)
+ [Suggerimenti per il partizionamento](partitioning-hints.md)

## Combinazione di più suggerimenti
<a name="combining-multiple-hints"></a>

È possibile specificare più suggerimenti in una singola query separandoli con virgole:

```
-- Combine join and partitioning hints
SELECT /*+ BROADCAST(d), REPARTITION(8) */ e.name, d.dept_name
FROM employees e JOIN departments d ON e.dept_id = d.id;

-- Multiple join hints
SELECT /*+ BROADCAST(s), MERGE(d) */ *
FROM employees e
JOIN students s ON e.id = s.id
JOIN departments d ON e.dept_id = d.id;

-- Hints within separate hint blocks within the same query
SELECT /*+ REPARTITION(100) */ /*+ COALESCE(500) */ /*+ REPARTITION_BY_RANGE(3, c) */ * FROM t;
```

## Considerazioni e limitazioni
<a name="hints-usage-notes"></a>
+ I suggerimenti sono suggerimenti di ottimizzazione, non comandi. L'ottimizzatore delle query può ignorare i suggerimenti basati su vincoli di risorse o condizioni di esecuzione.
+ I suggerimenti sono incorporati direttamente nelle stringhe di query SQL per entrambi e. CreateAnalysisTemplate StartProtectedQuery APIs
+ I suggerimenti devono essere inseriti direttamente dopo la parola chiave SELECT.
+ I parametri denominati non sono supportati con i suggerimenti e genereranno un'eccezione.
+ I nomi delle colonne nei suggerimenti REPARTITION e REPARTITION\_BY\_RANGE devono esistere nello schema di input.
+ I nomi delle colonne nei suggerimenti REBALANCE devono apparire nell'elenco di output SELECT.
+ I parametri numerici devono essere numeri interi positivi compresi tra 1 e 2147483647. *Le notazioni scientifiche come 1e1 non sono supportate*
+ I suggerimenti non sono supportati nelle query SQL sulla privacy differenziale.
+ I suggerimenti per le query SQL non sono supportati nei job. PySpark Per fornire direttive per i piani di esecuzione in un PySpark job, utilizza l'API Data Frame. Per ulteriori informazioni, consulta la [documentazione sull' DataFrame API Apache Spark.](https://spark.apache.org/docs/latest/api/python/reference/pyspark.sql/api/pyspark.sql.DataFrame.hint.html)