---
schema_version: "1"
id: 52953c03d89344cc1e60ed20845b0b51fc2de20b4cd42372510eac4041705cb4
title: Bridge 클라이언트 설정 변경
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/online/to_sync_change_computer_site.md
canonical_url: https://help.tableau.com/current/online/ko-kr/to_sync_change_computer_site.htm
source_site: help.tableau.com
content_type: documentation
content_hash: bba5d67692df45c965123fad7f709a7038625c19aeb9f79c2c89afe52cf01aaa
description: Change Tableau Bridge client settings using the configuration file.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# Bridge 클라이언트 설정 변경

사이트 관리자가 구성하여 클라이언트가 실행되는 방식을 변경할 수 있는 여러 Bridge 클라이언트 설정이 있습니다.

## Windows 클라이언트

Windows 클라이언트의 경우 구성 파일의 기본 위치는 `C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt`입니다.구성 파일의 변경 사항을 적용하려면 클라이언트를 다시 시작해야 합니다.

## Linux 컨테이너용 Bridge

`TabBridgeClientConfiguration.txt` 파일은 Bridge 클라이언트를 처음 실행할 때 기본 구성으로 생성됩니다.

구성 설정을 변경하려면 `TabBridgeClientConfiguration.txt` 파일을 편집하고 업데이트된 파일을 사용하여 새 Docker 컨테이너를 만드십시오.컨테이너를 만들고 업데이트하는 방법에 대한 자세한 내용은 [응용 프로그램 컨테이너화](https://docs.docker.com/get-started/02_our_app/)를 참조하십시오.

## Bridge 레거시 일정

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

## Bridge 클라이언트 설정

### serviceConnectionSettings

구성: `serviceConnectionSettings`

옵션:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>serviceUrl</code></td><td>Tableau 사이트 URL입니다.<p><i>구성할 수 없습니다</i>.</p></td></tr><tr><td><code>proxyServer</code></td><td>프록시 서버 및 포트입니다.<p><i>구성 가능</i></p></td></tr></tbody></table>

#### 예

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

```
"serviceConnectionSettings" : {
	"serviceUrl" : "https://online.tableau.com",
	"proxyServer" : {
	"serverName" : "http://localhost",
	"serverPort" : 8888
	}
```

### connection

구성: `connection`

옵션:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>connectTimeout</code></td><td>Tableau Cloud 연결 시도 시 Bridge 클라이언트 대기 시간입니다.<p>기본값: 1분</p><p><i>구성 가능합니다.</i></p></td></tr><tr><td><code>operationTimeout</code></td><td>Tableau Cloud에 성공적으로 연결된 후 각 서버(예: VizPortal) API 호출에 대한 Bridge 클라이언트 대기 시간입니다.<p>기본값: 15분</p><p><i>구성 가능합니다</i>.</p></td></tr><tr><td><code>maxAttemptsToRedirectHttpRequests</code></td><td>서버에 대한 API 호출을 포드에서 포드로 리디렉션할 수 있습니다.이 숫자는 서버 API 호출당 최대 리디렉션 수를 지정합니다.기본값: 20<p><i>구성 가능합니다</i>.</p></td></tr></tbody></table>

#### 예

```
"connection" : {
	"connectTimeout" : "00:01:00",
	"operationTimeout" : "00:15:00",
	"maxAttemptsToRedirectHttpRequests" : 20
	}
```

### dataSourceRefreshSettings

구성: `dataSourceRefreshSettings`

옵션:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>shutdownTimeoutInSeconds</code></td><td><i>구성할 수 없습니다</i>.</td></tr><tr><td><code>downloadDataSourcesInterval</code></td><td>Bridge 레거시 일정에 대해 클라이언트에 할당된 라이브 데이터 원본 및 추출 데이터 원본의 이름을 임시로 다운로드할 때의 시간 간격입니다.<p>기본값: 30분<br></p><p><i>구성 가능합니다</i>.<br></p></td></tr><tr><td><code>checkRefreshDataSourcesInterval</code></td><td>Bridge 레거시 일정에 새로 고침이 필요한지 여부를 확인하기 위해 Bridge 클라이언트에서 클라이언트에 할당된 데이터 원본을 확인하는 시간 간격입니다.<p>기본값: 5초</p><p><i>구성 가능합니다</i>.</p></td></tr><tr><td><code>extractRefreshTimeout</code></td><td>클라이언트에 의해 수행되는 새로 고침에 시간 제한을 적용합니다.시간 초과 제한은 단일 추출에서 새로 고침을 완료하는 데 허용되는 시간으로 이 시간이 지나면 클라이언트가 새로 고침을 취소합니다.시간 초과 제한에 도달하여 추출 새로 고침이 취소된 경우 클라이언트에 메시지가 표시되고 데이터 원본 소유자에게 이메일 알림이 전송됩니다.<p>기본값: 24시간</p><p>가상 연결의 경우 기본 추출 새로 고침 시간 초과 제한은 2시간이고 Tableau Cloud에 의해 제어됩니다. Bridge 클라이언트에서는 시간 제한을 제어할 수 없습니다.</p><p><i>구성 가능합니다</i>.</p></td></tr><tr><td><code>maxRemoteJobConcurrency</code></td><td>단일 클라이언트에 허용되는 동시 원격 새로 고침 작업(PDS 추출)의 최대 개수를 지정합니다.<p>기본값: 10</p><p>최소값: 1</p><p>최대값: 90</p><p><i>구성 가능합니다</i>.</p><p>이 설정을 적용하려면:</p><ol><li value="1"><p>클라이언트의 연결을 해제합니다.</p></li><li value="2"><p>클라이언트를 다시 연결하고 로그인합니다.</p></li><li value="3"><p>클라이언트를 명명된 풀에 할당합니다.</p></li></ol><p><b>참고:</b> Windows 사용자의 경우 이 설정을 변경한 후 응용 프로그램에서 다른 동작이 필요하다는 잘못된 오류가 표시되면 Windows 보안 저장소에서 Bridge 자격 증명을 수동으로 지우십시오.</p></td></tr><tr><td><code>JSONLogForExtractRefresh</code></td><td>true로 설정하면 클라이언트에서 JSON 형식의 추가 로그 파일이 생성됩니다.이 로그는 Bridge 레거시 새로 고침과 원격 새로 고침에서 추출의 최신 상태에 대한 메트릭을 추출당 한 줄로 캡처합니다.<p><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>에서는 JSON 로그 파일의 형식을 읽을 수 있으며 이 로그 파일을 데이터 원본으로 사용하여 라이브 비주얼리제이션을 만들 수 있습니다.자세한 내용은 <a href="https://help.tableau.com/current/pro/desktop/ko-kr/examples_json.htm">JSON 파일</a>을 참조하십시오.</p><p>로그 파일의 예: <code>
							ExtractRefreshMetrics_&lt;timestamp&gt;.json</code><br>이 구성 옵션의 값을 변경하면 Bridge 클라이언트를 다시 시작해야 합니다.</p><p><code>loggerSettings </code>구성 옵션은 JSON 로그 파일에 적용됩니다.</p><p>기본값: false</p><p><i>구성 가능합니다</i>.</p></td></tr><tr><td><code>dataSources</code></td><td>Bridge 레거시 일정 새로 고침 작업에 적용됩니다.사용자가 편집할 수 없습니다.<br>파일 기반 데이터 원본의 매핑된 로컬 파일 위치를 제공합니다.<p><i>구성할 수 없음</i></p></td></tr></tbody></table>

#### 예

추출이나 새로 고침을 오용하지 못하도록 클라이언트에서 수행되는 새로 고침 작업에 대한 시간 제한(시간 초과 제한이라고도 함)인 `extractRefreshTimeout`을 적용할 수 있습니다.시간 초과 제한은 단일 추출에서 새로 고침을 완료하는 데 허용되는 시간으로 이 시간이 지나면 클라이언트가 새로 고침을 취소합니다.

**참고**: 가상 연결의 추출에서 `extractRefreshTimeout`의 기본값은 2시간이고 Bridge 클라이언트에서는 이를 제어할 수 없습니다.대안으로, 기본 2시간 기간 내에 새로 고치거나 게시된 데이터 원본으로 전환하도록 가상 연결을 수정할 수 있습니다.

기본적으로 클라이언트의 시간 초과 제한은 24시간으로 설정됩니다.Bridge 구성 파일을 사용하여 클라이언트에 대한 시간 초과 제한을 변경할 수 있습니다.시간 초과 제한에 도달하여 추출 새로 고침이 취소된 경우 클라이언트에 메시지가 표시되고 데이터 원본 소유자에게 이메일 알림이 전송됩니다.

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

```
"dataSourceRefreshSettings" : {
	"shutdownTimeoutInSeconds" : "00:00:30",
	"downloadDataSourcesInterval" : "00:30:00",
	"checkRefreshDataSourcesInterval" : "00:00:05",
	"extractRefreshTimeout" : "24:00:00",
	"maxRemoteJobConcurrency" : 10,
	"JSONLogForExtractRefresh" : false,
	"dataSources" : [
	]
}
```

### loggerSettings

구성: `loggerSettings`

옵션:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>maxLogFileSizeInMB</code></td><td>로그 파일의 최대 크기(MB)입니다.로그 파일이 이 크기 제한을 초과하면 새 로그 파일이 만들어집니다.<p>기본값: 25MB</p><p><i>구성 가능합니다</i>.</p></td></tr><tr><td><code>maxBackupLogFileCount</code></td><td>허용되는 Bridge 로그 파일의 최대 수입니다.로그 파일 수가 제한을 초과하면 가장 오래된 로그 파일이 삭제됩니다.<p>기본값: 40<br></p><p><i>구성 가능합니다</i>.<br></p></td></tr><tr><td><code>remoteRequestLogFileLifeSpan</code></td><td>클라이언트로 전송되는 각 Bridge 새로 고침 작업에 대해 새로운 로그 파일 집합이 만들어집니다.<p><code>tabbridgeclijob_&lt;process_id, and if the data source is JDBC-based: fjprotocolserver_&lt;process_id&gt;, and stdout_jprotocolserver_&lt;process_id&gt;</code>.</p><p>기본적으로 로그 파일 수가 <code>maxBackupLogFileCount</code>를 초과하면 로그 파일이 삭제되기 전에 로그 폴더에 남아 있는 최대 시간은 8시간입니다.그렇지 않으면 로그 파일 수가 <code>maxBackupLogFileCount</code>보다 작거나 같은 동안 이러한 로그 파일은 무기한으로 남아 있습니다.</p><p><code>&lt;process_id&gt;</code>는 Windows 프로세스 ID를 나타냅니다.</p><p>기본값: 8시간</p><p><i>구성 가능합니다</i>.</p></td></tr></tbody></table>

#### 예

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

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

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

```
"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
	"maxBackupLogFileCount" : 40,
	"remoteRequestLogFileLifeSpan" : "00:00:00"
}
```

### dataSyncRestartInterval

구성: `dataSyncRestartInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>데이터 동기화의 재시작 간격을 설정합니다.</p><p><i>구성 가능합니다</i>.</p></td></tr></tbody></table>

### internetConnectionMonitorInterval

구성: `internetConnectionMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Bridge에서 유효한 연결이 있는지 확인하기 위해 인터넷에 ping을 실행하는 간격입니다.</p><p>기본값: 30초</p><p><i>구성 가능합니다</i>.</p></td></tr></tbody></table>

### secureStorageMonitorInterval

구성: `secureStorageMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>Bridge가 보안 저장소를 확인하는 간격입니다.<p><i>구성할 수 없습니다</i>.</p></td></tr></tbody></table>

#### cleanUpTempDirOnStartUp

구성: `cleanUpTempDirOnStartUp`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Bridge 클라이언트가 시작될 때 임시 파일을 제거할지 여부를 결정합니다.</p><p>기본값: true</p><p><i>구성 가능합니다</i>.</p></td></tr></tbody></table>

#### JSONLogForLiveQuery

구성: `JSONLogForLiveQuery`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>true로 설정하면 클라이언트에서 JSON 형식의 추가 로그 파일이 생성됩니다.이 로그는 라이브 쿼리 요청의 메트릭을 추출당 한 줄로 캡처합니다.<p><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>에서는 JSON 로그 파일의 형식을 읽을 수 있으며 이 로그 파일을 데이터 원본으로 사용하여 라이브 비주얼리제이션을 만들 수 있습니다.자세한 내용은 JSON 파일을 참조하십시오.</p><p>이 구성 옵션의 값을 변경하면 Bridge 클라이언트를 다시 시작해야 합니다.</p><p>기본값: true</p><p><i>구성 가능합니다</i>.</p></td></tr></tbody></table>

#### 예

```
"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,,
"JSONLogForLiveQuery" : true
}
```

## 기본 구성 파일

기본 구성 파일을 복사하려면 오른쪽 상단의 **클립보드로 복사** 아이콘을 클릭합니다.

```
{
	"serviceConnectionSettings" : {
		"serviceUrl" : "https://online.tableau.com/",
		"connection" : {
			"connectTimeout" : "00:01:00",
			"operationTimeout" : "00:15:00",
			"maxAttemptsToRedirectHttpRequests" : 20
		},
	},
	"dataSourceRefreshSettings" : {
		"shutdownTimeoutInSeconds" : "00:00:30",
		"downloadDataSourcesInterval" : "00:30:00",
		"checkRefreshDataSourcesInterval" : "00:00:05",
		"extractRefreshTimeout" : "24:00:00",
		"maxRemoteJobConcurrency" : 10,
		"JSONLogForExtractRefresh" : false,
		"dataSources" : [
		]
	},
	"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
		"maxBackupLogFileCount" : 40,
		"remoteRequestLogFileLifeSpan" : "08:00:00"
	},
	"dataSyncRestartInterval" : "24:00:00",
	"internetConnectionMonitorInterval" : "00:00:30",
	"secureStorageMonitorInterval" : "00:00:30",
	"cleanUpTempDirOnStartUp" : true,
	"JSONLogForLiveQuery" : true
}
```

## 이 섹션의 다른 문서