Azure SQL DW 업로드 태스크Azure SQL DW Upload Task

Azure SQL DW 업로드 태스크 를 통해 SSIS 패키지에서 로컬 데이터를 Azure SQL DW(Data Warehouse)의 테이블에 업로드할 수 있습니다.The Azure SQL DW Upload Task enables an SSIS package to upload local data to a table in Azure SQL Data Warehouse (DW). 현재 지원되는 원본 데이터 파일 형식은 UTF8 인코딩 방식의 구분 기호로 분리된 텍스트입니다.The currently supported source data file format is delimited text in UTF8 encoding. 업로드 절차는 Azure SQL Data Warehouse Loading Patterns and Strategies(Azure SQL Data Warehouse 로드 패턴 및 전략)에 설명된 것처럼 효율적인 PolyBase 방법을 따릅니다.The uploading process follows the efficient PolyBase approach as described in the article Azure SQL Data Warehouse Loading Patterns and Strategies. 특히 데이터는 Azure Blob Storage에 먼저 업로드되고 그 다음으로 Azure SQL DW에 업로드됩니다.Specifically, data will first be uploaded to Azure Blob Storage, and then to Azure SQL DW. 그러므로 이 태스크를 사용하려면 Azure Blob Storage 계정이 필요합니다.Therefore, an Azure Blob Storage account is needed to use this task.

Azure SQL DW 업로드 태스크 의 구성 요소는 Azure에 대 한 SQL Server Integration Services (SSIS) 기능 팩합니다.The Azure SQL DW Upload Task is a component of the SQL Server Integration Services (SSIS) Feature Pack for Azure.

Azure SQL DW 업로드 태스크를 추가하려면 해당 태스크를 SSIS 도구 상자에서 디자이너 캔버스로 끌어서 놓고 두 번 클릭하거나 마우스 오른쪽 단추를 클릭하고 편집 을 클릭하여 태스크 편집기 대화 상자를 표시합니다.To add an Azure SQL DW Upload Task, drag-drop it from SSIS Toolbox to the designer canvas, and double-click or right-click and click Edit to see the task editor dialog box.

일반 페이지에서 다음 속성을 구성합니다.On the General page, configure the following properties.

필드Field DescriptionDescription
LocalDirectoryLocalDirectory 업로드할 데이터 파일이 포함된 로컬 디렉터리를 지정합니다.Specifies the local directory that contains the data files to be uploaded.
RecursivelyRecursively 하위 디렉터리를 재귀적으로 검색할 것인지 여부를 지정합니다.Specifies whether to recursively search sub-directories.
FileNameFileName 특정 이름 패턴의 파일을 선택하려면 이름 필터를 지정합니다.Specifies a name filter to select files with certain name pattern. 예를 들어E.g. MySheet.xsl\ 은 MySheet001.xsl 및 MySheetABC.xslx와 같은 파일을 포함합니다.MySheet.xsl\ will include files such as MySheet001.xsl and MySheetABC.xslx.
RowDelimiterRowDelimiter 각 행의 끝을 표시하는 문자를 지정합니다.Specifies the character(s) that marks the end of each row.
ColumnDelimiterColumnDelimiter 각 열의 끝을 표시하는 하나 이상의 문자를 지정합니다.Specifies one or more characters that mark the end of each column. 예를 들어E.g. | (파이프), \t (탭), ' (작은따옴표) "(큰따옴표) 및 0x5c (백슬래시).| (pipe), \t (tab), ' (single quote), " (double quote), and 0x5c (backslash).
IsFirstRowHeaderIsFirstRowHeader 각 데이터 파일의 첫 번째 행에 실제 데이터 대신 열 이름이 포함되는지 여부를 지정합니다.Specifies whether the first row in each data file contains column names instead of actual data.
AzureStorageConnectionAzureStorageConnection Azure Storage 연결 관리자를 지정합니다.Specifies an Azure Storage connection manager.
BlobContainerBlobContainer 로컬 데이터가 업로드되고 PolyBase를 통해 Azure DW로 릴레이되는 Blob 컨테이너의 이름을 지정합니다.Specifies the name of blob container to which local data will be uploaded and relayed to Azure DW via PolyBase. 컨테이너가 없는 경우 새 컨테이너가 만들어집니다.A new container will be created if it does not exist.
BlobDirectoryBlobDirectory 로컬 데이터가 업로드되고 PolyBase를 통해 Azure DW로 릴레이되는 Blob 디렉터리(가상 계층 구조)를 지정합니다.Specifies the blob directory (virtual hierarchical structure) to which local data will be uploaded and relayed to Azure DW via PolyBase.
RetainFilesRetainFiles Azure Storage에 업로드된 파일을 유지할지 여부를 지정합니다.Specifies whether to retain the files uploaded to Azure Storage.
CompressionTypeCompressionType Azure Storage에 파일 업로드 시 사용할 압축 형식을 지정합니다.Specifies the compression format to use upon uploading files to Azure Storage. 로컬 원본은 영향을 받지 않습니다.Local source is not affected.
CompressionLevelCompressionLevel 압축 형식에 사용할 압축 수준을 지정합니다.Specifies the compression level to use for the compression format.
AzureDwConnectionAzureDwConnection Azure SQL DW용 ADO.NET 연결 관리자를 지정합니다.Specifies an ADO.NET connection manager for Azure SQL DW.
TableNameTableName 대상 테이블의 이름을 지정합니다.Specifies name of the destination table. 기존 테이블 이름을 선택 하거나 선택 하 여 새로 만들 ** <새 테이블 … >합니다.Either choose an existing table name, or create a new one by choosing **<New Table ...>.
TableDistributionTableDistribution 새 테이블에 대한 배포 방법을 지정합니다.Specifies the distribution method for new table. 새 테이블 이름이 TableName에 대해 지정된 경우 적용합니다.Applies if a new table name is specified for TableName.
HashColumnNameHashColumnName 해시 테이블 배포에 사용되는 열을 지정합니다.Specifies the column used for hash table distribution. TableDistribution 에 대해 HASH가 지정된 경우 적용합니다.Applies if HASH is specified for TableDistribution.

새 테이블에 업로드하는지 기존 테이블에 업로드하는지에 따라 다른 매핑 페이지가 표시됩니다.You will see a different Mappings page depending on whether you are uploading to a new table or to an existing one. 새 테이블에 업로드하는 경우 매핑할 원본 열과 생성할 대상 테이블의 해당 이름을 구성합니다.In the former case, configure which source columns are to be mapped and their corresponding names in the to-be-created destination table. 기존 테이블에 업로드하는 경우 원본 열과 대상 열 간 매핑 관계를 구성합니다.In the latter case, configure the mapping relationships between source and destination columns.

페이지에서 각 원본 열에 대한 데이터 형식 속성을 구성합니다.On the Columns page, configure the data type properties for each source column.

T-SQL 페이지에는 Azure Blob Storage에서 Azure SQL DW로 데이터를 로드하는 데 사용되는 T-SQL이 표시됩니다.The T-SQL page shows the T-SQL used to load data from Azure Blob Storage to Azure SQL DW. T-SQL은 다른 페이지의 구성에서 자동으로 생성되고 태스크 실행의 일부로 실행됩니다.The T-SQL is automatically generated from configurations on the other pages, and will be executed as part of the task execution. 편집 단추를 클릭하여 특정 요구 사항을 충족하기 위해 생성된 T-SQL을 수동으로 편집하도록 선택할 수 있습니다.You may choose to manually edit the generated T-SQL to meet your particular needs by clicking the Edit button. 다시 설정 단추를 클릭하여 자동으로 생성된 T-SQL을 나중에 되돌릴 수 있습니다.You can revert to the automatically generated one later on by clicking the Reset button.