Microsoft SQL Server

이 항목에서는 Microsoft SQL Server 대상 커넥터를 사용하여 Microsoft SQL Server 대상에 대한 연결을 구성하는 방법에 대해 설명합니다. Microsoft SQL Server 대상은 복제 작업에 사용되거나 데이터 파이프라인의 대상 데이터 플랫폼으로 사용됩니다. 데이터 파이프라인에서는 데이터 랜딩, 데이터 저장, 데이터 변환, 데이터 마트 만들기, 데이터 등록 등 다양한 작업을 대상 플랫폼에서 수행할 수 있습니다. Microsoft SQL Server 대상에 연결하기 전에 데이터베이스에서 사용자 전제 조건을 구성해야 합니다. 데이터 이동 게이트웨이을 통해 Microsoft SQL Server에 연결하는 경우 드라이버 설정에 설명된 대로 드라이버도 설치해야 합니다.

Microsoft SQL Server 대상 커넥터를 사용할 때의 제한 사항 및 고려 사항에 대한 자세한 내용은 제한 사항 및 고려 사항을 참조하십시오.

연결 속성 설정

이 섹션에서는 사용할 수 있는 연결 속성에 대해 설명합니다. 달리 명시되지 않는 한 모든 속성이 필요합니다.

데이터 이동 게이트웨이

Microsoft SQL Server 대상은 데이터 파이프라인이나 복제 작업에서 사용될 수 있습니다. Data Movement gateway는 파이프라인에서 Microsoft SQL Server 대상에 액세스하기 위해 필요할 수 있지만(Qlik Cloud에서 데이터베이스에 직접 액세스할 수 있는지 여부에 따라 다름), 복제 작업에서 Microsoft SQL Server 대상을 사용할 때는 항상 필요합니다.

데이터 파이프라인에서 Microsoft SQL Server 대상 사용

데이터 게이트웨이: 데이터 이동 게이트웨이는 대상 데이터베이스가 Qlik Cloud에서 액세스할 수 없고 비공개 링크를 통해서만 액세스할 수 있는 경우에만 필요합니다(예를 들어, 방화벽 뒤의 온프레미스 또는 Virtual Private Cloud에 있는 경우). 이 경우 대상 데이터베이스에 액세스하려는 데이터 이동 게이트웨이를 선택합니다.

사용 사례에 따라 이는 데이터 소스에서 데이터를 랜딩하기 위해 동일하거나 다른 데이터 이동 게이트웨이가 배포되어 있습니다. 가능한 데이터 이동 게이트웨이 배포 가능성에 대한 자세한 내용은 일반적인 사용 사례를 참조하십시오.

Qlik Cloud에서 대상 데이터베이스에 직접 액세스할 수 있는 경우 없음을 선택합니다.

복제 작업에서 Microsoft SQL Server 대상 사용

데이터 게이트웨이: Microsoft SQL Server 대상에 대한 연결을 테스트하는 데 사용할 데이터 이동 게이트웨이를 선택합니다. 이는 데이터 소스에 액세스하는 데 사용된 것과 동일한 게이트웨이여야 합니다.

데이터 대상

• 클라우드 공급자: 다음 중 하나를 적절하게 선택합니다.

  • 없음(온프레미스용)
  • Amazon RDS
  • Google Cloud
  • Microsoft Azure(Microsoft Azure 관리 인스턴스 및 Microsoft Azure 데이터베이스 모두 지원)

• 서버: Microsoft SQL Server 데이터베이스가 설치된 컴퓨터의 호스트 이름 또는 IP 주소입니다.

  정보 메모

  기본 포트를 재정의하려면 쉼표로 구분하여 서버 이름에 포트를 추가합니다. 예를 들어, 서버 이름이 myserver.company.local이고 포트가 3333인 경우 서버 이름은 다음과 같아야 합니다.

  myserver.company.local,3333

계정 속성

사용자 이름 및 비밀번호: Microsoft SQL Server 데이터베이스에 액세스할 수 있는 권한이 부여된 사용자의 사용자 이름과 비밀번호입니다.

데이터베이스 속성

• 데이터베이스 이름: 데이터베이스를 지정하는 데 사용할 수 있는 두 가지 방법이 있습니다.

  • 방법 1 - 목록에서 선택: 이 방법을 사용하려면 사용자가 마스터 데이터베이스에 사용자를 만들어야 합니다. 데이터베이스 로드를 클릭한 다음 데이터베이스를 선택합니다.
  • 방법 2 - 수동: 데이터베이스 이름을 수동으로 입력을 선택한 다음 데이터베이스 이름을 입력합니다.
• 암호화(신뢰할 수 있는 서버 인증서): Qlik Cloud와 데이터베이스 서버 사이의 통신을 암호화하려면 선택합니다. 선택하면 서버 인증서가 자동으로 신뢰하게 됩니다.
  • 인증서의 호스트 이름: 호스트 이름이 이 필드에 지정된 값과 일치하는 경우에만 서버 인증서를 신뢰하려면 서버 인증서 호스트 이름을 입력합니다.

내부 속성

내부 속성은 특별한 사용 사례를 위한 것이므로 대화 상자에 표시되지 않습니다. Qlik 지원 팀에서 지시한 경우에만 사용해야 합니다.

필드 오른쪽에 있는 및 버튼을 사용하여 필요에 따라 속성을 추가하거나 제거합니다.

이름

연결의 표시 이름입니다.

전제 조건

사용자 전제 조건

• 커넥터 설정에 지정된 사용자는 대상 Microsoft SQL Server 데이터베이스에서 최소한 db_owner 사용자 역할을 가지고 있어야 합니다.
• 커넥터 대화 상자에서 데이터베이스 로드를 클릭하여 데이터베이스를 선택할 수 있으려면 커넥터 설정에 지정된 사용자가 마스터 데이터베이스에 만들어져야 합니다.

드라이버 설정

드라이버는 데이터 이동 게이트웨이를 통해 데이터베이스에 액세스하는 경우에만 필요합니다. 데이터 이동 게이트웨이가 필요한 사용 사례에 대한 자세한 내용은 위의 데이터 이동 게이트웨이를 참조하십시오.

드라이버 설치 유틸리티(권장)를 사용하거나 수동으로 driver를 설치할 수 있습니다. 수동 설치는 드라이버 설치 유틸리티에 문제가 발생하는 드문 경우에만 시도해야 합니다.

드라이버 설치 유틸리티를 사용하여 드라이버 설치

이 섹션에서는 필수 driver를 설치하는 방법에 대해 설명합니다. 이 프로세스에는 필수 driver를 자동으로 다운로드, 설치 및 구성하는 스크립트 실행이 포함됩니다. 필요에 따라 스크립트를 실행하여 driver를 업데이트하고 제거할 수도 있습니다.

설치 준비

• Python 3.6 이상이 데이터 이동 게이트웨이 서버에 설치되어 있는지 확인합니다.

  Python은 대부분의 Linux 배포에 사전 설치되어 있습니다. 다음 명령을 실행하여 시스템에 설치된 Python 버전을 확인할 수 있습니다.

  python3 --version

driver 설치

driver를 다운로드하고 설치하려면:

1. Data Movement gateway 서비스 중지:

   sudo systemctl stop repagent

2. 선택적으로 서비스가 중지되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: inactive (dead) since <timestamp> ago

3. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

   opt/qlik/gateway/movement/drivers/bin

4. 다음 명령을 실행합니다.

   구문:

   ./install sqlserver

   driver를 다운로드할 수 없는 경우(액세스 제한 또는 기술 문제로 인해) driver를 다운로드할 위치와 데이터 이동 게이트웨이 컴퓨터에서 복사할 위치를 알려 주는 메시지가 표시됩니다. 완료했으면 install sqlserver 명령을 다시 실행합니다.

   그렇지 않으면 driver에 대한 EULA가 표시됩니다.

5. 다음 중 하나를 수행합니다.

   • [Enter] 키를 반복해서 눌러 EULA를 천천히 스크롤합니다.
   • 스페이스바를 반복해서 눌러 EULA를 빠르게 스크롤합니다.
   • q를 눌러 라이센스 텍스트를 종료하고 EULA 동의 옵션이 표시됩니다.

6. 다음 중 하나를 수행합니다.

   • "y"를 입력하고 [Enter]를 눌러 EULA에 동의하고 설치를 시작합니다.
   • "n"을 입력하고 [Enter] 키를 눌러 EULA를 거부하고 설치를 종료합니다.

   • "v"를 입력하고 [Enter] 키를 눌러 EULA를 다시 봅니다.

driver가 설치됩니다.

7. 설치가 완료될 때까지 기다린 다음("완료!"로 표시됨) Data Movement gateway 서비스를 시작합니다.

   sudo systemctl start repagent

8. 선택적으로 서비스가 시작되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: active (running) since <timestamp> ago

driver 업데이트

제공된 driver를 설치하기 전에 driver의 이전 버전을 제거하려면 업데이트 명령을 실행합니다.

driver를 다운로드하고 업데이트하려면:

1. Data Movement gateway 서비스 중지:

   sudo systemctl stop repagent

2. 선택적으로 서비스가 중지되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: inactive (dead) since <timestamp> ago

3. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

   opt/qlik/gateway/movement/drivers/bin

4. 다음 명령을 실행합니다.

   구문:

   ./update sqlserver

   driver를 다운로드할 수 없는 경우(액세스 제한 또는 기술 문제로 인해) driver를 다운로드할 위치와 데이터 이동 게이트웨이 컴퓨터에서 복사할 위치를 알려 주는 메시지가 표시됩니다. 완료했으면 update sqlserver 명령을 다시 실행합니다.

   그렇지 않으면 driver에 대한 EULA가 표시됩니다.

5. 다음 중 하나를 수행합니다.

   • [Enter] 키를 반복해서 눌러 EULA를 천천히 스크롤합니다.
   • 스페이스바를 반복해서 눌러 EULA를 빠르게 스크롤합니다.
   • q를 눌러 라이센스 텍스트를 종료하고 EULA 동의 옵션이 표시됩니다.

6. 다음 중 하나를 수행합니다.

   • "y"를 입력하고 [Enter]를 눌러 EULA에 동의하고 설치를 시작합니다.
   • "n"을 입력하고 [Enter] 키를 눌러 EULA를 거부하고 설치를 종료합니다.
   • "v"를 입력하고 [Enter] 키를 눌러 EULA를 처음부터 검토합니다.

이전 driver가 제거되고 새 driver가 설치됩니다.

7. 설치가 완료될 때까지 기다린 다음("완료!"로 표시됨) Data Movement gateway 서비스를 시작합니다.

   sudo systemctl start repagent

8. 선택적으로 서비스가 시작되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: active (running) since <timestamp> ago

driver 제거

driver를 제거하려면 제거 명령을 실행합니다.

driver를 제거하려면:

1. 이 커넥터를 사용하도록 구성된 모든 작업을 중지합니다.

2. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

   opt/qlik/gateway/movement/drivers/bin

3. 다음 명령을 실행합니다.

   구문:

   ./uninstall sqlserver

   driver이 제거됩니다.

수동으로 드라이버 설치

자동 드라이버 설치가 성공적으로 완료되지 않은 경우에만 수동으로 driver 설치를 시도해야 합니다.

Microsoft SQL Server를 데이터 파이프라인의 대상으로 사용하는 경우 ODBC 드라이버와 JDBC 드라이버를 모두 설치해야 합니다. 복제 작업에서 Microsoft SQL Server를 대상으로 사용하는 경우 ODBC 드라이버만 설치하면 됩니다.

ODBC 드라이버 설치

데이터 이동 게이트웨이을 설치한 후 msodbcsql<버전>.x86_64.rpm 드라이버를 다운로드합니다. /opt/qlik/gateway/movement/drivers/manifests/sqlserver.yaml의 binary-artifacts에서 지원되는 버전에 대한 직접 다운로드 링크를 찾을 수 있습니다. 다운로드가 완료되면 RPM을 데이터 이동 게이트웨이 컴퓨터에 복사합니다.

Data Movement gateway 서버에서 셸 프롬프트를 열고 다음을 수행합니다.

1. Data Movement gateway 서비스 중지:

   sudo systemctl stop repagent

2. 선택적으로 서비스가 중지되었는지 확인합니다.

   sudo systemctl status repagent

상태는 다음과 같아야 합니다.

Active: inactive (dead) since <timestamp> ago

3. 드라이버(RPM)를 설치합니다.

4. 작업 디렉터리를 <제품 디렉터리>/bin으로 변경합니다.

5. 다음과 같이 드라이버 위치를 site_arep_login.sh 파일에 복사합니다.

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql<version>/lib64/" >> site_arep_login.sh

   그러면 "LD_LIBRARY_PATH"에 드라이버가 추가되고 site_arep_login.sh 파일의 드라이버 위치가 업데이트됩니다.

6. 선택적으로 드라이버 위치가 복사되었는지 확인합니다.

   cat site_arep_login.sh

7. Data Movement gateway 서비스 시작:

   sudo systemctl start repagent

8. 선택적으로 서비스가 시작되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: active (running) since <timestamp> ago

9. Data Movement gateway에는 다음 ODBC 라이브러리가 필요합니다. msodbcsql-18.1.so.1.1

   현재 설치된 라이브러리 버전을 확인하려면 다음 명령을 실행합니다.

   ls /opt/microsoft/msodbcsql<version>/lib64/

   기존 라이브러리의 버전 번호가 다른 경우(예: libmsodbcsql-18.0.so.1.1) 기존 라이브러리와 필수 라이브러리 사이에 바로 가기 링크를 만들어야 합니다.

   이렇게 하려면 다음 명령을 실행합니다.

   cd /opt/microsoft/msodbcsql<version>/lib64/
   ln -s existing_library_name msodbcsql-18.1.so.1.1

   여기서 existing_library_name은 현재 설치된 라이브러리의 이름입니다(예: libmsodbcsql-18.0.so.1.1).

JDBC 드라이버 설치

1. mssql-jdbc-<버전>.jar 파일을 다운로드합니다. /opt/qlik/gateway/movement/drivers/manifests/sqlserver.yaml의 binary-artifacts에서 지원되는 버전에 대한 직접 다운로드 링크를 찾을 수 있습니다. 다운로드가 완료되면 JAR 파일을 데이터 이동 게이트웨이 컴퓨터의 다음 폴더에 복사합니다.

   /opt/qlik/gateway/movement/qcs_agents/qdi-db-commands/lib

2. 서비스 다시 시작에 설명된 명령을 실행하여 데이터 이동 게이트웨이 서비스를 다시 시작합니다.

제한 사항 및 고려 사항

데이터 파이프라인에서 사용 시 제한 사항 및 고려 사항

• 데이터 파이프라인에서 Microsoft SQL Server에 데이터를 랜딩할 때 실시간 보기가 지원되지 않습니다. 실시간 보기에 대한 자세한 내용은 데이터 집합 저장을 참조하십시오.

모든 데이터 작업에 적용되는 제한 사항 및 고려 사항

다음 대형 개체 유형이 소스 데이터베이스(0바이트)에서 비어 있는 경우 전체 로드 후에는 비어 있지 않습니다.

• BLOB은 0x0000(2바이트)으로 작성됩니다.
• TEXT(VARCHAR(max))는 0X00(1바이트)으로 작성됩니다.

• NTEXT(NVARCHAR(max))는 0x0000(2바이트)으로 작성됩니다.

복제 작업에만 적용되는 제한 사항 및 고려 사항

• 전체 크기 LOB 열은 일괄 최적화 적용 모드에서 지원되지 않습니다. 작업 설정에서 LOB 열 크기를 제한하거나 트랜잭션 적용 모드로 전환하여 이 제한을 해결할 수 있습니다.
• 일괄 최적화 적용 및 제한된 LOB 열 복제(KB) 옵션이 모두 활성화되면 대상의 BLOB 및 CLOB 열은 LOB 크기 제한 필드에 지정된 크기의 1/4로 잘립니다.
• 4바이트 이모티콘 문자를 복제해야 하는 경우 변환을 사용하여 데이터 유형을 WSTRING(n)에서 WSTRING(n*2)로 변환합니다.

데이터 유형

기본 데이터 유형 정보는 보존되며 데이터 집합 보기의 기본 데이터 유형 열에 표시됩니다. 열이 표시되지 않으면 데이터 집합 보기의 열 선택기를 열고 기본 데이터 유형 열을 선택해야 합니다.

다음 SQL Server 데이터 유형은 지원되지 않습니다. 데이터를 읽을 수 없습니다.

• CURSOR

• SQL_VARIANT

• TABLE

다음 데이터 유형은 VARCHAR(MAX)로 변환됩니다.

• XML

• GEOGRAPHY

• GEOMETRY