sp_polybase_join_group (Transact-SQL)

Artikel
2025-03-13

Gilt für: SQL Server 2016 (13.x) und höhere Versionen

Fügt eine SQL Server-Instanz als Serverknoten zu einer PolyBase-Gruppe für die Scale-Out-Berechnung hinzu.

Auf der SQL Server-Instanz muss die PolyBase-Funktion installiert sein. PolyBase ermöglicht die Integration von Nicht-SQL Server-Datenquellen wie Hadoop und Azure Blob Storage. Siehe auch sp_polybase_leave_group.

Transact-SQL-Syntaxkonventionen

Syntax

sp_polybase_join_group (
    @head_node_address = N'head_node_address'
    , @dms_control_channel_port = dms_control_channel_port
    , @head_node_sql_server_instance_name = 'head_node_sql_server_instance_name'
    )
[ ; ]

Argumente

Wichtig

Argumente für erweiterte gespeicherte Prozeduren müssen in der spezifischen Reihenfolge eingegeben werden, wie im Abschnitt Syntax beschrieben. Wenn die Parameter außerhalb der Reihenfolge eingegeben werden, tritt eine Fehlermeldung auf.

@head_node_address = N'head_node_address'

Der Name des Computers, auf dem der SQL Server-Hauptknoten der PolyBase-Erweiterungsgruppe gehostet wird. @head_node_address ist nvarchar(255).

@dms_control_channel_port = dms_control_channel_port

Der Port, an dem der Kontrollkanal des PolyBase-Datenverschiebungsdienstes für den Hauptknoten ausgeführt wird. @dms_control_channel_port ist ein unsigned __int16, mit einem Bereich von 0 bis 65535. Der Standardwert ist 16450.

@head_node_sql_server_instance_name = N'head_node_sql_server_instance_name'

Der Name des Hauptknotens der SQL Server-Instanz in der PolyBase-Gruppe mit horizontaler Skalierung. @head_node_sql_server_instance_name ist nvarchar(16).

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Berechtigungen

Erfordert die CONTROL SERVER-Berechtigung.

Hinweise

Nachdem Sie die gespeicherte Prozedur ausgeführt haben, fahren Sie die PolyBase-Engine herunter und starten Sie den PolyBase-Datenverschiebungsdienst auf dem Rechner neu. Um dies zu überprüfen, führen Sie die folgende DMV-Abfrage auf dem Hauptknoten aus:

EXEC sys.dm_exec_compute_nodes;

Beispiele

Im Beispiel wird der aktuelle Computer als Berechnungsknoten in eine PolyBase-Gruppe integriert. Der Name des Hauptknotens ist HST01 und der Name der SQL Server-Instanz auf dem Hauptknoten lautet MSSQLSERVER.

EXEC sp_polybase_join_group N'HST01', 16450, N'MSSQLSERVER';

Freigeben über