ปรับแต่งและปรับตั้งการเชื่อมต่อ
คุณสามารถปรับแต่งพารามิเตอร์ของสตริงการเชื่อมต่อและความสามารถในการเชื่อมต่อได้โดยใช้ไฟล์ TDC ใช้ได้กับการเชื่อมต่อทั้ง ODBC และ JDBC
หากคุณกำลังปรับแต่งการเชื่อมต่อบน JDBC คุณยังสามารถแก้ไขพารามิเตอร์สตริงการเชื่อมต่อในไฟล์พร็อพเพอร์ตี้ได้อีกด้วย ดูรายละเอียดได้ที่ใช้ไฟล์พร็อพเพอร์ตี้เพื่อปรับแต่งการเชื่อมต่อ JDBC
สำคัญ: ไฟล์ TDC สามารถใช้เพื่อปรับแต่งฟังก์ชันการทำงานของการเชื่อมต่อหรือเพื่อวินิจฉัยและแก้ไขปัญหาที่เกี่ยวข้องกับการเชื่อมต่อกับข้อมูลของคุณ Tableau ไม่สามารถทดสอบการแก้ไขใดๆ ที่อาจเกิดขึ้นกับไฟล์เหล่านี้ได้อย่างทั่วถึง การสร้างและใช้งานไฟล์ TDC ต้องมีการแก้ไขด้วยตนเอง และมีความจำเป็นอย่างยิ่งที่จะต้องทดสอบอย่างละเอียดถี่ถ้วนก่อนที่จะนำไปใช้ในสภาพแวดล้อมการผลิต
ใช้ไฟล์ TDC เพื่อปรับแต่งการเชื่อมต่อ
หมายเหตุ: คุณสามารถมีไฟล์ TDC ได้หนึ่งไฟล์ต่อการเชื่อมต่อเท่านั้น หากมีไฟล์ TDC หลายไฟล์ที่อ้างอิงถึงไดรเวอร์เดียวกัน ระบบจะใช้เพียงไฟล์เดียวเท่านั้น
ไฟล์ TDC (การปรับแต่งแหล่งข้อมูล Tableau) คือไฟล์ XML ที่มีนามสกุลไฟล์ “.tdc” ไฟล์เหล่านี้ใช้เพื่อปรับแต่งการตั้งค่า Tableau โดยเฉพาะ สำหรับการเชื่อมต่อแบบใช้ ODBC คุณยังสามารถใช้ไฟล์ TDC เพื่อกำหนดส่วนต่างๆ ของมาตรฐาน ODBC และ SQL ที่ไดรเวอร์ ODBC รองรับได้ด้วย
ไฟล์ TDC จะมีชื่อผู้ให้บริการ ชื่อไดรเวอร์ และส่วน <connection-customization> (และรวมในคลาส) สำหรับเครื่องมือเชื่อมต่อในตัว ชื่อผู้ให้บริการและชื่อไดรเวอร์ต้องตรงกับชื่อคลาสของตัวเชื่อมต่อ โดยทั่วไปแล้วชื่อผู้ให้บริการจะตรงกับชื่อไดรเวอร์ ชื่อคลาสทั่วไปสองชื่อจะใช้สำหรับตัวเชื่อมต่อฐานข้อมูลอื่น:
- สำหรับตัวเชื่อมต่อฐานข้อมูลอื่นๆ (JDBC) ชื่อคลาสคือ "genericjdbc”
- สำหรับตัวเชื่อมต่อฐานข้อมูลอื่นๆ (ODBC) ชื่อคลาสคือ "genericodbc”
หากเวิร์กบุ๊กหรือไฟล์แหล่งข้อมูลที่มีอยู่มีส่วนการปรับแต่งที่เปิดใช้งานอยู่แล้ว Tableau จะใช้เฉพาะการปรับแต่งที่กำหนดและจะไม่ใช้การปรับแต่งที่กำหนดไว้ในไฟล์ TDC
โครงสร้างของไฟล์ TDC
ไฟล์ TDC แต่ละไฟล์มีโครงสร้างพื้นฐานดังนี้:
<connection-customization class=DSCLASS enabled='true' version='10.0'>
<vendor name=VENDOR />
<driver name=DRIVER />
<customizations>
<customization name='CAP_FAST_METADATA' value='yes'/>
<customization name='CAP_SOMETHING_ELSE' value='yes'/>
...
</customizations>
</connection-customization>ไฟล์ TDC มี 3 ส่วนหลักดังนี้:
- ตัวแปรปรับแต่งการเชื่อมต่อ
- ชื่อผู้ให้บริการและไดรเวอร์
- การปรับแต่งเอง
ส่วน connection-customization ประกอบด้วย:
- แบ่งคลาส: แหล่งข้อมูลที่คุณต้องการเชื่อมต่อและปรับแต่ง
- เปิดใช้งาน: เพื่อระบุว่าจะใช้การปรับแต่งการเชื่อมต่อไฟล์ TDC หรือไม่ ในไฟล์ TDC ให้ตั้งค่าเป็น "จริง" เสมอ
- เวอร์ชัน: Tableau ละเว้นหมายเลขเวอร์ชัน
ส่วนถัดไปมีความสำคัญเนื่องจากการระบุชื่อผู้ให้บริการและชื่อไดรเวอร์ของผู้ให้บริการฐานข้อมูลสำหรับแหล่งข้อมูลของไฟล์ TDC นี้ ไฟล์ TDC แต่ละไฟล์ผูกกับแหล่งข้อมูลได้เพียงประเภทเดียวเท่านั้น สำหรับแหล่งข้อมูลเนทีฟของเรา ชื่อเหล่านี้ต้องตรงกับชื่อคลาสแหล่งข้อมูล ตัวอย่างเช่น "teradata" สำหรับการเชื่อมต่อ Teradata ของเรา สำหรับแหล่งข้อมูล ODBC ชื่อผู้ให้บริการและชื่อไดรเวอร์ของไฟล์ TDC ต้องตรงกับสิ่งที่รายงานไปยัง Tableau ตามฐานข้อมูลและไดรเวอร์ ตัวอย่างเช่น "SQLite" และ "ไดรเวอร์ SQLite3 ODBC " ตามลำดับ
ส่วนสุดท้ายระบุการปรับแต่งการเชื่อมต่อจริง
ต่อไปนี้คือตัวอย่างไฟล์ TDC สองไฟล์ ไฟล์แรกเป็นการเชื่อมต่อ ODBC ทั่วไป และไฟล์ที่สองเป็นการปรับเปลี่ยนการเชื่อมต่อ Salesforce ในระบบ โปรดทราบว่าสิ่งเหล่านี้เป็นเพียงตัวอย่างเท่านั้น และการปรับแต่งที่แสดงไว้ไม่ได้รับการเลือกเพื่อบรรลุเป้าหมายเฉพาะใดๆ
<?xml version='1.0' encoding='utf-8' ?>
<connection-customization class='genericodbc' enabled='true' version='8.10'>
<vendor name='Gen_ODBC_Vendor'/>
<driver name='Gen_Driver'/>
<customizations>
<customization name='CAP_FAST_METADATA' value='yes' />
<customization name='CAP_ODBC_BIND_FORCE_MAX_STRING_BUFFERS' value='yes' />
<customization name='CAP_ODBC_BIND_PRESERVE_BOM' value='yes' />
</customizations>
</connection-customization>
<?xml version='1.0' encoding='utf-8' ?>
<connection-customization class='salesforce' enabled='true' version='8.10'>
<vendor name='salesforce'/>
<driver name='salesforce'/>
<customizations>
<customization name='CAP_ODBC_EXPORT_CONTINUE_ON_ERROR' value='yes' />
<customization name='CAP_ODBC_EXPORT_FORCE_SINGLE_ROW_BINDING' value='yes' />
<customization name='CAP_ODBC_EXPORT_SUPPRESS_STRING_WIDTH_VALIDATION' value='no' />
</customizations>
</connection-customization>หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับการปรับแต่ง โปรดดู
ใช้ไฟล์พร็อพเพอร์ตี้เพื่อปรับแต่งการเชื่อมต่อ JDBC
ไฟล์พร็อพเพอร์ตี้จะถูกใช้โดย JDBC และส่งผ่านโดยตรงไปยังไดรเวอร์ JDBC ไฟล์เหล่านี้เป็นไฟล์ข้อความธรรมดาที่มีนามสกุลไฟล์ “.properties” โดยจะมีคู่ค่าคีย์สำหรับพารามิเตอร์การเชื่อมต่อแต่ละรายการ
การใช้ไฟล์พร็อพเพอร์ตี้ที่มีการเชื่อมต่อ JDBC จะคล้ายกับการใช้พารามิเตอร์ odbc-connect-string-extras ในไฟล์ TDC สำหรับการเชื่อมต่อ ODBC
หมายเหตุ: ไฟล์พร็อพเพอร์ตี้ควรอยู่ในรูปแบบ Latin-1 (ดู https://en.wikipedia.org/wiki/.properties(ลิงก์จะเปิดในหน้าต่างใหม่)) อย่างไรก็ตาม ตราบใดที่มีอักขระ ASCII เท่านั้น คุณจะสามารถบันทึกไฟล์ในรูปแบบ UTF-8 ได้อย่างปลอดภัยโดยไม่มี BOM (เครื่องหมายการจัดลำดับไบต์)
ในไฟล์ ให้วางคู่ค่าคีย์แต่ละคู่ในบรรทัดของตัวเองโดยไม่มีตัวคั่น ตั้งชื่อไฟล์ให้เป็นชื่อเดียวกับตัวเชื่อมต่อที่เกี่ยวข้อง แต่มีนามสกุลไฟล์ “.properties” ตัวอย่างเช่น ไฟล์พร็อพเพอร์ตี้สำหรับตัวเชื่อมต่อ SAP HANA จะเป็น “saphana.properties”
การติดตั้งไฟล์ tdc และพร็อพเพอร์ตี้
เมื่อสร้างไฟล์การปรับแต่ง (TDC หรือพร็อพเพอร์ตี้) แล้ว จะต้องวางไว้ในที่ไดเรกทอรี “แหล่งข้อมูล” เฉพาะเพื่อให้ค้นพบและใช้งานผลิตภัณฑ์ Tableau ได้ ตัวอย่างเช่น หากผู้ใช้จะเผยแพร่เนื้อหาจาก Tableau Desktop ไปยัง Tableau Server ควรคัดลอกการปรับแต่งไปยังไดเรกทอรีผลิตภัณฑ์ทั้งสอง
หลังจากคัดลอกไฟล์ไปยังไดเรกทอรีที่เหมาะสมแล้ว จะต้องรีสตาร์ท Tableau (รวมถึงโหนดทั้งหมดถ้าใช้ Tableau Server) เพื่อให้ระบบรู้จักการเปลี่ยนแปลง ดูด้านล่างนี้สำหรับเส้นทางไดเรกทอรีในการติดตั้งเริ่มต้น
เส้นทางแอปพลิเคชัน Tableau Desktop
- Desktop/Windows:
C:\Users\myuser\My Tableau Repository\Datasources - Desktop/Mac:
~/Documents/My Tableau Repository/Datasources - Prep Builder/Windows:
C:\Users\myuser\Documents\My Tableau Prep Repository\Datasource - Prep Builder/Mac:
~/Documents/My Tableau Prep Repository/Datasources - Bridge/Windows:
C:\Users\myuser\Documents\My Tableau Bridge Repository\Datasources - Bridge/Linux:
/root/Documents/My_Tableau_Bridge_Repository/Datasources/
เส้นทาง Tableau Server
หมายเหตุ: ไฟล์การปรับแต่งจะต้องได้รับการคัดลอกไปยังไดเรกทอรีที่เหมาะสมสำหรับโหนดเซิร์ฟเวอร์ทุกโหนดที่ใช้งาน
- Windows:
- Server:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
C:\Program Files\Tableau\Tableau Server\packages\bin.<build number> - การเชื่อมต่อแบบเสมือน:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources - โฟลว์ Prep:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources - การเขียนเว็บของ Prep:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources - Linux:
- Server:
/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/ - การเชื่อมต่อแบบเสมือน:
/var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/ - โฟลว์ Prep:
/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/ - การเขียนเว็บของ Prep:
/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
หลังจากที่คุณบันทึกไฟล์ TDC หรือไฟล์พร็อพเดอร์ตี้ที่กำหนดเองไปยังตำแหน่งที่ถูกต้อง และรีสตาร์ทแอปพลิเคชัน ไฟล์เหล่านั้นจะนำไปใช้กับการเชื่อมต่อทั้งหมดสำหรับประเภทแหล่งข้อมูลเดียวกัน