ใช้กิจกรรมการค้นหาเพื่อค้นหาข้อมูลจากแหล่งข้อมูล

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

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

ข้อกำหนดเบื้องต้น

เมื่อต้องการเริ่มต้นใช้งาน คุณต้องดําเนินการข้อกําหนดเบื้องต้นต่อไปนี้ให้เสร็จสมบูรณ์:

เพิ่มกิจกรรมการค้นหาไปยังไปป์ไลน์ด้วย UI

เมื่อต้องการใช้กิจกรรมการค้นหาในไปป์ไลน์ ให้ทําตามขั้นตอนต่อไปนี้ให้เสร็จสมบูรณ์:

การสร้างกิจกรรม

  1. สร้างไปป์ไลน์ใหม่ในพื้นที่ทํางานของคุณ

  2. ค้นหา ค้นหา ค้นหา ในบานหน้าต่างกิจกรรมของไปป์ไลน์ และเลือกเพื่อเพิ่มไปยังพื้นที่ทํางานของไปป์ไลน์

    สกรีนช็อตของ UI Fabric ที่มีบานหน้าต่าง กิจกรรม และ กิจกรรมการค้นหา ถูกเน้น

  3. เลือกกิจกรรมการค้นหาใหม่บนพื้นที่ทํางานถ้ายังไม่ได้เลือกไว้

    สกรีนช็อตที่แสดงแท็บการตั้งค่าทั่วไปของกิจกรรมการค้นหา

โปรดดูคําแนะนําการตั้งค่าทั่วไปเพื่อกําหนดค่าแท็บ การตั้งค่าทั่วไป

การตั้งค่าการค้นหา

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

สกรีนช็อตที่แสดงแท็บการตั้งค่ากิจกรรมการค้นหาที่เน้นแท็บและตําแหน่งที่จะเลือกการเชื่อมต่อใหม่

ตัวอย่างในภาพก่อนหน้านี้แสดงการเชื่อมต่อ Lakehouse แต่การเชื่อมต่อแต่ละชนิดมีรายละเอียดการกําหนดค่าเฉพาะสําหรับแหล่งข้อมูลที่เลือก

ปุ่ม แสดงตัวอย่างข้อมูล ในการตั้งค่า กิจกรรมการค้นหา เพื่อดูตัวอย่างข้อมูลที่ส่งกลับโดยคิวรีของคุณ

สกรีนช็อตแสดงตัวอย่างกิจกรรมการค้นหาของข้อมูลที่เลือก

ข้อมูลตัวอย่างช่วยให้คุณ:

  • ตรวจสอบว่าตารางหรือแบบสอบถาม Lakehouse ของคุณส่งกลับคอลัมน์และค่าที่คาดไว้
  • ยืนยันว่าผลลัพธ์เป็น แถวเดียว หรือ หลายแถว
  • ทําความเข้าใจรูปร่างผลลัพธ์ (firstRow vs value) ก่อนอ้างอิงใน นิพจน์

ใช้เอาต์พุตกิจกรรมการค้นหา

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

สกรีนช็อตแสดงเอาต์พุตกิจกรรมการค้นหาหลังจากเรียกใช้

คุณจะสามารถใช้ผลลัพธ์ของกิจกรรมการค้นหาผ่านตัวสร้าง นิพจน์ ในกิจกรรมที่ตามมา

เอาต์พุตการค้นหามักใช้เพื่อ:

  • ควบคุมตรรกะการแตกแขนง (ตัวอย่างเช่น If Condition หรือ Switch)
  • เล่นวนซ้ําแถวโดยใช้กิจกรรม ForEach

สกรีนช็อตแสดงวิธีใช้ผลลัพธ์ของกิจกรรมการค้นหา

ตัวอย่างนี้แสดงกิจกรรม หากเงื่อนไข โดยใช้ผลลัพธ์ของกิจกรรมการค้นหา

ความสามารถที่รองรับ

  • กิจกรรมการค้นหาสามารถส่งกลับได้สูงสุด 5,000 แถว ถ้าชุดผลลัพธ์ประกอบด้วยระเบียนเพิ่มเติม จะมีการส่งกลับ 5,000 แถวแรก
  • ผลลัพธ์กิจกรรมการค้นหาสนับสนุนขนาดสูงสุด 4 เมกะไบต์ กิจกรรมจะล้มเหลวถ้าขนาดเกินขีดจํากัด
  • ระยะเวลาที่นานที่สุดสําหรับกิจกรรมการค้นหาก่อนหมดเวลาคือ 24 ชั่วโมง

หมายเหตุ

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

แหล่งข้อมูลต่อไปนี้ได้รับการสนับสนุนสําหรับกิจกรรมการค้นหา

ประเภท ที่เก็บข้อมูล
<ค 0>Azure <ค 0>Azure Blob Storage
  Azure Cosmos DB สําหรับ NoSQL
  <ค 0>Azure Databricks
  <ค 0>Azure Data Explorer
  <ค 0>Azure Database for MySQL
  <ค 0>Azure Database for PostgreSQL
  <ค 0>Azure Data Lake Storage รุ่น2
  <ค 0>Azure Files
  ฐานข้อมูล Azure SQL
  <ค 0>Azure SQL Managed Instance
  <ค 0>Azure Synapse Analytics
  <ค 0>Azure Table Storage
ฐานข้อมูล Amazon RDS สําหรับ Oracle
  Amazon RDS สําหรับ SQL Server
  อเมซอน เรดชิฟท์
  ฐานข้อมูล IBM Db2
  Google บิ๊กคิวรี
  กรีนพลัมสําหรับท่อ
  Informix สําหรับไปป์ไลน์
  MariaDB
  <ค 0>Microsoft Access
  ฐานข้อมูล MySQL
  ฐานข้อมูล Oracle
  ฐานข้อมูล PostgreSQL
  เพรสโต้
  เซิร์ฟเวอร์แอปพลิเคชัน SAP BW Open Hub
  เซิร์ฟเวอร์ข้อความ SAP BW Open Hub
  ฐานข้อมูล SAP Hana
  เซิร์ฟเวอร์แอปพลิเคชันตาราง SAP
  เซิร์ฟเวอร์ข้อความตาราง SAP
  Snowflake
  ฐานข้อมูล SQL Server
  ฐานข้อมูล Teradata
  Vertica
ไฟล์ อเมซอน S3
  เข้ากันได้กับ Amazon S3
  Folder
  FTP
  พื้นที่เก็บข้อมูล Google Cloud
  Hdfs สําหรับไปป์ไลน์
  ที่เก็บข้อมูล Oracle Cloud
  SFTP
โปรโตคอลทั่วไป HTTP
  OData
  ODBC
<ค 0>Microsoft Fabric เลคเฮ้าส์
  <ค 0>คลังข้อมูล
  ฐานข้อมูล KQL
  ฐานข้อมูล SQL
<ค 0>NoSQL แคสซานดร้า
บริการและแอป Dataverse
  Dynamics 365
  <ค 0>Dynamics AX
  Dynamics ซีอาร์เอ็ม
  ออบเจ็กต์ Salesforce
  บริการ Salesforce Cloud
  ServiceNow
  SharePoint รายการออนไลน์

บันทึกและเรียกใช้หรือจัดกําหนดการไปป์ไลน์

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

สกรีนช็อตแสดงแท็บหน้าแรกในตัวแก้ไขไปป์ไลน์ที่มีชื่อแท็บบันทึกเรียกใช้และปุ่มกําหนดการที่เน้น

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