Partilhar via


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 em expansão.

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

Transact-SQL convenções de sintaxe

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

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na secção Sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

@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 = porta_de_controle_do_canal_dms

A porta onde o canal de controlo para o nó principal do Serviço de Movimento de Dados PolyBase está em execução. @dms_control_channel_port é um __int16não assinado, com um intervalo de 0 para 65535. O padrão é 16450.

@head_node_sql_server_instance_name = N'nome_da_instância_head_node_sql_server'

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 de código de retorno

0 (sucesso) ou 1 (fracasso).

Permissões

Requer a permissão de CONTROL SERVER.

Comentários

Depois de executar o procedimento armazenado, desligue o mecanismo PolyBase e reinicie o PolyBase Data Movement Service na máquina. Para verificar, execute o 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';