

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Hinweise für SQL-Analysen enthalten Optimierungsrichtlinien, die als Leitfaden für Strategien zur Abfrageausführung AWS Clean Rooms dienen. So können Sie die Abfrageleistung verbessern und die Rechenkosten senken. Hinweise geben an, wie die Spark-Analyse-Engine ihren Ausführungsplan generieren sollte.

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

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

Hinweise werden mithilfe einer Syntax im Kommentarstil in SQL-Abfragen eingebettet und müssen direkt nach dem SELECT-Schlüsselwort platziert werden.

## Unterstützte Hinweistypen
<a name="supported-hint-types"></a>

AWS Clean Rooms unterstützt zwei Kategorien von Hinweisen: Join-Hinweise und Partitionierungshinweise.

**Topics**
+ [Hinweise zusammenführen](join-hints.md)
+ [Hinweise zur Partitionierung](partitioning-hints.md)

## Kombinieren mehrerer Hinweise
<a name="combining-multiple-hints"></a>

Sie können mehrere Hinweise in einer einzigen Abfrage angeben, indem Sie sie durch Kommas trennen:

```
-- 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;
```

## Überlegungen und Einschränkungen
<a name="hints-usage-notes"></a>
+ Hinweise sind Optimierungsvorschläge, keine Befehle. Der Abfrageoptimierer ignoriert möglicherweise Hinweise, die auf Ressourcenbeschränkungen oder Ausführungsbedingungen basieren.
+ Hinweise werden sowohl für als auch CreateAnalysisTemplate direkt in SQL-Abfragezeichenfolgen eingebettet. StartProtectedQuery APIs
+ Hinweise müssen direkt nach dem SELECT-Schlüsselwort stehen.
+ Benannte Parameter werden bei Hinweisen nicht unterstützt und lösen eine Ausnahme aus.
+ Spaltennamen in den Hinweisen REPARTITION und REPARTITION\_BY\_RANGE müssen im Eingabeschema vorhanden sein.
+ Die Spaltennamen in den REBALANCE-Hinweisen müssen in der SELECT-Ausgabeliste erscheinen.
+ Numerische Parameter müssen positive Ganzzahlen zwischen 1 und 2147483647 sein. *Wissenschaftliche Schreibweisen wie 1e1 werden nicht unterstützt*
+ Hinweise werden in Differential Privacy SQL-Abfragen nicht unterstützt.
+ Hinweise für SQL-Abfragen werden in PySpark Jobs nicht unterstützt. Verwenden Sie die Datenrahmen-API, um Anweisungen für Ausführungspläne in einem PySpark Job bereitzustellen. Weitere Informationen finden Sie in den [Apache DataFrame Spark-API-Dokumenten](https://spark.apache.org/docs/latest/api/python/reference/pyspark.sql/api/pyspark.sql.DataFrame.hint.html). 