Hinweise - AWS Clean Rooms

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

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

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

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

Kombinieren mehrerer Hinweise

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

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