Bridge 클라이언트 설정 변경

사이트 관리자가 구성하여 클라이언트가 실행되는 방식을 변경할 수 있는 여러 Bridge 클라이언트 설정이 있습니다. 데이터 원본 소유자가 Bridge(레거시) 일정을 실행하기 위해 자신의 고유한 클라이언트를 유지하는 경우 이 항목에 설명되어 있는 일부 작업을 게시자가 처리해야 할 수도 있습니다.

Bridge를 Windows 서비스로 실행

클라이언트가 풀에 포함될 수 있도록 클라이언트를 Windows 서비스(서비스 모드)로 실행해야 합니다. 기본적으로 클라이언트는 전용 사용자가 컴퓨터에 로그인하도록 요구하지 않고 백그라운드에서 라이브 쿼리와 새로 고침의 부하 분산을 처리할 수 있도록 Windows 서비스로 실행되도록 설정됩니다. 클라이언트가 Windows 서비스로 실행되려면 클라이언트를 실행하는 Windows 사용자 계정이 컴퓨터에서 로컬 관리자 그룹의 멤버여야 합니다.

참고: 데이터 원본 소유자이고 직접 클라이언트를 관리하는 경우 클라이언트가 풀에 포함되지 않습니다. 그러나 컴퓨터에 로그온하지 않은 상태에서도 백그라운드에서 Bridge(레거시) 일정을 실행하려는 경우 클라이언트를 Windows 서비스(서비스 모드)로 실행해야 합니다.

  1. Windows 시스템 트레이를 열고 Bridge 아이콘을 클릭하여 클라이언트를 엽니다.

  2. 모드 드롭다운 메뉴에서 서비스를 선택합니다. 로그인 창이 표시됩니다.

    Tableau Bridge를 Windows 서비스로 계속 실행합니다.

  3. 로컬 관리자 자격 증명을 입력합니다.

    Windows 서비스 목록에서 Bridge는 Tableau Bridge 서비스로 나타납니다. 이는 Windows 서비스 콘솔에서 확인하거나 작업 관리자의 서비스 탭에서 확인할 수 있습니다.

Bridge를 Windows 서비스로 실행하지 않음

클라이언트가 서비스로 실행되지 않게 하려면 모드를 변경합니다.

  1. Windows 시스템 트레이를 열고 Bridge 아이콘을 클릭하여 클라이언트를 엽니다.

  2. 모드 드롭다운 메뉴에서 응용 프로그램을 선택합니다.

    Tableau Bridge를 서비스 대신 응용 프로그램으로 실행합니다.

클라이언트가 응용 프로그램 모드에서 실행되는 경우 사용자가 클라이언트를 실행한 컴퓨터에 Windows 사용자 계정으로 로그인한 경우에만 라이브 쿼리 및 예약된 새로 고침을 실행할 수 있습니다.

클라이언트가 연결된 사이트 전환

클라이언트를 사용하여 다른 Tableau Online 사이트에 게시된 데이터 원본을 새로 고치려는 경우 기존 클라이언트 연결을 해제하고 클라이언트에서 새 사이트에 인증할 수 있습니다.

  1. Windows 시스템 트레이를 열고 Bridge 아이콘을 클릭하여 클라이언트를 엽니다.
  2. 드롭다운 메뉴에서 연결 해제를 선택합니다.

    연결 해제를 선택하여 모든 데이터 정보를 제거하고 새로 고침을 Tableau Online으로 보내지 않음

    연결 해제는 클라이언트에서 데이터 원본 목록, 일정 및 연결 정보를 제거합니다.

  3. Windows 시스템 트레이를 열고 Bridge 아이콘을 클릭하여 클라이언트를 엽니다.

  4. 메시지가 표시되면 사이트 관리자 자격 증명으로 새 사이트에 로그인합니다.

  5. 클라이언트를 구성하려면 다음 중 하나 또는 둘 모두를 수행하십시오.

    • 이 클라이언트가 파일 기반 데이터 원본을 새로 고치는 경우 데이터 원본 소유자에게 데이터 원본 및 새로 고침 일정을 다시 구성하도록 요청하십시오.

    • 이 클라이언트가 권장 일정을 사용하는 라이브 연결 또는 추출 연결을 활용할 수 있게 하려면 새 클라이언트가 풀의 일부인지 확인합니다. 자세한 내용은 Bridge 클라이언트 풀 구성 및 관리를 참조하십시오.

클라이언트를 연결 해제하는 경우 해당 클라이언트로 새로 고치는 데이터 원본에 대한 Bridge(레거시) 일정도 제거해야 할 수 있습니다. 다른 데이터 원본은 풀에 등록된 다른 클라이언트에 의해 데이터 새로 고침 작업이 계속 수행됩니다.

자세한 내용은 끝내기 및 연결 해제의 효과를 참조하십시오.

새로 고침에 대한 시간 초과 제한 구성

추출이나 새로 고침을 오용하지 못하도록 클라이언트에서 수행되는 새로 고침 작업에 대한 시간 제한(시간 초과 제한이라고도 함)을 적용할 수 있습니다. 시간 초과 제한은 단일 추출에서 새로 고침을 완료하는 데 허용되는 시간으로 이 시간이 지나면 클라이언트가 새로 고침을 취소합니다. 시간 초과 제한에 도달하여 추출 새로 고침이 취소된 경우 클라이언트에 메시지가 표시되고 데이터 원본 소유자에게 이메일 알림이 전송됩니다.

기본적으로 클라이언트의 시간 초과 제한은 24시간으로 설정됩니다. Bridge 구성 파일을 사용하여 클라이언트에 대한 시간 초과 제한을 변경할 수 있습니다.

참고: 구성 파일의 변경 사항을 적용하려면 클라이언트를 다시 시작해야 합니다.

  1. 클라이언트가 설치된 컴퓨터에서 내 Tableau Bridge 리포지토리의 구성 폴더로 이동합니다.

    구성 폴더의 기본 위치는 C:\Users\jsmith\Documents\내 Tableau Bridge 리포지토리\Configuration입니다.

  2. TabBridgeClientConfiguration.txt 파일을 엽니다.

  3. extractRefreshTimeout 옆에서 새로 고침 작업을 완료하는 데 허용되는 시간을 변경합니다.

    참고: 구성 파일에서 매개 변수를 확인할 수 없는 경우 아래의 예와 같이 "extractRefreshTimeout" : 08:00:00",dataSourceRefreshSettings 설정에 추가하면 됩니다.

  4. 파일을 저장하고 닫습니다.

  5. 변경 내용을 적용하려면 클라이언트를 종료하고 다시 시작합니다. 클라이언트를 다시 시작하는 방법은 클라이언트가 응용 프로그램 모드에서 실행되는지, 아니면 서비스 모드에서 실행되는지에 따라 다릅니다.

    • 응용 프로그램 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다.

    • 서비스 모드인 경우 모드 드롭다운 메뉴에서 응용 프로그램을 선택하고 클라이언트 메뉴에서 끝내기를 선택합니다.

Bridge 로그 파일 관리

클라이언트는 정상 작동의 일부로 활동 로그를 만듭니다. 새로 고침을 모니터링하거나 Bridge 관련 문제를 해결하거나 Tableau 지원 부서에서 문제 해결에 도움이 되는 로그를 요청하는 경우에만 이러한 로그를 사용할 수 있습니다.

Bridge 로그 파일의 크기를 관리하거나 TabBridgeClientConfiguration.txt 파일에서 삭제하기 전에 로그 파일이 유지되는 시간을 늘릴 수 있습니다.

구성 가능한 옵션

  • maxLogFileSizeInMB: 기본적으로 Bridge 로그 파일에 허용되는 최대 크기는 25MB입니다. 로그 파일이 이 크기 제한을 초과하면 새 로그 파일이 만들어집니다.

  • maxBackupLogFileCount: 허용되는 최대 Bridge 로그 파일 수의 기본값은 40입니다. 로그 파일 수가 제한을 초과하면 가장 오래된 로그 파일이 삭제됩니다.

  • remoteRequestLogFileLifeSpan: 클라이언트로 전송되는 각 Bridge 새로 고침 작업에 대해 다음과 같은 새 로그 파일 집합이 생성됩니다. tabbridgeclijob_<process_id>, jprotocolserver_<process_id>stdout_jprotocolserver_<process_id>. 기본적으로 로그 파일 수가 maxBackupLogFileCount를 초과하면 로그 파일이 삭제하기 전에 로그 폴더에 남아 있는 최대 시간은 8시간입니다. 그렇지 않으면 로그 파일 수가 maxBackupLogFileCount보다 작거나 같은 동안 이러한 로그 파일은 무기한으로 남아 있습니다.

    참고: 여기서 <process_id>는 Windows 프로세스 ID를 나타냅니다.

참고: 이름이 tabprotosrv*인 로그 파일은 다른 Bridge 로그 파일과 다릅니다. 최대 크기는 1MB이고 최대 허용 로그 파일 수는 8,192개입니다. 이러한 값도 구성할 수 없습니다.

  1. 클라이언트가 설치된 컴퓨터에서 내 Tableau Bridge 리포지토리의 구성 폴더로 이동합니다.

    구성 폴더의 기본 위치는 C:\Users\jsmith\Documents\내 Tableau Bridge 리포지토리\Configuration입니다.

  2. TabBridgeClientConfiguration.txt 파일을 엽니다.

  3. loggerSettings 옆에서 다음 매개 변수에 대한 값을 변경할 수 있습니다.

    "maxLogFileSizeInMB" : 25

    "maxBackupLogFileCount" : 40

    "remoteRequestLogFileLifeSpan" : "08:00:00"

  4. 파일을 저장하고 닫습니다.

  5. 변경 내용을 적용하려면 클라이언트를 종료하고 다시 시작합니다. 클라이언트를 다시 시작하는 방법은 클라이언트가 응용 프로그램 모드에서 실행되는지, 아니면 서비스 모드에서 실행되는지에 따라 다릅니다.

    • 응용 프로그램 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다.

    • 서비스 모드인 경우 모드 드롭다운 메뉴에서 응용 프로그램을 선택하고 클라이언트 메뉴에서 끝내기를 선택합니다.

    Bridge 풀의 크기 관리

    기본적으로 풀의 각 클라이언트는 한 번에 최대 10개의 새로 고침 작업의 부하를 분산할 수 있습니다. 지정된 시간에 실행되는 새로 고침 작업의 수가 클라이언트 풀의 용량을 초과하거나 이를 지원할 하드웨어 리소스가 있는 경우 각 클라이언트의 용량을 늘리는 것이 좋습니다.

    TabBridgeClientConfiguration.txt 파일에서 클라이언트의 풀링 용량을 관리할 수 있습니다.

    구성 가능한 옵션

    • ConnectionPool: 클라이언트에서 허용하는 최대 동시 새로 고침 작업 수입니다. 기본값은 10이고, 허용되는 최소값은 1이며, 허용되는 최대값은 100입니다. 이 값을 변경하려면 클라이언트의 연결을 해제해야 합니다.

    • maxRemoteJobConcurrency: ConnectionPool의 절대 값을 변경하지 않고 클라이언트 성능 문제를 튜닝 또는 해결하는 데 사용할 수 있는 클라이언트가 허용하는 최대 동시 새로 고침 작업 수입니다. 기본값은 10입니다. 이 값은 ConnnectionPool에 지정된 값과 같거나 작아야 합니다. 이 값을 변경하면 클라이언트 연결을 해제할 필요가 없습니다.

    ConnectionPool 변경

    중요: 아래에 설명된 절차를 수행하려면 클라이언트 연결을 해제해야 합니다. 연결을 해제하면 사이트와 클라이언트 간의 연결이 제거됩니다. 즉, Bridge(레거시) 일정을 사용하여 새로 고쳐진 데이터 원본의 경우 클라이언트 연결을 해제하면 해당 데이터 원본에 대한 연결, 해당 일정 및 클라이언트의 모든 연결 정보가 제거됩니다. Bridge 풀의 크기를 수정하는 과정에서 Windows 시스템 트레이에서 Bridge 아이콘을 클릭하고 나열된 데이터 원본(5단계)을 기록하여 일정 조정 프로세스(10단계)에서 참조하는 것이 좋습니다.

    1. 클라이언트가 설치된 컴퓨터에서 내 Tableau Bridge 리포지토리의 구성 폴더로 이동합니다.

      구성 폴더의 기본 위치는 C:\Users\jsmith\Documents\내 Tableau Bridge 리포지토리\Configuration입니다.

    2. TabBridgeClientConfiguration.txt 파일을 엽니다.

    3. ConnectionPool 옆에 있는 값을 편집합니다.

    4. 파일을 저장하고 닫습니다.

    5. (선택 사항) Windows 시스템 트레이에서 Bridge 아이콘을 클릭하고 나열된 데이터 원본과 해당 데이터 원본에 대해 구성된 새로 고침 일정을 기록합니다.
    6. Windows 시스템 트레이에서 Bridge 아이콘을 마우스 오른쪽 단추로 클릭하고 연결 해제를 선택합니다.

      연결 해제 옵션에 대한 자세한 내용은 끝내기 및 연결 해제의 효과를 참조하십시오.

    7. 변경 내용을 적용하기 위해 클라이언트를 종료합니다. 클라이언트를 종료하는 방법은 클라이언트가 응용 프로그램 모드에서 실행되는지, 아니면 서비스 모드에서 실행되는지에 따라 다릅니다.

      • 응용 프로그램 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다.

      • 서비스 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다. 대화 상자에서 클라이언트 종료 및 작업 중지 확인란을 선택하고 닫기를 클릭합니다.

    8. Bridge를 다시 시작합니다.

    9. 메시지가 표시되면 사이트 관리자 자격 증명을 사용하여 Tableau Online에 로그인합니다.

    10. (선택 사항) Bridge(레거시) 일정을 사용하는 데이터 원본에 대해 5단계를 수행한 경우 새 Bridge(레거시) 일정 추가 또는 기존 일정 업데이트에 설명된 절차에 따라 새로 고침 일정을 조정하고 데이터 원본을 클라이언트와 효과적으로 다시 연결합니다.

maxRemoteJobConcurrency 변경

  1. 클라이언트가 설치된 컴퓨터에서 내 Tableau Bridge 리포지토리의 구성 폴더로 이동합니다.

    구성 폴더의 기본 위치는 C:\Users\jsmith\Documents\내 Tableau Bridge 리포지토리\Configuration입니다.

  2. TabBridgeClientConfiguration.txt 파일을 엽니다.

  3. maxRemoteJobConcurrency 옆에 있는 값을 편집합니다.

  4. 파일을 저장하고 닫습니다.

  5. 변경 내용을 적용하기 위해 클라이언트를 종료합니다. 클라이언트를 종료하는 방법은 클라이언트가 응용 프로그램 모드에서 실행되는지, 아니면 서비스 모드에서 실행되는지에 따라 다릅니다.

    • 응용 프로그램 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다.

    • 서비스 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다. 대화 상자에서 클라이언트 종료 및 작업 중지 확인란을 선택하고 닫기를 클릭합니다.

  6. Bridge를 다시 시작합니다.

  7. 메시지가 표시되면 사이트 관리자 자격 증명을 사용하여 Tableau Online에 로그인합니다.

  8. (선택 사항) Bridge(레거시) 일정을 사용하는 데이터 원본에 대해 5단계를 수행한 경우 새 Bridge(레거시) 일정 추가 또는 기존 일정 업데이트에 설명된 절차에 따라 새로 고침 일정을 조정하고 데이터 원본을 클라이언트와 효과적으로 다시 연결합니다.
피드백을 제공해 주셔서 감사합니다!