쿼리 빌더에서 쿼리 구축
쿼리 빌더를 사용하여 Snowflake에서 Braze 데이터를 활용한 보고서를 생성하는 방법을 알아보세요. 쿼리 빌더는 시작할 수 있도록 미리 작성된 SQL 쿼리 템플릿과 함께 제공되며, 직접 커스텀 SQL 쿼리를 작성하여 더 많은 인사이트를 얻을 수도 있습니다.
필수 조건
쿼리 빌더를 사용하려면 워크스페이스 수준에서 다음 권한이 필요합니다.
| 권한 | 허용되는 작업 |
|---|---|
| “View Dashboard Reports” | 대시보드에서 쿼리 빌더 열기 |
| “View PII” | 고객 데이터를 포함할 수 있는 쿼리 빌더 데이터에 액세스 |
| “Edit Dashboard Reports” | 쿼리 빌더 보고서 생성, 편집 및 실행 |
쿼리 빌더 사용
1단계: SQL 쿼리 만들기
새 쿼리를 만들려면 분석 > 쿼리 빌더로 이동한 다음 SQL 쿼리 만들기를 선택합니다.

쿼리 작성에 아이디어나 도움이 필요하면 쿼리 템플릿을 선택하고 미리 만들어진 템플릿을 선택합니다. 빈 쿼리로 시작하려면 SQL 편집기를 선택합니다.
보고서에는 현재 날짜와 시간이 포함된 이름이 자동으로 지정됩니다. 이름 위에 마우스를 올리고 을 선택하여 SQL 쿼리에 의미 있는 이름을 지정하세요.

2단계: 쿼리 구축하기
쿼리를 구축할 때 인공지능의 도움을 받거나 직접 작성할 수 있습니다.

이 기능은 이제 Braze의 통합 인공지능 어시스턴트인 BrazeAI Operator™의 일부입니다. 이전에 독립형 어시스턴트로 제공되던 인공지능 기능은 이제 대시보드에서 작업 중인 어디에서나 Operator를 통해 모두 이용할 수 있습니다.
쿼리 빌더 사이드 패널에서 Operator에게 질문하기를 선택하고 원하는 데이터를 설명합니다. Operator는 사용 가능한 Snowflake 데이터 테이블을 대상으로 SQL을 작성하며, 보고서를 실행하기 전에 SQL을 검토하고 결과를 미리 볼 수 있습니다. 쿼리 빌더에서 Operator를 사용하려면 “대시보드 보고서 편집” 권한이 필요합니다.
생성된 SQL은 직접 작성하는 쿼리와 동일한 SQL 작성 규칙을 따라야 합니다. 자세한 내용은 Operator로 할 수 있는 작업을 참조하세요. Operator가 데이터를 처리하는 방식은 Operator 데이터 프라이버시 및 보안을 참조하세요.
Snowflake 구문을 사용하여 SQL 쿼리를 작성합니다. 쿼리할 수 있는 테이블과 열의 전체 목록은 테이블 참조를 확인하세요.
쿼리 빌더에서 테이블 세부 정보를 보려면 다음을 수행합니다.
- 쿼리 빌더 페이지에서 참조 패널을 열고 사용 가능한 데이터 테이블을 선택하여 사용 가능한 데이터 테이블과 그 이름을 확인합니다.
- 세부 정보 보기를 선택하여 테이블 설명과 데이터 유형 등 테이블 열에 대한 정보를 확인합니다.
- SQL에 테이블 이름을 삽입하려면 을 선택합니다.
쿼리를 특정 기간으로 제한하면 결과를 더 빠르게 생성할 수 있습니다. 다음은 지난 1시간 동안의 구매 수와 발생한 매출을 가져오는 쿼리 예시입니다.
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()));
이 쿼리는 지난 한 달 동안의 이메일 발송 수를 가져옵니다.
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개 행까지 가져옵니다.
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100
문제 해결
다음과 같은 이유로 쿼리가 실패할 수 있습니다.
- SQL 쿼리의 구문 오류
- 처리 시간 초과(6분 경과 후)
- 실행하는 데 6분 이상 걸리는 보고서는 시간 초과됩니다.
- 보고서가 시간 초과되면 데이터를 쿼리하는 기간을 제한하거나 더 구체적인 데이터 집합을 쿼리해 보세요.
3단계: 보고서 생성하기
쿼리 구축을 마쳤으면 날짜 범위 필터를 사용하여 결과의 기간(고정 또는 상대)을 설정합니다. 그런 다음 쿼리 실행을 선택합니다. 오류나 보고서 시간 초과가 없으면 결과가 대시보드에 표시됩니다.
보고서를 CSV로 다운로드하려면 내보내기를 선택합니다.


각 보고서는 하루에 한 번만 결과를 생성할 수 있습니다. 같은 날짜에 동일한 보고서를 여러 번 실행하면 각 보고서에 동일한 결과가 표시됩니다.
보고서 시간 초과
실행하는 데 6분 이상 걸리는 보고서는 시간 초과됩니다. 한동안 쿼리를 실행하지 않았다가 처음 실행하는 경우 처리 시간이 더 오래 걸려 시간 초과될 가능성이 높아질 수 있습니다. 이 경우 보고서를 다시 실행해 보세요.
여러 번 시도한 후에도 보고서가 계속 시간 초과되면 지원팀에 문의하세요.
중단 사유 쿼리하기
모든 USERS_MESSAGES_*_ABORT_SHARED 테이블에서 ABORT_TYPE 열을 쿼리하여 메시지가 전송되지 않은 이유를 분석할 수 있습니다. ABORT_TYPE 필드에는 중단의 구체적인 사유를 설명하는 문자열 값이 포함되어 있으며, 함께 제공되는 ABORT_LOG 필드에는 추가 세부 정보(예: 트리거된 최대 게재빈도 설정 규칙)가 포함되어 있습니다.
예를 들어, 지난 30일 동안의 이메일 중단 건수를 유형별로 집계하려면 다음과 같이 쿼리합니다.
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 값의 전체 목록과 각 값에 대한 설명은 중단 유형을 참조하세요.
데이터 및 결과
보고서 날짜 범위 필터를 사용하여 포함할 데이터 기간을 선택합니다. 최대 1년의 기록을 선택할 수 있습니다. 단, 워크스페이스에 Snowflake 데이터 공유 또는 Currents가 있는 경우 최대 2년의 데이터를 선택할 수 있습니다.
대시보드에는 결과의 처음 1,000개 행까지 표시됩니다. 내보내기를 하면 CSV에 최대 100,000개 행이 포함될 수 있습니다. 더 많은 데이터가 필요한 보고서의 경우 Currents 또는 내보내기 API 엔드포인트를 사용하세요.
Snowflake 크레딧
각 회사는 쿼리 빌더에 사용할 수 있는 Snowflake 크레딧을 매월 10개씩 제공받으며, 이 크레딧은 모든 워크스페이스에서 공유됩니다. 추가 크레딧을 구매하면 월별 할당량이 늘어납니다. 쿼리를 실행하거나 테이블을 미리 볼 때마다 Snowflake 크레딧의 일부가 사용됩니다.

크레딧 사용량은 SQL 쿼리의 실행 시간과 관련이 있습니다. 실행 시간이 길수록 쿼리에 드는 Snowflake 크레딧의 비율이 높아집니다. 실행 시간은 시간이 지남에 따라 쿼리의 복잡성과 규모에 따라 달라질 수 있습니다. 복잡한 쿼리를 자주 실행할수록 리소스 할당량이 커지고 실행 시간이 빨라집니다.
Braze SQL 편집기에서 보고서를 작성, 편집 또는 저장할 때는 크레딧이 사용되지 않습니다. 크레딧은 매월 1일 UTC 기준 오전 12시에 월별 할당량으로 재설정됩니다. 월별 크레딧 사용량은 쿼리 빌더 페이지 상단에서 모니터링할 수 있습니다.

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