انتقل إلى المحتوى
وثائق المطور أدلة كيفية الاستخدام الدعم طلب عرض توضيحي تسجيل الدخول
Pushwoosh.com

Snowflake: إدراج صف

استخدم Snowflake: إدراج صف لكتابة صف في جدول Snowflake من خطوة في الرحلة، عبر SQL API، باستخدام رمز وصول برمجي. تنتقل قيم الأعمدة كمعلمات مرتبطة، وليس داخل نص عبارة SQL، لذلك لا يمكن لقيمة أن تخرج من عمودها وتغير ما تفعله العبارة. تصادق هذه النقطة باستخدام رمز الوصول البرمجي الخاص بها. لا تستخدم أي تكامل على مستوى الحساب تم تكوينه في مكان آخر في الإعدادات.

الاستخدامات النموذجية:

  • تغذية جدول تقارير: إدراج صف لكل خطوة في الرحلة تم الوصول إليها، للوحة معلومات أو استعلام مجدول لاحق.
  • تسجيل الأحداث فور حدوثها: كتابة بيانات الرحلة الأولية مباشرة في مستودع البيانات بدلاً من انتظار خط أنابيب دفعي.
  • الربط مع البيانات الحالية: إدراج قيمة جهاز أو Tag يمكن لجداول Snowflake الخاصة بك الربط بها مع مجموعات البيانات الخاصة بك.

تكوين النقطة

Anchor link to
  1. اسحب Snowflake: إدراج صف من قسم التكاملات في اللوحة اليسرى إلى لوحة العمل.
  2. انقر نقرًا مزدوجًا على النقطة وأدخل اسم الخطوة.
  3. في مضيف الحساب، أدخل مضيف حساب Snowflake الخاص بك من عنوان URL الخاص به، على سبيل المثال ab12345.eu-central-1.snowflakecomputing.com. لا تقم بتضمين https:// أو شرطة مائلة في النهاية. يضيف Pushwoosh https:// ومسار API بنفسه.
درج إدراج صف Snowflake مع تعبئة اسم الخطوة وتعيين مضيف الحساب إلى عنوان URL لـ Snowflake
  1. في رمز الوصول البرمجي، أدخل رمزًا من Snowsight > المستخدم الخاص بك > الإعدادات > المصادقة > رموز الوصول البرمجية. يتم تخزينه مقنعًا، مثل رأس سري لـ webhook.
حقل رمز الوصول البرمجي مقنع
  1. في الجدول، أدخل الجدول المستهدف كـ TABLE، SCHEMA.TABLE، أو DATABASE.SCHEMA.TABLE، باستخدام الأحرف والأرقام والشرطات السفلية فقط. لا تطلب هذه النقطة مستودع بيانات أو قاعدة بيانات أو مخططًا بشكل منفصل: يتم حل TABLE المجرد مقابل أي قاعدة بيانات ومخطط يستخدمه المستخدم الافتراضي للرمز، وتتجاوز قيمة DATABASE.SCHEMA.TABLE ذلك.
حقل الجدول معين إلى PW.PUBLIC.TRAVELERS
  1. في الأعمدة، أضف صفًا واحدًا لكل عمود جدول للكتابة فيه. أدخل اسم العمود والقيمة. يجب أن تكون الأسماء غير فارغة وفريدة، وتتبع نفس قاعدة الأحرف/الأرقام/الشرطة السفلية مثل الجدول. يمكن أن تكون القيمة نصًا ثابتًا أو ماكرو للمسافر مثل {{tag:Name}}، وهي نفس الماكروات الموجودة في نص Webhook. أو انقر على إدراج قيمة ديناميكية لاختيار سمة أنتجتها خطوة سابقة في هذه الرحلة، على سبيل المثال استجابة LLM أو قيمة Webhook معينة.
جدول اسم وقيمة الأعمدة مع تعيين DEVICE_ID إلى ماكرو hwid للجهاز
  1. انقر على حفظ.

الاستجابة

Anchor link to

يستمر المسافر إلى أي خطوة تقوم بتوصيلها بعد ذلك على لوحة العمل.

السمات بعد تشغيل الخطوة

Anchor link to
السمةما تحتويه
snowflake_statement_handleمقبض العبارة المقدمة

كيفية استخدامها في الخطوات اللاحقة

Anchor link to

لقد استمر المسافر بالفعل إلى الخطوة التالية بغض النظر عن هذه السمة. احفظها في Tag باستخدام تحديث ملف تعريف المستخدم إذا كنت بحاجة إلى التحقق من حالة تلك العبارة لاحقًا من خلال API الخاص بـ Snowflake.

الإخفاقات والاستجابات غير المتوقعة

Anchor link to

يؤدي الطلب الفاشل إلى إسقاط المسافر من الرحلة. انظر الأخطاء والطلبات الفاشلة.

سيناريو مثال: تدفق نشاط الرحلة إلى Snowflake

Anchor link to

يريد فريق أن يكون نشاط الرحلة في نفس جدول Snowflake الذي تستعلم عنه تقاريرهم الخاصة بالفعل.

  1. أضف Snowflake: إدراج صف مباشرة بعد الخطوة التي تريد تسجيلها. عيّن الجدول إلى PW.PUBLIC.TRAVELERS. في الأعمدة، عيّن DEVICE_ID إلى {{device:hwid}}.
  2. انقر على حفظ.

بمجرد تشغيل هذا، يصل الصف إلى نفس الجدول الذي تقرأ منه تقارير Snowflake الخاصة بالفريق بالفعل.