Compartir vía


sp_polybase_join_group (Transact-SQL)

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores

Agrega una instancia de SQL Server como nodo de ejecución a un grupo de PolyBase para una computación de escalabilidad horizontal.

Debe instalarse la característica PolyBase en la instancia de SQL Server. PolyBase permite la integración de orígenes de datos que no son de SQL Server, como Hadoop y Azure Blob Storage. Vea también sp_polybase_leave_group.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

Importante

Los argumentos para los procedimientos almacenados extendidos deben especificarse en el orden específico, tal como se describe en la sección de Sintaxis . Si los parámetros se escriben fuera de orden, se produce un mensaje de error.

@head_node_address = N'head_node_address'

Nombre de la máquina que hospeda el nodo principal de SQL Server del grupo de escalabilidad horizontal de PolyBase. @head_node_address is nvarchar(255).

@dms_control_channel_port = dms_control_channel_port

El puerto donde se ejecuta el canal de control para el Servicio de movimiento de datos de PolyBase del nodo principal. @dms_control_channel_port es un unsigned __int16, con un intervalo de 0 a 65535. El valor predeterminado es 16450.

@head_node_sql_server_instance_name = N'head_node_sql_server_instance_name'

Nombre de la instancia de SQL Server del nodo principal en el grupo de escalabilidad horizontal de PolyBase. @head_node_sql_server_instance_name es nvarchar(16).

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Permisos

Requiere el permiso CONTROL SERVER.

Comentarios

Después de ejecutar el procedimiento almacenado, apague el motor de PolyBase y reinicie el servicio de movimiento de datos de PolyBase en la máquina. Para comprobarlo, ejecute la siguiente DMV en el nodo principal:

EXEC sys.dm_exec_compute_nodes;

Ejemplos

En el ejemplo se une la máquina actual como un nodo de cómputo en un grupo de PolyBase. El nombre del nodo principal es HST01 y el nombre de la instancia de SQL Server en el nodo principal es MSSQLSERVER.

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