Verwenden eines Erläuterungsplans zur Verbesserung der Abfrageleistung von Babelfish

Ab Version 2.1.0 enthält Babelfish zwei Funktionen, die den PostgreSQL-Optimierer transparent verwenden, um geschätzte und tatsächliche Abfragepläne für T-SQL-Abfragen am TDS-Port zu generieren. Diese Funktionen ähneln der Verwendung von SET STATISTICS PROFILE oder SET SHOWPLAN_ALL mit SQL-Server-Datenbanken, um langsam laufende Abfragen zu identifizieren und zu verbessern.

Anmerkung

Das Abrufen von Abfrageplänen von Funktionen, Kontrollflüssen und Cursor wird derzeit nicht unterstützt.

In der Tabelle finden Sie einen Vergleich der Funktionen zur Erläuterung des Abfrageplans in SQL Server, Babelfish und PostgreSQL.

SQL Server	Babelfish	PostgreSQL
SHOWPLAN_ALL	BABELFISH_SHOWPLAN_ALL	EXPLAIN
STATISTICS PROFILE	BABELFISH_STATISTICS PROFILE	EXPLAIN ANALYZE
Verwendet den SQL-Server-Optimierer	Verwendet den PostgreSQL-Optimierer	Verwendet den PostgreSQL-Optimierer
Ein- und Ausgabeformat von SQL Server	Eingabeformat von SQL Server und Ausgabeformat von PostgreSQL	Ein- und Ausgabeformat von PostgreSQL
Für die Sitzung einstellen	Für die Sitzung einstellen	Auf eine bestimmte Anweisung anwenden
Unterstützt Folgendes: SELECT INSERT AKTUALISIERUNG DELETE CURSOR CREATE EXECUTE EXEC und Funktionen, einschließlich Kontrollfluss (CASE, WHILE-BREAK-CONTINUE, WAITFOR, BEGIN-END, IF-ELSE usw.)	Unterstützt Folgendes: SELECT INSERT AKTUALISIERUNG DELETE CREATE EXECUTE EXEC RAISEERROR THROW PRINT USE	Unterstützt Folgendes: SELECT INSERT AKTUALISIERUNG DELETE CURSOR CREATE EXECUTE

Verwenden Sie die Babelfish-Funktionen wie folgt:

• SET BABELFISH_SHOWPLAN_ALL [ON|OFF] – Legen Sie diese Funktion auf ON fest, um einen geschätzten Abfrageausführungsplan zu generieren. Diese Funktion implementiert das Verhalten des PostgreSQL-Befehls EXPLAIN. Verwenden Sie diesen Befehl, um den Erläuterungsplan für die angegebene Abfrage abzurufen.

• SET BABELFISH_STATISTICS PROFILE [ON|OFF] – Legen Sie diese Funktion auf ON fest, um tatsächliche Abfrageausführungspläne zu erhalten. Diese Funktion implementiert das Verhalten des PostgreSQL-Befehls EXPLAIN ANALYZE.

Weitere Informationen zu den PostgreSQL-Befehlen EXPLAIN und EXPLAIN ANALYZE finden Sie unter EXPLAIN in der PostgreSQL-Dokumentation.

Anmerkung

Ab Version 2.2.0 können Sie den Parameter escape_hatch_showplan_all auf Ignorieren einstellen, um die Verwendung des Präfixes BABELFISH_ in der SQL-Server-Syntax für die SET-Befehle SHOWPLAN_ALL und STATISTICS PROFILE zu vermeiden.

Die folgende Befehlssequenz aktiviert beispielsweise die Abfrageplanung und gibt dann einen geschätzten Abfrageausführungsplan für die SELECT-Anweisung zurück, ohne die Abfrage auszuführen. In diesem Beispiel wird die SQL-Server-Beispieldatenbank northwind mit dem sqlcmd-Befehlszeilentool zum Abfragen des TDS-Ports verwendet:

1> SET BABELFISH_SHOWPLAN_ALL ON
2> GO
1> SELECT t.territoryid, e.employeeid FROM
2> dbo.employeeterritories e, dbo.territories t
3> WHERE e.territoryid=e.territoryid ORDER BY t.territoryid;
4> GO

QUERY PLAN                                                                                                                                                                                                                                      
------------------------------------------------------------------------------------                                                                                                              
Query Text: SELECT t.territoryid, e.employeeid FROM
dbo.employeeterritories e, dbo.territories t
WHERE e.territoryid=e.territoryid ORDER BY t.territoryid
Sort  (cost=6231.74..6399.22 rows=66992 width=10)
  Sort Key: t.territoryid NULLS FIRST
  ->  Nested Loop  (cost=0.00..861.76 rows=66992 width=10)  
        ->  Seq Scan on employeeterritories e  (cost=0.00..22.70 rows=1264 width=4)
              Filter: ((territoryid)::"varchar" IS NOT NULL)
        ->  Materialize  (cost=0.00..1.79 rows=53 width=6)
              ->  Seq Scan on territories t  (cost=0.00..1.53 rows=53 width=6)

Wenn Sie mit der Überprüfung und Anpassung Ihrer Abfrage fertig sind, deaktivieren Sie die Funktion wie nachfolgend gezeigt:

1> SET BABELFISH_SHOWPLAN_ALL OFF

Wenn BABELFISH_STATISTICS PROFILE auf ON festgelegt ist, gibt jede ausgeführte Abfrage ihre reguläre Ergebnismenge zurück, gefolgt von einer zusätzlichen Ergebnismenge, die tatsächliche Abfrageausführungspläne anzeigt. Babelfish generiert den Abfrageplan, der die schnellste Ergebnismenge liefert, wenn die SELECT-Anweisung aufgerufen wird.

1> SET BABELFISH_STATISTICS PROFILE ON
1>
2> GO
1> SELECT e.employeeid, t.territoryid FROM
2> dbo.employeeterritories e, dbo.territories t
3> WHERE t.territoryid=e.territoryid ORDER BY t.territoryid;
4> GO

Die Ergebnismenge und der Abfrageplan werden zurückgegeben (dieses Beispiel zeigt nur den Abfrageplan).

QUERY PLAN                                                                                                                                                                                                                                
---------------------------------------------------------------------------
Query Text: SELECT e.employeeid, t.territoryid FROM
dbo.employeeterritories e, dbo.territories t
WHERE t.territoryid=e.territoryid ORDER BY t.territoryid
Sort  (cost=42.44..43.28 rows=337 width=10)
  Sort Key: t.territoryid NULLS FIRST                                                                                                                                               
  ->  Hash Join  (cost=2.19..28.29 rows=337 width=10)
       Hash Cond: ((e.territoryid)::"varchar" = (t.territoryid)::"varchar")
        ->  Seq Scan on employeeterritories e  (cost=0.00..22.70 rows=1270 width=36)
        ->  Hash  (cost=1.53..1.53 rows=53 width=6)
             ->  Seq Scan on territories t  (cost=0.00..1.53 rows=53 width=6)

Weitere Informationen darüber, wie Sie Ihre Abfragen und die vom PostgreSQL-Optimierer zurückgegebenen Ergebnisse analysieren können, finden Sie unter explain.depesz.com. Weitere Informationen zu den PostgreSQL-Befehlen EXPLAIN und EXPLAIN ANALYZE finden Sie unter EXPLAIN in der PostgreSQL-Dokumentation.

Parameter, die Erläuterungsoptionen von Babelfish steuern

Sie können die in der folgenden Tabelle aufgeführten Parameter verwenden, um die Art der Informationen zu steuern, die in Ihrem Abfrageplan angezeigt werden.

Parameter	Beschreibung
babelfishpg_tsql.explain_buffers	Ein boolescher Wert, der Informationen zur Puffernutzung für den Optimierer ein- und ausschaltet. (Standardwert: off) (Zulässig: off, on)
babelfishpg_tsql.explain_costs	Ein boolescher Wert, der geschätzte Start- und Gesamtkosteninformationen für den Optimierer ein- und ausschaltet. (Standardwert: on) (Zulässig: off, on)
babelfishpg_tsql.explain_format	Gibt das Ausgabeformat für den EXPLAIN-Plan an. (Standardwert: text) (Zulässig: text, xml, json, yaml)
babelfishpg_tsql.explain_settings	Ein boolescher Wert, der die Aufnahme von Informationen zu Konfigurationsparametern in die EXPLAIN-Planausgabe ein- oder ausschaltet. (Standardwert: off) (Zulässig: off, on)
babelfishpg_tsql.explain_summary	Ein boolescher Wert, der zusammenfassende Informationen wie die Gesamtzeit nach dem Abfrageplan ein- oder ausschaltet. (Standardwert: on) (Zulässig: off, on)
babelfishpg_tsql.explain_timing	Ein boolescher Wert, der die tatsächliche Startzeit und die Zeit, die in jedem Knoten in der Ausgabe verbracht wird, ein- oder ausschaltet. (Standardwert: on) (Zulässig: off, on)
babelfishpg_tsql.explain_verbose	Ein boolescher Wert, der die detaillierteste Version eines Erläuterungsplans ein- oder ausschaltet. (Standardwert: off) (Zulässig: off, on)
babelfishpg_tsql.explain_wal	Ein boolescher Wert, der die Generierung von WAL-Datensatzinformationen im Rahmen eines Erläuterungsplans aktiviert (oder deaktiviert). (Standardwert: off) (Zulässig: off, on)

Sie können die Werte aller Babelfish-bezogenen Parameter in Ihrem System überprüfen, indem Sie entweder den PostgreSQL-Client oder den SQL-Server-Client verwenden. Führen Sie den folgenden Befehl aus, um Ihre aktuellen Parameterwerte abzurufen:

1> execute sp_babelfish_configure '%explain%';
2> GO

In der folgenden Ausgabe sehen Sie, dass alle Einstellungen für diesen speziellen Babelfish-DB-Cluster auf ihre Standardwerte festgelegt sind. In diesem Beispiel wird nicht die gesamte Ausgabe gezeigt.

             name                   setting                     short_desc
---------------------------------- -------- --------------------------------------------------------
babelfishpg_tsql.explain_buffers   off      Include information on buffer usage
babelfishpg_tsql.explain_costs     on       Include information on estimated startup and total cost
babelfishpg_tsql.explain_format    text     Specify the output format, which can be TEXT, XML, JSON, or YAML
babelfishpg_tsql.explain_settings  off      Include information on configuration parameters
babelfishpg_tsql.explain_summary   on       Include summary information (e.g.,totaled timing information) after the query plan 
babelfishpg_tsql.explain_timing    on       Include actual startup time and time spent in each node in the output
babelfishpg_tsql.explain_verbose   off      Display additional information regarding the plan
babelfishpg_tsql.explain_wal       off      Include information on WAL record generation

(8 rows affected)

Sie können die Einstellung für diese Parameter mit sp_babelfish_configure ändern, wie im folgenden Beispiel veranschaulicht.

1> execute sp_babelfish_configure 'explain_verbose', 'on';
2> GO

Wenn Sie die Einstellung auf einer clusterweiten Ebene dauerhaft festlegen möchten, schließen Sie das Schlüsselwort Server ein, wie im folgenden Beispiel gezeigt.

1> execute sp_babelfish_configure 'explain_verbose', 'on', 'server';
2> GO