sp_polybase_join_group (Transact-SQL)

Artikel
2025-03-14

gäller för: SQL Server 2016 (13.x) och senare versioner

Lägger till en SQL Server-instans som en beräkningsnod till en PolyBase-grupp för utskalningsberäkning.

SQL Server-instansen måste ha funktionen PolyBase installerad. PolyBase möjliggör integrering av icke-SQL Server-datakällor, till exempel Hadoop och Azure Blob Storage. Se även sp_polybase_leave_group.

Transact-SQL syntaxkonventioner

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'
    )
[ ; ]

Argument

Viktig

Argument för utökade lagrade procedurer måste anges i den specifika ordning som beskrivs i avsnittet Syntax. Om parametrarna anges i fel ordning visas ett felmeddelande.

@head_node_address = N'head_node_address'

Namnet på den dator som är värd för SQL Server-huvudnoden i PolyBase-skalningsgrupp. @head_node_address är nvarchar(255).

@dms_control_channel_port = dms_kontroll_kanal_port

Porten där kontrollkanalen för huvudnoden PolyBase Data Movement Service körs. @dms_control_channel_port är en osignerad __int16med ett intervall på 0 till 65535. Standardvärdet är 16450.

@head_node_sql_server_instance_name = N'head_node_sql_server_instance_name'

Namnet på huvudnodens SQL Server-instans i PolyBase scale-out-gruppen. @head_node_sql_server_instance_name är nvarchar(16).

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Behörigheter

Kräver behörighet för kontroll av server.

Anmärkningar

När du har kört den lagrade proceduren stänger du av PolyBase-motorn och startar om PolyBase Data Movement Service på datorn. Kontrollera genom att köra följande DMV på huvudnoden:

EXEC sys.dm_exec_compute_nodes;

Exempel

Exemplet kopplar den aktuella datorn som en beräkningsnod till en PolyBase-grupp. Namnet på huvudnoden är HST01 och namnet på SQL Server-instansen på huvudnoden är MSSQLSERVER.

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

Dela via