PolyBase 연결 구성(Transact-SQL)

아티클
05/03/2023

적용 대상: SQL Server Azure SQL Database Azure Synapse Analytics Analytics Platform System(PDW)

PolyBase Hadoop 및 Microsoft Azure Blob Storage 연결을 위한 전역 구성 설정을 표시하거나 변경합니다.

구문

  
--List all of the configuration options  
sp_configure  
[;]  
  
--Configure Hadoop connectivity  
sp_configure [ @configname = ] 'hadoop connectivity',  
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 }  
[;]  
  
RECONFIGURE  
[;]

인수

[ @configname= ] 'option_name'
구성 옵션의 이름입니다. option_name은 varchar(35) 이며 기본값은 NULL입니다. 이 인수를 지정하지 않으면 옵션의 전체 목록이 반환됩니다.

[ @configvalue= ] 'value'
새로운 구성 설정입니다. value는 int이며 기본값은 NULL입니다. 최대값은 개별 옵션에 따라 달라집니다.

'hadoop connectivity'
PolyBase에서 Hadoop 클러스터 또는 Azure Blob Storage로 모든 연결에 대해 Hadoop 데이터 원본 유형을 지정합니다. 자세한 내용은 CREATE EXTERNAL DATA SOURCE(Transact-SQL)를 참조하세요.

다음은 Hadoop 연결 설정 및 지원되는 해당 Hadoop 데이터 원본입니다. 한 번에 하나의 설정만 적용할 수 있습니다.

옵션 1, 4, 7, 8은 서버의 모든 세션에서 여러 유형의 외부 데이터 원본을 만들고 사용할 수 있도록 허용합니다.

옵션 0: Hadoop 연결 사용 안 함
옵션 1: Windows Server의 Hortonworks HDP 1.3
옵션 1: Azure Blob Storage(WASB[S])
옵션 2: Linux의 Hortonworks HDP 1.3
옵션 3: Linux에서 Cloudera CDH 4.3
옵션 4: Windows Server의 Hortonworks HDP 2.0
옵션 4: Azure Blob Storage(WASB[S])
옵션 5: Linux의 Hortonworks HDP 2.0
옵션 6: Linux에서 Cloudera CDH 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, 5.12, 5.13
옵션 7: Linux에서 Hortonworks HDP 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.0
옵션 7: Windows Server에서 Hortonworks HDP 2.1, 2.2, 2.3, 2.4
옵션 7: Azure Blob Storage(WASB[S])
옵션 8:* Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Azure Blob Storage(WASB[S]) 및 Azure Data Lake Storage Gen2(ABFS[S])

* 옵션 8은 SQL Server 2019 CU11에서 도입되었습니다.

기본적으로 Hadoop 연결은 0(사용 안 함)으로 설정됩니다. PolyBase를 설치한 다음, 사용하도록 설정한 후에는 PolyBase Hadoop 연결 값을 구성해야 합니다. 자세한 내용은 Windows에 PolyBase 설치 및 Hadoop에서 외부 데이터에 액세스하도록 PolyBase 구성을 참조하세요.

RECONFIGURE
구성 값(config_value)과 일치하도록 실행 값(run_value)을 업데이트합니다. run_value 및 config_value의 정의는 결과 집합을 참조하세요. sp_configure로 설정된 새 구성 값은 RECONFIGURE 문으로 실행 값을 설정할 때까지 적용되지 않습니다. 그런 다음, RECONFIGURE를 실행한 후 SQL Server 서비스를 중지했다가 다시 시작해야 합니다.

중요

SQL Server 서비스를 중지할 때는 두 개의 추가 서비스인 PolyBase 엔진 및 데이터 이동 서비스도 자동으로 중지됩니다. SQL Server 엔진 서비스를 다시 시작한 후 이 두 서비스는 자동으로 시작되지 않으므로 수동으로 시작합니다.

반환 코드 값

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

결과 집합

매개 변수 없이 실행한 경우 sp_configure는 5개의 열이 있는 결과 집합을 반환합니다.

열 이름	데이터 형식	설명
name	nvarchar(35)	구성 옵션의 이름입니다.
minimum	int	구성 옵션의 최소값입니다.
maximum	int	구성 옵션의 최대값입니다.
config_value	int	sp_configure를 사용하여 설정된 값입니다.
run_value	int	PolyBase에서 사용 중인 현재 값입니다. 이 값은 RECONFIGURE를 실행하여 설정합니다. config_value 및 run_value 는 값이 변경 중이 아니라면 일반적으로 동일합니다. 재구성이 진행 중인 경우 이 실행 값이 정확하기 위해서는 다시 시작해야 할 수 있습니다.

일반적인 설명

SQL Server에서 RECONFIGURE를 실행한 후 ‘hadoop connectivity’의 실행 값을 적용하려면 SQL Server을 다시 시작해야 합니다.

분석 플랫폼 시스템(PDW)에서 RECONFIGURE를 실행한 후 ‘hadoop connectivity’의 실행 값을 적용하려면 분석 플랫폼 시스템(PDW) 영역을 다시 시작해야 합니다.

SQL Server 2022(16.x)부터 Hadoop은 PolyBase에서 지원되지 않습니다.

제한 사항

명시적 또는 암시적 트랜잭션에서는 RECONFIGURE가 허용되지 않습니다.

사용 권한

모든 사용자는 매개 변수 없이 또는 @configname 매개 변수를 사용하여 sp_configure를 실행할 수 있습니다.

구성 값을 변경하거나 RECONFIGURE를 실행하려면 sysadmin 고정 서버 역할에 멤버 자격이나 ALTER SETTINGS 서버 수준 권한이 필요합니다.

예

A. 모든 사용 가능한 구성 설정 나열

다음 예에서는 모든 구성 옵션을 나열하는 방법을 보여 줍니다.

EXEC sp_configure;

결과로 옵션 이름과 그 뒤에 해당 옵션에 대한 최소 및 최대값이 반환됩니다. config_value는 재구성이 완료되면 PolyBase에서 사용할 값입니다. run_value 는 현재 사용되는 값입니다. config_value 및 run_value 는 값이 변경 중이 아니라면 일반적으로 동일합니다.

B. 특정 구성 이름에 대한 구성 설정 나열

EXEC sp_configure @configname='hadoop connectivity';

C. Hadoop 연결 설정

이 예에서는 PolyBase를 옵션 7로 설정합니다. 이 옵션을 사용하면 PolyBase가 Linux 및 Windows Server의 HDP 2.1, 2.2, 2.3과 Azure Blob Storage에 외부 테이블을 만들고 사용할 수 있습니다. 예를 들어, SQL에서는 30개의 외부 테이블을 포함할 수 있습니다. 이 중 7개는 Linux의 Hortonworks HDP 2.1에 있는 데이터를 참조하고 4개는 Linux의 Hortonworks HDP 2.2를 참조하며 7개는 Linux의 Hortonworks HDP 2.3을 참조하고 나머지 12개는 Azure Blob Storage를 참조합니다.

--Configure external tables to reference data on Hortonworks HDP 2.1, 2.2, and 2.3 on Linux, and Azure Blob Storage  
  
sp_configure @configname = 'hadoop connectivity', @configvalue = 7;  
GO  
  
RECONFIGURE  
GO