PolyBase 연결 구성(Transact-SQL)PolyBase Connectivity Configuration (Transact-SQL)

이 항목은 다음에 적용됩니다. 예SQL Server 아니요Azure SQL Database아니요Azure SQL Data Warehouse 예병렬 데이터 웨어하우스THIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse yesParallel Data Warehouse

PolyBase Hadoop 및 Azure Blob 저장소 연결을 위한 전역 구성 설정을 표시하거나 변경합니다.Displays or changes global configuration settings for PolyBase Hadoop and Azure blob storage connectivity.

항목 링크 아이콘 Transact-SQL 구문 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax


--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 }  
[;]  

RECONFIGURE  
[;]  

인수Arguments

[ @configname= ] 'option_name'[ @configname= ] 'option_name'
구성 옵션의 이름입니다.Is the name of a configuration option. option_namevarchar(35)이며 기본값은 NULL입니다.option_name is varchar(35), with a default of NULL. 이 인수를 지정하지 않으면 옵션의 전체 목록이 반환됩니다.If not specified, the complete list of options is returned.

[ @configvalue= ] 'value'[ @configvalue= ] 'value'
새로운 구성 설정입니다.Is the new configuration setting. valueint이며 기본값은 NULL입니다.value is int, with a default of NULL. 최대값은 개별 옵션에 따라 달라집니다.The maximum value depends on the individual option.

'hadoop connectivity''hadoop connectivity'
PolyBase에서 Hadoop 클러스터 또는 Azure Blob 저장소(WASB)로의 모든 연결에 대한 Hadoop 데이터 원본 유형을 지정합니다.Specifies the type of Hadoop data source for all connections from PolyBase to Hadoop clusters or Azure blob storage (WASB). 이 설정은 외부 블레이드에 대한 외부 데이터 원본을 만드는 데 필요합니다.This setting is required in order to create an external data source for an external table. 자세한 내용은 CREATE EXTERNAL DATA SOURCE(Transact-SQL)를 참조하세요.For more information, see CREATE EXTERNAL DATA SOURCE (Transact-SQL),

다음은 Hadoop 연결 설정 및 지원되는 해당 Hadoop 데이터 원본입니다.These are the Hadoop connectivity settings and their corresponding supported Hadoop data sources. 한 번에 하나의 설정만 적용할 수 있습니다.Only one setting can be in effect at a time. 옵션 1, 4 및 7은 서버의 모든 세션에서 여러 유형의 외부 데이터 원본을 만들고 사용할 수 있도록 허용합니다.Options 1, 4, and 7 allow multiple types of external data sources to be created and used across all sessions on the server.

  • 옵션 0: Hadoop 연결 사용 안 함Option 0: Disable Hadoop connectivity

  • 옵션 1: Windows Server에서 Hortonworks HDP 1.3Option 1: Hortonworks HDP 1.3 on Windows Server

  • 옵션 1: Azure Blob 저장소(WASB[S])Option 1: Azure blob storage (WASB[S])

  • 옵션 2: Linux에서 Hortonworks HDP 1.3Option 2: Hortonworks HDP 1.3 on Linux

  • 옵션 3: Linux에서 Cloudera CDH 4.3Option 3: Cloudera CDH 4.3 on Linux

  • 옵션 4: Windows Server에서 Hortonworks HDP 2.0Option 4: Hortonworks HDP 2.0 on Windows Server

  • 옵션 4: Azure Blob 저장소(WASB[S])Option 4: Azure blob storage (WASB[S])

  • 옵션 5: Linux에서 Hortonworks HDP 2.0Option 5: Hortonworks HDP 2.0 on Linux

  • 옵션 6: Linux에서 Cloudera 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11 및 5.12Option 6: Cloudera 5.1, 5.2, 5.3, 5.4, 5.5, 5.9, 5.10, 5.11, and 5.12 on Linux

  • 옵션 7: Linux에서 Hortonworks 2.1, 2.2, 2.3, 2.4, 2.5 및 2.6Option 7: Hortonworks 2.1, 2.2, 2.3, 2.4, 2.5, and 2.6 on Linux

  • 옵션 7: Windows Server에서 Hortonworks 2.1, 2.2 및 2.3Option 7: Hortonworks 2.1, 2.2, and 2.3 on Windows Server

  • 옵션 7: Azure Blob 저장소(WASB[S])Option 7: Azure blob storage (WASB[S])

    RECONFIGURERECONFIGURE
    구성 값(config_value)과 일치하도록 실행 값(run_value)을 업데이트합니다.Updates the run value (run_value) to match the configuration value (config_value). run_value 및 config_value에 대한 정의는 결과 집합 을 참조하세요.See Result Sets for definitions of run_value and config_value. sp_configure로 설정된 새 구성 값은 RECONFIGURE 문으로 실행 값을 설정할 때까지 적용되지 않습니다.The new configuration value that is set by sp_configure does not become effective until the run value is set by the RECONFIGURE statement.

    RECONFIGURE를 실행한 후 SQL Server 서비스를 중지했다가 다시 시작해야 합니다.After running RECONFIGURE, you must stop and restart the SQL Server service. SQL Server 서비스를 중지할 때는 두 개의 추가 PolyBase 엔진 및 데이터 이동 서비스가 자동으로 중지됩니다.Note that when stopping the SQL Server service, the two additional PolyBase Engine and Data Movement Service will automatically stop. SQL Server 엔진 서비스를 다시 시작한 후 이 두 서비스를 다시 시작합니다(자동으로 시작되지 않음).After restarting the SQL Server engine service, re-start these two services again (they won’t start automatically).

반환 코드 값Return Code Values

0(성공) 또는 1(실패)0 (success) or 1 (failure)

결과 집합Result Sets

매개 변수 없이 실행한 경우 sp_configure 는 다섯 개의 열이 있는 결과 집합을 반환합니다.When executed with no parameters, sp_configure returns a result set with five columns.

열 이름Column name 데이터 형식Data type DescriptionDescription
namename nvarchar(35)nvarchar(35) 구성 옵션의 이름입니다.Name of the configuration option.
minimumminimum intint 구성 옵션의 최소값입니다.Minimum value of the configuration option.
maximummaximum intint 구성 옵션의 최대값입니다.Maximum value of the configuration option.
config_valueconfig_value intint sp_configure를 사용하여 설정된 값입니다.Value that was set using sp_configure.
run_valuerun_value intint PolyBase에서 사용 중인 현재 값입니다.Current value in use by PolyBase. 이 값은 RECONFIGURE를 실행하여 설정합니다.This value is set by running RECONFIGURE.

config_valuerun_value 는 값이 변경 중이 아니라면 일반적으로 동일합니다.The config_value and run_value are usually the same unless the value is in the process of being changed.

재구성이 진행 중인 경우 이 실행 값이 정확하기 위해서는 다시 시작해야 할 수 있습니다.A restart might be required before this run value is accurate, if the reconfiguration is in progress.

일반적인 주의 사항General Remarks

SQL ServerSQL Server에서 RECONFIGURE를 실행한 후 'hadoop connectivity'의 실행 값을 적용하려면 SQL ServerSQL Server을 다시 시작해야 합니다.In SQL ServerSQL Server, after running RECONFIGURE, for the run value of the 'hadoop connectivity' to take effect, you need to restart SQL ServerSQL Server.
병렬 데이터 웨어하우스Parallel Data Warehouse에서 RECONFIGURE를 실행한 후 'hadoop connectivity'의 실행 값을 적용하려면 병렬 데이터 웨어하우스Parallel Data Warehouse 영역을 다시 시작해야 합니다.In 병렬 데이터 웨어하우스Parallel Data Warehouse, after running RECONFIGURE, for the run value of the 'hadoop connectivity' to take effect, you need to restart the 병렬 데이터 웨어하우스Parallel Data Warehouse region.

제한 사항Limitations and Restrictions

명시적 또는 암시적 트랜잭션에서는 RECONFIGURE가 허용되지 않습니다.RECONFIGURE is not allowed in an explicit or implicit transaction.

PermissionsPermissions

모든 사용자는 매개 변수 없이 또는 매개 변수와 함께 sp_configure @configname 를 실행할 수 있습니다.All users can execute sp_configure with no parameters or the @configname parameter.

구성 값을 변경하거나 RECONFIGURE를 실행하려면 sysadmin 고정 서버 역할에 멤버 자격이나 ALTER SETTINGS 서버 수준 권한이 필요합니다.Requires ALTER SETTINGS server-level permission or membership in the sysadmin fixed server role to change a configuration value or to run RECONFIGURE.

Examples

1.A. 모든 사용 가능한 구성 설정 나열List all available configuration settings

다음 예에서는 모든 구성 옵션을 나열하는 방법을 보여 줍니다.The following example shows how to list all configuration options.

EXEC sp_configure;  

결과로 옵션 이름과 그 뒤에 해당 옵션에 대한 최소 및 최대값이 반환됩니다.The result returns the option name followed by the minimum and maximum values for the option. config_value 는 재구성이 완료되면 SQL 또는 PolyBase에서 사용할 값입니다.The config_value is the value that SQL, or PolyBase, will use when reconfiguration is complete. run_value 는 현재 사용되는 값입니다.The run_value is the value that is currently being used. config_valuerun_value 는 값이 변경 중이 아니라면 일반적으로 동일합니다.The config_value and run_value are usually the same unless the value is in the process of being changed.

2.B. 특정 구성 이름에 대한 구성 설정 나열List the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

3.C. Hadoop 연결 설정Set Hadoop connectivity

이 예에서는 PolyBase를 옵션 7로 설정합니다.This example sets PolyBase to option 7. 이 옵션을 사용하면 PolyBase가 Linux 및 Windows Server의 Hortonworks 2.1, 2.2, 2.3과 Azure Blob 저장소에 외부 테이블을 만들고 사용할 수 있습니다.This option allows PolyBase to create and use external tables on Hortonworks 2.1, 2.2, and 2.3 on Linux and Windows Server, and Azure blob storage. 예를 들어 SQL에서는 30개의 외부 테이블을 포함할 수 있습니다. 이 중 7개는 Linux의 Hortonworks 2.1에 있는 데이터를 참조하고 4개는 Linux의 Hortonworks 2.2를 참조하며 7개는 Linux의 Hortonworks 2.3을 참조하고 나머지 12개는 Azure Blob 저장소를 참조합니다.For example, SQL could have 30 external tables with 7 of them referencing data on Hortonworks 2.1 on Linux, 4 on Hortonworks 2.2 on Linux, 7 on Hortonworks 2.3 on Linux, and the other 12 referencing Azure blob storage.

--Configure external tables to reference data on Hortonworks 2.1, 2.2, and 2.3 on Linux, and Azure blob storage  

sp_configure @configname = 'hadoop connectivity', @configvalue = 7;  
GO  

RECONFIGURE  
GO  

관련 항목:See Also

sp_configure(Transact-SQL) sp_configure (Transact-SQL)
CREATE EXTERNAL TABLE(Transact-SQL) CREATE EXTERNAL TABLE (Transact-SQL)
CREATE EXTERNAL FILE FORMAT(Transact-SQL) CREATE EXTERNAL FILE FORMAT (Transact-SQL)
CREATE EXTERNAL DATA SOURCE(Transact-SQL)CREATE EXTERNAL DATA SOURCE (Transact-SQL)