รีเฟรชไฟล์เอาต์พุตลำดับงานจากบรรทัดคำสั่ง

รองรับใน Tableau Prep Builder เท่านั้น

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

หากต้องการรายการตัวเลือกบรรทัดคําสั่งทั้งหมดที่รองรับใน Tableau Prep โปรดดูการอ้างอิงบรรทัดคําสั่ง Tableau Prep

หมายเหตุ:หากคุณใช้การจัดการใบอนุญาตตามข้อมูลเข้าสู่ระบบ (LBLM) โปรดเปิด Tableau Prep และเข้าสู่ระบบสภาพแวดล้อม Tableau Server หรือไซต์ Tableau Cloud ที่คุณใช้ในการเปิดใช้งานอยู่เป็นระยะๆ ไม่เช่นนั้นสัญญาเช่าอาจหมดอายุ ซึ่งทำให้ลำดับงานที่เรียกใช้ผ่านบรรทัดคำสั่งเกิดความล้มเหลว คุณสามารถติดต่อผู้ดูแลระบบของคุณเพื่อเปลี่ยนแปลงระยะเวลาสัญญาเช่าของคุณเป็นระยะเวลาสูงสุด ดูข้อมูลเพิ่มเติมได้ที่การจัดการใบอนุญาตตามข้อมูลเข้าสู่ระบบ

ข้อจำกัดของตัวเชื่อมต่อ

  • ตัวเชื่อมต่อ JDBC หรือ ODBC: ลำดับงานที่มีตัวเชื่อมต่อสามารถเรียกใช้จากบรรทัดคำสั่งได้ตั้งแต่เวอร์ชัน 2019.2.3
  • ตัวเชื่อมต่อคลาวด์: ลำดับงานที่มีตัวเชื่อมต่อคลาวด์ เช่น Google BigQuery ไม่สามารถเรียกใช้ได้จากบรรทัดคำสั่ง ให้เรียกใช้ลำดับงานด้วยตนเองหรือเรียกใช้ลำดับงานตามกำหนดเวลาใน Tableau Server หรือ Tableau Cloud โดยใช้Tableau Prep Conductor หากต้องการข้อมูลเพิ่มเติม โปรดดู รักษาข้อมูลลำดับงานให้เป็นปัจจุบันเสมอ
  • การตรวจสอบสิทธิ์แบบลงชื่อเพียงครั้งเดียว: ไม่รองรับการเรียกใช้การลำดับงานจากบรรทัดคำสั่ง หากคุณใช้การตรวจสอบสิทธิ์แบบลงชื่อเพียงครั้งเดียว คุณสามารถเรียกใช้ลำดับงานจาก Tableau Prep Builder แทนได้
  • การตรวจสอบสิทธิ์หลายปัจจัย: Tableau Prep Command Line Interface (CLI) ไม่รองรับ Tableau ที่ใช้การตรวจสอบสิทธิ์หลายปัจจัย (MFA) หากต้องการข้อมูลเพิ่มเติม โปรดดูที่ไม่สามารถเผยแพร่โฟลว์ Tableau Prep โดยใช้บรรทัดคำสั่งหลังจากเปิดใช้งาน MFA ใน Tableau Cloud ในฐานความรู้ Tableau

สำหรับอุปกรณ์ Windows คุณสามารถกำหนดเวลากระบวนการนี้โดยใช้ Windows Task Scheduler หากต้องการข้อมูลเพิ่มเติม โปรดดู ตัวกำหนดเวลางานในความช่วยเหลือออนไลน์ของ Microsoft

หากคุณเรียกใช้ลำดับงานจากบรรทัดคำสั่ง Tableau Prep Builder จะรีเฟรชเอาต์พุตทั้งหมดของลำดับงานด้วยการตั้งค่าสำหรับการส่งออกข้อมูลที่ระบุใน Tableau Prep Builder หากต้องการข้อมูลเกี่ยวกับวิธีการระบุตำแหน่งเอาต์พุตของคุณ โปรดดู สร้างไฟล์การแยกข้อมูลและแหล่งข้อมูลที่เผยแพร่. หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าตัวเลือกการเขียน (เวอร์ชัน 2020.2.1 และใหม่กว่า) โปรดดู กำหนดค่าตัวเลือกการเขียน

ก่อนการเรียกใช้ลำดับงาน

ในการเรียกใช้ลำดับงานจากบรรทัดคำสั่ง คุณจำเป็นต้องสิทธิ์ของผู้ดูแลระบบในอุปกรณ์ที่เรียกใช้ลำดับงานและคุณจำเป็นต้องมีข้อมูลต่อไปนี้

  • พาธที่ติดตั้ง Tableau Prep Builder

  • หากเชื่อมต่อฐานข้อมูลและเผยแพร่ไฟล์เอาต์พุตไปบังเซิรืฟเวอร์หรือฐานข้อมูล (เวอร์ชัน 2020.3.1 หรือใหม่กว่า) - สร้างไฟล์ credentials .json ที่มีข้อมูลเข้าสู่ระบบที่จำเป็นทั้งหมด

  • พาธที่มีไฟล์ Tableau Flow (.tfl)

ข้อกำหนดไฟล์ Credentials .json

หมายเหตุ: ไม่จำเป็นต้องมีไฟล์ credentials .json หากลำดับงานเชื่อมต่อกับเอาต์พุตของไฟล์ในเครื่อง ไฟล์ที่จัดเก็บในการแชร์เครือข่าย หรือไฟล์อินพุตที่ใช้การตรวจสอบสิทธิ์ของ Windows (SSPI) หากต้องการข้อมูลเพิ่มเติมเกี่ยวับการตรวจสอบสิทธิ์ของ Windows โปรดดู รุ่น SSPI ในความช่วยเหลือออนไลน์ของ Microsoft

Tableau Prep Builder ใช้ข้อมูลจากไฟล์ลำดับงานและจากไฟล์ credentials .json เพื่อเรียกใช้ลำดับงานเมื่อคุณมีการเชื่อมต่อทางไกล ตัวอย่างเช่น ชื่อฐานข้อมูลของการเชื่อมต่อทางไกลและชื่อโปรเจ็กต์ของไฟล์เอาต์พุตมาจากลำดับงาน และชื่อเซิร์ฟเวอร์และข้อมูลเข้าสู่ระบบมาจากไฟล์ credentials .json

  • หากคุณต้องการใช้ไฟล์ซ้ำ ให้วางไฟล์ไว้ในโฟลเดอร์ที่จะไม่ถูกเขียนทับในกระบวนการติดตั้ง Tableau Prep Builder
  • หากคุณเรียกใช้โฟลว์ที่มีรายการต่อไปนี้ คุณต้องรวมไฟล์ .json ที่มีข้อมูลเข้าสู่ระบบซึ่งจำเป็นในการเชื่อมต่อ
    • เชื่อมต่อกับไฟล์ฐานข้อมูลหรือแหล่งข้อมูลที่เผยแพร่
    • เอาต์พุตที่เผยแพร่ไปยังเซิร์ฟเวอร์หรือเผยแพร่ไปยังฐานข้อมูล (เวอร์ชัน 2020.3.1 หรือใหม่กว่า)
    • ลำดับงานที่มีขั้นตอนสคริปต์สำหรับ Rserve หรือ TabPy ไฟล์ .json ต้องมีข้อมูลเข้าสู่ระบบซึ่งจำเป็นในการเชื่อมต่อกับบริการเหล่านี้ หากต้องการข้อมูลเพิ่มเติม โปรดดู ข้อกำหนดอาร์เรย์สำหรับเวอร์ชันที่คุณใช้ด้านล่าง
  • ข้อมูลเข้าสู่ระบบที่ระบุในลำดับงานและข้อมูลเข้าสู่ระบบที่อยู่ในไฟล์ .json ต้องตรงกัน มิฉะนั้นลำดับงานจะล้มเหลว
  • หากคุณเรียกใช้กระบวนการนี้ จะมีการใช้ชื่อโฮสต์ พอร์ต และชื่อผู้ใช้เพื่อค้นหาการเชื่อมต่อที่ตรงกันในไฟล์ลำดับงาน Tableau (.tfl) และมีการอัปเดตก่อนเรียกใช้กระบวนการ ไม่จำเป็นต้องมี ID พอร์ตและ ID ไซต์หากการเชื่อมต่อของคุณไม่ต้องการข้อมูลดังกล่าว
  • หากเชื่อมต่อกับแหล่งข้อมูลที่เผยแพร่ ให้รวมชื่อโฮสต์, contentUrl และพอร์ต (80 สำหรับ http และ 443 สำหรับ https) ในการเชื่อมต่อขาเข้า จำเป็นต้องใช้ชื่อโฮสต์ในการค้นหาการเชื่อมต่อที่ตรงกันในไฟล์ลำดับงาน Tableau (.tfl) รวมถึงใช้ contentUrl และพอร์ตเพื่อสร้างการเชื่อมต่อกับเซิร์ฟเวอร์

  • หากคุณเชื่อมต่อกับ Tableau Cloud ให้รวมพอร์ต (80 หรือ 443) ในการเชื่อมต่อขาเข้าสำหรับพ็อดที่คุณกำลังเชื่อมต่อ และใน URI การเชื่อมต่อเซิร์ฟเวอร์ ให้ตรวจสอบว่าได้รวมคำนำหน้าพ็อดที่เกี่ยวข้องพร้อมกับ online.tableau.com ไว้แล้ว หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับ Tableau Cloud โปรดดู การเชื่อมต่อ Tableau Bridge ไปยัง Tableau Cloud ในความช่วยเหลือ Tableau Cloud
  • (เวอร์ชัน 2021.4.1 หรือใหม่กว่า) หากคุณรวมพารามิเตอร์ในลำดับงาน คุณสามารถสร้างและรวมไฟล์ parameters override .json ในบรรทัดคำสั่งเพื่อเปลี่ยนค่าพารามิเตอร์จากค่าเริ่มต้นปัจจุบัน หากต้องการข้อมูลเพิ่มเติม โปรดดู เรียกใช้ลำดับงานที่มีค่าพารามิเตอร์.

ข้อมูลเข้าสู่ระบบอาจมีรูปแบบที่แตกต่างกัน ขึ้นอยู่กับเวอร์ชัน Tableau Prep Builder ของคุณ คลิกบนแท็บด้านล่างเพื่อดูรูปแบบข้อมูลเข้าสู่ระบบสำหรับเวอร์ชัน Tableau Prep Builder ของคุณ

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

การเชื่อมต่อเซิร์ฟเวอร์การเชื่อมต่อฐานข้อมูลการเชื่อมต่อ Rserver หรือ Tableau Python

ชื่อบล็อกการเชื่อมต่อ: "tableauServerConnections"

รวมข้อมูลต่อไปนี้ในอาร์เรย์:

  • serverUrl (ชื่อเซิร์ฟเวอร์) สำหรับ Tableau Cloud ให้รวมคำนำหน้าพ็อดที่เกี่ยวข้องพร้อมกับ online.tableau.com ตัวอย่างเช่น "https://10az.online.tableau.com"
  • contentUrl (ID ไซต์ ซึ่งจะปรากฏขึ้นหลังจาก /site/ ใน URL สำหรับ Tableau Server หรือ Tableau Cloud ตัวอย่างเช่น "https://my.server/#/site/mysite" ให้ตั้งค่า "contentUrl": "mysite".))
  • พอร์ต (ID พอร์ต)
  • ชื่อผู้ใช้
  • password

ชื่อบล็อกการเชื่อมต่อ: "databaseConnections"

รวมข้อมูลต่อไปนี้ในอาร์เรย์:

  • ชื่อโฮสต์ (ชื่อเซิร์ฟเวอร์)
  • พอร์ต (ID พอร์ต)
  • ชื่อผู้ใช้
  • password

รวมเฉพาะอาร์เรย์นี้เท่านั้นหากลำดับงานของคุณมีขั้นตอนสคริปต์สำหรับ R หรือ TabPy

ชื่อบล็อกการเชื่อมต่อ: "extensions"

รวมข้อมูลต่อไปนี้ในอาร์เรย์:

  • extensionName: ระบุ "rSupport" หรือ "pythonSupport"
  • ปกติ: รวม "host” และ "port" คุณยังสามารถรวม "username" หรือ "sslCertificate” (เนื้อหาของไฟล์ .pem สาธารณะที่เข้ารหัสเป็นสตริง base64) หากมี
  • ละเอียดอ่อน: รวม "password" หากคุณใช้รหัสผ่าน หรือไม่เช่นนั้นให้รวมอาร์เรย์ที่ว่าง

หมายเหตุ: จำเป็นต้องมี ContentUrl ในไฟล์ .json เสมอสำหรับการเชื่อมต่อเซิร์ฟเวอร์ หากเชื่อมต่อกับไซต์ที่เป็นค่าเริ่มต้น ตัวอย่างเช่น "https://my.server/#/site/” ให้ตั้งค่า ContentUrl เป็นที่ว่าง ตัวอย่างเช่น "contentUrl": ""

เรียกใช้ลำดับงานที่มีค่าพารามิเตอร์

รองรับใน Tableau Prep Builder เวอร์ชัน 2021.4.1 และใหม่กว่า

ในการเรียกใช้ลำดับงานจากบรรทัดคำสั่งที่มีค่าพารามิเตอร์ คุณสามารถสร้างไฟล์ parameters override .json ที่มีค่าพารามิเตอร์ที่คุณต้องการจะใช้ ค่าเหล่านี้แทนที่ค่าปัจจุบัน (ค่าเริ่มต้น) ที่กำหนดไว้สำหรับพารามิเตอร์นั้น

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

หมายเหตุ: ตั้งแต่เวอร์ชัน 2022.1.1 ไม่จำเป็นต้องมีค่าพารามิเตอร์ครอบในเครื่องหมายคำพูดอีกต่อไป ในเวอร์ชันก่อนหน้า ชื่อและค่าพารามิเตอร์ทั้งหมดต้องอยู่ในเครื่องหมายคำพูด

ตัวอย่าง:

{
    "Parameter 1": Value 1,
    "Number Parameter": 40,
    "Boolean Parameter": True
}				

เมื่อคุณเรียกใช้ลำดับงานที่มี -p --parameters และชื่อของไฟล์ในบรรทัดคำสั่ง

ตัวอย่าง:

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

Mac

/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

ตัวอย่าง

ส่วนนี้จะแสดงตัวอย่างต่างๆ ของไฟล์ข้อมูลเข้าสู่ระบบที่คุณสามารถสร้างด้วยข้อกำหนด credentials .json

การเชื่อมต่อกับการเชื่อมต่อเซิร์ฟเวอร์

ตัวอย่างนี้แสดงไฟล์ข้อมูลเข้าสู่ระบบ .json ที่เชื่อมต่อและเอาต์พุตไปยังการเชื่อมต่อเซิร์ฟเวอร์ที่ใช้ข้อมูลเข้าสู่ระบบเดียวกัน

{
 "tableauServerConnections":[
   {
    "serverUrl":"https://my.server",
    "contentUrl": "mysite",
    "port":443,
    "username": "jsmith",
    "password": "passw0rd$"
   }
 ]
}				

การเชื่อมต่อกับการเชื่อมต่อเซิร์ฟเวอร์และเอาต์พุตไปยังการเชื่อมต่อฐานข้อมูล

ตัวอย่างนี้แสดงไฟล์ข้อมูลเข้าสู่ระบบ .json ที่เชื่อมต่อกับการเชื่อมต่อเซิร์ฟเวอร์และเอาต์พุตไปยังการเชื่อมต่อฐานข้อมูล

{
 "tableauServerConnections":[
   {
    "serverUrl":"https://my.server",
    "contentUrl": "mysite",
    "port":443,
    "username": "jsmith",
    "password": "passw0rd$"
   }
],
 "databaseConnections":[
   {
    "hostname":"example123.redshift.amazonaws.com",
    "port":"5439",
    "username":"jsmith",
    "password":"p@s$w0rd!"
   }
 ]
}

ลำดับงานมีการเชื่อมต่อสคริปต์ Rserve และ TabPy และเอาต์พุตไปยังการเชื่อมต่อฐานข้อมูล

ตัวอย่างนี้แสดงไฟล์ข้อมูลเข้าสู่ระบบ .json ที่มีข้อมูลเข้าสู่ระบบ Rserve และ Tabpy และเอาต์พุตไปยังการเชื่อมต่อฐานข้อมูล

{
 "extensions": [
    {
	  "extensionName": "rSupport",
	  "regular": {
		"host": "localhost",
		"port": "9000",
		"username": "jsmith"
	},
	"sensitive": {	
	  "password": "pwd"	
	}
   },
   {
	"extensionName": "pythonSupport",
	"regular": {
	  "host": "localhost",
	  "port": "9000"
	},
	"sensitive": {
	}
   }
 ],										
 "databaseConnections":[
   {
    "hostname":"example123.redshift.amazonaws.com",
    "port": "5439",
    "username": "jsmith",
    "password": "p@s$w0rd!"
   },
   {
    "hostname":"mysql.mydb.tsi.lan",
    "port": "3306",
    "username": "jsmith",
    "password": "mspa$$w0rd"
   }
 ]
}			

การเชื่อมต่อและการเอาต์พุตไปยังการเชื่อมต่อฐานข้อมูลที่ต่างกัน

ตัวอย่างนี้แสดงไฟล์ข้อมูลเข้าสู่ระบบ .json ที่เชื่อมต่อและเอาต์พุตไปยังการเชื่อมต่อฐานข้อมูลที่ต่างกัน:

{
 "databaseConnections":[
{
  "hostname":"example123.redshift.amazonaws.com",
  "port": "5439",
  "username": "jsmith",
  "password": "p@s$w0rd!"
 },
 {
   "hostname":"mysql.mydb.tsi.lan",
   "port": "3306",
   "username": "jsmith",
   "password": "mspa$$w0rd"
  }
 ]
}			

ป้อนอาร์เรย์สำหรับการเชื่อมต่อขาเข้าและขาออกของคุณ

หมายเหตุ: หากคุณใช้ Tableau Prep Builder เวอร์ชัน 2018.2.2 ถึง 2018.3.1 ให้รวมอาร์เรย์ "inputConnections" และ "outputConnections" เสมอ แม้ว่าลำดับงานจะไม่มีการเชื่อมต่อทางไกลสำหรับอินพุตหรือเอาต์พุตก็ตาม เพียงแค่ปล่อยให้อาร์เรย์เหล่านั้นที่ว่าง หากคุณใช้ Tableau Prep Builder เวอร์ชัน 2018.3.2 และใหม่กว่า คุณไม่จำเป็นต้องรวมอาร์เรย์ที่ว่าง

การเชื่อมต่อขาเข้าการเชื่อมต่อขาออกการเชื่อมต่อ Rserver หรือ Tableau Python
  • ชื่อโฮสต์ (ชื่อเซิร์ฟเวอร์)
  • contentUrl (จำเป็นสำหรับแหล่งข้อมูลที่เผยแพร่เสมอ ดูคำอธิบายที่การเชื่อมต่อขาออก)
  • พอร์ต (ID พอร์ต)
  • ชื่อผู้ใช้
  • password
  • serverUrl
  • contentUrl (ID ไซต์ ซึ่งจะปรากฏขึ้นหลังจาก /site/ ใน URL สำหรับ Tableau Server หรือ Tableau Cloud ตัวอย่างเช่น "https://my.server/#/site/mysite" ให้ตั้งค่า "contentUrl": "mysite".)
  • ชื่อผู้ใช้
  • password

รวมเฉพาะอาร์เรย์นี้เท่านั้นหากลำดับงานของคุณมีขั้นตอนสคริปต์สำหรับ R หรือ TabPy ที่จำเป็นต้องมีรหัสผ่าน

  • extensionName: ระบุ "rSupport" หรือ "pythonSupport"
  • ข้อมูลเข้าสู่ระบบ: รวม "password"

ตัวอย่าง

ส่วนนี้จะแสดงสองตัวอย่างของไฟล์ข้อมูลเข้าสู่ระบบที่คุณสามารถสร้างด้วยข้อกำหนด credentials .json

การเชื่อมต่อกับแหล่งข้อมูลที่เผยแพร่

ตัวอย่างนี้แสดงไฟล์ข้อมูลเข้าสู่ระบบ .json ที่เชื่อมต่อกับแหล่งข้อมูลที่เผยแพร่และเอาต์พุตข้อมูลไปยังเซิร์ฟเวอร์ที่มี ID ไซต์

หมายเหตุ: หาก inputConnection หรือ outputConnection ใช้ไซต์เริ่มต้น ตัวอย่างเช่น "https://my.server/#/site/" ให้ตั้งค่า ContentUrl เป็นที่ว่าง ตัวอย่างเช่น "contentUrl": ""

{ 
  "inputConnections":[
    {
     "hostname":"https://my.server",
     "contentUrl": "mysite",
     "port":443,								
     "username": "jsmith",
     "password": "passw0rd$"
    }
 ],
  "outputConnections":[
    {
     "serverUrl":"https://my.server",
     "contentUrl":"mysite",
     "username":"jsmith",
     "password":"passw0rd$"
    }
 ]
}

การเชื่อมต่อกับฐานข้อมูลสองแห่ง

ตัวอย่างนี้แสดงไฟล์ข้อมูลเข้าสู่ระบบ .json ที่เชื่อมต่อกับ MySQL และ Oracle และเอาต์พุตข้อมูลไปยังเซิร์ฟเวอร์ที่มี ID ไซต์

{ 
  "inputConnections":[
    {
     "hostname":"mysql.example.lan",
     "port":1234,
     "username": "jsmith",				
     "password": "passw0rd"
  },
    {
     "hostname":"Oracle.example.lan",
     "port":5678,
     "username": "jsmith",				
     "password": "passw0rd" 
  }
], 
  "outputConnections":[
    {
     "serverUrl":"http://my.server",
     "contentUrl":"mysite",
     "username":"jsmith",
     "password":"passw0rd$"
    } 
  ]
}

ลำดับงานมีขั้นตอนสคริปต์สำหรับ Rserve และ TabPy และเชื่อมต่อกับฐานข้อมูล

ตัวอย่างนี้แสดงไฟล์ข้อมูลเข้าสู่ระบบ .json ที่มีรหัสผ่านสำหรับบริการ Rserve และ TabPy และเชื่อมต่อกับ MySQL

{ 
  "inputConnections":[
    {
     "hostname":"mysql.example.lan",
     "port":1234,
     "username": "jsmith",				
     "password": "passw0rd"
  }
], 
  "extensions":[
    {
     "extensionName":"rSupport",
     "credentials":{
     "password":"pwd",
    }
  },
   {
	"extensionName" : "pythonSupport",
	"credentials": {
	"password": "pwd"
	}
   } 
  ]
}

เคล็ดลับในการสร้างไฟล์ข้อมูลเข้าสู่ระบบ

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

  • หากคุณใช้ Tableau Prep Builder เวอร์ชัน 2018.2.2 ถึง 2018.3.1 ให้รวมอาร์เรย์ "inputConnections" และ "outputConnections" เสมอ แม้ว่าลำดับงานจะไม่มีการเชื่อมต่อทางไกลสำหรับอินพุตหรือเอาต์พุตก็ตาม เพียงแค่ปล่อยให้อาร์เรย์เหล่านั้นที่ว่าง

    หากคุณใช้ Tableau Prep Builder เวอร์ชัน 2018.3.2 และใหม่กว่า คุณไม่จำเป็นต้องรวมอาร์เรย์ที่ว่าง

    • ไม่มีการเชื่อมต่อขาเข้าทางไกลใช่ไหม รวมไวยากรณ์นี้ที่ด้านบนของไฟล์ .json

      {
       "inputConnections":[
        ],
    • ไม่มีการเชื่อมต่อขาออกทางไกลใช่ไหม รวมไวยากรณ์นี้ที่ด้านล่างของไฟล์ .json

    • "outputConnections":[
        ]
      }
  • ไม่มี ID พอร์ตสำหรับการเชื่อมต่อขาเข้าหรือไม่ได้ระบุพอร์ตในชื่อเซิร์ฟเวอร์

    หากไม่มี ID พอร์ตสำหรับการเชื่อมต่อของคุณ ไม่ต้องรวมการอ้างอิง "port":xxxx, ในไฟล์ .json รวมถึง "port": "" หากมี ID พอร์ตในชื่อเซิร์ฟเวอร์ ให้รวม ID พอร์ตในชื่อโฮสต์ ตัวอย่างเช่น "hostname": "mssql.example.lan,1234"

  • เมื่ออ้างอิง "serverUrl": ไม่ต้องรวม "/" ที่ตอนท้ายของที่อยู่ ตัวอย่างเช่น ใช้ "serverUrl": "http://server" ไม่ใช่ "serverUrl": "http://server/"

  • หากคุณมีการเชื่อมต่อขาเข้าและขาออกหลายรายการในข้อมูลเข้าสู่ระบบสำหรับแต่ละรายการในไฟล์

  • หากเชื่อมต่อกับแหล่งข้อมูลที่เผยแพร่ อย่าลืมรวมชื่อโฮสต์และ contentUrl ในการเชื่อมต่อขาเข้า

เรียกใช้ลำดับงาน

สำคัญ: ตัวอย่างด้านล่างมีการเปลี่ยนชื่อของ "Tableau Prep” เวอร์ชัน 2019.1.2 เป็น "Tableau Prep Builder" หากคุณกำลังใช้ผลิตภัณฑ์เวอร์ชันก่อนหน้านี้ ให้ใช้ "Tableau Prep" แทน

  1. เปิดข้อความแจ้งคำสั่งหรือข้อความแจ้งคำสั่งเทอร์มินัล (MacOS) ในฐานะผู้ดูแลระบบ

  2. เรียกใช้หนึ่งในคำสั่งต่อไปนี้โดยใช้ไวยากรณ์ที่แสดงด้านล่าง

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

      หมายเหตุ: หากเชื่อมต่อหรือเอาต์พุตไปยังไฟล์ที่จัดเก็บในการแชร์เครือข่าย ให้ใช้รูปแบบ UNC สำหรับพาธ: \\server\path\file name ไฟล์ต้องไม่มีการป้องกันด้วยรหัสผ่าน

      Windows

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

      Mac

      /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl
    • ลำดับงานเชื่อมต่อกับฐานข้อมูลหรือเผยแพร่ไปยังเซิร์ฟเวอร์

      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"

      Mac

      /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
    • ไฟล์ลำดับงานหรือไฟล์ข้อมูลเข้าสู่ระบบจัดเก็บในการแชร์เครือข่าย (ใช้รูปแบบ UNC สำหรับพาธ: \\server\path\file name):

      Windows

      "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "\server\path\[your credential file name].json" -t "\server\path\[your flow file name].tfl"

      Mac: แมปการแชร์เครือข่ายไปยัง /Volumes ใน Finder เพื่อให้อยู่ถาวร จากนั้นใช้ /Volumes/.../[your file] เพื่อระบุพาธ:

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

สำหรับข้อผิดพลาดทั่วไปและการแก้ไขปัญหา โปรดดู ข้อผิดพลาดที่พบได้บ่อยเมื่อใช้บรรทัดคำสั่งเพื่อเรียกใช้ลำดับงาน

เรียกใช้ลำดับงานโดยเปิดใช้งานการรีเฟรชแบบเพิ่มหน่วย

รองรับใน Tableau Prep Builder เวอร์ชัน 2020.2.1 และใหม่กว่า และบนเว็บตั้งแต่เวอร์ชัน 2020.4 ขณะนี้ไม่รองรับการรีเฟรชแบบเพิ่มหน่วยเมื่อเขียนเอาต์พุตลำดับงานไปยัง Microsoft Excel

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

Windows

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

Mac

/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 Builder จะทำงานดังต่อไปนี้:

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

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

ตัวเลือกคำสั่ง

หากคุณต้องการดูตัวเลือกความช่วยเหลือ ให้เพิ่ม -h ในบรรทัดคำสั่ง

ตัวเลือกคำสั่งคำอธิบายหมายเหตุ
-c , --connections <arg>พาธการเชื่อมต่อไปยังไฟล์ข้อมูลเข้าสู่ระบบต้องการพาธไปยังตำแหน่งของไฟล์ข้อมูลเข้าสู่ระบบ
-d, --debugแก้ไขข้อบกพร่องของกระบวนการลำดับงานเพิ่มตัวเลือกนี้เพื่อดูข้อมูลเพิ่มเติมเพื่อช่วยแก้ไขปัญหาด้วยการรีเฟรชลำดับงาน ไฟล์บันทึกจัดเก็บใน: My Tableau Prep Builder Repository\Command Line Repository\Logs
-dsv, --disableSslValidationปิดใช้งานการตรวจสอบความถูกต้องของ SSLเรียกใช้โฟลว์โดยไม่ต้องดำเนินการตรวจสอบความถูกต้องของใบรับรอง เมื่อเรียกใช้ตัวเลือกนี้บน MacOS กล่องโต้ตอบอาจปรากฎขึ้นเพื่อร้องขอผู้ใช้และรหัสผ่านคีย์เชน ตั้งแต่ Tableau Prep Builder เวอร์ชัน 2019.3.2 คุณสามารถส่งผ่านพารามิเตอร์เพิ่มเติมนี้เพื่อปิดใช้งานกล่องโต้ตอบคีย์เชนดังกล่าว ตัวอย่าง: /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ดูความช่วยเหลือสำหรับตัวเลือกไวยากรณ์

ตัวเลือกความช่วยเหลือหรือข้อผิดพลาดของไวยากรณ์จะแสดงข้อมูลต่อไปนี้:

usage: tableau-prep-cli [-c <arg>] [-d]  [-h] [-t <arg>]
-c,--connections <arg>        Path to a file with all connection information
-d,--debug                    This option is for debugging
-dsv,--disableSslValidation   Disable SSL validation
-h,--help                     Print usage message
-inc,--incrementalRefresh     Run incremental refresh for all outputs that are configured to support it
-t,--tflFile <arg>            The Tableau Prep Builder flow file	
-inc, --incrementalRefreshเรียกใช้การรีเฟรชแบบเพิ่มหน่วยสำหรับเอาต์พุตทั้งหมดที่กำหนดค่าไว้สำหรับใช้งาน

รวมตัวเลือกนี้เพื่อเรียกใช้การรีเฟรชแบบเพิ่มหน่วยสำหรับอินพุตทั้งหมดที่กำหนดค่าไว้สำหรับใช้งาน การรีเฟรชแบบเพิ่มหน่วยช่วยให้ Tableau Prep Builder สามารถรับและประมวลผลเฉพาะแถวใหม่จากแถวทั้งหมดในลำดับงาน

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

หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับการเรียกใช้ลำดับงานด้วยการรีเฟรชแบบเพิ่มหน่วย โปรดดู รีเฟรชข้อมูลโฟลว์โดยใช้การรีเฟรชแบบเพิ่มหน่วย

-t, --tflFile <arg>ไฟล์ลำดับงาน .tflต้องการพาธไปยังตำแหน่งของไฟล์ลำดับงาน .tfl
-p, --parameters ไฟล์ parameters override .jsonรวมไฟล์นี้หากคุณต้องการแทนที่ค่าพารามิเตอร์ปัจจุบัน (ค่าเริ่มต้น) ที่ใช้กับลำดับงาน หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับการใช้พารามิเตอร์ของลำดับงาน โปรดดู สร้างและใช้พารามิเตอร์ในลำดับงาน

ตัวอย่างไวยากรณ์

บรรทัดคำสั่งด้านล่างแสดงสี่ตัวอย่างในการเรียกใช้ลำดับงานด้วยเกณฑ์ต่อไปนี้:

  • เวอร์ชัน Tableau Prep Builder: 2022.1.1

    สำคัญ: ตัวอย่างด้านล่างมีการเปลี่ยนชื่อของ "Tableau Prep” เวอร์ชัน 2019.1.2 เป็น "Tableau Prep Builder" หากคุณกำลังใช้ผลิตภัณฑ์เวอร์ชันก่อนหน้านี้ ให้ใช้ "Tableau Prep" แทน

  • ชื่อลำดับงาน: Flow1.tfl

  • ตำแหน่งลำดับงาน: C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows

  • ชื่อไฟล์ข้อมูลเข้าสู่ระบบ: Flow 1.json

  • ตำแหน่งไฟล์ข้อมูลเข้าสู่ระบบ: C:\Users\jsmith\Desktop\Flow credentials

  • ตำแหน่งไฟล์ข้อมูลเข้าสู่ระบบที่จัดเก็บในการแชร์เครือข่าย: \tsi.lan\files\Flow credentials

ลำดับงานเชื่อมต่อและเผยแพร่ไปยังไฟล์ในเครื่อง

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

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

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -inc -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -inc -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

ลำดับงานเชื่อมต่อกับฐานข้อมูลและเผยแพร่ไปยังเซิร์ฟเวอร์

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\C:\Users\jsmith\Desktop\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Users/jsmith/Desktop/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

ลำดับงานเผยแพร่ไปยังเซิร์ฟเวอร์และข้อมูลเข้าสู่ระบบจัดเก็บในการแชร์เครือข่าย

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\\tsi.lan\files\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Volumes/files/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl