사이트 관리자가 구성하여 클라이언트가 실행되는 방식을 변경할 수 있는 여러 Bridge 클라이언트 설정이 있습니다. 데이터 원본 소유자가 Bridge(레거시) 일정을 실행하기 위해 자신의 고유한 클라이언트를 유지하는 경우 이 항목에 설명되어 있는 일부 작업을 게시자가 처리해야 할 수도 있습니다.
Bridge를 Windows 서비스로 실행
클라이언트가 풀에 포함될 수 있도록 클라이언트를 Windows 서비스(서비스 모드)로 실행해야 합니다. 기본적으로 클라이언트는 전용 사용자가 컴퓨터에 로그인하도록 요구하지 않고 백그라운드에서 라이브 쿼리와 새로 고침의 부하 분산을 처리할 수 있도록 Windows 서비스로 실행되도록 설정됩니다. 클라이언트가 Windows 서비스로 실행되려면 클라이언트를 실행하는 Windows 사용자 계정이 컴퓨터에서 로컬 관리자 그룹의 멤버여야 합니다.
참고: 데이터 원본 소유자이고 직접 클라이언트를 관리하는 경우 클라이언트가 풀에 포함되지 않습니다. 그러나 컴퓨터에 로그온하지 않은 상태에서도 백그라운드에서 Bridge(레거시) 일정을 실행하려는 경우 클라이언트를 Windows 서비스(서비스 모드)로 실행해야 합니다.
Windows 시스템 트레이를 열고 Bridge 아이콘을 클릭하여 클라이언트를 엽니다.
모드 드롭다운 메뉴에서 서비스를 선택합니다. 로그인 창이 표시됩니다.
로컬 관리자 자격 증명을 입력합니다.
Windows 서비스 목록에서 Bridge는 Tableau Bridge 서비스로 나타납니다. 이는 Windows 서비스 콘솔에서 확인하거나 작업 관리자의 서비스 탭에서 확인할 수 있습니다.
Bridge를 Windows 서비스로 실행하지 않음
클라이언트가 서비스로 실행되지 않게 하려면 모드를 변경합니다.
Windows 시스템 트레이를 열고 Bridge 아이콘을 클릭하여 클라이언트를 엽니다.
모드 드롭다운 메뉴에서 응용 프로그램을 선택합니다.
클라이언트가 응용 프로그램 모드에서 실행되는 경우 사용자가 클라이언트를 실행한 컴퓨터에 Windows 사용자 계정으로 로그인한 경우에만 라이브 쿼리 및 예약된 새로 고침을 실행할 수 있습니다.
클라이언트가 연결된 사이트 전환
클라이언트를 사용하여 다른 Tableau Cloud 사이트에 게시된 콘텐츠를 새로 고치려는 경우 기존 클라이언트 연결을 해제하고 클라이언트에서 새 사이트에 인증할 수 있습니다.
- Windows 시스템 트레이를 열고 Bridge 아이콘을 클릭하여 클라이언트를 엽니다.
드롭다운 메뉴에서 연결 해제를 선택합니다.
연결 해제는 클라이언트에서 Bridge(레거시) 일정을 사용하는 데이터 원본 목록, 일정 및 연결 정보를 제거합니다.
Windows 시스템 트레이를 열고 Bridge 아이콘을 클릭하여 클라이언트를 엽니다.
메시지가 표시되면 사이트 관리자 자격 증명으로 새 사이트에 로그인합니다.
클라이언트를 구성하려면 다음 중 하나 또는 둘 모두를 수행하십시오.
이 클라이언트가 특정 클라이언트에 연결된 데이터 원본을 새로 고치는 경우 데이터 원본 소유자에게 데이터 원본 및 새로 고침 일정을 다시 구성하도록 요청하십시오.
이 클라이언트가 Online 일정을 사용하는 라이브 연결 또는 추출 연결을 활용할 수 있게 하려면 새 클라이언트가 풀의 일부인지 확인합니다. 자세한 내용은 Bridge 클라이언트 풀 구성를 참조하십시오.
클라이언트를 연결 해제하는 경우 해당 클라이언트로 새로 고치는 데이터 원본에 대한 Bridge(레거시) 일정도 제거해야 할 수 있습니다. 다른 데이터 원본은 풀에 등록된 다른 클라이언트에 의해 데이터 새로 고침 작업이 계속 수행됩니다.
자세한 내용은 끝내기 및 연결 해제의 효과를 참조하십시오.
Bridge 클라이언트 설정
구성 파일의 기본 위치는 C:\Users\jsmith\문서\내 Tableau Bridge 리포지토리\Configuration\TabBridgeClientConfiguration.txt입니다.
구성 | 구성 옵션 | 구성 가능 여부 | 설명 |
serviceConnectionSettings | serviceUrl | 아니요 | Tableau 사이트 URL입니다. |
connection | connectTimeout | 예 | Tableau Cloud 연결 시도 시 Bridge 클라이언트 대기 시간입니다. 기본값: 1분 |
operationTimeout | 예 | Tableau Cloud에 성공적으로 연결된 후 각 서버(예: VizPortal) API 호출에 대한 Bridge 클라이언트 대기 시간입니다. 기본값: 15분 | |
maxAttemptsToRedirectHttpRequests | 예 | 서버에 대한 API 호출을 POD에서 POD로 리디렉션할 수 있습니다. 이 숫자는 서버 API 호출당 최대 리디렉션 수를 지정합니다. 기본값: 20 | |
connectionPool | Size | 예 | Online 일정에 적용됩니다. 로그인 시간에 생성된 새로 고침 토큰의 수입니다. Bridge 클라이언트는 Tableau Cloud에 연결해야 할 때 새로 고침 토큰을 사용합니다. 새로 고침 작업은 동시에 처리되며 각 작업에 토큰이 필요합니다. 기본값: 10 최소값: 1 최대값: 100. 이 값을 변경하려면 클라이언트의 연결을 해제해야 합니다. |
dataSourceRefreshSettings | shutdownTimeoutInSeconds | 해당 없음 | 사용되지 않습니다. 지원되지 않습니다. |
downloadDataSourcesInterval | 예 | 레거시 일정에 대해 클라이언트에 할당된 라이브 데이터 원본 및 추출 데이터 원본의 이름을 임시로 다운로드할 때의 시간 간격입니다. 기본값: 30분 | |
checkRefreshDataSourcesInterval
| 예 | 레거시 일정에 새로 고침이 필요한지 여부를 확인하기 위해 Bridge 클라이언트에서 클라이언트에 할당된 데이터 원본을 확인하는 시간 간격입니다. 기본값: 5초 | |
extractRefreshTimeout | 예 | 클라이언트에 의해 수행되는 새로 고침에 시간 제한을 적용합니다. 시간 초과 제한은 단일 추출에서 새로 고침을 완료하는 데 허용되는 시간으로 이 시간이 지나면 클라이언트가 새로 고침을 취소합니다. 시간 초과 제한에 도달하여 추출 새로 고침이 취소된 경우 클라이언트에 메시지가 표시되고 데이터 원본 소유자에게 이메일 알림이 전송됩니다. 기본값: 24시간 가상 연결의 경우 기본 추출 새로 고침 시간 초과 제한은 2시간이고 Tableau Cloud에 의해 제어됩니다. Bridge 클라이언트에서는 시간 제한을 제어할 수 없습니다. | |
maxRemoteJobConcurrency | 예 | Online 일정에 적용됩니다. 클라이언트가 허용하는 원격 새로 고침 작업의 최대 수입니다. 이 구성의 값은 기본값: 10 최소값: 1 최대값: | |
JSONLogForExtractRefresh | 예 | true로 설정하면 클라이언트에서 JSON 형식의 추가 로그 파일이 생성됩니다. 이 로그는 레거시 새로 고침과 원격 새로 고침에서 추출의 최신 상태에 대한 메트릭을 추출당 한 줄로 캡처합니다. Tableau Desktop에서는 JSON 로그 파일의 형식을 읽을 수 있으며 이 로그 파일을 데이터 원본으로 사용하여 라이브 비주얼리제이션을 만들 수 있습니다. 자세한 내용은 JSON 파일을 참조하십시오. 로그 파일의 예:
이 구성 옵션의 값을 변경하면 Bridge 클라이언트를 다시 시작해야 합니다.
기본값: false | |
dataSources | 아니요 | 레거시 일정 새로 고침 작업에 적용됩니다. 사용자가 편집할 수 없습니다. 파일 기반 데이터 원본의 매핑된 로컬 파일 위치를 제공합니다. | |
loggerSettings | maxLogFileSizeInMB | 예 | 로그 파일의 최대 크기(MB)입니다. 로그 파일이 이 크기 제한을 초과하면 새 로그 파일이 만들어집니다. 기본값: 25MB |
maxBackupLogFileCount | 예 | 허용되는 Bridge 로그 파일의 최대 수입니다. 로그 파일 수가 제한을 초과하면 가장 오래된 로그 파일이 삭제됩니다. 기본값: 40 | |
remoteRequestLogFileLifeSpan | 예 | 클라이언트로 전송되는 각 Bridge 새로 고침 작업에 대해 새로운 로그 파일 집합 tabbridgeclijob_<process_id 가 만들어집니다. 데이터 원본이 JDBC 기반인 경우 fjprotocolserver_<process_id>, and stdout_jprotocolserver_<process_id> 가 만들어집니다.기본적으로 로그 파일 수가
기본값: 8시간 | |
dataSyncRestartInterval | 해당 없음 | 사용되지 않습니다. 지원되지 않습니다. | |
internetConnectionMonitorInterval | 예 | Bridge에서 유효한 연결이 있는지 확인하기 위해 인터넷에 ping을 실행하는 간격입니다. 기본값: 30초 | |
secureStorageMonitorInterval | 해당 없음 | 사용되지 않습니다. 지원되지 않습니다. | |
cleanUpTempDirOnStartUp | 예 | Bridge 클라이언트가 시작될 때 임시 파일을 제거할지 여부를 결정합니다. 기본값: true | |
JSONLogForLiveQuery | 예 | true로 설정하면 클라이언트에서 JSON 형식의 추가 로그 파일이 생성됩니다. 이 로그는 라이브 쿼리 요청의 메트릭을 추출당 한 줄로 캡처합니다. Tableau Desktop에서는 JSON 로그 파일의 형식을 읽을 수 있으며 이 로그 파일을 데이터 원본으로 사용하여 라이브 비주얼리제이션을 만들 수 있습니다. 자세한 내용은 JSON 파일을 참조하십시오. 로그 파일의 예:
이 구성 옵션의 값을 변경하면 Bridge 클라이언트를 다시 시작해야 합니다.
기본값: true |
새로 고침에 대한 시간 초과 제한 구성
추출이나 새로 고침을 오용하지 못하도록 클라이언트에서 수행되는 새로 고침 작업에 대한 시간 제한(시간 초과 제한이라고도 함)을 적용할 수 있습니다. 시간 초과 제한은 단일 추출에서 새로 고침을 완료하는 데 허용되는 시간으로 이 시간이 지나면 클라이언트가 새로 고침을 취소합니다.
참고: 가상 연결의 추출에서 기본 추출 새로 고침 시간 초과 제한은 2시간이고 Bridge 클라이언트에서는 이를 제어할 수 없습니다. 대안으로, 기본 2시간 기간 내에 새로 고치거나 게시된 데이터 원본으로 전환하도록 가상 연결을 수정할 수 있습니다.
기본적으로 클라이언트의 시간 초과 제한은 24시간으로 설정됩니다. Bridge 구성 파일을 사용하여 클라이언트에 대한 시간 초과 제한을 변경할 수 있습니다. 시간 초과 제한에 도달하여 추출 새로 고침이 취소된 경우 클라이언트에 메시지가 표시되고 데이터 원본 소유자에게 이메일 알림이 전송됩니다.
구성 파일의 변경 사항을 적용하려면 클라이언트를 다시 시작해야 합니다.
클라이언트가 설치된 컴퓨터에서 내 Tableau Bridge 리포지토리의 구성 폴더로 이동합니다.
TabBridgeClientConfiguration.txt 파일을 엽니다.
extractRefreshTimeout 옆에서 새로 고침 작업을 완료하는 데 허용되는 시간을 변경합니다.
참고: 구성 파일에서 매개 변수를 확인할 수 없는 경우 "extractRefreshTimeout"을 추가하고 dataSourceRefreshSettings 설정에 원하는 새로 고침 시간을 추가하면 됩니다.
파일을 저장하고 닫습니다.
변경 내용을 적용하려면 클라이언트를 끝내고 다시 시작합니다. 클라이언트를 다시 시작하는 방법은 클라이언트가 응용 프로그램 모드에서 실행되는지, 아니면 서비스 모드에서 실행되는지에 따라 다릅니다.
응용 프로그램 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다.
서비스 모드인 경우 모드 드롭다운 메뉴에서 응용 프로그램을 선택하고 클라이언트 메뉴에서 끝내기를 선택합니다.
Bridge 로그 파일 관리
클라이언트는 정상 작동의 일부로 활동 로그를 만듭니다. 새로 고침을 모니터링하거나 Bridge 관련 문제를 해결하거나 Tableau 지원 부서에서 문제 해결에 도움이 되는 로그를 요청하는 경우에만 이러한 로그를 사용할 수 있습니다.
Bridge 로그 파일의 크기를 관리하거나 TabBridgeClientConfiguration.txt 파일에서 삭제하기 전에 로그 파일이 유지되는 시간을 늘릴 수 있습니다.
참고: 이름이 tabprotosrv*인 로그 파일은 다른 Bridge 로그 파일과 다릅니다. 최대 크기는 1MB이고 최대 허용 로그 파일 수는 8,192개입니다. 이러한 값도 구성할 수 없습니다.
클라이언트가 설치된 컴퓨터에서 내 Tableau Bridge 리포지토리의 구성 폴더로 이동합니다.
TabBridgeClientConfiguration.txt 파일을 엽니다.
loggerSettings 옆에서 다음 매개 변수에 대한 값을 변경할 수 있습니다.
"maxLogFileSizeInMB" : 25
"maxBackupLogFileCount" : 40
"remoteRequestLogFileLifeSpan" : "08:00:00"
파일을 저장하고 닫습니다.
변경 내용을 적용하려면 클라이언트를 종료하고 다시 시작합니다. 클라이언트를 다시 시작하는 방법은 클라이언트가 응용 프로그램 모드에서 실행되는지, 아니면 서비스 모드에서 실행되는지에 따라 다릅니다.
응용 프로그램 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다.
서비스 모드인 경우 모드 드롭다운 메뉴에서 응용 프로그램을 선택하고 클라이언트 메뉴에서 끝내기를 선택합니다.
Bridge 풀의 크기 관리
기본적으로 풀의 각 클라이언트는 한 번에 최대 10개의 새로 고침 작업의 부하를 분산할 수 있습니다. 지정된 시간에 실행되는 새로 고침 작업의 수가 클라이언트 풀의 용량을 초과하거나 이를 지원할 하드웨어 리소스가 있는 경우 각 클라이언트의 용량을 늘리는 것이 좋습니다.
TabBridgeClientConfiguration.txt 파일에서 클라이언트의 풀링 용량을 관리할 수 있습니다.
ConnectionPool 구성 변경
중요: 아래에 설명된 절차를 수행하려면 클라이언트 연결을 해제해야 합니다. 연결을 해제하면 사이트와 클라이언트 간의 연결이 제거됩니다. 즉, Bridge(레거시) 일정을 사용하여 새로 고쳐진 데이터 원본의 경우 클라이언트 연결을 해제하면 해당 데이터 원본에 대한 연결, 해당 일정 및 클라이언트의 모든 연결 정보가 제거됩니다. Bridge 풀의 크기를 수정하는 과정에서 Windows 시스템 트레이에서 Bridge 아이콘을 클릭하고 나열된 데이터 원본(5단계)을 기록하여 일정 조정 프로세스(10단계)에서 참조하는 것이 좋습니다.
클라이언트가 설치된 컴퓨터에서 내 Tableau Bridge 리포지토리의 구성 폴더로 이동합니다.
구성 폴더의 기본 위치는 C:\Users\jsmith\Documents\내 Tableau Bridge 리포지토리\Configuration입니다.
TabBridgeClientConfiguration.txt 파일을 엽니다.
ConnectionPool
옆에 있는 값을 편집합니다.파일을 저장하고 닫습니다.
- (선택 사항) Windows 시스템 트레이에서 Bridge 아이콘을 클릭하고 나열된 데이터 원본과 해당 데이터 원본에 대해 구성된 새로 고침 일정을 기록합니다.
Windows 시스템 트레이에서 Bridge 아이콘을 마우스 오른쪽 단추로 클릭하고 연결 해제를 선택합니다.
연결 해제 옵션에 대한 자세한 내용은 끝내기 및 연결 해제의 효과를 참조하십시오.
변경 내용을 적용하기 위해 클라이언트를 종료합니다. 클라이언트를 종료하는 방법은 클라이언트가 응용 프로그램 모드에서 실행되는지, 아니면 서비스 모드에서 실행되는지에 따라 다릅니다.
응용 프로그램 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다.
서비스 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다. 대화 상자에서 클라이언트 종료 및 작업 중지 확인란을 선택하고 닫기를 클릭합니다.
Bridge를 다시 시작합니다.
메시지가 표시되면 사이트 관리자 자격 증명을 사용하여 Tableau Cloud에 로그인합니다.
- (선택 사항) Bridge(레거시) 일정을 사용하는 데이터 원본에 대해 5단계를 수행한 경우 새 Bridge(레거시) 일정 추가 또는 기존 일정 업데이트에 설명된 절차에 따라 새로 고침 일정을 조정하고 데이터 원본을 클라이언트와 효과적으로 다시 연결합니다.
maxRemoteJobConcurrency 구성 변경
클라이언트가 설치된 컴퓨터에서 내 Tableau Bridge 리포지토리의 구성 폴더로 이동합니다.
TabBridgeClientConfiguration.txt 파일을 엽니다.
maxRemoteJobConcurrency
옆에 있는 값을 편집합니다.파일을 저장하고 닫습니다.
변경 내용을 적용하기 위해 클라이언트를 종료합니다. 클라이언트를 종료하는 방법은 클라이언트가 응용 프로그램 모드에서 실행되는지, 아니면 서비스 모드에서 실행되는지에 따라 다릅니다.
응용 프로그램 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다.
서비스 모드인 경우 클라이언트 메뉴에서 끝내기를 선택합니다. 대화 상자에서 클라이언트 종료 및 작업 중지 확인란을 선택하고 닫기를 클릭합니다.
Bridge를 다시 시작합니다.
메시지가 표시되면 사이트 관리자 자격 증명을 사용하여 Tableau Cloud에 로그인합니다.
- (선택 사항) Bridge(레거시) 일정을 사용하는 데이터 원본에 대해 5단계를 수행한 경우 새 Bridge(레거시) 일정 추가 또는 기존 일정 업데이트에 설명된 절차에 따라 새로 고침 일정을 조정하고 데이터 원본을 클라이언트와 효과적으로 다시 연결합니다.