ข้ามไปยังเนื้อหา

เชื่อมต่อข้อมูลของคุณ

แหล่งข้อมูล (source) คือสถานที่ที่ workspace ของคุณอ่านแถวจากมัน อาจเป็น Google Sheet ตารางใน Databricks หรือ Snowflake ฐานข้อมูล Postgres หรือชุดข้อมูลที่บันทึกไว้ใน workspace นี้ เมื่อแนบแล้ว ทั้งหมดนี้ทำงานในลักษณะเดียวกัน — งานการเสริมข้อมูล การทดสอบย้อนหลัง และการประเมินผลทั้งหมดอ่านผ่านแหล่งข้อมูล

สิ่งที่คุณสามารถเชื่อมต่อได้

Section titled “สิ่งที่คุณสามารถเชื่อมต่อได้”
แหล่งข้อมูล อ่านจากมัน เขียนผลลัพธ์กลับ ใช้ในการทดสอบย้อนหลัง
Google Sheet ใช่ ใช่ หลังจากจับข้อมูล
ตาราง Postgres ใช่ ใช่ หลังจากจับข้อมูล
ตาราง Databricks ใช่ ไม่ หลังจากจับข้อมูล
ตาราง Snowflake ใช่ ไม่ หลังจากจับข้อมูล
ชุดข้อมูลที่บันทึกไว้ ใช่ ไม่ ใช่

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

เชื่อมต่อข้อมูลประจำตัวของคุณ

Section titled “เชื่อมต่อข้อมูลประจำตัวของคุณ”

การตั้งค่า Workspace → การรวมระบบ → การเชื่อมต่อข้อมูล

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

กรอกข้อมูลในบัตรแล้วกด เชื่อมต่อ เราทดสอบข้อมูลประจำตัวกับบริการจริงก่อนที่จะบันทึกอะไร ดังนั้น “เชื่อมต่อแล้ว” หมายความว่ามันใช้งานได้จริง หากไม่ใช่ คุณจะได้รับข้อมูลว่าข้อมูลประจำตัวถูกปฏิเสธ ไม่สามารถเข้าถึงโฮสต์ได้ หรือหมดเวลา

ข้อมูลประจำตัวจะถูกเข้ารหัสและ ไม่แสดงอีกเลย — แม้แต่กับคุณ เพื่อเปลี่ยนข้อมูลประจำตัว ให้เชื่อมต่ออีกครั้ง

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

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

หากบุคคลหรือชุดข้อมูลที่อยู่เบื้องหลังแหล่งข้อมูลหายไป

Section titled “หากบุคคลหรือชุดข้อมูลที่อยู่เบื้องหลังแหล่งข้อมูลหายไป”

การยกเลิกการเชื่อมต่อสามารถทำได้อีกครั้ง สองสิ่งนี้ไม่สามารถทำได้:

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

ในทั้งสองกรณีแหล่งข้อมูลที่ได้รับผลกระทบจะ ถูกตัดออก และงานของพวกเขาจะ หยุดชะงัก โดยมีเหตุผลแสดงอยู่บนงาน — “การเชื่อมต่อถูกลบ” หรือ “ชุดข้อมูลถูกลบ” การตั้งค่าของคุณและประวัติเพิ่มข้อมูลของคุณถูกเก็บไว้ แต่การเชื่อมต่ออีกครั้งจะไม่ช่วยในครั้งนี้: ไม่มีอะไรให้เชื่อมต่ออีกแล้ว แนบแหล่งข้อมูลอีกครั้ง — ผ่านการเชื่อมต่อที่มีชีวิตหรือต่อชุดข้อมูลอื่น งานที่ เขียน ไปยังแหล่งข้อมูลเก่าอาจถูกชี้ไปยังแหล่งใหม่และเปิดใช้งานอีกครั้ง งานที่ อ่าน จากมันไม่สามารถเปิดใช้งานได้อีก: สร้างงานใหม่บนแหล่งข้อมูลใหม่ ประวัติของมันยังคงอยู่กับอันเก่า

workspace ที่เกิดเหตุการณ์นี้ปลอดภัยที่จะปล่อยไว้: งานที่ถูกหยุดจะไม่เสียค่าใช้จ่ายอะไรและไม่ทำการลองใหม่

แนบแหล่งข้อมูล

Section titled “แนบแหล่งข้อมูล”

งาน → แหล่งข้อมูล → แนบ หรือจากกรอบแบทช์ในแคนวาส

เลือกประเภทของแหล่งข้อมูล แล้วกรอกข้อมูลเดียวที่จำเป็น:

  • Google Sheet — วางลิงก์ของชีต เลือกแท็บ และแมพคอลัมน์
  • ชุดข้อมูลที่บันทึกไว้ — เลือกหนึ่งจากไลบรารีของ workspace นี้ ไม่มีอะไรอื่นต้องกรอก
  • Databricks หรือ Snowflake — ให้ไดเรกทอรี (Databricks) หรือฐานข้อมูล (Snowflake) สคีมาและตาราง จากนั้นกด ดูตัวอย่างตาราง เพื่อตรวจสอบว่าคุณมีตารางที่ถูกต้องหรือไม่ก่อนการแมพคอลัมน์
  • ตาราง Postgres — ให้ชื่อของตาราง (และสคีมา หากไม่ใช่ public) กด ดูตัวอย่างตาราง แล้วทำการแมพคอลัมน์ Postgres เป็นแหล่งข้อมูล SQL อันเดียวที่สามารถเขียนได้: ติ๊ก เขียนกลับ บนการเสริมข้อมูลใด ๆ ควรทำการเติมเต็ม

ประเภทแหล่งข้อมูลที่คุณยังไม่ได้เชื่อมต่อจะแสดงเป็นสีเทา พร้อมหมายเหตุบอกให้คุณเชื่อมต่อมันก่อน

การเลือกคอลัมน์หลัก

Section titled “การเลือกคอลัมน์หลัก”

แหล่งข้อมูลแต่ละแห่งต้องการคอลัมน์หนึ่งที่ระบุแถว — นี่คือวิธีที่ผลิตภัณฑ์รู้ว่าแถวไหนที่มันจัดการไปแล้ว เลือกสิ่งที่ไม่เปลี่ยนแปลง: ID แทนชื่อที่อาจมีการแก้ไข

คอลัมน์เปลี่ยนแปลง (ตารางในคลังข้อมูล)

Section titled “คอลัมน์เปลี่ยนแปลง (ตารางในคลังข้อมูล)”

หากตารางของคุณมี “เวลาอัปเดตล่าสุด” ให้ตั้งชื่อมัน หากไม่มี แถวแต่ละแถวจะถูกปฏิบัติเสมือนว่าต้องการการทำงานในทุกการรัน ในตารางขนาดใหญ่ นั่นมีความสำคัญ

ชุดข้อมูลที่บันทึกไว้

Section titled “ชุดข้อมูลที่บันทึกไว้”

ชุดข้อมูล (dataset) คือชุดแถวที่กำหนดไว้ใน workspace นี้ ชุดข้อมูลคือสิ่งที่การทดสอบย้อนหลังและการประเมินผลจะทำงานด้วย เนื่องจากพวกเขาไม่เปลี่ยนแปลงภายใต้การรัน

ค้นหาพวกเขาได้ภายใต้ งาน → ชุดข้อมูล มีสามวิธีในการสร้างหนึ่งชุด

วางลงในฟอร์ม ดีสำหรับรายการสั้น ๆ

นำเข้าไฟล์ CSV หรือ JSON

Section titled “นำเข้าไฟล์ CSV หรือ JSON”

งาน → ชุดข้อมูล → นำเข้าไฟล์

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

ไฟล์สามารถถือได้ถึง 50,000 แถว และ 4 MB ถ้าเกินขีดจำกัดใด ข้อมูลการนำเข้าจะถูกปฏิเสธและบอกคุณ — ไม่มีอะไรที่จะถูกตัดออกเงียบ ๆ

จับข้อมูลจากแหล่งข้อมูล

Section titled “จับข้อมูลจากแหล่งข้อมูล”

งาน → ชุดข้อมูล → จับข้อมูลจากแหล่งข้อมูล

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

สิ่งหนึ่งที่ต้องเข้าใจเกี่ยวกับการจับข้อมูล:

การจับข้อมูลคือภาพนิ่ง จากตอนนี้เป็นต้นไป — ไม่ใช่การสร้างขึ้นใหม่จากอดีต

แถวแต่ละแถวจะถูกบันทึกว่าเป็นที่รู้จักในขณะที่คุณจับมัน ดังนั้นการจับข้อมูล ครั้งเดียว ที่ใช้ในการทดสอบย้อนหลังในช่วงเวลาที่ผ่านมา จะไม่ค้นพบอะไรเลย — ซึ่งถูกต้องเพราะไม่มีข้อมูลนั้นที่สามารถรู้ได้ในขณะนั้น

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

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

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

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

การจับข้อมูลตามกำหนดการ

Section titled “การจับข้อมูลตามกำหนดการ”

ชุดข้อมูลที่จับข้อมูลตามกำหนดการจะแสดงอยู่ใต้ชื่อใน งาน → ชุดข้อมูล ตัวอย่างเช่น “จับทุกวันเวลา 06:00 UTC · ถัดไป 30 ต.ค. เวลา 06:00” จากที่นั่นคุณสามารถ หยุดชั่วคราว, ดำเนินการต่อ หรือ หยุดการทำซ้ำ การหยุดจะเก็บชุดข้อมูลและทุกอย่างที่ถูกจับข้อมูลไว้แล้ว ชุดข้อมูลสามารถมีได้เพียงกำหนดการเดียว คุณยังสามารถจับข้อมูลเข้าไปในชุดข้อมูลนี้ด้วยมือได้ทุกเมื่อ

การจับข้อมูลที่กำหนดการสามารถข้ามรอบได้ และลองอีกครั้งในรอบถัดไป เมื่อ:

  • การทดสอบย้อนหลัง การศึกษา หรือการประเมินผลที่ใช้ชุดข้อมูลนี้ยังคงทำงานอยู่ การเพิ่มแถวในขณะที่หนึ่งทำงานอยู่จะทำให้มันหยุด เพราะมันจะตรวจสอบว่าข้อมูลของมันไม่ได้เปลี่ยนแปลง
  • การสมัครสมาชิกของ workspace ของคุณหมดอายุหรือถึงขีดจำกัดการใช้งาน การจับข้อมูลจะกลับมาทำงานโดยอัตโนมัติเมื่อจัดการเรียบร้อยแล้ว

กำหนดการ หยุดตัวเอง และบอกเหตุผล ว่าทำไมเมื่อดำเนินงานต่อจะล้มเหลวอีกครั้ง:

  • หยุดชั่วคราว — ชุดข้อมูลเต็ม ชุดข้อมูลถึงขีดจำกัด 50,000 แถวหรือ 4 MB การจับข้อมูลใหม่จะถูกปฏิเสธแทนที่จะลบประวัติที่เก่า เพราะจะเปลี่ยนสิ่งที่การทดสอบย้อนหลังในช่วงเวลาที่ผ่านมาเห็น ลบระเบียน หรือจับข้อมูลไปยังชุดข้อมูลใหม่ จากนั้นให้ดำเนินการต่อ
  • หยุดชั่วคราว — แหล่งข้อมูลถูกตัดออก, การเข้าถึงแหล่งข้อมูลถูกยกเลิก, การเชื่อมต่อถูกลบ หรือ แหล่งข้อมูลไม่สามารถอ่านได้ เชื่อมต่อหรือแนบแหล่งข้อมูลอีกครั้ง จากนั้นให้ดำเนินการต่อ การดำเนินการต่อจะถูกปฏิเสธในขณะที่แหล่งข้อมูลยังไม่สามารถใช้ได้

ที่มาของชุดข้อมูล

Section titled “ที่มาของชุดข้อมูล”

ชุดข้อมูลแต่ละชุดจะจดจำวิธีการสร้างมัน ภายใต้ชื่อของมันใน งาน → ชุดข้อมูล คุณจะเห็นหนึ่งใน:

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

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

ในทางกลับกัน แหล่งข้อมูลแต่ละแห่งใน งาน → แหล่งข้อมูล จะระบุว่ามีชุดข้อมูลจำนวนเท่าใดถูกจับจากมัน

หากมีสิ่งใดที่ไม่ทำงาน

Section titled “หากมีสิ่งใดที่ไม่ทำงาน”

“เชื่อมต่อสิ่งนี้ในระบบการรวมก่อน” — คุณยังไม่มีข้อมูลประจำตัวของตัวเองสำหรับประเภทแหล่งข้อมูลนั้น การเชื่อมต่อของเพื่อนร่วมงานไม่ถือว่าเป็นตัวเลือก

“ข้อมูลประจำตัวนี้ไม่ทำงานอีกต่อไป” — ข้อมูลประจำตัวที่บันทึกไม่สามารถทำงานได้อีกต่อไป อาจถูกหมุนเวียนหรือหมดอายุ เชื่อมต่ออีกครั้ง

งานของคุณถูกหยุดชั่วคราว — ข้อมูลประจำตัวที่พวกเขาอ่านหยุดการเชื่อมต่อ หรือแหล่งข้อมูลถูกตัดออก เชื่อมต่ออีกครั้งหรือทำการแนบอีกครั้ง แล้วเปิดใช้งานงานอีกครั้ง ไม่มีอะไรหายไป การจับข้อมูลตามกำหนดการที่อ่านจากแหล่งข้อมูลเดียวกันหยุดชะงักในลักษณะเดียวกัน ให้ดำเนินการต่อจาก งาน → ชุดข้อมูล

งานพูดว่า “การเชื่อมต่อถูกลบ” หรือ “ชุดข้อมูลถูกลบ” — สิ่งที่มันอ่านผ่านถูกลบ ไม่ใช่แค่หยุดการเชื่อมต่อ ดังนั้นไม่มีอะไรให้เชื่อมต่ออีกครั้ง เชื่อมต่อแหล่งข้อมูลอีกครั้ง — ด้วยการเชื่อมต่อที่มีชีวิตหรือชุดข้อมูลอื่น หากงานเขียนไปยังแหล่งข้อมูลที่ถูกลบ ชี้ไปยังแหล่งข้อมูลใหม่และเปิดใช้งาน หากมันอ่านจากแหล่งนี้ ให้สร้างงานใหม่ในการอ่านจากแหล่งข้อมูลใหม่ การเปิดงานเก่าอีกครั้งจะถูกปฏิเสธด้วยเหตุผล เพราะมันจะหยุดอีกครั้งในการรันครั้งถัดไป

“รหัสประจำตัวไม่ถูกต้อง” — ไดเรกทอรี สคีมา ชื่อโต๊ะหรือชื่อคอลัมน์มีตัวอักษรที่เราจะไม่ใส่เข้าไปในคำค้น ใช้ชื่อพื้นฐาน โดยไม่มีเครื่องหมายอัญประกาศ เครื่องหมายที่มีจุดหรือเครื่องหมายจุลภาคในฟิลด์เดียว

“แนบแล้ว” — workspace นี้มีแหล่งข้อมูลที่ใช้งานแหล่งข้อมูลนี้อยู่แล้ว

งานล้มเหลวอ้างว่าไม่สามารถเขียน — เป้าหมายของมันเป็นแหล่งข้อมูลแบบอ่านอย่างเดียว เช่น ตารางในคลังข้อมูลหรือตารางข้อมูล ชี้งานไปยังสเปรดชีตแทน

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