เปลี่ยนการตั้งค่าไคลเอ็นต์ Bridge

นำไปใช้กับ Tableau Cloud

ผู้ดูแลเว็บไซต์สามารถกำหนดค่าการตั้งค่าไคลเอ็นต์ Bridge ได้หลายรายการเพื่อเปลี่ยนวิธีการทำงานของไคลเอ็นต์

ไคลเอ็นต์ Windows

สำหรับไคลเอ็นต์ Windows ตำแหน่งเริ่มต้นของไฟล์การกำหนดค่าคือ C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt คุณต้องรีสตาร์ทไคลเอ็นต์เพื่อให้การเปลี่ยนแปลงที่ทำกับไฟล์การกำหนดค่านั้นมีผล

Bridge สำหรับ Linux สำหรับคอนเทนเนอร์

ไฟล์ TabBridgeClientConfiguration.txt จะสร้างขึ้นด้วยการกำหนดค่าเริ่มต้นในครั้งแรกที่คุณเรียกใช้ไคลเอ็นต์ Bridge

หากต้องการเปลี่ยนการตั้งค่าการกำหนดค่า ให้แก้ไขไฟล์ TabBridgeClientConfiguration.txt และสร้างคอนเทนเนอร์ Docker ใหม่ด้วยไฟล์ที่อัปเดต หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับวิธีการสร้างและอัปเดตคอนเทนเนอร์ โปรดดูสร้างคอนเทนเนอร์แอปพลิเคชัน

กำหนดการของ Bridge รุ่นเดิม

ในบางกรณี เจ้าของแหล่งข้อมูลอาจต้องรับผิดชอบต่องานบางอย่างที่อธิบายไว้ในหัวข้อนี้ หากมีการบำรุงรักษาไคลเอ็นต์ของตนเองเพื่อเรียกใ้ชกำหนดการแบบเดิมของ Bridge

การตั้งค่าไคลเอ็นต์ Bridge

serviceConnectionSettings

การกำหนดค่า: serviceConnectionSettings

ตัวเลือก:

`serviceUrl`	URL ของไซต์ Tableau ไม่สามารถกำหนดค่าได้
`proxyServer`	เซิร์ฟเวอร์พร็อกซีและพอร์ต กำหนดค่าได้

ตัวอย่าง

คุณต้องรีสตาร์ทไคลเอ็นต์เพื่อให้การเปลี่ยนแปลงที่ทำกับไฟล์การกำหนดค่านั้นมีผล

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

การเชื่อมต่อ

การกำหนดค่า: connection

ตัวเลือก:

connectTimeout

เวลารอของไคลเอ็นต์ Bridge เมื่อพยายามเชื่อมต่อกับ Tableau Cloud

ค่าเริ่มต้น: 1 นาที

กำหนดค่าได้

operationTimeout

เวลารอของไคลเอ็นต์ Bridge สำหรับแต่ละเซิร์ฟเวอร์ (เช่น VizPortal) การเรียก API หลังจากเชื่อมต่อกับ Tableau Cloud สำเร็จ

ค่าเริ่มต้น: 15 นาที

กำหนดค่าได้

maxAttemptsToRedirectHttpRequests

การเรียก API ไปยังเซิร์ฟเวอร์สามารถเปลี่ยนเส้นทางจาก POD ไปยัง POD ได้ ตัวเลขนี้ระบุจำนวนการเปลี่ยนเส้นทางสูงสุดต่อการเรียก API ของเซิร์ฟเวอร์ ค่าเริ่มต้น: 20

กำหนดค่าได้

ตัวอย่าง

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

connectionPool

การกำหนดค่า: connectionPool

ตัวเลือก:

size

มีผลกับกำหนดเวลารีเฟรช Bridge

จำนวนโทเค็นการรีเฟรชที่สร้างขึ้นเมื่อเข้าสู่ระบบ ไคลเอ็นต์ Bridge ใช้โทเค็นการรีเฟรชเมื่อจำเป็นต้องเชื่อมต่อกับ Tableau Cloud งานรีเฟรชจะได้รับการประมวลผลพร้อมกัน และแต่ละงานต้องใช้โทเค็น

ค่าเริ่มต้น: 10

ค่าต่ำสุด: 1

ค่าสูงสุด: 100

กำหนดค่าได้

ตัวอย่าง

ตามค่าเริ่มต้นแล้ว ไคลเอ็นต์แต่ละรายการในกลุ่มสามารถจัดสรรภาระงานการรีเฟรชได้สูงสุด 10 รายการในครั้งเดียว หากจำนวนงานการรีเฟรชที่ทำงานอยู่ในช่วงเวลาหนึ่งเกินความจุของพูลไคลเอ็นต์ หรือคุณมีทรัพยากรฮาร์ดแวร์ที่จะรองรับ ให้พิจารณาเพิ่มความจุของไคลเอ็นต์แต่ละรายการ

สำหรับ Windows การเปลี่ยนค่า size จำเป็นต้องยกเลิกการเชื่อมโยงกับไคลเอ็นต์ การยกเลิกการลิงก์จะลบการเชื่อมโยงระหว่างเว็บไซต์กับไคลเอ็นต์ ซึ่งหมายความว่าสำหรับแหล่งข้อมูลที่ได้รับการรีเฟรชโดยใช้กำหนดการรุ่นเดิมของ Bridge การยกเลิกการเชื่อมโยงกับไคลเอ็นต์จะลบการเชื่อมโยงกับแหล่งข้อมูลเหล่านั้น รวมถึงกำหนดการ และข้อมูลการเชื่อมต่อใดๆ จากไคลเอ็นต์ ในการปรับเปลี่ยนขนาดของพูล Bridge เราขอแนะนำให้คุณคลิกไอคอน Bridge ในถาดของระบบ Windows และบันทึกรายการแหล่งข้อมูลที่แสดงเพื่อช่วยในกระบวนการจัดกำหนดการใหม่

"connection" : {
	"connectTimeout" : "00:01:00",
	"operationTimeout" : "00:15:00",
	"maxAttemptsToRedirectHttpRequests" : 20
	},
"connectionPool" : {
	"size" : 10
}

dataSourceRefreshSettings

การกำหนดค่า: dataSourceRefreshSettings

ตัวเลือก:

`shutdownTimeoutInSeconds`	ไม่สามารถกำหนดค่าได้
`downloadDataSourcesInterval`	ช่วงเวลาสำหรับการดาวน์โหลดชั่วคราวซึ่งชื่อแหล่งข้อมูลแบบสดและแหล่งข้อมูลแบบแยกข้อมูลที่กำหนดให้กับไคลเอ็นต์สำหรับกำหนดการรุ่นเดิมของ Bridge ค่าเริ่มต้น: 30 นาที กำหนดค่าได้
`checkRefreshDataSourcesInterval`	ช่วงเวลาสำหรับไคลเอ็นต์ Bridge เพื่อตรวจสอบแหล่งข้อมูลที่กำหนดให้กับไคลเอ็นต์เพื่อกำหนดว่าจำเป็นต้องรีเฟรชสำหรับกำหนดการของรุ่นเดิมของ Bridge หรือไม่ ค่าเริ่มต้น: 5 วินาที กำหนดค่าได้
`extractRefreshTimeout`	บังคับใช้การจำกัดเวลาสำหรับการรีเฟรชที่ดำเนินการโดยไคลเอ็นต์ ขีดจำกัดการหมดเวลาคือเวลาที่นานที่สุดที่อนุญาตสำหรับการแยกข้อมูลครั้งเดียวเพื่อทำการรีเฟรชให้เสร็จสิ้นก่อนที่ไคลเอ็นต์จะยกเลิก หากการรีเฟรชการแยกข้อมูลถูกยกเลิกเนื่องจากถึงขีดจำกัดการหมดเวลา คุณจะเห็นข้อความในไคลเอ็นต์และการแจ้งเตือนทางอีเมลจะส่งไปยังเจ้าของแหล่งข้อมูล ค่าเริ่มต้น: 24 ชั่วโมง สำหรับการเชื่อมต่อแบบเสมือน ขีดจำกัดการหมดเวลาของการรีเฟรชการแยกข้อมูลตามค่าเริ่มต้นคือ 2 ชั่วโมงและถูกควบคุมโดย Tableau Cloud โดยจะไม่สามารถควบคุมขีดจำกัดเวลานี้โดยไคลเอ็นต์ Bridge ได้ กำหนดค่าได้
`maxRemoteJobConcurrency`	มีผลกับกำหนดเวลารีเฟรช Bridge จำนวนงานรีเฟรชระยะไกลสูงสุดที่ไคลเอ็นต์อนุญาต ค่าสำหรับการกำหนดค่านี้ต้องเท่ากับหรือน้อยกว่า connectionPool ปรับค่าสูงสุดตามความสามารถของเครื่อง เช่น CPU และ RAM ต้องรีสตาร์ทไคลเอ็นต์ ค่าเริ่มต้น: 10 ต่ำสุด: 1 สูงสุด: ค่าสำหรับ `connectionPool` กำหนดค่าได้
`JSONLogForExtractRefresh`	เมื่อตั้งค่าเป็นจริง ไคลเอ็นต์จะสร้างไฟล์บันทึกเพิ่มเติมในรูปแบบ JSON บันทึกจะบันทึกเมตริกของการรีเฟรชการแยกข้อมูล สำหรับทั้งการรีเฟรชรุ่นเดิมของ Bridge และการรีเฟรชระยะไกล โดยมีบรรทัดเดียวต่อการแยกข้อมูล รูปแบบของไฟล์บันทึก JSON นั้นสามารถอ่านได้โดย Tableau Desktop และสามารถใช้เป็นแหล่งข้อมูลเพื่อสร้างการแสดงเป็นภาพแบบสดได้ หากต้องการข้อมูลเพิ่มเติม โปรดดูไฟล์ JSON ตัวอย่างของไฟล์บันทึกคือ: `ExtractRefreshMetrics_<timestamp>.json` การเปลี่ยนค่าของตัวเลือกการกำหนดค่านี้จำเป็นต้องรีสตาร์ทไคลเอ็นต์ Bridge ตัวเลือกการกำหนดค่า `loggerSettings` จะมีผลกับไฟล์บันทึก JSON ค่าเริ่มต้น: false กำหนดค่าได้
`dataSources`	มีผลกับงานการรีเฟรชกำหนดการรุ่นเดิมของ Bridge ผู้ใช้ไม่สามารถแก้ไขได้ แสดงรายการตำแหน่งไฟล์ในเครื่องที่แมปสำหรับแหล่งข้อมูลที่เป็นไฟล์ ไม่สามารถกำหนดค่าได้

ตัวอย่าง

หากต้องการควบคุมการใช้การแยกข้อมูลหรือการรีเฟรชอย่างไม่ถูกต้อง คุณสามารถบังคับใช้การจำกัดเวลาโดยใช้ 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

ตัวเลือก:

maxLogFileSizeInMB

ขนาดสูงสุดของไฟล์บันทึกมีหน่วยเป็น MB เมื่อไฟล์บันทึกมีขนาดเกินขีดจำกัด ระบบจะสร้างไฟล์บันทึกใหม่

ค่าเริ่มต้น: 25 MB

กำหนดค่าได้

maxBackupLogFileCount

จำนวนไฟล์บันทึก Bridge สูงสุดที่อนุญาต เมื่อจำนวนไฟล์บันทึกเกินขีดจำกัด ระบบจะลบไฟล์บันทึกที่เก่าที่สุดออก

ค่าเริ่มต้นคือ 40

กำหนดค่าได้

remoteRequestLogFileLifeSpan

สำหรับงานการรีเฟรช Bridge แต่ละงานที่ส่งไปยังไคลเอ็นต์ ไฟล์บันทึกชุดใหม่จะสร้างขึ้น:

tabbridgeclijob_<process_id, and if the data source is JDBC-based: fjprotocolserver_<process_id>, and stdout_jprotocolserver_<process_id>

ตามค่าเริ่มต้นแล้ว ระยะเวลาสูงสุดที่ไฟล์บันทึกจะยังคงอยู่ในโฟลเดอร์บันทึกก่อนจะถูกลบคือ 8 ชั่วโมง หากจำนวนไฟล์บันทึกเกิน maxBackupLogFileCount ทั้งนี้ ไฟล์บันทึกเหล่านี้จะคงอยู่ตลอดไปหากจำนวนไฟล์บันทึกน้อยกว่าหรือเท่ากับ maxBackupLogFileCount

<process_id> แสดงถึง ID ของกระบวนการ Windows

ค่าเริ่มต้น: 8 ชั่วโมง

กำหนดค่าได้

ตัวอย่าง

ไคลเอ็นต์จะสร้างบันทึกกิจกรรมโดยเป็นส่วนหนึ่งของการทำงานปกติ คุณสามารถใช้บันทึกเหล่านี้เพื่อตรวจสอบการรีเฟรช แก้ปัญหาเกี่ยวกับ Bridge หรือหากฝ่ายสนับสนุน Tableau ขอบันทึกจากคุณเพื่อช่วยแก้ไขปัญหา

คุณสามารถจัดการขนาดของไฟล์บันทึกของ Bridge หรือเพิ่มไฟล์บันทึกเวลาที่ยังคงอยู่ก่อนที่จะถูกลบในไฟล์ TabBridgeClientConfiguration.txt ได้

หมายเหตุ: ไฟล์บันทึกชื่อ tabprotosrv* จะแตกต่างจากไฟล์บันทึกอื่นๆ ของ Bridge ขนาดสูงสุดคือ 1 MB และจำนวนไฟล์บันทึกสูงสุดที่อนุญาตคือ 8,192 โดยค่าเหล่านี้ไม่สามารถกำหนดค่าได้

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

dataSyncRestartInterval

การกำหนดค่า: dataSyncRestartInterval

ตั้งค่าช่วงเวลารีสตาร์ทของการซิงค์ข้อมูล

กำหนดค่าได้

internetConnectionMonitorInterval

การกำหนดค่า: internetConnectionMonitorInterval

ช่วงเวลาสำหรับ Bridge เพื่อ ping อินเทอร์เน็ตเพื่อตรวจสอบว่ามีการเชื่อมต่อที่ถูกต้องหรือไม่

ค่าเริ่มต้น: 30 วินาที

กำหนดค่าได้

secureStorageMonitorInterval

การกำหนดค่า: secureStorageMonitorInterval

ช่วงเวลาสำหรับ Bridge เพื่อกำหนดพื้นที่เก็บข้อมูลที่ปลอดภัย

ไม่สามารถกำหนดค่าได้

cleanUpTempDirOnStartUp

การกำหนดค่า: cleanUpTempDirOnStartUp

กำหนดว่าจะลบไฟล์ชั่วคราวเมื่อไคลเอ็นต์ Bridge เริ่มทำงานหรือไม่

ค่าเริ่มต้น: true

กำหนดค่าได้

JSONLogForLiveQuery

การกำหนดค่า: JSONLogForLiveQuery

เมื่อตั้งค่าเป็นจริง ไคลเอ็นต์จะสร้างไฟล์บันทึกเพิ่มเติมในรูปแบบ JSON บันทึกจะรวบรวมเมตริกของคำขอค้นหาที่ใช้งานอยู่ โดยมีหนึ่งบรรทัดต่อการแยกข้อมูล

รูปแบบของไฟล์บันทึก JSON นั้นสามารถอ่านได้โดย Tableau Desktop และสามารถใช้เป็นแหล่งข้อมูลเพื่อสร้างการแสดงเป็นภาพแบบสดได้ หากต้องการข้อมูลเพิ่มเติม โปรดดูไฟล์ JSON

การเปลี่ยนค่าของตัวเลือกการกำหนดค่านี้จำเป็นต้องรีสตาร์ทไคลเอ็นต์ Bridge

ค่าเริ่มต้น: true

กำหนดค่าได้

ตัวอย่าง

"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
		},
		"connectionPool" : {
			"size" : 10
		}
	},
	"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
}

บทความอื่นๆ ในส่วนนี้

ย้อนกลับไปด้านบน

ขอบคุณสำหรับข้อเสนอแนะของคุณ

ส่งข้อเสนอแนะของคุณเรียบร้อยแล้ว ขอขอบคุณ

ความช่วยเหลือของ Tableau Cloud