PolyBase 연결 구성(Transact-SQL)
적용 대상: 
SQL Server 
Azure SQL Database Azure Synapse Analytics PDW(Analytics Platform System)
PolyBase Hadoop 및 Microsoft Azure Blob Storage 연결을 위한 전역 구성 설정을 표시하거나 변경합니다.
구문
모든 구성 옵션을 나열합니다.
sp_configure
[ ; ]
Hadoop 연결을 구성합니다.
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 연결'
PolyBase에서 Hadoop 클러스터 또는 Azure Blob Storage로 모든 연결에 대해 Hadoop 데이터 원본 유형을 지정합니다. 자세한 내용은 CREATE EXTERNAL DATA SOURCE를 참조하세요.
다음 목록에는 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: 1 Hortonworks HDP 3.1, Cloudera CDH 6.1, 6.2, 6.3, Azure Blob Storage(WASB[S]) 및 Azure Data Lake Storage Gen2(ABFS[S])
1 옵션 8은 SQL Server 2019(15.x) CU 11에서 도입되었습니다.
기본적으로 Hadoop 연결은 (사용 안 함)으로 0 설정됩니다. PolyBase를 설치한 다음, 사용하도록 설정한 후에는 PolyBase Hadoop 연결 값을 구성해야 합니다. 자세한 내용은 Windows에 PolyBase 설치 및 Hadoop에서 외부 데이터에 액세스하도록 PolyBase 구성을 참조하세요.
RECONFIGURE
구성 값(config_value)과 일치하도록 실행 값(run_value)을 업데이트합니다. run_value 및 config_value의 정의는 결과 집합을 참조하세요. 설정된 새 구성 값은 문에 의해 sp_configure RECONFIGURE 실행 값이 설정될 때까지 유효하지 않습니다. 그런 다음, RECONFIGURE를 실행한 후 SQL Server 서비스를 중지했다가 다시 시작해야 합니다.
Important
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) 이상 버전에서는 PolyBase에서 Hadoop이 더 이상 지원되지 않습니다.
제한 사항
RECONFIGURE 는 명시적 또는 암시적 트랜잭션에서 허용되지 않습니다.
사용 권한
모든 사용자는 매개 변수 또는 @configname 매개 변수 없이 실행할 sp_configure 수 있습니다.
구성 값을 변경하거나 RECONFIGURE를 실행하려면 sysadmin 고정 서버 역할에 멤버 자격이나 ALTER SETTINGS 서버 수준 권한이 필요합니다.
예
A. 모든 사용 가능한 구성 설정 나열
다음 예에서는 모든 구성 옵션을 나열하는 방법을 보여 줍니다.
EXECUTE sp_configure;
결과로 옵션 이름과 그 뒤에 해당 옵션에 대한 최소 및 최대값이 반환됩니다. 다시 config_value 구성이 완료될 때 PolyBase에서 사용하는 값입니다. run_value 현재 사용 중인 값입니다. config_value run_value 값이 변경되는 중이 아니면 일반적으로 동일합니다.
B. 특정 구성 이름에 대한 구성 설정 나열
EXECUTE sp_configure @configname = 'hadoop connectivity';
C. Hadoop 연결 설정
이 예에서는 PolyBase를 옵션 7로 설정합니다. 이 옵션을 사용하면 PolyBase가 Linux 및 Windows Server의 HDP 2.1, 2.2, 2.3과 Azure Blob Storage에 외부 테이블을 만들고 사용할 수 있습니다. 예를 들어 SQL Server에는 30개의 외부 테이블이 있으며, 그 중 7개는 Linux의 Hortonworks HDP 2.1, Linux의 Hortonworks HDP 2.2에는 4개, Linux의 Hortonworks HDP 2.3에는 7개, 다른 12개는 Azure Blob Storage를 참조하는 데이터를 참조합니다.
이 코드는 Linux 및 Azure Blob Storage에서 Hortonworks HDP 2.1, 2.2 및 2.3의 데이터를 참조하도록 외부 테이블을 구성합니다.
EXECUTE sp_configure
@configname = 'hadoop connectivity',
@configvalue = 7;
GO
RECONFIGURE;
GO