ข้อมูลอ้างอิงบรรทัดคำสั่ง 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_<product_installer_name>.exe: เป็นตัวติดตั้ง Tableau สำหรับผลิตภัณฑ์และเวอร์ชันที่คุณกำลังติดตั้งอยู่

  • option1, option2 และอื่นๆ คือวิธีที่คุณต้องการเรียกใช้กระบวนการติดตั้ง

  • PROPERTY1, PROPERTY2 และอื่นๆ ช่วยให้คุณระบุการตั้งค่าต่างๆ ที่โปรแกรมติดตั้งควรดำเนินการระหว่างกระบวนการติดตั้ง

ตัวอย่าง:

tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

คําสั่งนี้จะติดตั้ง 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 ด้วยตัวเลือก --refresh และคีย์ผลิตภัณฑ์

MacOS: เรียกใช้ตัวเลือก -refresh บนออบเจ็กต์ Tableau ในพาธ /Applications

--return <key>

ปิดใช้งานคีย์ผลิตภัณฑ์ที่ให้มาเพื่อให้สามารถนํากลับมาใช้ใหม่ได้ นอกจากนี้ยังยอมรับขีดเดียว (-return)

Windows: เรียกใช้ tableau.exe ด้วยตัวเลือก -return และคีย์ผลิตภัณฑ์

MacOS: เรียกใช้ตัวเลือก -return บนออบเจ็กต์ Tableau ในพาธ /Applications

การกําหนดค่าและการจัดเก็บ

ใช้คําสั่งเหล่านี้เพื่อกําหนดการตั้งค่าไฟล์และตําแหน่งที่เก็บ

ไวยากรณ์คำอธิบาย
--settings-file <file location>

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

ตัวอย่างไฟล์ .json

{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}

ตัวอย่างคำสั่ง:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --settings-file "C:\ProgramData\Tableau\global-proxy-config.json" --settings-file "C:\Users\jsmith\AppData\Roaming\Tableau\db-config.json"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --settings-file "/Library/Tableau/global-proxy-config.json" --settings-file "/Users/jsmith/Library/Application Support/Tableau/db-config.json"

--repository-location <file path>

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

ตัวอย่าง:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"

--user-data-directory <location>

ไดเร็กทอรีที่ใช้สําหรับจัดเก็บข้อมูลแอปพลิเคชันอิเล็กตรอน

ในขณะที่ --repository-location จัดการสินทรัพย์ทางธุรกิจของคุณ (บันทึกและข้อมูล) --user-data-directory จัดการเครื่องมือภายในของแอปพลิเคชัน

ในฐานะผู้ดูแลระบบ ให้ใช้แฟล็กนี้หากคุณเรียกใช้ Tableau Prep Builder ในสภาพแวดล้อมที่ทํางานพร้อมกันจํานวนมากซึ่งหลายกระบวนการจําเป็นต้องมีสถานะของแอปพลิเคชันแยกต่างหาก หรือเมื่อแก้ปัญหาข้อผิดพลาดในการล็อกเซสชันแบบถาวรบนเซิร์ฟเวอร์แบบเฮดเลส

หมายเหตุ: เมื่อคุณเรียกใช้คําสั่ง ระบบจะสร้างโฟลเดอร์ที่ระบุใน --user-data-directory โดยอัตโนมัติ อย่างไรก็ตาม บัญชีผู้ใช้ที่เรียกใช้สคริปต์ต้องมีสิทธิ์ “เขียน” ไปยังไดเรกทอรีหลักนั้น

ตัวอย่าง:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"

การเปิดไฟล์

ใช้คำสั่งเหล่านี้เพื่อเปิดไฟล์โฟลว์ 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:"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"

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: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

- p, - - parameters

เส้นทางไปยังไฟล์ .json ที่แทนที่ค่าพารามิเตอร์เริ่มต้นในโฟลว์ของคุณ นี่คือไฟล์แยกจากไฟล์ credentials.json และรวมชื่อและค่าพารามิเตอร์ของคุณ

หากต้องการข้อมูลเพิ่มเติม โปรดดู “เรียกใช้ลำดับงานที่มีค่าพารามิเตอร์” ในข้อกำหนดของไฟล์ข้อมูลเข้าสู่ระบบ .json(ลิงก์จะเปิดในหน้าต่างใหม่)

ตัวอย่าง:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json

-t,--tflFile <file path>เส้นทางไปยังไฟล์โฟลว์ Tableau Prep ของคุณ
-inc, --incrementalRefresh

หากคุณไม่ได้เปิดใช้งาน Tableau Prep Conductor บนเซิร์ฟเวอร์ของคุณเพื่อกำหนดเวลาการเรียกใช้โฟลว์ คุณสามารถใช้คำสั่งนี้เพื่อเรียกใช้โฟลว์ของคุณโดยใช้การรีเฟรชแบบเพิ่มหน่วยได้ หากต้องการข้อมูลเพิ่มเติม โปรดดูเรียกใช้โฟลว์ที่เปิดใช้งานการรีเฟรชแบบเพิ่มหน่วย

ตัวอย่าง:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl

คําสั่งเบ็ดเตล็ด

ใช้คําสั่งเหล่านี้เพื่อพิมพ์เวอร์ชัน Tableau Prep, เปิดโหมดแก้ไขข้อบกพร่องเพื่อดีบักกระบวนการลําดับงาน การตรวจสอบ disableSSL และอื่นๆ

ไวยากรณ์คำอธิบาย
--versionส่งออก CLI ของ Tableau Prep Builder เวอร์ชันปัจจุบันและยุติกระบวนการทันที
-d, --debug

เปิดใช้งานโหมดแก้ไขข้อบกพร่อง สร้างบันทึกโดยละเอียดในโฟลเดอร์ที่เก็บเพื่อแก้ไขปัญหา ไฟล์บันทึกจัดเก็บใน: My Tableau Prep Builder Repository\Command Line Repository\Logs

ตัวอย่าง:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl

-dsv, --disableSslValidation

ปิดใช้งานการตรวจสอบใบรับรอง SSL (มีประโยชน์สําหรับสภาพแวดล้อมเซิร์ฟเวอร์ภายในบางอย่าง) เมื่อเรียกใช้ตัวเลือกนี้บน MacOS กล่องโต้ตอบอาจปรากฎขึ้นเพื่อร้องขอผู้ใช้และรหัสผ่านคีย์เชน

ตั้งแต่ Tableau Prep Builder เวอร์ชัน 2019.3.2 คุณสามารถส่งผ่านพารามิเตอร์เพิ่มเติมนี้เพื่อปิดใช้งานกล่องโต้ตอบคีย์เชนดังกล่าว

ตัวอย่าง:

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

-h, --help)

แสดงเมนูช่วยเหลือสำหรับตัวเลือกบรรทัดคำสั่ง

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