Azure Data Factory 또는 Azure Synapse Analytics를 사용하여 SAP 테이블에서 데이터 복사
적용 대상:
Azure Data Factory Azure Synapse Analytics
팁
기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!
이 문서에서는 Azure Data Factory 및 Azure Synapse Analytics 파이프라인에서 복사 작업을 사용하여 SAP 테이블에서 데이터를 복사하는 방법을 간략하게 설명합니다. 자세한 내용은 작업 복사 개요를 참조하세요.
팁
SAP 데이터 통합 시나리오에서 전반적인 지원에 대한 자세한 내용은 Azure Data Factory를 사용한 SAP 데이터 통합 백서에 설명된 각 SAP 커넥터의 자세한 소개, 비교 및 지침을 참조하세요.
지원되는 기능
이 SAP 테이블 커넥터는 다음 기능에 대해 지원됩니다.
| 지원되는 기능 | IR |
|---|---|
| 복사 작업(원본/-) | ② |
| 조회 작업 | ② |
① Azure 통합 런타임 ② 자체 호스팅 통합 런타임
복사 작업의 원본 또는 싱크로 지원되는 데이터 저장소 목록은 지원되는 데이터 저장소 표를 참조하세요.
특히 이 SAP 테이블 커넥터는 다음을 지원합니다.
다음의 SAP 테이블에서 데이터 복사:
- SAP ECC(SAP ERP Central Component) 버전 7.01 이상(2015년 이후에 릴리스된 최근 SAP 지원 패키지 스택).
- SAP BW(SAP Business Warehouse) 버전 7.01 이상(2015년 이후에 릴리스된 최근 SAP 지원 패키지 스택).
- SAP S/4HANA.
- SAP Business Suite 버전 7.01 이상(2015년 이후에 릴리스된 최근 SAP 지원 패키지 스택)의 기타 제품.
SAP 투명 테이블, 풀링된 테이블, 클러스터된 테이블 및 보기 모두에서 데이터 복사.
SNC(Secure Network Communications)가 구성된 경우 기본 인증 또는 SNC를 사용하여 데이터 복사.
SAP 애플리케이션 서버 또는 SAP 메시지 서버에 연결.
기본 또는 사용자 지정 RFC를 통해 데이터 검색.
버전 7.01 이상에서는 SAP ECC 버전 대신 SAP NetWeaver 버전을 참조합니다. 예를 들어, SAP ECC 6.0 EHP 7은 일반적으로 NetWeaver 버전 >=7.4입니다. 현재 환경에 대해 잘 모르는 경우 SAP 시스템에서 다음 단계를 따라 버전을 확인합니다.
- SAP GUI를 사용하여 SAP 시스템에 연결합니다.
- 시스템 ->상태로 이동합니다.
- SAP_BASIS의 릴리스를 확인하여 701 이상인지 확인합니다.
필수 조건
이 SAP 테이블 커넥터를 사용하려면 다음을 수행해야 합니다.
자체 호스팅 통합 런타임을 설정합니다(버전 3.17 이상). 자세한 내용은 자체 호스팅 통합 런타임 만들기 및 구성을 참조하세요.
SAP 웹 사이트에서 64비트 SAP Connector for Microsoft .NET 3.0을 다운로드하고 이를 자체 호스팅 통합 런타임 컴퓨터에 설치합니다. 설치 도중 선택적 설치 단계 창에서 GAC에 어셈블리 설치를 선택해야 합니다.
SAP 테이블 커넥터에서 사용 중인 SAP 사용자는 다음 사용 권한이 있어야 합니다.
- RFC(Remote Function Call) 대상을 사용하기 위한 권한 부여.
- S_SDSAUTH 권한 부여 개체 실행 작업에 대한 사용 권한. 과반수 권한 부여 개체에서 SAP Note 460089를 참조하세요. 기본 NCo 커넥터에는 RFC_FUNCTION_SEARCH와 같은 특정 RFC가 필요합니다.
시작하기
파이프라인에 복사 작업을 수행하려면 다음 도구 또는 SDK 중 하나를 사용하면 됩니다.
UI를 사용하여 SAP 테이블에 연결된 서비스 만들기
다음 단계를 사용하여 Azure Portal UI에서 SAP 테이블에 연결된 서비스를 만듭니다.
Azure Data Factory 또는 Synapse 작업 영역에서 관리 탭으로 이동하여 연결된 서비스를 선택하고 새로 만들기를 클릭합니다.
SAP를 검색하고 SAP 테이블 커넥터를 선택합니다.
서비스 세부 정보를 구성하고, 연결을 테스트하고, 새로운 연결된 서비스를 만듭니다.
커넥터 구성 세부 정보
다음 섹션에서는 SAP 테이블 커넥터와 관련된 엔터티를 정의하는 데 사용되는 속성에 대해 자세히 설명합니다.
연결된 서비스 속성
SAP BW Open Hub 연결된 서비스에서 지원되는 속성은 다음과 같습니다.
| 속성 | 설명 | 필수 |
|---|---|---|
type |
type 속성을 SapTable(으)로 설정해야 합니다. |
예 |
server |
SAP 인스턴스가 있는 서버의 이름입니다. SAP 애플리케이션 서버에 연결하는 데 사용합니다. |
아니요 |
systemNumber |
SAP 시스템의 시스템 번호입니다. SAP 애플리케이션 서버에 연결하는 데 사용합니다. 허용되는 값은 문자열 형식의 두 자리 10진수입니다. |
아니요 |
messageServer |
SAP 메시지 서버의 호스트 이름입니다. SAP 메시지 서버에 연결하는 데 사용합니다. |
아니요 |
messageServerService |
메시지 서버의 서비스 이름 또는 포트 번호입니다. SAP 메시지 서버에 연결하는 데 사용합니다. |
아니요 |
systemId |
테이블이 있는 SAP 시스템의 ID입니다. SAP 메시지 서버에 연결하는 데 사용합니다. |
아니요 |
logonGroup |
SAP 시스템의 로그온 그룹입니다. SAP 메시지 서버에 연결하는 데 사용합니다. |
아니요 |
clientId |
SAP 시스템의 클라이언트 ID입니다. 허용되는 값은 문자열 형식의 세 자리 10진수입니다. |
예 |
language |
SAP 시스템에서 사용하는 언어입니다. 기본값은 EN여야 합니다. |
아니요 |
userName |
SAP 서버에 대한 액세스 권한이 있는 사용자의 이름입니다. | 예 |
password |
사용자의 암호입니다. 이 필드를 SecureString 유형으로 표시하여 안전하게 저장하거나, Azure Key Vault에 저장된 비밀을 참조합니다. |
예 |
sncMode |
테이블이 있는 SAP 서버에 액세스하기 위한 SNC 활성화 표시기입니다. SNC로 SAP 서버에 연결하려는 경우에 사용합니다. 허용되는 값은 0(해제, 기본값) 또는 1(설정)입니다. |
아니요 |
sncMyName |
테이블이 있는 SAP 서버에 액세스하기 위한 개시 장치의 SNC 이름입니다.sncMode의 값이 설정일 때 적용됩니다. |
아니요 |
sncPartnerName |
테이블이 있는 SAP 서버에 액세스하기 위한 통신 파트너의 SNC 이름입니다.sncMode의 값이 설정일 때 적용됩니다. |
아니요 |
sncLibraryPath |
테이블이 있는 SAP 서버에 액세스하기 위한 외부 보안 제품의 라이브러리입니다.sncMode의 값이 설정일 때 적용됩니다. |
아니요 |
sncQop |
적용할 SNC 보호 품질 수준입니다.sncMode의 값이 설정일 때 적용됩니다. 허용되는 값은 1(인증), 2(무결성), 3(개인 정보), 8(기본값), 9(최대값)입니다. |
아니요 |
connectVia |
데이터 저장소에 연결하는 데 사용할 통합 런타임입니다. 사전 요구 사항에서 설명한 대로 자체 호스팅 통합 런타임이 필요합니다. | 예 |
예 1: SAP 애플리케이션 서버에 연결
{
"name": "SapTableLinkedService",
"properties": {
"type": "SapTable",
"typeProperties": {
"server": "<server name>",
"systemNumber": "<system number>",
"clientId": "<client ID>",
"userName": "<SAP user>",
"password": {
"type": "SecureString",
"value": "<Password for SAP user>"
}
},
"connectVia": {
"referenceName": "<name of Integration Runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
예 2: SAP 메시지 서버에 연결
{
"name": "SapTableLinkedService",
"properties": {
"type": "SapTable",
"typeProperties": {
"messageServer": "<message server name>",
"messageServerService": "<service name or port>",
"systemId": "<system ID>",
"logonGroup": "<logon group>",
"clientId": "<client ID>",
"userName": "<SAP user>",
"password": {
"type": "SecureString",
"value": "<Password for SAP user>"
}
},
"connectVia": {
"referenceName": "<name of integration runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
예 3: SNC를 사용하여 연결
{
"name": "SapTableLinkedService",
"properties": {
"type": "SapTable",
"typeProperties": {
"server": "<server name>",
"systemNumber": "<system number>",
"clientId": "<client ID>",
"userName": "<SAP user>",
"password": {
"type": "SecureString",
"value": "<Password for SAP user>"
},
"sncMode": 1,
"sncMyName": "<SNC myname>",
"sncPartnerName": "<SNC partner name>",
"sncLibraryPath": "<SNC library path>",
"sncQop": "8"
},
"connectVia": {
"referenceName": "<name of integration runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
데이터 세트 속성
데이터 세트 정의에 대한 섹션 및 속성의 전체 목록은 데이터 세트를 참조하세요. 이 섹션에서는 SAP 테이블 데이터 세트에서 지원되는 속성의 목록을 제공합니다.
SAP BW Open Hub 연결된 서비스 간에 데이터를 복사하려는 경우 다음 속성이 지원됩니다.
| 속성 | 설명 | 필수 |
|---|---|---|
type |
type 속성을 SapTableResource(으)로 설정해야 합니다. |
예 |
tableName |
데이터를 복사할 SAP 테이블의 이름입니다. | 예 |
예시
{
"name": "SAPTableDataset",
"properties": {
"type": "SapTableResource",
"typeProperties": {
"tableName": "<SAP table name>"
},
"schema": [],
"linkedServiceName": {
"referenceName": "<SAP table linked service name>",
"type": "LinkedServiceReference"
}
}
}
복사 작업 속성
작업 정의에 대한 섹션 및 속성의 전체 목록은 파이프라인을 참조하세요. 다음 섹션에서는 SAP 테이블 데이터 원본에서 지원되는 속성의 목록을 제공합니다.
SAP 테이블 원본
SAP 테이블의 데이터를 복사하려는 경우 다음과 같은 속성이 지원됩니다.
| 속성 | 설명 | 필수 |
|---|---|---|
type |
type 속성을 SapTableSource(으)로 설정해야 합니다. |
예 |
rowCount |
검색할 행의 수입니다. | 아니요 |
rfcTableFields |
SAP 테이블에서 복사할 필드(열)입니다. 예: column0, column1. |
아니요 |
rfcTableOptions |
SAP 테이블의 행을 필터링하는 옵션입니다. 예: COLUMN0 EQ 'SOMEVALUE'. 이 문서 뒷부분에 나오는 SAP 쿼리 연산자 표도 참조하세요. |
아니요 |
customRfcReadTableFunctionModule |
SAP 테이블에서 데이터를 읽는 데 사용할 수 있는 사용자 지정 RFC 함수 모듈입니다. 사용자 지정 RFC 함수 모듈을 사용하여 SAP 시스템에서 데이터를 검색 후 서비스로 반환하는 방법을 정의할 수 있습니다. 사용자 지정 함수 모듈에는 서비스에서 사용하는 기본 인터페이스인 /SAPDS/RFC_READ_TABLE2 인터페이스와 비슷하게 구현된 인터페이스(가져오기, 내보내기, 테이블)가 있어야 합니다. |
아니요 |
partitionOption |
SAP 테이블에서 읽을 파티션 메커니즘입니다. 지원되는 옵션은 다음과 같습니다.
|
아니요 |
partitionColumnName |
데이터를 분할하는 데 사용되는 열의 이름입니다. | 아니요 |
partitionUpperBound |
분할을 계속하는데 사용할 partitionColumnName에 지정된 열의 최대값입니다. |
아니요 |
partitionLowerBound |
분할을 계속하는데 사용할 partitionColumnName에 지정된 열의 최소값입니다. (참고: 파티션 옵션이 PartitionOnInt인 경우 partitionLowerBound의 값은 "0"일 수 없음) |
아니요 |
maxPartitionsNumber |
데이터를 분할할 최대 파티션 수입니다. 기본값은 1입니다. | 아니요 |
sapDataColumnDelimiter |
출력 데이터를 분할하기 위해 SAP RFC에 전달되어 구분 기호로 사용하는 단일 문자입니다. | 아니요 |
팁
SAP 테이블에 수십억 개의 행과 같은 방대한 양의 데이터가 있는 경우 partitionOption 및 partitionSetting을 사용하여 데이터를 더 작은 파티션으로 분할합니다. 이 경우 데이터는 파티션당 읽히고, 각 데이터 파티션은 단일 RFC 호출을 통해 SAP 서버에서 검색됩니다.
예를 들어, partitionOption을 partitionOnInt로 선택하면 각 파티션에 있는 행의 수는 (partitionUpperBound에서 partitionLowerBound 사이에 있는 총 행 수)/maxPartitionsNumber의 수식으로 계산됩니다.
복사 속도를 높이기 위해 데이터 파티션을 병렬로 로드하려면 복사 작업의 parallelCopies 설정이 병렬 처리 수준을 제어합니다. 예를 들어 parallelCopies의 값을 4로 설정하면 서비스는 지정된 파티션 옵션과 설정에 따라 4개의 쿼리를 동시에 생성하고 실행하며, 각 쿼리는 SAP 테이블에서 데이터의 일부를 검색합니다. maxPartitionsNumber의 값은 parallelCopies 속성 값의 배수로 설정하는 것이 좋습니다. 데이터를 파일 기반 데이터 저장소로 복사하는 경우 폴더에 여러 개의 파일(폴더 이름만 지정)로 쓰는 것이 좋습니다. 이 경우에는 단일 파일에 쓰는 것보다 성능이 더 좋습니다.
팁
BASXML은 서비스 내의 이 SAP 테이블 커넥터를 기본적으로 사용합니다.
rfcTableOptions에서 다음의 일반적인 SAP 쿼리 연산자를 사용하여 행을 필터링할 수 있습니다.
| Operator | Description |
|---|---|
EQ |
같음 |
NE |
같지 않음 |
LT |
보다 작음 |
LE |
작거나 같음 |
GT |
보다 큼 |
GE |
크거나 같음 |
IN |
TABCLASS IN ('TRANSP', 'INTTAB')의 값과 같음 |
LIKE |
LIKE 'Emma%'의 값과 같음 |
예시
"activities":[
{
"name": "CopyFromSAPTable",
"type": "Copy",
"inputs": [
{
"referenceName": "<SAP table input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "SapTableSource",
"partitionOption": "PartitionOnInt",
"partitionSettings": {
"partitionColumnName": "<partition column name>",
"partitionUpperBound": "2000",
"partitionLowerBound": "1",
"maxPartitionsNumber": 500
}
},
"sink": {
"type": "<sink type>"
},
"parallelCopies": 4
}
}
]
SAP 테이블 조인
현재 SAP 테이블 커넥터는 기본 함수 모듈을 사용하는 하나의 테이블만 지원합니다. 여러 테이블이 조인된 데이터를 가져오려면 다음 단계를 수행하여 SAP 테이블 커넥터에서 customRfcReadTableFunctionModule 속성을 활용할 수 있습니다.
- 쿼리를 “옵션”으로 사용하고 데이터를 검색하는 고유한 논리를 적용할 수 있는 사용자 지정 함수 모듈을 작성합니다.
- "사용자 지정 함수 모듈"의 경우 사용자 지정 함수 모듈의 이름을 입력합니다.
- "RFC 테이블 옵션"의 경우 함수 모듈에 제공할 테이블 조인 문을 "COLUMN0의
<TABLE1>INNER JOIN<TABLE2>"과 같은 옵션으로 지정합니다.
예제는 아래와 같습니다.
팁
SAP 테이블 커넥터에서 지원하는 뷰에서 조인된 데이터를 집계하는 것도 고려할 수 있습니다. 또한 관련 테이블을 추출하여 Azure(예: Azure Storage, Azure SQL Database)에 온보딩한 다음 Data Flow를 사용하여 추가 조인 또는 필터링을 진행해 볼 수 있습니다.
사용자 지정 함수 모듈 만들기
SAP 테이블의 경우 현재 복사 원본에서 customRfcReadTableFunctionModule 속성을 지원하므로 사용자 고유의 논리를 활용하고 데이터를 처리할 수 있습니다.
다음은 "사용자 지정 함수 모듈"을 시작하기 위한 몇 가지 요구 사항에 관한 간단한 지침입니다.
정의:
데이터를 아래 테이블 중 하나로 내보냅니다.
다음은 SAP 테이블 커넥터가 사용자 지정 함수 모듈에서 작동하는 방식을 보여 주는 그림입니다.
SAP NCO를 통해 SAP 서버와의 연결을 빌드합니다.
아래와 같이 설정된 매개 변수를 사용하여 "사용자 지정 함수 모듈"을 호출합니다.
- QUERY_TABLE: SAP 테이블 데이터 세트에 설정된 테이블 이름입니다.
- Delimiter: SAP 테이블 원본에서 설정한 구분 기호입니다.
- ROWCOUNT/Option/Fields: 테이블 원본에서 설정한 행 수/집계 옵션/필드입니다.
결과를 가져오고 아래의 방법으로 데이터를 구문 분석합니다.
필드 테이블의 값을 구문분석하여 스키마를 가져옵니다.
출력 테이블의 값을 가져와서 해당 값이 포함된 테이블을 확인합니다.
OUT_TABLE의 값을 가져와서 데이터를 구문 분석한 다음 싱크에 씁니다.
SAP 테이블의 데이터 형식 매핑
SAP 테이블의 데이터를 복사하는 경우 SAP 테이블 데이터 형식에서 서비스 내에서 사용되는 중간 데이터 형식으로 다음 매핑이 사용됩니다. 복사 활동에서 원본 스키마와 데이터 형식을 싱크에 매핑하는 방법에 대한 자세한 내용은 스키마 및 데이터 형식 매핑을 참조하세요.
| SAP ABAP 형식 | 서비스 중간 데이터 형식 |
|---|---|
C(문자열) |
String |
I(정수) |
Int32 |
F(부동) |
Double |
D(날짜) |
String |
T(시간) |
String |
P(BCD 압축, 통화, 10진수, 수량) |
Decimal |
N(숫자) |
String |
X(이진 및 원시) |
String |
조회 작업 속성
속성에 대한 자세한 내용을 보려면 조회 작업을 확인하세요.
관련 콘텐츠
복사 작업에서 원본 및 싱크로 지원되는 데이터 저장소 목록은 지원되는 데이터 저장소를 참조하세요.