จัดการรายงาน: แก้ไข SQL

ตัวอย่างการนำทาง

เมนูหลัก > การติดตั้ง > จัดการรายงาน > คำสั่ง (ปุ่ม) > แก้ไข SQL

ฟีเจอร์: ตัวแก้ไขโค้ด

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

คำอธิบายปุ่ม

ปุ่ม คำอธิบาย
เทมเพลต

แทรก SQL เริ่มต้นสำหรับช่องที่กำลังแก้ไข (เช่น สำหรับตัวกรองรายงาน จะเป็นคิวรีที่ส่งคืน filter_key และ filter_value พร้อมแถวทั้งหมด)

ปุ่มนี้จะแสดงเฉพาะเมื่อมีเทมเพลตเท่านั้น คือเมื่อคุณแก้ไข SQL ของตัวกรองรายงาน คุณลักษณะ หรือคำสั่ง ปุ่มจะถูกซ่อนเมื่อคุณแก้ไข SQL ของรายงานเอง

หากในเอดิเตอร์มี SQL อยู่แล้ว จะแสดงข้อความ “เทมเพลต SQL จะแทนที่ SQL ที่มีอยู่ ดำเนินการต่อ?” ก่อน

ทดสอบ

ทดสอบ SQL ที่ป้อนโดยการรัน SQL นั้น

  • หาก SQL รันได้ จะแสดงข้อความ “ทดสอบผ่าน ไม่พบพารามิเตอร์” หรือ “ทดสอบผ่าน” ตามด้วยรายการพารามิเตอร์ที่ SQL ใช้
  • หาก SQL ล้มเหลว จะแสดงข้อความแสดงข้อผิดพลาดของฐานข้อมูล
ล้างออกล้างช่องข้อมูล
บันทึกบันทึกการเปลี่ยนแปลงทั้งหมด
ยกเลิกยกเลิกการเปลี่ยนแปลง
X (มุมบน)

ปิดหน้าต่างป๊อปอัป SQL และสร้างช่องข้อมูล

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

คำอธิบายแท็บ

แท็บ คำอธิบาย
ตาราง

แสดงรายการตารางทั้งหมดในฐานข้อมูล (ไม่รวมตารางระบบ)

มีเมนูคลิกขวาพร้อมตัวเลือกต่อไปนี้:

  • สร้าง เลือก SQL: สร้าง เลือก SQL สำหรับตารางนั้น (รายการช่องข้อมูลที่เลือกช่องข้อมูลที่ต้องการได้)
  • แสดงช่องข้อมูล: เปิดคอลัมน์ที่แสดงช่องข้อมูลทั้งหมดที่ลิงก์กับตาราง ดับเบิลคลิกช่องข้อมูลเพื่อเพิ่มลงในส่วนบันทึก (คือส่วนที่แก้ไข SQL)
ฟังก์ชัน

แสดงรายการฟังก์ชัน PostgreSQL ที่ผู้ใช้กำหนดและเลือกได้

ดับเบิลคลิกฟังก์ชันเพื่อแทรกชื่อฟังก์ชัน (ฟังก์ชันคือคิวรีที่ส่งคืนค่าที่ระบุ)

มีเมนูคลิกขวา:

  • สร้าง เลือก SQL: สร้าง เลือก SQL สำหรับคิวรี ต่างจากในแท็บ ตาราง ตรงที่ SQL จะรวมคำสั่งไว้ด้วย
ขั้นตอน

แสดงรายการโพรซีเยอร์ PostgreSQL ที่ผู้ใช้กำหนด

ดับเบิลคลิกที่โพรซีเยอร์เพื่อแทรกชื่อของโพรซีเยอร์

มีเมนูคลิกขวา:

  • สร้างคำสั่ง SQL: แทนที่ SQL ด้วยคำสั่ง CALL สำหรับโพรซีเยอร์ โดยมีพารามิเตอร์หนึ่งตัวต่อบรรทัด และมีชนิดข้อมูลของพารามิเตอร์เป็นคอมเมนต์ หากในเอดิเตอร์มี SQL อยู่แล้ว จะแสดงข้อความ “SQL ที่เลือกจะแทนที่ SQL ที่มีอยู่ ดำเนินการต่อ?” ก่อน
Params

แสดงรายการพารามิเตอร์ของคิวรี (เช่น :active_user_id) และพารามิเตอร์ที่ผู้ใช้กำหนดจากรายการที่มีให้

ดับเบิลคลิกพารามิเตอร์เพื่อแทรกลงในคิวรี

เคล็ดลับ: การสร้างคิวรี SQL

  • การจัดการพารามิเตอร์: พารามิเตอร์ขึ้นต้นด้วยเครื่องหมายทวิภาค (เช่น :param_name) ทดสอบคิวรีเพื่อยืนยันว่าพารามิเตอร์ถูกต้อง
  • ประสิทธิภาพ: เคอร์เซอร์รอจะแสดงขึ้นระหว่างการทำงานกับฐานข้อมูลเพื่อแสดงว่ากำลังประมวลผล

ข้อจำกัด: SQL

  • ตัวแก้ไขนี้ออกแบบมาสำหรับ PostgreSQL และอาจไม่รองรับระบบฐานข้อมูลอื่น
  • ฟีเจอร์ ทดสอบ อาจตรวจไม่พบข้อผิดพลาดขณะรันทั้งหมด
  • ปุ่มการนำทางจะถูกซ่อนหากไม่มีตารางหรือมุมมองแบบทรีที่ลิงก์ไว้

การแก้ไขปัญหา: SQL

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

รายงานปัญหาของหน้านี้

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