Snowflake: การแทรกแถว

ใช้ Snowflake: insert row เพื่อเขียนแถวลงในตาราง Snowflake จากขั้นตอน journey ผ่าน SQL API โดยใช้ programmatic access token ค่าของคอลัมน์จะถูกส่งเป็นพารามิเตอร์ที่ผูกไว้ ไม่ได้อยู่ภายในข้อความคำสั่ง SQL ดังนั้นค่าจึงไม่สามารถหลุดออกจากคอลัมน์และเปลี่ยนแปลงการทำงานของคำสั่งได้ พอยต์นี้จะยืนยันตัวตนด้วย programmatic access token ของตัวเอง ไม่ได้ใช้การผสานรวมระดับบัญชีใดๆ ที่กำหนดค่าไว้ที่อื่นใน Settings

การใช้งานทั่วไป:

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

ข้อควรระวัง

โดยค่าเริ่มต้น programmatic access token จะมีอายุ 15 วัน พอยต์จะเริ่มล้มเหลวในวันที่หมดอายุ โดยไม่มีการเตือนล่วงหน้า โปรดตั้งการแจ้งเตือนในปฏิทินของคุณเองเพื่อหมุนเวียนโทเค็น มิฉะนั้นคำขอจะหยุดทำงานอย่างเงียบๆ สองสัปดาห์หลังจากที่คุณตั้งค่านี้

กำหนดค่าพอยต์

1. ลาก Snowflake: insert row จากส่วน Integrations ของแผงด้านซ้ายไปยัง canvas
2. ดับเบิลคลิกที่พอยต์และป้อน Step Name
3. ใน Account host ให้ป้อนโฮสต์ของบัญชี Snowflake ของคุณจาก URL ตัวอย่างเช่น ab12345.eu-central-1.snowflakecomputing.com ไม่ต้องใส่ https:// หรือเครื่องหมายทับต่อท้าย Pushwoosh จะเพิ่ม https:// และเส้นทาง API เอง

4. ใน Programmatic access token ให้ป้อนโทเค็นจาก Snowsight > your user > Settings > Authentication > Programmatic access tokens โทเค็นจะถูกเก็บไว้ในรูปแบบที่ถูกปิดบัง เช่นเดียวกับ secret header ของ webhook

5. ใน Table ให้ป้อนตารางเป้าหมายเป็น TABLE, SCHEMA.TABLE หรือ DATABASE.SCHEMA.TABLE โดยใช้เฉพาะตัวอักษร ตัวเลข และเครื่องหมายขีดล่างเท่านั้น พอยต์นี้จะไม่ขอ warehouse, database หรือ schema แยกต่างหาก: TABLE ที่ไม่มีข้อมูลอื่นจะถูกแก้ไขเทียบกับ database และ schema ที่เป็นค่าเริ่มต้นของผู้ใช้โทเค็น และค่า DATABASE.SCHEMA.TABLE จะมาแทนที่ค่าเหล่านั้น

6. ใน Columns ให้เพิ่มหนึ่งแถวต่อคอลัมน์ตารางที่จะเขียน ป้อนชื่อคอลัมน์และค่า ชื่อต้องไม่ว่างเปล่าและไม่ซ้ำกัน และใช้กฎตัวอักษร/ตัวเลข/ขีดล่างเดียวกันกับ Table ค่าอาจเป็นข้อความคงที่หรือมาโครของ traveler เช่น {{tag:Name}} ซึ่งเป็นมาโครเดียวกับในเนื้อหาของ Webhook หรือคลิก Insert Dynamic Value เพื่อเลือกแอททริบิวต์ที่ขั้นตอนก่อนหน้าใน journey นี้สร้างขึ้น เช่น การตอบสนองของ LLM หรือค่า Webhook ที่แมปไว้

ตัวอย่าง

เมื่อตั้งค่า Table เป็น PW.PUBLIC.TRAVELERS การตั้งค่า Columns เป็น DEVICE_ID พร้อมกับ ID อุปกรณ์ของ traveler ({{device:hwid}}) จะเป็นการแทรกแถวลงในคอลัมน์ DEVICE_ID ของตารางนั้น

7. คลิก Save

การตอบสนอง

traveler จะเดินทางต่อไปยังขั้นตอนใดก็ตามที่คุณเชื่อมต่อถัดไปบน canvas

แอททริบิวต์หลังจากการรันขั้นตอน

แอททริบิวต์	สิ่งที่เก็บไว้
snowflake_statement_handle	แฮนเดิลของคำสั่งที่ส่งไป

วิธีใช้ในขั้นตอนถัดไป

traveler ได้เดินทางต่อไปยังขั้นตอนถัดไปแล้วโดยไม่คำนึงถึงแอททริบิวต์นี้ บันทึกค่านี้ไปยัง Tag ด้วย Update user profile หากคุณต้องการตรวจสอบสถานะของคำสั่งนั้นในภายหลังผ่าน API ของ Snowflake เอง

ความล้มเหลวและการตอบสนองที่ไม่คาดคิด

คำขอที่ล้มเหลวจะทำให้ traveler ออกจาก journey ดู ข้อผิดพลาดและคำขอที่ล้มเหลว

สถานการณ์ตัวอย่าง: การสตรีมกิจกรรม journey ไปยัง Snowflake

ทีมต้องการให้กิจกรรม journey อยู่ในตาราง Snowflake เดียวกันกับที่การรายงานของพวกเขาค้นหาอยู่แล้ว

1. เพิ่ม Snowflake: insert row ทันทีหลังจากขั้นตอนที่คุณต้องการบันทึก ตั้งค่า Table เป็น PW.PUBLIC.TRAVELERS ใน Columns ตั้งค่า DEVICE_ID เป็น {{device:hwid}}
2. คลิก Save

เมื่อรันแล้ว แถวจะไปอยู่ในตารางเดียวกันกับที่การรายงาน Snowflake ของทีมอ่านอยู่แล้ว