Snowflake: вставка строки

Используйте элемент Snowflake: вставка строки, чтобы записать строку в таблицу Snowflake на шаге journey через SQL API с помощью программного токена доступа. Значения столбцов передаются как связанные параметры, а не внутри текста SQL-запроса, поэтому значение не может выйти за пределы своего столбца и изменить действие запроса. Этот элемент аутентифицируется с помощью собственного программного токена доступа. Он не использует интеграцию на уровне аккаунта, настроенную в другом месте в Настройках (Settings).

Типичные сценарии использования:

• Заполнение таблицы отчетов: вставляйте строку для каждого достигнутого шага journey для панели управления или последующего запланированного запроса.
• Логирование событий по мере их возникновения: записывайте необработанные данные journey прямо в хранилище, не дожидаясь пакетной обработки.
• Объединение с существующими данными: вставляйте значение устройства или тега, по которому ваши таблицы Snowflake смогут объединяться с вашими собственными наборами данных.

Осторожно

Срок действия программного токена доступа по умолчанию составляет 15 дней. Элемент начнет давать сбой в день истечения срока действия без предварительного предупреждения. Поставьте напоминание в своем календаре о необходимости его ротации, иначе запросы молча перестанут работать через две недели после настройки.

Настройка элемента

1. Перетащите Snowflake: вставка строки из раздела Интеграции на левой панели на холст.
2. Дважды щелкните по элементу и введите Название шага.
3. В поле Хост аккаунта введите хост вашего аккаунта Snowflake из его URL, например ab12345.eu-central-1.snowflakecomputing.com. Не включайте https:// или косую черту в конце. Pushwoosh сам добавит https:// и путь API.

4. В поле Программный токен доступа введите токен из Snowsight > ваш пользователь > Settings > Authentication > Programmatic access tokens. Он хранится в замаскированном виде, как секретный заголовок веб-хука.

5. В поле Таблица введите целевую таблицу в формате TABLE, SCHEMA.TABLE или DATABASE.SCHEMA.TABLE, используя только буквы, цифры и знаки подчеркивания. Этот элемент не запрашивает хранилище, базу данных или схему отдельно: TABLE без указания схемы и базы данных будет разрешена относительно базы данных и схемы, установленных по умолчанию для пользователя токена, а значение DATABASE.SCHEMA.TABLE переопределит их.

6. В разделе Столбцы добавьте по одной строке для каждого столбца таблицы, в который нужно произвести запись. Введите имя столбца и значение. Имена не должны быть пустыми и должны быть уникальными, к ним применяется то же правило (буквы/цифры/подчеркивание), что и к Таблице. Значение может быть фиксированным текстом или макросом путешественника, таким как {{tag:Name}} — те же макросы, что и в теле Веб-хука. Или нажмите Вставить динамическое значение, чтобы выбрать атрибут, созданный на предыдущем шаге этого journey, например, ответ LLM или сопоставленное значение из Веб-хука.

Пример

Если для Таблицы установлено значение PW.PUBLIC.TRAVELERS, а для Столбцов задано имя DEVICE_ID со значением ID устройства путешественника ({{device:hwid}}), то в столбец DEVICE_ID этой таблицы будет вставлена новая строка.

7. Нажмите Сохранить.

Ответ

Путешественник переходит к следующему шагу, с которым вы соедините этот элемент на холсте.

Атрибуты после выполнения шага

Атрибут	Что содержит
snowflake_statement_handle	Идентификатор отправленного запроса

Как использовать на последующих шагах

Путешественник уже перешел к следующему шагу независимо от этого атрибута. Сохраните его в Тег с помощью элемента Обновить профиль пользователя, если вам понадобится позже проверить статус этого запроса через собственный API Snowflake.

Сбои и непредвиденные ответы

Неудачный запрос удаляет путешественника из journey. См. Ошибки и неудачные запросы.

Пример сценария: Потоковая передача активности journey в Snowflake

Команда хочет, чтобы активность journey попадала в ту же таблицу Snowflake, которую уже запрашивают их собственные отчеты.

1. Добавьте Snowflake: вставка строки сразу после шага, который вы хотите логировать. Установите для Таблицы значение PW.PUBLIC.TRAVELERS. В Столбцах установите DEVICE_ID в {{device:hwid}}.
2. Нажмите Сохранить.

После выполнения этого шага строка попадает в ту же таблицу, из которой уже читают данные отчеты команды в Snowflake.