업그레이드Qlik 데이터 게이트웨이 - 직접 액세스

새로운 기능 및 개선 사항:

Direct Access gateway 1.6.5에는 다음과 같은 기능과 개선 사항이 도입되었습니다.

• SAP ODP 커넥터 지원

  이 버전에는 직접 액세스 게이트웨이을 통해 SAP ODP 소스에 액세스하는 기능이 도입되었습니다. 이를 용이하게 하기 위해 새로운 데이터 게이트웨이 필드가 SAP ODP 커넥터에 추가되었습니다. 새로운 필드를 통해 고객은 SAP ODP 소스에 액세스하는 데 사용할 게이트웨이를 선택할 수 있습니다.

  관련 항목: SAP ODP 커넥터 (영어로만 제공)

• 확장된 로깅 기능

  이 버전에는 Qlik Support에서 특정 게이트웨이 구성 요소의 문제를 해결하는 데 사용할 수 있는 새로운 로거가 도입되었습니다.

• 새로 지원되는 지역

  이제 일본이 Qlik Cloud 테넌트 지역으로 지원됩니다.

• 성능 향상

  암호화된 세션에 대한 메모리 할당이 향상되었습니다.

해결된 문제

Direct Access gateway 1.6.5은 다음 문제를 해결합니다.

• 보안 취약성

  ODBC 커넥터로 작업할 때 비밀이 DCAAS 로그에 기록됩니다.

• 프로세스 격리 성능

  부하가 높으면 프로세스를 시작하는 데 오랜 시간이 걸립니다.

• 잘못된 설치 경로

  직접 액세스 게이트웨이를 설치하면 사용자가 설정 마법사에서 다른 폴더를 선택한 경우에도 항상 Qlik이 루트 폴더로 설정됩니다.

새로운 기능 및 개선 사항:

• 관리 콘솔에서 로그 파일 보기 및 다운로드 지원

  이 버전에는 관리 콘솔에서 직접 액세스 게이트웨이 로그 파일을 보고 필요한 경우 Qlik 지원팀과 공유할 수 있는 기능이 도입되었습니다. 정상적인 상황에서는 로그 파일을 볼 이유가 없지만, 반복적인 오류나 기타 문제가 발생하는 경우 로그 파일이 원인을 찾아내는 데 도움이 되는 경우가 많습니다.

  관련 항목: 로그 파일 보기 및 다운로드

• 직접 액세스 게이트웨이 자동 설치 지원

  이제 고객은 직접 액세스 게이트웨이를 자동으로 설치할 수 있습니다. 이는 조직 전체의 여러 컴퓨터에 직접 액세스 게이트웨이를 설치해야 하는 경우 유용합니다.

  관련 항목: 직접 액세스 게이트웨이 자동 설치

• 향상된 세션 연속성

  다시 로드 세션이 만료되면 DirectAccess-1012 오류가 발생하는 경우가 있었습니다. 이제 직접 액세스 게이트웨이는 Qlik Cloud를 더 자주 ping하여 다시 로드 세션을 유지하려고 합니다.

해결된 문제

Direct Access gateway 1.6.4은 다음 문제를 해결합니다.

• configuration.properties 파일에 잘못된 매개 변수 이름이 있습니다.

  직접 액세스 게이트웨이를 새로 설치할 때 configuration.properties 파일의 EXTEND_FIRST_REQUEST_TIMEOUT 매개 변수 이름이 FIRST_REQUEST_TIME_EXTENSION으로 잘못 호출됩니다.

• 포드 가용성 다시 로드

  여러 다시 로드가 동일한 다시 로드 ID를 공유할 때 QCS의 다시 로드 포드 수가 최댓값에 도달했습니다.

직접 액세스 게이트웨이 1.6.3에는 다음과 같은 개선 사항과 버그 수정이 포함되어 있습니다.

• 데이터 손실 방지

  이전 버전에서는 잠재적인 데이터 손실을 방지하기 위해 Direct Access gateway가 다시 로드 중에 데이터 소스에 자동으로 다시 연결되지 않았습니다. 이 버전에서는 이제 Direct Access gateway가 필요에 따라 데이터 소스에 자동으로 다시 연결됩니다. 데이터 손실을 방지하기 위해 다시 연결하기 전에 완료된 다시 로드 요약을 확인합니다. 데이터 손실이 감지되면 다시 로드가 실패합니다.

• 다시 로드 세션의 시간 초과

  드문 경우지만 다시 로드 세션이 무기한으로 유지되는 경우가 있습니다. 이러한 상황을 방지하기 위해 이 버전에서는 다시 로드 세션에 대해 3시간 제한 시간을 도입했습니다.

• 로드 요청의 시간 초과 연장

  다음 오류로 인해 다시 로드가 실패하는 경우가 있습니다.

  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 매개 변수(로드 요청 시간 초과 연장용)가 configuration.properties 파일에 추가되었습니다. 기본값은 "0"입니다. 이러한 오류가 자주 발생하는 고객은 시간 제한을 5~10분으로 설정해 보시기 바랍니다.

• 자세한 연결 오류 메시지 지원

  Direct Access gateway 커넥터를 통해 ODBC 기반을 사용할 때 자세한 연결 오류 메시지를 볼 수 있는 지원이 추가되었습니다. 이제 고객은 고급 커넥터 설정에서 ShowErrorDetailMessage 매개 변수를 "true"로 설정하여 ODBC 드라이버가 반환한 전체 오류를 확인할 수 있습니다. 자세한 오류 메시지는 데이터 로드 편집기에 표시됩니다.

  정보 메모오류 메시지는 사용 중인 데이터 소스에서 전체적으로 제공됩니다. Qlik은 어떤 방식으로든 오류 메시지에 추가 정보를 추가하거나 편집하지 않습니다.

• 동일한 다시 로드 ID를 사용하여 여러 번 다시 로드 처리

  이 버전에서는 동일한 다시 로드 ID를 사용하는 여러 다시 로드를 구별하는 데 엔진 세션 ID가 사용됩니다. 이렇게 하면 잠재적인 충돌을 방지하여 다음 오류로 인해 다시 로드가 실패하게 됩니다.

  Connector error: data loading error (DirectAccess-4008

직접 액세스 게이트웨이 1.6.2에서는 프로세스 격리 모드에서 작업할 때 커넥터 에이전트가 충돌하는 문제가 해결되었습니다.

새로운 기능 및 개선

Direct Access gateway 1.6.1에는 몇 가지 중요한 기능과 개선 사항이 도입되어 전반적인 안정성과 성능이 개선되었습니다.

• 여러 커넥터 프로세스에 걸쳐 다시 로드 분산 지원

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

  관련 항목: 다시 로드 중 커넥터 충돌 완화

• SAP BW(Direct Access gateway 사용) 커넥터로 작업할 때 청크를 비활성화하는 기능이 추가되었습니다.

  이 버전에는 SAP BW(Direct Access gateway 사용) 커넥터에 대한 BEX_ONE_CHUNK 응용 프로그램 매개 변수가 도입되었습니다. Qlik Cloud에서 직접(즉, Direct Access gateway를 사용하지 않고) SAP BW에 액세스하는 경우 성능을 최적화하기 위해 결과 집합은 SAP 백엔드에서 청크로 나누어 별도의 스레드로 읽혀집니다. 그러나 Direct Access gateway를 사용하여 SAP BW에 액세스할 때 결과 집합을 청크로 나누는 것은 실질적인 이점이 없습니다. 반대로 데이터 전송 중에 추가 임시 테이블을 만들어야 하므로 SAP의 공유 메모리를 더 많이 소비합니다. 일반적으로 필수는 아니지만 SAP 커넥터 이진 폴더에 있는 appsettings.json 파일에서 BEX_ONE_CHUNK:false를 설정하여 청크 분할을 시작할 수 있습니다.

• SAP BW(Direct Access gateway 사용) 및 SAP SQL(Direct Access gateway 사용) 커넥터에 대한 진단 개선 사항

  SAP BW(Direct Access gateway 사용) 및 SAP SQL(Direct Access gateway 사용) 커넥터 로그의 경우, 로그 파일 이름 확장자 앞에 _port 접미사가 추가되었고 동일한 포트에서 수신하는 커넥터의 새 인스턴스에서 발생한 이벤트를 구별하기 위해 ProcessID=### 메시지가 커넥터의 로그 파일에 추가되었습니다.

• 재연결 개선

  다시 로드 중 재연결 메커니즘이 개선되어 Direct Access gateway가 더 이상 다시 로드를 시작한 포드에 연결할 필요가 없습니다(이전의 경우와 동일). 이제 다시 로드를 시작한 Pod에 반복적으로 연결을 시도하는 대신(종종 다시 로드 실패가 발생함), 사용할 수 있는 첫 번째 Pod에 연결됩니다.

해결된 문제

Direct Access gateway 1.6.0은 다음 문제를 해결합니다.

• Direct Access gateway를 사용하는 ODBC 커넥터 로그:

  다른 데이터 소스에서 다시 로드를 수행할 때 한 데이터 소스의 프로세스가 다른 데이터 소스의 로깅에 잘못 표시되었습니다.

• 설정에 파일이 없습니다.

  Direct Access gateway 설치 중에는 configuration.properties 파일이 복사되지 않습니다.

• Qlik Cloud 리소스 크기 조정 중 오류 다시 로드

  Qlik Cloud 리소스 확장으로 인해 DirectAccess-1006 오류가 발생하는 경우가 있습니다. Direct Access gateway를 통해 수행된 응용 프로그램 다시 로드 중에 발생하는 특정 Qlik Cloud 리소스 확장 시나리오의 처리를 개선하기 위해 향상되었습니다.

• Snowflake 연결 실패

  ODBC(Direct Access gateway 사용) 커넥터를 통해 Snowflake에 연결하면 실패합니다.

• DLE에서 응용 프로그램 스크립트 오류 디버깅

  결과 제한 옵션이 활성화된 데이터 로드 편집기(DLE)에서 응용 프로그램 스크립트 디버깅이 다음 오류와 함께 실패하는 경우가 있습니다.

  Connector error: Invalid load request (DirectAccess-1006).

해결된 문제:

• ODBC(직접 액세스 게이트웨이 사용) 커넥터: 대형 테이블 다시 로드를 취소하면 커넥터가 충돌하는 경우가 있습니다. 이를 방지하기 위해 개선되었습니다.

• Microsoft SQL Server(직접 액세스 게이트웨이 사용) 커넥터: 이전 Windows Server 버전에서 호스팅되는 SQL Server에 대한 연결을 설정하려고 하면 TLS 호환성 문제로 인해 연결이 실패하고 다음 오류가 반환됩니다.

  Please check the values for Username‚ Password‚ Host and other properties. Description: Client unable to establish connection - ERROR [08001] [Qlik][SqlServer] Problem establishing connection to the server.

  문제를 해결하기 위해 SQL Server 드라이버가 업데이트되었습니다.

• SAP SQL(직접 액세스 게이트웨이 사용) 커넥터: 테이블을 미리 볼 때 다음 오류가 발생하는 경우가 있습니다.

  Exception of Type System.OutOfMemoryException

• SAP SQL(직접 액세스 게이트웨이 사용) 커넥터: 테이블 미리 보기를 시도하면 다음 오류와 함께 몇 분 후에 시간이 초과되는 경우가 있습니다.

  Request could not be completed.

• SAP SQL(직접 액세스 게이트웨이 사용) 및 SAP BW(직접 액세스 게이트웨이 사용) 커넥터: 여러 동시 요청 문제를 해결하는 데 도움이 되도록 로그에 진단 정보를 추가했습니다.

새로운 기능 및 개선 사항:

• ODBC(직접 액세스 게이트웨이를 통해) (영어로만 제공) 커넥터를 지원합니다.

• 이제 관리 콘솔의 버전 열에 RepAgent(하위 구성 요소 중 하나) 버전 대신 직접 액세스 게이트웨이 버전이 표시됩니다.

해결된 문제:

• 직접 액세스 게이트웨이를 업그레이드하면 고급 ODBC 커넥터 로깅 설정(예: 로그 파일 보존 및 최대 크기)이 기본값으로 다시 설정됩니다.
• 드문 경우지만 ODBC 커넥터가 충돌하여 직접 액세스 게이트웨이 에이전트가 다시 시작할 수 없습니다.
• 연결이 실패했거나 SQL 쿼리가 유효하지 않은 경우 실제 오류 원인 대신 일반 "오프셋 및 길이가 경계를 초과했습니다..." 오류가 반환됩니다.
• 드문 경우지만 초기 게이트웨이 쿼리 후 지연 또는 처리가 연장된 3GB보다 큰 앱에 대해 "DirectAccess-4008" 오류와 함께 허브 다시 로드가 실패합니다. 관련 문제를 식별하는 데 도움이 되도록 추가 로깅이 추가되었습니다.

해결된 문제:

• C:\ProgramData\Qlik\Gateway\configuration.properties 파일에서 ODBC_LOG_LEVEL 값을 변경해도 아무런 효과가 없습니다.

• 활성 직접 액세스 게이트웨이 연결이 몇 분 동안 사용되지 않으면 다음 오류와 함께 다시 로드가 실패합니다.

  Connector error: Invalid load request (DirectAccess-1006)

  세션이 아직 살아 있는 경우 시간이 초과되지 않아 문제가 해결되었습니다.

• MySQL 및 PostgreSQL에서 수많은 열이 있는 테이블을 로드하면 다음 오류와 함께 실패하는 경우가 있습니다.

  System.InvalidOperationException: Failed to HPACK encode the headers

• 사용자에게 직접 액세스 게이트웨이가 포함된 관리 공간에 대한 권한이 없는 경우 다음과 같은 불명확한 오류가 표시됩니다.

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Object reference not set to an instance of an object.

  문제에 대한 보다 정확한 설명으로 오류 메시지가 개선되었습니다.

• 과도한 메모리 소비로 인해 여러 번의 다시 로드 시도가 실패하는 경우가 있었습니다.

기능 및 개선 사항:

직접 액세스 게이트웨이은 주기적으로 상태를 확인합니다. 이 버전부터 직접 액세스 게이트웨이 서비스가 5분 동안 응답하지 않으면 상태 확인이 다시 시작합니다.

해결된 문제:

• 메타데이터를 즉시 반환하지만 몇 분 후에 첫 번째 데이터 청크만 반환하는 쿼리로 다시 로드를 시작할 때 다음 오류가 발생하는 경우가 있습니다.

  Connector error: data loading error (DirectAccess-4008)

• 특정 시나리오에서 직접 액세스 게이트웨이는 다시 로드가 중단되었을 때 Qlik Cloud에 다시 연결하지 않습니다.

• 다시 로드하는 동안 다음 오류가 발생하는 상황이 드물게 있습니다.

  No connection could be made because the target machine actively refused it.

• SQL Server에 연결할 때 비밀번호의 특수 문자가 올바르게 인코딩되지 않아 다음 오류가 발생합니다.

  Command test connection returned non-success: Error message: Please check the values for Username‚ Password‚ Host and other properties. Description: Access credentials are not valid for this connection.

• 쿼리가 데이터를 반환하는 동안 사용자 인터페이스에서 로드 활동을 중단하면 ODBC 커넥터가 충돌하는 경우가 있습니다.

• 과도한 로드와 관련된 드문 시나리오에서 다음 오류와 함께 다시 로드가 실패하는 경우가 있습니다.

  Connector error: Unknown reason:. Index was outside the bounds of the array. (DirectAccess-1500)

Qlik Cloud 테넌트 인증에 필요한 CA 인증서를 업데이트했습니다.

이 버전은 다음 문제를 해결합니다.

Qlik 데이터 게이트웨이 - 직접 액세스 1.3.1은 특정 시나리오에서 CPU를 과도하게 사용하는 경향이 있습니다. 버전 1.3.2는 이 문제를 해결하고 다른 변경 내용은 포함하지 않습니다. CPU 관련 장애를 방지하기 위해 모든 고객은 즉시 버전 1.3.2로 업그레이드하는 것이 좋습니다.

이 버전은 Qlik Cloud 정부용 CA 번들이 포함되어 있으며 여러 문제를 해결합니다.

Qlik Cloud 정부에 대한 CA 번들 파일

CA 번들은 Qlik Cloud 테넌트의 ID를 인증하여 신뢰할 수 있는 연결을 보장합니다.

이전 직접 액세스 게이트웨이 버전에서는 Qlik Cloud 정부 고객에 대한 CA 번들 파일이 필요에 따라 Qlik에서 제공되었습니다. 이 버전부터 CA 번들 파일이 설치에 포함됩니다.

기본 설정에서 CA 번들 파일은 다음 위치에 설치됩니다. C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

해결된 문제

• 프록시 연결에 사용되는 HTTP 클라이언트가 리디렉션을 따르는 보안 취약점이 확인되었습니다.

• 직접 액세스 게이트웨이 에이전트가 다음 오류와 함께 충돌하는 경우가 있습니다.

  Unable to write data to the transport connection: An established connection was aborted by the software in your host machine

• 로그 초기화 중에 예외가 발생하여 다시 시작할 때 직접 액세스 게이트웨이이 중단되는 경우가 있습니다.
• 불필요한 시간 초과를 방지하기 위해 다시 로드 세션 처리가 개선되었습니다.
• 관리 콘솔의 직접 액세스 게이트웨이 버전 열이 잘못된 버전을 나타냅니다.
• 사용자가 작업을 중지하거나 할당량 제한에 도달한 후에도 에이전트는 데이터를 게이트웨이로 계속 보냅니다.
• 데이터 게이트웨이에 대한 종단 간 암호화는 기본적으로 활성화되지 않으며 런타임 플래그에 의해 제어되었습니다.

이 버전은 다음 문제를 해결합니다.

• Qlik 데이터 게이트웨이 버전 1.2 – 디지털 서명 문제로 인해 직접 액세스가 설치되지 않을 수 있습니다.
• 업그레이드 중에 구성 파일을 덮어써서 변경 내용이 손실됨

기능 및 개선 사항:

• SAP BW 및 SAP SQL 소스에 대한 지원이 추가되었습니다. 이러한 소스에 대한 연결 설정에 대한 자세한 내용은 SAP NetWeaver (영어로만 제공)를 참조하십시오.

해결된 문제:

• Qlik 데이터 게이트웨이 - 직접 액세스 서비스의 안정성 및 복구 가능성이 향상되어 서비스를 수동으로 다시 시작할 필요가 없습니다.
• 기본 직접 액세스 게이트웨이 설치 및 구성 매개 변수 덮어쓰기 지원

기능 및 개선 사항:

• Windows Server 2022 지원 추가

해결된 문제:

• 설정 중 사용자 지정 경로 선택과 관련된 잠재적인 안정성 문제가 해결되었습니다.

1.1.0

2022년 10월 18일

기능 및 개선 사항:

• Oracle Wallets 지원
• Google BigQuery 지원
• 개선된 오류 메시지

해결된 문제:

• 드라이버 충돌 후 개선된 시스템 복구
• Qlik 데이터 게이트웨이 - 직접 액세스 서비스가 예기치 않게 중지되는 경우가 있음