쿼리 빌더에서 쿼리 구축

쿼리 빌더를 사용하여 Snowflake에서 Braze 데이터를 활용한 보고서를 생성하는 방법을 알아보세요. 쿼리 빌더는 시작할 수 있도록 미리 작성된 SQL 쿼리 템플릿과 함께 제공되며, 직접 커스텀 SQL 쿼리를 작성하여 더 많은 인사이트를 얻을 수도 있습니다.

필수 조건

쿼리 빌더를 사용하려면 워크스페이스 수준에서 다음 권한이 필요합니다.

쿼리 빌더 사용

1단계: SQL 쿼리 생성

새 쿼리를 생성하려면 분석 > 쿼리 빌더로 이동한 다음 SQL 쿼리 생성을 선택합니다.

쿼리 작성에 아이디어나 도움이 필요하다면 쿼리 템플릿을 선택하고 미리 만들어진 템플릿을 선택하세요. 빈 쿼리로 시작하려면 SQL 편집기를 선택합니다.

보고서에는 현재 날짜와 시간이 포함된 이름이 자동으로 지정됩니다. 이름 위에 마우스를 올리고 을 선택하여 SQL 쿼리에 의미 있는 이름을 지정하세요.

2단계: 쿼리 구축

쿼리를 구축할 때 인공지능의 도움을 받거나 직접 구축하도록 선택할 수 있습니다.

• using operator
• on my own

참고

이 기능은 이제 Braze의 통합 인공지능 어시스턴트인 BrazeAI Operator™의 일부입니다. 이전에 독립형 어시스턴트로 제공되던 인공지능 기능은 이제 대시보드에서 작업 중인 어디에서나 Operator를 통해 모두 이용할 수 있습니다.

쿼리 빌더 사이드 패널에서 Operator에게 질문을 선택하고 원하는 데이터를 설명하세요. Operator가 사용 가능한 Snowflake 데이터 테이블을 대상으로 SQL을 작성하며, 보고서를 실행하기 전에 SQL을 검토하고 결과를 미리 볼 수 있습니다. 쿼리 빌더에서 Operator를 사용하려면 “대시보드 보고서 편집” 권한이 필요합니다.

생성된 SQL은 직접 작성한 쿼리와 동일한 SQL 작성 규칙을 따라야 합니다. 자세한 내용은 Operator로 할 수 있는 작업을 참조하세요. Operator가 데이터를 처리하는 방식은 Operator 데이터 프라이버시 및 보안을 참조하세요.

Snowflake 구문을 사용하여 SQL 쿼리를 작성합니다. 쿼리할 수 있는 테이블 및 열의 전체 목록은 테이블 참조를 확인하세요.

쿼리 빌더 내에서 테이블 세부 정보를 보려면 다음을 수행합니다.

1. 쿼리 빌더 페이지에서 참조 패널을 열고 사용 가능한 데이터 테이블을 선택하여 사용 가능한 데이터 테이블과 그 이름을 확인합니다.
2. 세부 정보 보기를 선택하여 테이블 설명과 데이터 유형 등 테이블 열에 대한 정보를 확인합니다.
3. SQL에 테이블 이름을 삽입하려면 를 선택합니다.

쿼리를 특정 기간으로 제한하면 결과를 더 빠르게 생성할 수 있습니다. 다음은 지난 1시간 동안의 구매 수와 발생한 매출을 가져오는 쿼리 예시입니다.

1
2
3

SELECT COUNT(*) as Purchases, SUM(price) as Revenue
FROM USERS_BEHAVIORS_PURCHASE_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('hour', -1, date_trunc('day',CURRENT_DATE()));

이 쿼리는 지난 한 달 동안의 이메일 발송 수를 가져옵니다.

1
2
3

SELECT COUNT(*) as Sends
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('month', -1, date_trunc('day',CURRENT_DATE()));

CANVAS_ID, CANVAS_VARIATION_API_ID 또는 CAMPAIGN_ID를 쿼리하면 연결된 이름 열이 결과 테이블에 자동으로 포함됩니다. SELECT 쿼리 자체에 이름 열을 포함할 필요는 없습니다.

ID 이름	연결된 이름 열
CANVAS_ID	Canvas 이름
CANVAS_VARIATION_API_ID	캔버스 배리언트 이름
CAMPAIGN_ID	Campaign 이름

이 쿼리는 세 가지 ID와 연결된 이름 열을 최대 100개 행까지 가져옵니다.

1
2
3

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

문제 해결

다음과 같은 이유로 쿼리가 실패할 수 있습니다.

• SQL 쿼리의 구문 오류
• 처리 시간 초과(6분 후)
  • 실행에 6분 이상 걸리는 보고서는 시간 초과됩니다.
  • 보고서가 시간 초과되면 데이터를 쿼리하는 기간을 제한하거나 더 구체적인 데이터 세트를 쿼리해 보세요.

3단계: 보고서 생성

쿼리 구축을 마쳤다면 쿼리 실행을 선택합니다. 오류나 보고서 시간 초과가 없으면 쿼리에서 CSV 파일이 생성됩니다.

CSV 보고서를 다운로드하려면 내보내기를 선택합니다.

중요

각 보고서는 하루에 한 번만 결과를 생성할 수 있습니다. 같은 캘린더 날짜에 동일한 보고서를 여러 번 실행하면 각 보고서에서 동일한 결과가 표시됩니다.

보고서 시간 초과

실행하는 데 6분 이상 걸리는 보고서는 시간 초과됩니다. 한동안 쿼리를 실행하지 않다가 처음 실행하는 경우에는 처리 시간이 더 오래 걸릴 수 있으므로 시간 초과될 가능성이 더 높습니다. 이런 경우 보고서를 다시 실행해 보세요.

여러 번 시도한 후에도 보고서가 계속 시간 초과되면 지원팀에 문의하세요.

중단 사유 쿼리하기

모든 USERS_MESSAGES_*_ABORT_SHARED 테이블에서 ABORT_TYPE 열을 쿼리하여 메시지가 전송되지 않은 이유를 분석할 수 있습니다. ABORT_TYPE 필드에는 중단의 구체적인 사유를 설명하는 문자열 값이 포함되어 있으며, 함께 제공되는 ABORT_LOG 필드에는 추가 세부 정보(예: 트리거된 최대 게재빈도 설정 규칙)가 포함되어 있습니다.

예를 들어, 지난 30일 동안의 이메일 중단 건수를 유형별로 집계하려면 다음과 같이 쿼리합니다.

1
2
3
4
5

SELECT ABORT_TYPE, COUNT(*) as abort_count
FROM USERS_MESSAGES_EMAIL_ABORT_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('day', -30, CURRENT_DATE())
GROUP BY ABORT_TYPE
ORDER BY abort_count DESC

ABORT_TYPE 값 및 각 설명의 전체 목록은 중단 유형을 참조하세요.

데이터 및 결과

모든 쿼리는 최근 60일간의 데이터를 표시합니다. 결과를 내보내면 최대 1,000개의 행만 포함됩니다. 더 많은 양의 데이터가 필요한 보고서의 경우 Currents 또는 내보내기 API 엔드포인트와 같은 도구를 사용할 수 있습니다.

Snowflake 크레딧

각 회사는 매월 5개의 Snowflake 크레딧을 사용할 수 있으며, 이 크레딧은 모든 워크스페이스에서 공유됩니다. 쿼리를 실행하거나 테이블을 미리 볼 때마다 Snowflake 크레딧의 일부가 사용됩니다.

참고

Snowflake 크레딧은 기능 간에 공유되지 않습니다. 예를 들어, SQL 세그먼트 확장과 쿼리 빌더의 크레딧은 서로 독립적입니다.

크레딧 사용량은 SQL 쿼리의 실행 시간과 관련이 있습니다. 실행 시간이 길수록 쿼리에 드는 Snowflake 크레딧의 비중이 커집니다. 실행 시간은 시간이 지나면서 쿼리의 복잡성과 크기에 따라 달라질 수 있습니다. 복잡한 쿼리를 더 자주 실행할수록 리소스 할당량이 커지고 실행 시간이 빨라집니다.

Braze SQL 편집기에서 보고서를 작성, 편집 또는 저장할 때는 크레딧이 사용되지 않습니다. 크레딧은 매월 1일 오전 12시(UTC)에 5개로 재설정됩니다. 월별 크레딧 사용량은 쿼리 빌더 페이지 상단에서 확인할 수 있습니다.

크레딧 한도에 도달하면 쿼리를 실행할 수 없지만, SQL 보고서를 생성, 편집, 저장할 수는 있습니다. 쿼리 빌더 크레딧을 추가로 구매하려면 계정 매니저에게 문의하세요.