sp_polybase_join_group (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Adiciona uma instância do SQL Server como um nó de computação a um grupo PolyBase para computação de expansão.

A instância do SQL Server deve ter o recurso PolyBase instalado. PolyBase permite a integração de fontes de dados que não sejam do SQL Server, como Hadoop e Armazenamento de Blobs do Azure. Consulte também sp_polybase_leave_group (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

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

@head_node_address = N'head_node_address'

O nome da máquina que hospeda o nó principal do SQL Server do grupo de expansão PolyBase. @head_node_address é nvarchar(255).

@dms_control_channel_port = dms_control_channel_port

A porta em que o canal de controle do nó de cabeçalho do Serviço de Movimentação de Dados PolyBase está em execução. @dms_control_channel_port é um __int16 sem sinal, com um intervalo de 0 a 65535. O padrão é 16450.

@head_node_sql_server_instance_name = N'head_node_sql_server_instance_name'

O nome da instância do SQL Server do nó principal no grupo de expansão PolyBase. @head_node_sql_server_instance_name é nvarchar(16).

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Requer a permissão CONTROL SERVER.

Comentários

Depois de executar o procedimento armazenado, desligue o mecanismo PolyBase e reinicie o Serviço de Movimentação de Dados PolyBase na máquina. Para verificar, execute a seguinte DMV no nó principal:

EXEC sys.dm_exec_compute_nodes;

Exemplos

O exemplo une a máquina atual como um nó de computação a um grupo PolyBase. O nome do nó principal é HST01 e o nome da instância do SQL Server no nó principal é MSSQLSERVER.

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