Snowflake: 행 삽입
Snowflake: 행 삽입을 사용하여 프로그래매틱 액세스 토큰을 통해 SQL API를 통해 Journey 단계에서 Snowflake 테이블에 행을 작성합니다. 열 값은 SQL 명령문 텍스트 내부가 아닌 바인딩된 매개변수로 전달되므로 값이 열에서 벗어나 명령문의 동작을 변경할 수 없습니다. 이 포인트는 자체 프로그래매틱 액세스 토큰으로 인증합니다. 설정의 다른 곳에 구성된 계정 수준 통합은 사용하지 않습니다.
일반적인 사용 사례:
- 보고 테이블 피드: 대시보드 또는 다운스트림의 예약된 쿼리를 위해 도달한 Journey 단계당 행을 삽입합니다.
- 이벤트 발생 시 기록: 배치 파이프라인을 기다리지 않고 원시 Journey 데이터를 웨어하우스에 직접 작성합니다.
- 기존 데이터와 조인: Snowflake 테이블이 자체 데이터 세트와 조인할 수 있는 장치 또는 태그 값을 삽입합니다.
포인트 구성
Anchor link to- 왼쪽 패널의 통합 섹션에서 Snowflake: 행 삽입을 캔버스로 드래그합니다.
- 포인트를 두 번 클릭하고 단계 이름을 입력합니다.
- 계정 호스트에 URL에서 Snowflake 계정의 호스트(예:
ab12345.eu-central-1.snowflakecomputing.com)를 입력합니다.https://또는 후행 슬래시를 포함하지 마세요. Pushwoosh가https://와 API 경로를 자체적으로 추가합니다.
- 프로그래매틱 액세스 토큰에 Snowsight > 사용자 > 설정 > 인증 > 프로그래매틱 액세스 토큰에서 가져온 토큰을 입력합니다. 이 토큰은 웹훅 비밀 헤더처럼 마스킹되어 저장됩니다.
- 테이블에 대상 테이블을
TABLE,SCHEMA.TABLE또는DATABASE.SCHEMA.TABLE형식으로 입력하고, 문자, 숫자, 밑줄만 사용합니다. 이 포인트는 웨어하우스, 데이터베이스 또는 스키마를 별도로 묻지 않습니다.TABLE만 입력하면 토큰 사용자의 기본 데이터베이스 및 스키마에 대해 확인되고,DATABASE.SCHEMA.TABLE값은 이를 재정의합니다.
- 열에 작성할 테이블 열당 하나의 행을 추가합니다. 열 이름과 값을 입력합니다. 이름은 비어 있지 않고 고유해야 하며 테이블과 동일한 문자/숫자/밑줄 규칙을 따릅니다. 값은 고정된 텍스트이거나
{{tag:Name}}과 같은 트래블러 매크로일 수 있으며, 이는 웹훅 본문과 동일한 매크로입니다. 또는 동적 값 삽입을 클릭하여 이 Journey의 이전 단계에서 생성된 속성(예: LLM 응답 또는 매핑된 웹훅 값)을 선택합니다.
- 저장을 클릭합니다.
트래블러는 캔버스에서 다음에 연결하는 단계로 계속 진행합니다.
단계 실행 후 속성
Anchor link to| 속성 | 내용 |
|---|---|
snowflake_statement_handle | 제출된 명령문의 핸들 |
이후 단계에서 사용하는 방법
Anchor link to트래블러는 이 속성과 관계없이 이미 다음 단계로 진행했습니다. 나중에 Snowflake 자체 API를 통해 해당 명령문의 상태를 확인해야 하는 경우 사용자 프로필 업데이트를 사용하여 태그에 저장하세요.
실패 및 예기치 않은 응답
Anchor link to요청이 실패하면 트래블러는 Journey에서 제외됩니다. 오류 및 실패한 요청을 참조하세요.
예시 시나리오: Journey 활동을 Snowflake로 스트리밍하기
Anchor link to한 팀이 자체 보고서가 이미 쿼리하는 동일한 Snowflake 테이블에 Journey 활동을 포함시키고 싶어합니다.
- 기록하려는 단계 바로 뒤에 Snowflake: 행 삽입을 추가합니다. 테이블을
PW.PUBLIC.TRAVELERS로 설정합니다. 열에서DEVICE_ID를{{device:hwid}}로 설정합니다. - 저장을 클릭합니다.
이것이 실행되면, 해당 행은 팀의 Snowflake 보고서가 이미 읽고 있는 동일한 테이블에 저장됩니다.