Suggerimenti - AWS Clean Rooms

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

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

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

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

Combinazione di più suggerimenti

È 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

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