For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.
Amplitude SQL: 쿼리 시작하기
Amplitude 쿼리 제품을 사용하면 Amplitude가 관리하는 Snowflake 데이터베이스를 통해 원시 데이터를 쿼리할 수 있습니다. 쿼리에는 또한 Amplitude SQL이라는 차트 유형이 포함되어 있어 Amplitude 플랫폼 내에서 직접 Amplitude 데이터에 대해 사용자 지정 SQL을 작성할 수 있습니다.
Amplitude는 30분마다 데이터를 Snowflake에 로드합니다.
이 기능은 유럽 연합에서 사용할 수 없습니다.
시작하기
_생성 > 차트 > 추가 차트 유형 보기_를 통해 Amplitude SQL을 찾으십시오. 다른 차트와 마찬가지로 저장하고 공유할 수 있으며 대시보드에 추가할 수 있습니다.
이 기능은 포트폴리오 뷰에 대한 데이터 대기열을 지원하지 않습니다.
터미널이나 SQL 워크벤치 또는 Python용 Snowflake 커넥터와 같은 타사 애플리케이션을 통해 Snowflake 데이터베이스에 직접 연결할 수도 있습니다. Snowflake 자격 증명은 Amplitude 서포트나 담당 성공 관리자에게 문의하십시오.
설정 및 구문
쿼리 패키지는 Snowflake 및 Amplitude SQL에 대해 단순화된 테이블 스키마를 사용합니다. 스키마에는 단일 테이블이 포함되어 있으며, $events 약어를 사용하여 참조할 수 있습니다.
다른 테이블에 액세스하려면 전체 이름을 사용하십시오. 전체 이름은 _스키마 표시_에서 확인할 수 있습니다.
쿼리 테이블은 데이터 필드를 무제한으로 지원합니다. 쿼리는 사용자 정의 사용자 속성 및 이벤트 속성을 변형으로 저장하며, 이를 개별 열로 쿼리할 수 있습니다. 사용자 정의 사용자 속성에는 접두어 user_properties:가 있고, 이벤트 속성에는 접두어 event_properties:가 있습니다.
사용자 또는 이벤트 속성에 마침표나 공백이 포함되어 있는 경우, 속성 이름을 따옴표로 묶으십시오: user_properties:"first name".
특정 값을 검색하려는 경우 속성 값을 작은따옴표로 묶으십시오: user_properties:"plan type"='enterprise'.
기본적으로 Amplitude SQL은 사용자가 지난 30일 동안 수행한 이벤트에 대한 간단한 SQL 쿼리를 표시합니다. SQL 구문에는 다음 필드가 포함됩니다.
$date를 날짜(이벤트 발생 날짜)로 지정.COUNT(DISTINCT $amplitude_id)를 고유 사용자(고유 사용자 수)라는 별칭으로 지정.COUNT($amplitude_id)를 총계(사용자 총 수)로 표시.
SQL 구문 강조 표시는 SQL 명령을 질의의 나머지 부분과 구별하는 데 도움이 됩니다.
Amplitude SQL은 또한 테이블의 열에 대한 자동 완성을 지원합니다.
쿼리 결과
SQL 쿼리 작성을 완료한 후 _계산_을 클릭하여 실행합니다. 쿼리 실행이 완료되면:
- 쿼리 결과는 데이터 테이블에 나타납니다.
- 결과의 시계열 차트가 테이블 아래에 나타납니다.
쿼리 편집기 아래에 있는 컨트롤을 사용하여 시계열 시각화를 사용자 정의하십시오. 이 옵션에는 SQL SELECT 문에서 반환하는 모든 필드가 포함됩니다. 예를 들어 위의 쿼리에서 이러한 값은 날짜, 고유 사용자 및 _합계_입니다.
- X축 열: X축에 사용할 항목을 선택합니다. 이 값은 시계열이어야 합니다.
- 지표 열: Y축에 플롯할 SQL
SELECT문에서 반환된 필드를 선택합니다.
속성별 적용
차트를 열별로 그룹화하려면 레이블 열 필드에 열 이름을 입력한 다음 _계산_을 누릅니다.
쿼리 공유 및 저장
결과를 PNG, PDF 또는 CSV 파일로 내보내려면 _자세히 > 내보내기_로 이동하십시오. 또한 분석을 저장하여 팀과 공유하거나, 자신이 만든 시각화를 Amplitude의 대시보드에 추가할 수도 있습니다.
데이터 테이블 결과 및 .CSV 데이터 테이블 내보내기는 1,000행으로 제한됩니다.
다음으로, Snowflake 데이터를 보다 빠르게 쿼리할 수 있는 특수 필드 바로 가기에 대해 알아보십시오.
이 내용이 도움이 되었나요?