sp_polybase_join_group (Transact-SQL)

Articolo
2025-03-20

Si applica a: SQL Server 2016 (13.x) e versioni successive

Aggiungere un'istanza di SQL Server come nodo di calcolo a un gruppo PolyBase per il calcolo con scalabilità orizzontale.

L'istanza di SQL Server deve avere la funzionalità PolyBase installata. PolyBase consente l'integrazione di origini dati non SQL Server, ad esempio Hadoop e Archiviazione BLOB di Azure. Si veda anche sp_polybase_leave_group.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

Importante

Gli argomenti per le stored procedure estese devono essere immessi nell'ordine specifico, come descritto nella sezione Sintassi. Se i parametri vengono immessi in ordine non corretto, si verifica un messaggio di errore.

@head_node_address = N'head_node_address'

Nome della macchina che ospita il nodo principale di SQL Server del gruppo con scalabilità orizzontale PolyBase. @head_node_address è nvarchar(255).

@dms_control_channel_port = dms_control_channel_port

La porta in cui è in esecuzione il canale di controllo per il servizio di movimento dei dati PolyBase nel nodo principale. @dms_control_channel_port è un unsigned __int16, con un intervallo da 0 a 65535. Il valore predefinito è 16450.

@head_node_sql_server_instance_name = N'head_node_sql_server_instance_name'

Il nome dell'istanza di SQL Server del nodo principale nel gruppo PolyBase con scalabilità orizzontale. @head_node_sql_server_instance_name è nvarchar(16).

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Autorizzazioni

È richiesta l'autorizzazione CONTROL SERVER.

Osservazioni:

Dopo aver eseguito la stored procedure, spegnere il motore PolyBase e riavviare il servizio PolyBase Data Movement sul computer. Per verificare, eseguire il seguente DMV sul nodo principale.

EXEC sys.dm_exec_compute_nodes;

Esempi

L'esempio aggiunge il computer corrente come nodo di calcolo a un gruppo PolyBase. Il nome del nodo head è HST01 e il nome dell'istanza di SQL Server nel nodo head è MSSQLSERVER.

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

Condividi tramite