เรียนรู้วิธีใช้ node Azure Cosmos DB ใน n8n ปฏิบัติตามเอกสารทางเทคนิคเพื่อรวม node Azure Cosmos DB เข้ากับ workflow ของคุณ
ใช้ node Azure Cosmos DB เพื่อทำงานอัตโนมัติใน Azure Cosmos DB และรวม Azure Cosmos DB เข้ากับแอปพลิเคชันอื่นๆ n8n มีการสนับสนุนในตัวสำหรับคุณสมบัติ Azure Cosmos DB ที่หลากหลาย ซึ่งรวมถึงการสร้าง รับ อัปเดต และลบคอนเทนเนอร์และรายการ
ในหน้านี้ คุณจะพบรายการการดำเนินการที่ node Azure Cosmos DB รองรับ และลิงก์ไปยังแหล่งข้อมูลเพิ่มเติม
Credentials
อ้างถึง Azure Cosmos DB credentials สำหรับข้อมูลการตรวจสอบสิทธิ์สำหรับ node นี้
การดำเนินงาน
- Container:
- Create
- Delete
- Get
- Get Many
- Item:
- Create
- Delete
- Get
- Get Many
- Execute Query
- Update
รายการ: ดำเนินการค้นหา
ดำเนินการค้นหา NoSQL SQL กับคอนเทนเนอร์และส่งคืนรายการที่ตรงกัน
Parameters
| parameter | จำเป็น | คำอธิบาย |
|---|---|---|
| Container | ใช่ | คอนเทนเนอร์ที่จะเรียกใช้แบบสอบถาม เลือกจากรายการหรือป้อนรหัสคอนเทนเนอร์โดยตรง |
| Query | ใช่ | แบบสอบถาม SQL ที่จะดำเนินการ ใช้ $1, $2, $3 ฯลฯ เป็นตัวยึดตำแหน่งสำหรับ parameter การสืบค้น n8n จะแปลงสิ่งเหล่านี้เป็น @Param1, @Param2, @Param3 ก่อนที่จะส่งคำขอไปยัง Azure Cosmos DB ตัวอย่างเช่น: SELECT * FROM c WHERE c.status = $1 AND c.startDate = $2. |
| Simplify | ไม่ | เมื่อเปิดใช้งาน (ค่าเริ่มต้น) จะตัดฟิลด์ข้อมูลเมตา Cosmos DB ภายใน (ที่ขึ้นต้นด้วย _ ) จากสินค้าที่ส่งคืน ปิดใช้เพื่อรับการตอบสนอง API ดิบแบบเต็ม |
Options
ขยาย Options เพื่อกำหนดค่า parameter การสืบค้น
| ตัวเลือก | คำอธิบาย |
|---|---|
| Query Parameters | รายการค่า string ที่คั่นด้วยเครื่องหมายจุลภาคซึ่งแมปตามตำแหน่ง $1, $2 ฯลฯ ในแบบสอบถาม ค่าทั้งหมดจะถูกส่งเป็น string เสมอ (All values are always sent as strings.) ใช้สิ่งนี้สำหรับตัวกรองข้อความธรรมดา เช่น ชื่อหรือค่าสถานะ ตัวอย่าง: active,2024. |
| Query Parameters (JSON) | array JSON ของค่าที่แมปตำแหน่งกับ $1, $2 ฯลฯ ในแบบสอบถาม รักษาประเภทดั้งเดิม: ตัวเลข, boolean, null และ string ที่มีศูนย์นำหน้า ใช้สิ่งนี้แทน Query Parameters เมื่อความแม่นยำของประเภทมีความสำคัญ ตัวอย่าง: [1737062400000, "01234", true, null]. |
การเลือกระหว่าง parameter การค้นหาและ parameter การค้นหา (JSON) (Choosing between Query Parameters and Query Parameters (JSON))
Azure Cosmos DB ทำการเปรียบเทียบตามประเภท ตัวกรองเช่น WHERE c.startDate = $1 ส่งคืนไม่มีผลลัพธ์หาก startDate ถูกจัดเก็บเป็นตัวเลขในฐานข้อมูล แต่ parameter มาถึงเป็น string
- ใช้ Query Parameters เมื่อค่าตัวกรองทั้งหมดของคุณเป็นข้อความ (ชื่อ สถานะ ตัวระบุ)
- ใช้ Query Parameters (JSON) เมื่อคุณต้องการกรองตัวเลข boolean
nullหรือ string ที่ขึ้นต้นด้วยตัวเลขและจะต้องยังคงเป็น string (เช่น รหัสไปรษณีย์ เช่น"01234").
Limitation: ตัวแยกวิเคราะห์ JSON ของ JavaScript ไม่สามารถแสดงจำนวนเต็มที่มากกว่าได้ Number.MAX_SAFE_INTEGER (9007199254740991 ) ด้วยความแม่นยำเต็มที่ ค่าที่เกินขีดจำกัดนี้อาจสูญเสียความแม่นยำเมื่อใช้งาน Query Parameters (JSON).
เทมเพลตและตัวอย่าง
เรียกดูเทมเพลตการรวมเอกสาร node Azure Cosmos DB หรือ ค้นหาเทมเพลตทั้งหมด
ทรัพยากรที่เกี่ยวข้อง
อ้างถึง เอกสารของ Azure Cosmos DB สำหรับข้อมูลเพิ่มเติมเกี่ยวกับบริการ
จะทำอย่างไรถ้าการดำเนินการของคุณไม่รองรับ
หาก node นี้ไม่สนับสนุนการดำเนินการที่คุณต้องการ คุณสามารถใช้ HTTP Request เพื่อเรียก API ของบริการ
คุณสามารถใช้ credentials ที่คุณสร้างขึ้นสำหรับบริการนี้ใน node คำขอ HTTP:
- ใน node คำขอ HTTP ให้เลือก Authentication > Predefined Credential Type.
- เลือกบริการที่คุณต้องการเชื่อมต่อ
- เลือกข้อมูลประจำตัวของคุณ
อ้างถึง Custom API actions for existing nodes สำหรับข้อมูลเพิ่มเติม
