sp_polybase_join_group(Transact-SQL)

적용 대상: SQL Server 2016(13.x) 이상 버전

스케일 아웃 계산을 위해 SQL Server 인스턴스를 PolyBase 그룹에 컴퓨팅 노드로 추가합니다.

SQL Server 인스턴스에는 PolyBase 기능이 설치되어 있어야 합니다. PolyBase를 사용하면 Hadoop 및 Azure Blob Storage와 같은 SQL Server 이외의 데이터 원본을 통합하여 사용하도록 설정할 수 있습니다. sp_polybase_leave_group도 참조하세요.

Transact-SQL 구문 표기 규칙

구문

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

인수

@head_node_address = N'head_node_address'

PolyBase 스케일 아웃 그룹의 SQL Server 헤드 노드를 호스팅하는 컴퓨터의 이름입니다. @head_node_address는 nvarchar(255)입니다.

@dms_control_channel_port = dms_control_channel_port

헤드 노드 PolyBase 데이터 이동 서비스의 제어 채널이 실행 중인 포트입니다. @dms_control_channel_port는 unsigned __int16이며, 범위는 0~65535입니다. 기본값은 16450입니다.

@head_node_sql_server_instance_name = N'head_node_sql_server_instance_name'

PolyBase 스케일 아웃 그룹에 있는 헤드 노드 SQL Server 인스턴스의 이름입니다. @head_node_sql_server_instance_name은 nvarchar(16)입니다.

반환 코드 값

0(성공) 또는 1(실패).

사용 권한

CONTROL SERVER 권한이 필요합니다.

설명

저장 프로시저를 실행한 후 PolyBase 엔진을 종료하고 시스템에서 PolyBase 데이터 이동 서비스를 다시 시작합니다. 확인하려면 헤드 노드에서 다음 DMV를 실행합니다:

EXEC sys.dm_exec_compute_nodes;

예시

이 예시에서는 현재 컴퓨터를 PolyBase 그룹에 컴퓨팅 노드로 조인합니다. 헤드 노드의 이름은 HST01이고 헤드 노드에 있는 SQL Server 인스턴스의 이름은 MSSQLSERVER입니다.

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

관련 콘텐츠

• SQL Server에서 PolyBase를 사용한 데이터 가상화
• 시스템 저장 프로시저(Transact-SQL)