기본 콘텐츠로 건너뛰기 보완적인 콘텐츠로 건너뛰기

문제 해결 직접 액세스 게이트웨이

이 섹션에서는 직접 액세스 게이트웨이 문제를 해결하기 위해 수행할 수 있는 다양한 작업에 대해 설명합니다.

로그 파일 보기 및 다운로드

로그 파일은 직접 액세스 게이트웨이 작업에 대한 정보를 제공합니다. Qlik 지원에서 문제 해결을 위해 로그 파일 제공을 요청할 수 있습니다. 로그 뷰어에서 로그 파일을 보거나 다운로드할 수 있습니다. 정상적인 상황에서는 로그 파일을 검사할 이유가 없지만 반복적인 실패 또는 기타 문제가 발생하는 경우 로그 파일이 원인을 정확히 찾는 데 도움이 되는 경우가 많습니다.

정보 메모로그를 보고 다운로드하려면 데이터를 소비할 수 있음 역할이 필요합니다.

로그 뷰어를 열려면:

  1. 관리 활동 센터에서 데이터 게이트웨이로 이동하여 직접 액세스 게이트웨이를 찾습니다.

  2. 행 끝에 있는 자세히을 클릭하고 로그 보기를 선택합니다.

    로그 뷰어 창이 열립니다.

  3. 왼쪽 위의 드롭다운 목록에서 Qlik 지원에서 보거나 다운로드하도록 요청한 로그 유형을 선택합니다.

    다음 로그를 사용할 수 있습니다.

    • 직접 액세스 게이트웨이 로그(DirectAccessAgent)
    • DCaaS 로그(dcaas_logs)
    • ODBC 기반 커넥터 로그(odbc-connector_logs)
    • SAP BW 커넥터 로그(QvSAPBwConnector-<날짜 + 타임스탬프>)
    • SAP ODP 커넥터 로그(QvSapConnectorPackage-<프로세스 ID>)
    • SAP SQL 커넥터 로그(QvSqlBwConnector-<날짜 + 타임스탬프>)
    • 커넥터 에이전트 로그(connector-agent_logs_<날짜>)
  4. 옆에 있는 드롭다운 목록에서 보거나 다운로드하려는 로그를 선택합니다. 로그 파일은 최신(현재 활성 로그 파일)에서 가장 오래된 것으로 정렬됩니다. 로그 파일을 선택한 후 위로 스크롤하는 화살표아래로 스크롤하는 화살표 버튼을 사용하여 각각 로그 파일의 시작 또는 끝으로 이동할 수 있습니다.

    팁 메모로그 파일 보기는 최신 메시지로 자동 업데이트되지 않습니다. 보기를 업데이트하려면 아래로 스크롤하는 화살표을 클릭하여 최신 메시지로 업데이트될 로그 파일의 끝으로 이동합니다.
  5. 로그 파일을 다운로드하려면 다운로드를 클릭합니다.

    브라우저 설정에 따라 파일이 컴퓨터에 다운로드되거나 저장하라는 메시지가 표시됩니다.

직접 액세스 게이트웨이 컴퓨터의 직접 액세스 게이트웨이 로그 열기

관리 활동 센터에서 직접 액세스 게이트웨이(DirectAccessAgent) 로그를 다운로드할 수 있을 뿐만 아니라 직접 액세스 게이트웨이 컴퓨터에서 직접 열 수도 있습니다. 기본 설치에서 이러한 로그는 다음 위치에 있습니다.

C:\Program Files\Qlik\ConnectorAgent\data\logs

로깅 수준 변경

경고 메모Qlik 지원 담당자가 지시한 경우에만 로깅 수준을 변경합니다.

아래 설명된 대로 직접 액세스 게이트웨이 로그의 로깅 수준을 변경할 수 있습니다.

커넥터 구성 요소의 로깅 수준 변경

문제 해결을 위해 커넥터 구성 요소 로그의 로깅 수준을 변경해야 할 수도 있습니다.

그렇게 하려면:

  1. C:\ProgramData\Qlik\Gateway\configuration.properties 를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
  2. <COMPONENT>_LOG_LEVEL 속성을 찾습니다. 여기서 COMPONENT는 다음 중 하나일 수 있습니다.

    • AGENT
    • DCAAS
    • ODBC
    • SAPBW
    • SAPSQL
    • SAPPACKAGE
    • FILE
  3. 다음 중 하나로 설정합니다. ERROR, WARN, INFO, DEBUG
  4. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

    정보 메모직접 액세스 게이트웨이 1.7.1부터 AGENT 구성 요소만 변경한 경우 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작할 필요가 없습니다.

DirectAccessAgent 로깅 수준 변경

문제 해결을 위해 DirectAccessAgent 로그의 로깅 수준을 변경해야 할 수도 있습니다. DirectAccessAgent는 Qlik Cloud 서비스에 대한 연결을 담당합니다. DirectAccessAgent 로그의 로깅 세부 정보 수준을 보고 변경하려면 기본 설치의 경우 ConnectorAgent 하위 폴더(C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent )에서 다음 명령을 실행합니다.

  • 현재 로깅 수준을 보려면 다음을 실행합니다.

    connectoragent configuration getloggers
  • 로깅 수준을 Trace로 설정하려면 다음을 실행합니다.

    connectoragent configuration setloggers -l Root -v DEBUG
  • 로깅 수준을 Verbose로 설정하려면 다음을 실행합니다.

    connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

등록 키 업데이트

예상치 못하게 키가 손상되거나 권한이 없는 사용자가 데이터 게이트웨이 서버에 액세스한 것으로 의심되는 경우 등록 키를 변경해야 할 수 있습니다.

등록 키를 업데이트하려면:

  1. 직접 액세스 게이트웨이 서버에서 관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
  2. 다음 명령을 실행합니다.

    • 새 키 생성:

      connectoragent qcs generate_keys

    • 키 표시:

      connectoragent qcs get_registration

      키가 표시됩니다.

      직접 액세스 등록 키 이미지

  3. 위의 예와 같이 전체 키를 복사합니다.

  4. 관리 활동 센터에서 해당 행의 끝에 있는 자세히 버튼을 클릭하고 편집을 선택하여 데이터 게이트웨이 설정을 엽니다.

  5. 필드에 키를 붙여넣고(현재 키 교체) 설정을 저장합니다.

  6. Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리에 설명된 대로 직접 액세스 게이트웨이 서버로 돌아가 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

다시 로드 세션 수명 연장

직접 액세스 게이트웨이Qlik Cloud 간의 연결이 20초 이상 유휴 상태인 경우 다음 오류와 함께 다시 로드 작업이 실패할 수 있습니다.

Invalid object name '#<TempTableName>' (indicating that the 직접 액세스 게이트웨이 temp tables are unavailable).

기본 세션 수명은 20초이지만, 이 오류가 자주 발생하는 경우 다음과 같이 세션 수명을 연장할 수 있습니다.

  1. C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.

  2. ODBC_RELOAD_SESSION_LIFE 매개 변수를 찾아 필요에 따라 값을 늘립니다.
  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

로드 요청에 대한 제한 시간 연장

네트워크 중단이 발생하면 다음 오류와 함께 다시 로드가 실패할 수 있습니다.

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

위의 오류가 자주 발생하는 경우 EXTEND_FIRST_REQUEST_TIMEOUT 매개 변수를 5~10분으로 설정해 보십시오.

정보 메모매개 변수 값의 측정값 단위는 분입니다.

수행할 작업:

  1. C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.

  2. EXTEND_FIRST_REQUEST_TIMEOUT 매개 변수를 찾아 값을 5~10분으로 늘립니다. 기본값은 "0"입니다.
  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

다시 로드 중 커넥터 충돌 완화

프로세스 격리를 통해 관리자는 게이트웨이 서버 운영 체제에 직접 액세스하여 커넥터 유형별로 다시 로드할 수 있는 프로세스 수를 제어할 수 있습니다. 여러 커넥터 프로세스에 다시 로드를 분산시키면 각 커넥터 프로세스에서 동시에 실행되는 다시 로드 수가 줄어들어 격리 수준이 높아집니다. 결과적으로 커넥터 충돌이 발생한 경우 전반적인 직접 액세스 게이트웨이 안정성이 향상될 수 있습니다.

정보 메모

직접 액세스 게이트웨이 1.6.1 이상이 필요합니다.

프로세스 격리 해제

Qlik 지원 센터에서는 문제 해결을 위해 프로세스 격리 해제를 요청할 수 있습니다.

정보 메모새로 설치하면 프로세스 격리가 기본적으로 활성화됩니다. 각 커넥터 유형에 대한 동시 다시 로드의 기본 수는 9입니다. 아래 프로세스 격리 켜거나 동시 다시 로드 수 변경에 설명된 대로 기본값을 변경할 수 있습니다.

프로세스 격리를 끄려면 다음을 수행합니다.

  1. C:\ProgramData\Qlik\Gateway\configuration.properties 파일을 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.
  2. [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE(조건부 모든 행 색 지정)을 None(지정된 행)으로 설정합니다.

  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

프로세스 격리 켜거나 동시 다시 로드 수 변경

프로세스 격리를 켜거나 동시 다시 로드 수를 변경하려면:

  1. C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.

    파일에는 다양한 커넥터 유형에 해당하는 세 가지 접두사가 포함되어 있습니다. ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name>SAPPACKAGE_<property-name>.

  2. [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODELoad 로 설정하고 [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNTN으로 설정합니다.

    여기서:

    N = 명령 프로세스 1개 + 할당할 동시 다시 로드 프로세스 수입니다. 예를 들어, 값 10은 최대 9개의 동시 다시 로드를 의미합니다.

  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

ODBC 커넥터 프로세스 격리 예

configuration.properties 파일 중 다음 부분은 최대 12번의 다시 로드에 대해 ODBC 커넥터 프로세스 격리를 활성화하는 방법을 보여 줍니다.

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

정보 메모직접 액세스 게이트웨이 버전 1.6.7부터 다른 설정을 변경하지 않고도 MAX_PROCESS_COUNT 값이 10을 초과할 수 있습니다. 특정 커넥터 유형에 대한 다시 로드를 완전히 분리하려면(즉, 커넥터 프로세스당 한 번만 다시 로드) 이 값을 최소 30으로 설정해야 하지만 워크로드에 따라서는 최대 60까지 설정해야 할 수도 있습니다.

문제 발생 시 다시 로드하기 위한 데이터 캐싱

각각의 다시 로드 작업에 대해 직접 액세스 게이트웨이는 메모리에 데이터 청크를 캐시하고 이를 디스크로 오프로드할 수 있습니다(캐싱에 할당된 크기를 초과하는 경우). 이는 자동 복구를 사용하지 않고 4025, 4020 및 4021 오류가 자주 발생하는 경우 특히 유용합니다. 데이터 청크를 디스크로 오프로드하기 위한 캐시 크기 threshold를 설정하여 이 기능을 켭니다(다시 로드할 때마다). 지정된 threshold에 도달하면 게이트웨이는 다음 암호화된 청크를 직접 액세스 게이트웨이 컴퓨터의 디스크로 오프로드합니다.

정보 메모직접 액세스 게이트웨이 1.6.8 이상이 필요합니다.

캐시 크기를 설정하려면:

  1. C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.

  2. RELOAD_CACHE_MEMORY_MBN으로 설정합니다. 기본값은 0이며 기능이 활성화되지 않음을 의미합니다.

    여기서:

    N = 데이터 청크 캐싱에 할당된 메모리 양(다시 로드할 때마다)

    정보 메모이 기능을 활성화하면 직접 액세스 게이트웨이 컴퓨터의 메모리 소비가 증가하므로 활성화된 동안 메모리에 미치는 영향을 모니터링하는 것이 좋습니다. 대부분의 상황에서는 RELOAD_CACHE_MEMORY_MB 값을 100으로 설정하면 충분합니다.
  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
정보 메모불필요한 파일 축적으로 인한 성능 저하를 방지하기 위해 처리된 데이터 청크가 컴퓨터 메모리 및 디스크에서 삭제됩니다.

기본 청크 캐시 디렉터리 재정의

정보 메모직접 액세스 게이트웨이 1.7.1 이상이 필요합니다.

각각의 다시 로드 작업에 대해 직접 액세스 게이트웨이는 메모리에 데이터 청크를 캐시하고 이를 디스크로 오프로드할 수 있습니다(캐싱에 할당된 크기를 초과하는 경우). 시스템 드라이브에 충분한 디스크 공간이 없으면 기본 청크 캐시 디렉터리(C:\ProgramData\Qlik\Gateway\tmp)를 재정의할 수 있습니다.

정보 메모안정성을 보장하고 성능을 최적화하려면 로컬 경로만 사용하는 것이 가장 좋습니다.

수행할 작업:

  1. 텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
  2. OVERRIDE_CHUNKS_CACHE_DIR 속성을 찾아 원하는 디렉터리로 설정합니다.

    예:

    OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

    정보 메모경로를 따옴표로 묶지 마십시오.
  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

ODBC(직접 액세스 게이트웨이를 통해) 커넥터를 사용하여 작업할 때 기본 Qlik Cloud 데이터 유형 재정의

정보 메모직접 액세스 게이트웨이 1.7.1 이상이 필요합니다.

공급업체 ODBC 드라이버가 소스 데이터 유형을 처리하는 데 문제가 있어 다시 로드하는 동안 오류가 발생하거나 잘못된 데이터가 Qlik Cloud에 로드되는 경우가 있습니다. 이러한 경우 Qlik Cloud 데이터 유형 또는 해당 사양(예: 배율 또는 정밀도)을 재정의할 수 있습니다.

경고 메모많은 문제는 QlikDataTypeString로 변경하면 간단히 해결할 수 있지만, 그렇게 할 수 없는 경우 소스 데이터 유형을 매핑할 수 있는 Qlik Cloud 데이터 유형에 대한 지침을 받으려면 Qlik 지원 센터에 문의하는 것이 좋습니다.

수행할 작업:

  1. 텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\custom_type_mapping.json을 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다. 이 파일에는 Qlik Cloud 데이터 유형에 대한 예 소스가 포함되어 있습니다.
  2. 문제가 있는 데이터 유형을 원하는 Qlik Cloud 데이터 유형에 매핑하는 섹션을 추가합니다.

    다음 예(custom_type_mapping.json 파일에 포함됨)에서 고객은 Qlik Cloud DateTime 데이터 유형의 크기를 27로 변경해야 합니다.

    {

    "Identifier": "Amazon Athena ODBC (x64)",

    "NativeDataType": "timestamp with time zone",

    "QlikDataType": "DateTime",

    "Size": 27,

    "IsBit": false

    }

  3. custom_type_mapping.json 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
  4. 데이터를 다시 로드합니다.

직접 액세스 게이트웨이Qlik Cloud에 다시 연결하도록 강제합니다.

기본적으로 직접 액세스 게이트웨이Qlik Cloud에서 연결이 끊어지면 45초 후에 다시 연결됩니다. 상당히 오랜 시간이 걸리는 경우 게이트웨이를 더 빨리 강제로 재연결할 수 있습니다.

수행할 작업:

  1. 텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다. 이 파일에는 Qlik Cloud 데이터 유형에 대한 예 소스가 포함되어 있습니다.
  2. 파일의 시작 부분에 있는 # Connector Agent 섹션에 AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds>를 추가합니다.

    예:

    AGENT_PONG_TIMEOUT_SECONDS=30

    정보 메모최소 시간은 30초입니다.
  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

ODBC 데이터 소스에 연결할 때 발생하는 오류 메시지 세부 정보 증가

보안 문제로 인해 ODBC 드라이버에서 반환하는 기본 오류 메시지에는 최소한의 정보만 포함됩니다. 그러나 특정 시나리오에서는 특정 문제를 해결하기 위해 추가 정보가 필요할 수도 있습니다. 더 자세한 오류 메시지를 보려면 커넥터 대화 상자의 고급 섹션에 ShowErrorDetailMessage 속성을 추가하고 True로 설정합니다. 문제를 해결한 후 최적의 보안을 위해 해당 속성을 삭제하거나 False로 설정하는 것이 좋습니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 개선 방법을 알려 주십시오!