일반 SQL 커넥터 기술 참조

이 문서에서는 일반 SQL 커넥터에 대해 설명합니다. 이 문서는 다음 제품에 적용됩니다.

• Microsoft Identity Manager 2016(MIM2016)
• Microsoft Entra ID

MIM2016 경우 커넥터는 Microsoft 다운로드 센터에서 다운로드할 수 있습니다.

작업에서 이 커넥터를 보려면 Generic SQL Connector step-by-step(일반 SQL 커넥터 단계별) 문서를 참조하세요.

일반 SQL 커넥터 개요

일반 SQL 커넥터를 사용하면 ODBC 연결을 제공하는 데이터베이스 시스템과 동기화 서비스를 통합할 수 있습니다.

대략적인 관점에서 다음 기능은 커넥터의 현재 릴리스에서 지원됩니다.

필수 조건

커넥터를 사용하기 전에 동기화 서버에 다음 사항이 있는지 확인합니다.

• Microsoft .NET 4.6.2 프레임워크 이상
• 64비트 ODBC 클라이언트 드라이버
• 커넥터를 사용하여 Oracle 12c와 통신하는 경우 ODBC 패키지와 함께 Oracle Instant Client 12.2.0.1 이상이 필요합니다.
• 커넥터를 사용하여 Oracle 18c-23c와 통신하는 경우 ODBC 패키지와 함께 Oracle Instant Client 18-23 이상과 UTF8 문자(예: NLS_LANG=AMERICAN_AMERICA)를 지원하도록 NLS_LANG 시스템 변수를 설정해야 합니다. AL32UTF8.
• 이 커넥터는 트랜잭션당 SQL 준비된 문과 여러 문을 사용합니다. 일부 RDBM 시스템에는 트랜잭션 처리, 서버 쪽 준비 SQL 문 및 동일한 트랜잭션 내의 여러 문과 관련된 ODBC 드라이버에 문제가 있을 수 있습니다. 해당 문이 데이터베이스로 올바르게 전송되도록 DSN 연결 옵션을 적절하게 구성하세요. 예를 들어 MySQL ODBC Driver 버전 8.0.32에는 NO_SSPS=1 및 MULTI_STATEMENTS=1 옵션이 필요합니다. 'autocommit' 또는 '성공한 작업에만 커밋'와 같은 다른 옵션은 일괄 처리 내보내기가 처리되는 방식에 영향을 줄 수 있습니다. 자세한 내용은 데이터베이스 관리자에게 문의하세요. 내보내기 중에 발생하는 문제를 해결하려면 내보내기 일괄 처리 크기를 1로 설정하고 커넥터 자세한 정보 로깅을 사용하도록 설정합니다.

이 커넥터를 배포하려면 데이터베이스 구성을 변경하고 MIM의 구성을 변경해야 할 수 있습니다. 프로덕션 환경에서 타사 데이터베이스 서버와 MIM을 통합하는 배포의 경우 고객은 데이터베이스 공급업체 또는 배포 파트너와 협력하여 이 통합에 대한 도움말, 지침 및 지원을 수행하는 것이 좋습니다.

연결된 데이터 원본의 사용 권한

일반 SQL 커넥터에서 지원되는 작업을 만들거나 수행하려면 다음이 있어야 합니다.

• db_datareader
• db_datawriter

포트 및 프로토콜

ODBC 드라이버가 작동하는 데 필요한 포트는 데이터베이스 공급업체의 설명서를 참조하세요.

새 커넥터 만들기

일반 SQL 커넥터를 만들려면 동기화 서비스에서 관리 에이전트 및 만들기를 선택합니다. 일반 SQL(Microsoft) 커넥터를 선택합니다.

연결

커넥터는 연결에 ODBC DSN 파일을 사용합니다. 관리 도구의 시작 메뉴에 위치한 ODBC 데이터 원본을 사용하여 DSN 파일을 만듭니다. 관리 도구에서 커넥터에 제공할 수 있도록 파일 DSN 을 만듭니다.

연결 화면은 새 일반 SQL 커넥터를 만드는 첫 번째 화면입니다. 먼저 다음 정보를 제공해야 합니다.

• DSN 파일 경로
• 인증
  • 사용자 이름
  • 암호

데이터베이스는 다음 인증 방법 중 하나를 지원해야 합니다.

• Windows 인증: 인증하는 데이터베이스는 Windows 자격 증명을 사용하여 사용자를 확인합니다. 지정된 사용자 이름/암호는 데이터베이스를 사용하여 인증하는 데 사용됩니다. 이 계정에는 데이터베이스에 대한 권한이 필요합니다.
• SQL 인증: 인증 데이터베이스는 연결 화면에 정의된 사용자 이름/암호를 사용하여 데이터베이스에 연결합니다. DSN 파일에 사용자 이름/pasword를 저장하는 경우 연결 화면에 제공된 자격 증명이 우선합니다.
• Azure SQL Database 인증: 자세한 내용은 Microsoft Entra 인증을 통해 SQL Database에 연결을 참조하세요.

DN은 앵커입니다. 이 옵션을 선택하면 DN도 앵커 특성으로 사용됩니다. 간단한 구현을 위해 사용할 수 있지만 다음과 같은 제한이 있습니다.

• 커넥터는 하나의 개체 형식만 지원합니다. 따라서 참조 특성은 동일한 개체 형식만 참조할 수 있습니다.

내보내기 형식: 개체 바꾸기: 내보내는 동안 일부 특성만 변경되면 모든 특성을 가진 전체 개체가 내보내지고 기존 개체가 바뀝니다.

스키마 1(개체 형식 검색)

이 페이지에서는 커넥터가 데이터베이스의 다른 개체 형식을 검색하는 방법을 구성하려고 합니다.

모든 개체 형식은 파티션으로 표시되고 파티션 및 계층 구성에서 추가로 구성됩니다.

개체 유형 검색 방법: 커넥터는 이러한 개체 형식 검색 방법을 지원합니다.

• 고정 값: 개체 형식 목록에 쉼표로 구분된 목록을 제공합니다. 예: User,Group,Department
  
• 테이블/뷰/저장 프로시저: 테이블/뷰/저장 프로시저의 이름과 개체 형식 목록을 제공하는 열 이름을 제공합니다. 저장 프로시저를 사용하는 경우 [Name]:[Direction]:[Value] 형식으로 매개 변수도 제공합니다. 별도 줄에 각 매개 변수를 제공합니다.(Ctrl + Enter를 사용하여 새 줄 가져옴)
  
• SQL 쿼리: 이 옵션을 사용하면 개체 유형이 있는 단일 열을 반환하는 SQL 쿼리를 SELECT [Column Name] FROM TABLENAME제공할 수 있습니다. 반환된 열은 문자열 형식(varchar)이어야 합니다.

스키마 2(특성 유형 검색)

이 페이지에서는 특성 이름 및 형식을 검색하는 방법을 구성합니다. 구성 옵션은 이전 페이지에서 검색된 모든 개체 유형에 대해 나열됩니다.

특성 유형 검색 방법: 커넥터는 스키마 1 화면에서 검색된 모든 개체 형식을 사용하여 이러한 특성 유형 검색 방법을 지원합니다.

• 테이블/뷰/저장 프로시저: 특성 이름을 찾는 데 사용해야 하는 테이블/뷰/저장 프로시저의 이름을 제공합니다. 저장 프로시저를 사용하는 경우 [Name]:[Direction]:[Value] 형식으로 매개 변수도 제공합니다. 별도 줄에 각 매개 변수를 제공합니다.(Ctrl + Enter를 사용하여 새 줄 가져옴) 다중값 특성에서 특성 이름을 검색하려면 테이블 또는 뷰의 쉼표로 구분된 목록을 제공합니다. 부모 테이블과 자식 테이블에 열 이름이 같은 경우 다중값 시나리오는 지원되지 않습니다.
• SQL 쿼리: 이 옵션을 사용하면 특성 이름을 가진 단일 열을 반환하는 SQL 쿼리를 제공할 수 있습니다 SELECT [Column Name] FROM TABLENAME. 반환된 열은 문자열 형식(varchar)이어야 합니다.

스키마 3(앵커 및 DN 정의)

이 페이지에서는 검색된 각 개체 유형에 대해 앵커 및 DN 특성을 구성할 수 있습니다. 앵커를 고유하게 만드는 여러 특성을 선택할 수 있습니다.

• 다중값 및 부울 특성은 나열되지 않습니다.

• 연결 페이지에서 DN이 Anchor인 경우가 아니면 DN 및 앵커 에 동일한 특성을 사용할 수 없습니다.

• 연결 페이지에서 DN이 Anchor인 경우 이 페이지에는 DN 특성만 필요합니다. 이 특성은 앵커 특성으로도 사용됩니다.

  

스키마 4(특성 유형, 참조 및 방향 정의)

이 페이지를 사용하면 정수, 이진 또는 부울 값과 같은 특성 형식 및 각 특성에 대한 방향을 구성할 수 있습니다. 페이지 스키마 2 의 모든 특성은 다중값 특성을 포함하여 나열됩니다.

• DataType: 특성 형식을 동기화 엔진에서 알려진 형식에 매핑하는 데 사용됩니다. 기본값은 SQL 스키마에서 검색하는 대로 동일한 형식을 사용하지만 날짜/시간 및 참조는 쉽게 감지할 수 없습니다. 이를 위해 DateTime 또는 참조를 지정해야 합니다.
• 방향: 특성 방향을 Import, Export 또는 ImportExport로 설정할 수 있습니다. ImportExport는 기본값입니다.

참고:

• 커넥터에서 특성 형식을 검색할 수 없는 경우 문자열 데이터 형식을 사용합니다.
• 중첩 테이블 은 하나의 열 데이터베이스 테이블로 간주할 수 있습니다. Oracle은 중첩 테이블의 행을 특정 순서 없이 저장합니다. 그러나 PL/SQL 변수로 중첩 테이블을 검색하는 경우 행은 1부터 시작하는 지정된 연속 첨자입니다. 이렇게 하면 개별 행에 대한 배열과 유사한 액세스 권한이 부여됩니다.
• VARRYS 는 커넥터에서 지원되지 않습니다.

스키마 5(참조 특성에 대한 파티션 정의)

이 페이지에서는 특성이 참조하는 파티션(개체 형식)에 대한 모든 참조 특성을 구성합니다.

DN이 앵커를 사용하는 경우 참조하는 것과 동일한 개체 형식을 사용해야 합니다. 다른 개체 형식은 참조할 수 없습니다.

"*"를 선택하면 개체 형식의 열 이름도 지정해야 합니다.

가져온 후 아래 이미지와 비슷한 내용이 표시됩니다.

전역 매개 변수

전역 매개 변수 페이지는 델타 가져오기, 날짜/시간 형식 및 암호 메서드를 구성하는 데 사용됩니다.

제네릭 SQL 커넥터는 델타 가져오기에 대해 다음 메서드를 지원합니다.

• 트리거: 트리거를 사용하여 델타 뷰 생성을 참조 하세요.
• 워터마크: 모든 데이터베이스에서 사용할 수 있는 제네릭 접근 방식입니다. 워터마크 쿼리는 데이터베이스 공급업체에 따라 미리 채워집니다. 워터마크 열은 사용되는 모든 테이블/뷰에 있어야 합니다. 이 열은 테이블과 종속 테이블(다중값 또는 자식) 테이블에 대한 삽입 및 업데이트를 추적해야 합니다. 동기화 서비스와 데이터베이스 서버 간에 시계는 동기화되어야 합니다. 그렇지 않은 경우 델타 가져오기의 일부 항목을 생략할 수 있습니다.
  제한:
  • 워터마크 전략은 삭제된 개체를 지원하지 않습니다.
• 스냅샷: (Microsoft SQL Server로만 작동) 스냅샷을 사용하여 델타 뷰 생성
• 변경 내용 추적: (Microsoft SQL Server에서만 작동) 정보 변경 내용 추적
  제한:
  • 앵커 및 DN 특성은 테이블에서 선택한 개체에 대한 기본 키의 일부여야 합니다.
  • SQL 쿼리는 변경 내용 추적 사용하여 가져오기 및 내보내기 중에 지원되지 않습니다.

추가 매개 변수: 데이터베이스 서버의 위치를 나타내는 데이터베이스 서버 표준 시간대를 지정합니다. 이 값은 다양한 형식의 날짜 및 시간 특성을 지원하는 데 사용됩니다.

커넥터는 항상 날짜 및 날짜 시간을 UTC 형식으로 저장합니다. 날짜 및 시간을 올바르게 변환할 수 있으려면 데이터베이스 서버의 표준 시간대 및 형식을 지정해야 합니다. 형식은 .NET 형식으로 표현되어야 합니다.

내보내는 동안 모든 날짜 시간 특성은 커넥터에 UTC 시간 형식으로 제공되어야 합니다.

암호 구성: 커넥터는 암호 동기화 기능을 제공하고 암호 설정 및 변경을 지원합니다.

커넥터는 암호 동기화를 지원하는 두 가지 방법을 제공합니다.

• 저장 프로시저: 이 메서드는 암호 설정 및 변경을 지원하기 위해 두 개의 저장 프로시저가 필요합니다. 아래 예제에 따라 암호 SP 설정 및 암호 SP 매개 변수 변경에서 암호 추가 및 변경 작업을 위한 모든 매개 변수를 입력합니다.
• 암호 확장: 이 메서드에는 암호 확장 DLL이 필요합니다(IMAExtensible2Password 인터페이스를 구현하는 확장 DLL 이름을 제공해야 합니다). 커넥터가 런타임에 DLL을 로드할 수 있도록 확장 폴더에 암호 확장 어셈블리를 배치해야 합니다.

확장 구성 페이지에서 암호 관리를 사용하도록 설정해야 합니다 .

파티션 및 계층 구조 구성

파티션 및 계층 페이지에서 모든 개체 형식을 선택합니다. 각 개체 형식은 자체 파티션입니다.

연결 또는 전역 매개 변수 페이지에 정의된 값을 재정의할 수도 있습니다.

앵커 구성

앵커가 이미 정의되었으므로 이 페이지는 읽기 전용입니다. 선택한 앵커 특성은 항상 개체 형식에 추가되어 개체 형식 간에 고유하게 유지됩니다.

실행 단계 매개 변수 구성

이러한 단계는 커넥터의 실행 프로필에서 구성됩니다. 이러한 구성은 데이터 가져오기 및 내보내기의 실제 작업을 수행합니다.

전체 및 델타 가져오기

일반 SQL 커넥터는 다음의 메서드를 사용하여 전체 및 델타 가져오기를 지원합니다.

• 테이블
• 보기
• 저장 프로시저
• SQL 쿼리

테이블/뷰
개체에 대한 다중값 특성을 가져오려면 다중값 테이블/뷰의 이름에 테이블/뷰 이름을 제공하고 조인 조건의 각 조인 조건을 부모 테이블과 함께 제공해야 합니다. 데이터 원본에 다중값 테이블이 두 개 이상 있는 경우 단일 보기에 공용 구조체를 사용할 수 있습니다.

예: Employee 개체와 모든 다중값 특성을 가져오려고 합니다. Employee(주 테이블)과 Department(다중값)라는 두 개의 테이블이 있습니다. 다음을 수행하십시오:

• 테이블/뷰/SP에서 직원을 입력합니다.
• 다중값 테이블/뷰 이름에서 부서를 입력합니다.
• 예를 들어 Employee.DEPTID=Department.DepartmentID조인 조건의 직원 및 부서 간에 조인 조건을 입력합니다.

저장 프로시저

• 많은 데이터가 있는 경우 저장 프로시저를 사용하여 페이지 매김을 구현하는 것이 좋습니다.
• 저장 프로시저에서 페이지 매김을 지원하려면 시작 인덱스 및 끝 인덱스만 제공해야 합니다. 참조: 많은 양의 데이터를 효율적으로 페이징합니다.
• @StartIndex실행 @EndIndex 시 해당 페이지 크기 값이 구성 단계 페이지에 구성된 값으로 대체됩니다. 예를 들어 커넥터가 첫 번째 페이지를 검색하고 페이지 크기가 500으로 설정된 경우 이러한 상황에서 @StartIndex 는 1과 @EndIndex 500이 됩니다. 커넥터가 후속 페이지를 검색하고 @StartIndex 및 @EndIndex 값을 변경하는 경우 이러한 값은 증가합니다.
• 매개 변수가 있는 저장 프로시저를 실행하려면 매개 변수를 [Name]:[Direction]:[Value] 형식으로 제공합니다. 각 매개 변수를 별도의 줄에 입력합니다(Ctrl + Enter 키를 사용하여 새 줄 가져오기).
• 일반 SQL 커넥터는 Microsoft SQL Server의 연결된 서버에서 가져오기 작업을 지원합니다. 정보가 연결된 서버의 테이블에서 검색되어야 하는 경우 테이블은 다음 형식으로 제공되어야 합니다. [ServerName].[Database].[Schema].[TableName]
• 일반 SQL 커넥터는 실행 단계 정보와 스키마 탐색 간에 구조가 비슷한(모두 별칭 이름 및 데이터 형식) 개체만 지원합니다. 스키마에서 선택한 개체와 실행 단계에서 제공된 정보가 다른 경우 SQL Connector는 이러한 유형의 시나리오를 지원할 수 없습니다.

SQL 쿼리

페이지 매김이 있는 샘플 SQL 쿼리 - 잘못된 쿼리는 새 줄 문자가 사용되므로 작동하지 않습니다.

WITH A AS 
  (select dense_rank() over (order by BusinessEntityID) 
    rownumber, BusinessEntityID, DeptID, NationalIDNumber, LoginID, JobTitle, BirthDate, MaritalStatus, HireDate, ModifiedDate, Password 
    from Employees
  ) select * from A where rownumber between @StartIndex and @EndIndex

페이지 매김이 있는 샘플 SQL 쿼리 - 올바른 쿼리:

WITH A AS (select dense_rank() over (order by BusinessEntityID) rownumber, BusinessEntityID, DeptID, NationalIDNumber, LoginID, JobTitle, BirthDate, MaritalStatus, HireDate, ModifiedDate, Password from Employees) select * from A where rownumber between @StartIndex and @EndIndex

• 여러 결과 집합 쿼리는 지원되지 않습니다.
• SQL 쿼리는 페이지 매김을 지원하고 페이지 매김을 지원하는 변수로 시작 인덱스 및 끝 인덱스를 제공합니다.

델타 가져오기

델타 가져오기 구성에는 전체 가져오기에 비해 몇 가지 구성이 더 필요합니다.

• 트리거 또는 스냅샷 접근 방식을 선택하여 델타 변경 내용을 추적하는 경우 기록 테이블 또는 스냅샷 데이터베이스 이름 상자에서 기록 테이블 또는 스냅샷 데이터베이스를 제공합니다.
• 예를 들어 기록 테이블과 부모 테이블 사이에 조인 조건을 제공해야 합니다. Employee.ID=History.EmployeeID
• 기록 테이블에서 부모 테이블의 트랜잭션을 추적하려면 작업 정보가 포함된 열 이름(추가/업데이트/삭제)을 제공해야 합니다.
• 워터마크를 선택하여 델타 변경 내용을 추적하는 경우 워터마크 열 이름에 작업 정보가 포함된 열 이름을 제공합니다.
• 변경 형식 특성 열은 변경 형식에 필요합니다. 이 열은 기본 테이블 또는 다중 값 테이블에서 발생하는 변경 사항을 델타 뷰의 변경 형식에 매핑합니다. 이 열은 특성 수준 변경에 대해 Modify_Attribute 변경 유형을 포함할 수 있거나 개체 수준 변경 형식에 대한 변경 형식을 추가, 수정 또는 삭제합니다. 기본값 추가, 수정, 삭제 이외의 경우 사용자는 이 옵션을 사용하여 해당 값을 정의할 수 있습니다.

내보내기

일반 SQL 커넥터는 다음과 같은 네 가지 지원되는 메서드를 사용하여 내보내기를 지원합니다.

• 테이블
• 보기
• 저장 프로시저
• SQL 쿼리

테이블/뷰
테이블/보기 옵션을 선택하면 커넥터는 내보내기를 수행할 각 쿼리를 생성합니다.

저장 프로시저

저장 프로시저 옵션을 선택하는 경우 삽입/업데이트/삭제 작업을 수행하려면 내보내기에서 세 가지 저장 프로시저가 필요합니다.

• SP 이름 추가: 개체가 해당 테이블에서 삽입하려는 커넥터에 제공되는 경우 이 SP가 실행됩니다.
• SP 이름 업데이트: 각 테이블의 업데이트를 위해 커넥터에 개체가 제공되면 이 SP가 실행됩니다.
• SP 이름 삭제: 각 테이블에서 삭제할 커넥터에 개체가 있는 경우 이 SP가 실행됩니다.
• 저장 프로시저에 매개 변수 값으로 사용되는 스키마에서 선택된 특성입니다. 예를 들어 @EmployeeName: INPUT: EmployeeName (EmployeeName은 커넥터 스키마에서 선택되고 커넥터는 내보내기를 수행하는 동안 해당 값을 바꿉니다.)
• 매개 변수가 있는 저장 프로시저를 실행하려면 매개 변수 형식을 [Name]:[Direction]:[Value] 제공합니다. 각 매개 변수를 별도의 줄에 입력합니다(Ctrl + Enter 키를 사용하여 새 줄 가져오기).

SQL query

SQL 쿼리 옵션을 선택하는 경우 삽입/업데이트/삭제 작업을 수행하려면 내보내기에서 세 가지 쿼리가 필요합니다.

• 쿼리 삽입: 개체가 해당 테이블에서 삽입하려는 커넥터에 제공되는 경우 이 쿼리가 실행됩니다.
• 업데이트 쿼리: 각 테이블의 업데이트를 위해 커넥터에 개체가 있는 경우 이 쿼리가 실행됩니다.
• 쿼리 삭제: 이 쿼리는 각 테이블의 삭제를 위해 커넥터에 개체가 있는 경우 실행됩니다.
• 예를 들어 쿼리에 매개 변수 값으로 사용되는 스키마에서 선택한 특성 Insert into Employee (ID, Name) Values (@ID, @EmployeeName)

샘플 다단계 업데이트 SQL 쿼리 - 새 줄 문자는 SQL 문을 구분하는 데 사용됩니다.

update Employee set jobTitle=@JOBTITLE where BusinessEntityID=@BUSINESSENTITYID
insert into ChangeLog VALUES (@BUSINESSENTITYID)

문제 해결

• 커넥터 문제를 해결하기 위해 로깅을 사용하도록 설정하는 방법에 대한 자세한 내용은 커넥터에 대해 ETW 추적을 사용하도록 설정하는 방법을 참조 하세요.