ข้อมูลอ้างอิงบรรทัดคำสั่ง Tableau Prep
คุณสามารถโต้ตอบกับ Tableau Prep โดยใช้บรรทัดคําสั่งผ่านแอปพลิเคชันหลัก (Tableau Prep.exe) หรือผ่านอินเทอร์เฟซบรรทัดคําสั่ง (tableau-prep-cli.bat )
Tableau Prep.exe: ใช้สําหรับกําหนดค่าวิธีการเริ่มต้นของแอปพลิเคชัน ตัวอย่างเช่น ติดตั้ง เปิดใช้งาน ให้สิทธิ์อนุญาต การตั้งค่าไดเรกทอรีข้อมูลผู้ใช้ หรือการแก้ไขปัญหาเปลือกอิเล็กตรอน
Tableau-prep-cli.bat: ใช้สําหรับการเรียกใช้โฟลว์ ตัวอย่างเช่น การส่งข้อมูลเข้าสู่ระบบ พารามิเตอร์ และการรีเฟรชเอาต์พุตข้อมูลโดยไม่ต้องเปิดอินเทอร์เฟซภาพ
เอกสารนี้จะอธิบายตัวเลือกไวยากรณ์บรรทัดคําสั่งทั้งหมดที่ Tableau Prep รองรับและพร้อมใช้งานสําหรับลูกค้า โดยแยกตามยูทิลิตี้ที่มีให้ใช้งาน
เอกสารนี้ไม่ได้รวมไวยากรณ์คำสั่งบรรทัดเพิ่มเติมที่ใช้โดยนักพัฒนาและฝ่ายสนับสนุนของ Tableau ไว้ด้วย
แอปพลิเคชัน Tableau Prep
การดําเนินการต่อไปนี้สามารถทําได้จากบรรทัดคําสั่งสําหรับโปรแกรมประยุกต์ Tableau Prep.exe
ติดตั้ง
ติดตั้ง Tableau Prep โดยเรียกใช้ไฟล์ติดตั้ง (.exe) จากบรรทัดคำสั่งของคอมพิวเตอร์ในฐานะผู้ดูแลระบบ หากต้องการข้อมูลเพิ่มเติม โปรดดู ติดตั้งจากบรรทัดคำสั่ง(ลิงก์จะเปิดในหน้าต่างใหม่)
หมายเหตุ: ตัวเลือกนี้พร้อมใช้งานกับ Windows เท่านั้น
| ไวยากรณ์ | คำอธิบาย |
|---|---|
tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2 | เรียกใช้คำสั่งในฐานะผู้ดูแลระบบจากไดเรกทอรีที่มีไฟล์ .exe อยู่ในนั้น หรือระบุเส้นทางเต็มที่พาไปที่ตำแหน่งของไฟล์ .exe บนคอมพิวเตอร์ อย่าเรียกใช้จากไดเรกทอรีที่แชร์ หากต้องการดูรายการตัวเลือกตัวติดตั้งที่รองรับ โปรดดูตัวเลือกของตัวติดตั้ง(ลิงก์จะเปิดในหน้าต่างใหม่) สําหรับรายการพร็อพเพอร์ตี้ตัวติดตั้งที่รองรับ โปรดดูพร็อพเพอร์ตี้ตัวติดตั้ง(ลิงก์จะเปิดในหน้าต่างใหม่)
ตัวอย่าง:
คําสั่งนี้จะติดตั้ง Tableau เวอร์ชัน 2026.2 ในโหมดเงียบ (ไม่แสดงข้อความแจ้ง, UI หรือกล่องโต้ตอบใบอนุญาต) ดําเนินการติดตั้งให้เสร็จสิ้นโดยไม่ต้องรีสตาร์ท ยอมรับข้อตกลงสิทธิ์อนุญาตสําหรับผู้ใช้ปลายทาง (EULA) และตั้งค่าการรายงานข้อผิดพลาดและการรายงานการใช้งานเป็น ปิด |
การเปิดใช้งาน ใบอนุญาต และการลงทะเบียน
ใช้คําสั่งเหล่านี้เพื่อตรวจสอบใบอนุญาตของคุณ เปิดใช้งานผลิตภัณฑ์ระหว่างการติดตั้งหรือหลัง และลงทะเบียนผลิตภัณฑ์ หากต้องการข้อมูลเพิ่มเติม โปรดดู เปิดใช้งาน Tableau Desktop และ Tableau Prep Builder(ลิงก์จะเปิดในหน้าต่างใหม่)
| ไวยากรณ์ | คำอธิบาย |
|---|---|
--activate <key> | เปิดใช้งานผลิตภัณฑ์โดยใช้คีย์ผลิตภัณฑ์ที่ให้มา ออกด้วยรหัส 0 เมื่อสําเร็จ มิฉะนั้น ให้ออกมาพร้อมกับรหัสข้อผิดพลาด นอกจากนี้ยังยอมรับขีดเดียว (-activate) หากต้องการเปิดใช้งานผลิตภัณฑ์ระหว่างการติดตั้ง ให้เพิ่มบรรทัดคำสั่งเดียวที่มีตัวเลือกตัวติดตั้ง ACTIVATE_KEY "<key>" และป้อนคีย์ผลิตภัณฑ์ในเครื่องหมายคำพูด |
--register | ลงทะเบียนผลิตภัณฑ์ นอกจากนี้ยังยอมรับขีดเดียว (-register) หากต้องการลงทะเบียน Tableau จากบรรทัดคำสั่ง คุณต้องกรอกค่ารีจิสทรี (Windows) หรือ .plist (Mac) ล่วงหน้าบนคอมพิวเตอร์แต่ละเครื่องที่จะเรียกใช้ Tableau Prep Builder สําหรับ Windows คุณสามารถลงทะเบียนผลิตภัณฑ์ระหว่างการติดตั้งได้โดยเพิ่มบรรทัดคําสั่งเดียวที่มีตัวเลือกตัวติดตั้ง REGISTER="1" หากต้องการข้อมูลเพิ่มเติม โปรดดูลงทะเบียน Tableau Desktop และ Tableau Prep Builder(ลิงก์จะเปิดในหน้าต่างใหม่) |
--check-license | แสดง UI การเปิดใช้งานหากไม่มีใบอนุญาต |
--refresh | อัปเดตใบอนุญาตด้วยวันที่ที่ระยะเวลาการบํารุงรักษาปัจจุบันหมดอายุและหยุดข้อความหมดอายุ ออกด้วยรหัส 0 เมื่อสําเร็จ นอกจากนี้ยังยอมรับขีดเดียว (-refresh) Windows: เรียกใช้ tableau.exe ด้วยตัวเลือก MacOS: เรียกใช้ตัวเลือก |
--return <key> | ปิดใช้งานคีย์ผลิตภัณฑ์ที่ให้มาเพื่อให้สามารถนํากลับมาใช้ใหม่ได้ นอกจากนี้ยังยอมรับขีดเดียว (-return) Windows: เรียกใช้ tableau.exe ด้วยตัวเลือก MacOS: เรียกใช้ตัวเลือก |
การกําหนดค่าและการจัดเก็บ
ใช้คําสั่งเหล่านี้เพื่อกําหนดการตั้งค่าไฟล์และตําแหน่งที่เก็บ
| ไวยากรณ์ | คำอธิบาย |
|---|---|
--settings-file <file location> | โหลดการตั้งค่าการกําหนดค่าแอปพลิเคชันจากไฟล์ที่กําหนด คุณสามารถระบุได้หลายครั้งเพื่อรองรับการกําหนดค่าแบบเลเยอร์ เช่น เมื่อคุณมีการกําหนดค่าพร็อกซีเซิร์ฟเวอร์ส่วนกลางที่ทุกคนใช้ และการกําหนดค่าฐานข้อมูลเฉพาะที่ใช้สําหรับโฟลว์ ตัวอย่างไฟล์ .json {
"connection-sources":[
{
"endpoint":"prod-db-server.company.com",
"username":"service_account_admin",
"password":"secure_password_123"
}
]
}ตัวอย่างคำสั่ง: Windows: MacOS |
--repository-location <file path> | ตั้งค่าไดเรกทอรีที่เก็บ ตามค่าเริ่มต้นระหว่างการติดตั้ง Tableau Prep จะสร้างโฟลเดอร์ในโฟลเดอร์เอกสารของคุณที่เรียกว่าที่เก็บ Tableau Prep ของฉัน โฟลเดอร์นี้ประกอบด้วยโฟลเดอร์สําหรับลําดับงาน แหล่งข้อมูล การเชื่อมต่อ ตลอดจนไฟล์บันทึก และแคชชั่วคราว ในสภาพแวดล้อมเซิร์ฟเวอร์หรือระบบอัตโนมัติ คุณสามารถใช้คําสั่งนี้เพื่อระบุตําแหน่งที่เก็บอื่นและชี้ไปที่ที่เก็บนั้นได้ ตัวอย่าง: Windows: " MacOS: |
--user-data-directory <location> | ไดเร็กทอรีที่ใช้สําหรับจัดเก็บข้อมูลแอปพลิเคชันอิเล็กตรอน ในขณะที่ ในฐานะผู้ดูแลระบบ ให้ใช้แฟล็กนี้หากคุณเรียกใช้ Tableau Prep Builder ในสภาพแวดล้อมที่ทํางานพร้อมกันจํานวนมากซึ่งหลายกระบวนการจําเป็นต้องมีสถานะของแอปพลิเคชันแยกต่างหาก หรือเมื่อแก้ปัญหาข้อผิดพลาดในการล็อกเซสชันแบบถาวรบนเซิร์ฟเวอร์แบบเฮดเลส หมายเหตุ: เมื่อคุณเรียกใช้คําสั่ง ระบบจะสร้างโฟลเดอร์ที่ระบุใน ตัวอย่าง: Windows: MacOS: |
การเปิดไฟล์
ใช้คำสั่งเหล่านี้เพื่อเปิดไฟล์โฟลว์ Tableau Prep รูปแบบ .tfl และ .tflx
| ไวยากรณ์ | คำอธิบาย |
|---|---|
--tfl<file> | เปิดไฟล์โฟลว์ .tfl ที่ระบุ ใช้เครื่องหมายคําพูดแบบคู่หากเส้นทางไฟล์ของคุณมีช่องว่าง ตัวอย่าง: Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl" MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl "/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl" |
--tflx<file> | เปิดไฟล์โฟลว์ที่ทําเป็นแพ็กเกจ .tflx ที่ระบุ ตัวอย่าง: Windows: MacOS: |
Tableau Prep แอปพลิเคชันบรรทัดคําสั่ง
คําสั่งต่อไปนี้สามารถเรียกใช้ได้โดยใช้อินเทอร์เฟซบรรทัดคําสั่ง Tableau Prep (tableau-prep-cli.bat)
รีเฟรชเอาต์พุตโฟลว์
ใช้ตัวเลือกเหล่านี้เพื่อเรียกใช้ลําดับงานจากบรรทัดคําสั่งเพื่อรีเฟรชเอาต์พุตโฟลว์ วิธีนี้ช่วยให้คุณเรียกใช้โฟลว์ได้ครั้งละหนึ่งรายการเท่านั้น หากต้องการข้อมูลและข้อจำกัดเพิ่มเติม โปรดดูรีเฟรชไฟล์เอาต์พุตโฟลว์จากบรรทัดคำสั่ง(ลิงก์จะเปิดในหน้าต่างใหม่)
| ไวยากรณ์ | คำอธิบาย |
|---|---|
-c, --connections <path> | เส้นทางไปยังไฟล์ .json ที่มีข้อมูลเข้าสู่ระบบสําหรับแหล่งข้อมูลและเซิร์ฟเวอร์ของคุณ Tableau Prep Builder ใช้ข้อมูลจากไฟล์ลำดับงานและจากไฟล์ credentials .json เพื่อเรียกใช้ลำดับงานเมื่อคุณมีการเชื่อมต่อทางไกล หากต้องการข้อมูลเพิ่มเติม โปรดดูดูข้อกำหนดของไฟล์ข้อมูลเข้าสู่ระบบ .json(ลิงก์จะเปิดในหน้าต่างใหม่) หากคุณเชื่อมต่อกับฐานข้อมูล Snowflake อย่าลืมรวมพารามิเตอร์เฉพาะ เช่น บทบาท คลังสินค้า และบางครั้ง OAuth โทเค็นหรือการตรวจสอบสิทธิ์เบราว์เซอร์ภายนอก ตัวอย่างไฟล์การตั้งค่า .json - Snowflake: {
"connection-sources":[
{
"endpoint":"company_account.snowflakecomputing.com",
"username":"SVC_TABLEAU_PREP",
"password":"EncryptedPassword123",
"attributes":{
"warehouse": "DATA_LOAD_WH",
"role": "TRANSFORM_ROLE"
}
}
]
} ตัวอย่าง: Windows: MacOS: |
- p, - - parameters | เส้นทางไปยังไฟล์ .json ที่แทนที่ค่าพารามิเตอร์เริ่มต้นในโฟลว์ของคุณ นี่คือไฟล์แยกจากไฟล์ credentials.json และรวมชื่อและค่าพารามิเตอร์ของคุณ หากต้องการข้อมูลเพิ่มเติม โปรดดู “เรียกใช้ลำดับงานที่มีค่าพารามิเตอร์” ในข้อกำหนดของไฟล์ข้อมูลเข้าสู่ระบบ .json(ลิงก์จะเปิดในหน้าต่างใหม่) ตัวอย่าง: Windows: MacOS: |
-t,--tflFile <file path> | เส้นทางไปยังไฟล์โฟลว์ Tableau Prep ของคุณ |
-inc, --incrementalRefresh | หากคุณไม่ได้เปิดใช้งาน Tableau Prep Conductor บนเซิร์ฟเวอร์ของคุณเพื่อกำหนดเวลาการเรียกใช้โฟลว์ คุณสามารถใช้คำสั่งนี้เพื่อเรียกใช้โฟลว์ของคุณโดยใช้การรีเฟรชแบบเพิ่มหน่วยได้ หากต้องการข้อมูลเพิ่มเติม โปรดดูเรียกใช้โฟลว์ที่เปิดใช้งานการรีเฟรชแบบเพิ่มหน่วย ตัวอย่าง: Windows: MacOS: |
คําสั่งเบ็ดเตล็ด
ใช้คําสั่งเหล่านี้เพื่อพิมพ์เวอร์ชัน Tableau Prep, เปิดโหมดแก้ไขข้อบกพร่องเพื่อดีบักกระบวนการลําดับงาน การตรวจสอบ disableSSL และอื่นๆ
| ไวยากรณ์ | คำอธิบาย |
|---|---|
--version | ส่งออก CLI ของ Tableau Prep Builder เวอร์ชันปัจจุบันและยุติกระบวนการทันที |
-d, --debug | เปิดใช้งานโหมดแก้ไขข้อบกพร่อง สร้างบันทึกโดยละเอียดในโฟลเดอร์ที่เก็บเพื่อแก้ไขปัญหา ไฟล์บันทึกจัดเก็บใน: My Tableau Prep Builder Repository\Command Line Repository\Logs ตัวอย่าง: Windows: MacOS: |
-dsv, --disableSslValidation | ปิดใช้งานการตรวจสอบใบรับรอง SSL (มีประโยชน์สําหรับสภาพแวดล้อมเซิร์ฟเวอร์ภายในบางอย่าง) เมื่อเรียกใช้ตัวเลือกนี้บน MacOS กล่องโต้ตอบอาจปรากฎขึ้นเพื่อร้องขอผู้ใช้และรหัสผ่านคีย์เชน ตั้งแต่ Tableau Prep Builder เวอร์ชัน 2019.3.2 คุณสามารถส่งผ่านพารามิเตอร์เพิ่มเติมนี้เพื่อปิดใช้งานกล่องโต้ตอบคีย์เชนดังกล่าว ตัวอย่าง: MacOS: |
-h, --help) | แสดงเมนูช่วยเหลือสำหรับตัวเลือกบรรทัดคำสั่ง |
