---
title: Amplitude
description: Amplitude에 연결하고 동기화 동작을 파악하며 기록되는 모든 테이블과 열을 쿼리합니다.
species: reference
---
# Amplitude

API 키, 비밀 키, 과거 데이터 수집 시작일을 사용해 Amplitude에 연결합니다. 이 소스는 `titan.amplitude` 아래에 고정 테이블 1개를 기록합니다.
```sql
select
  uuid,
  event_id,
  event_type
from titan.amplitude.events
limit 10
```

## Amplitude 연결

1. **앱**을 열고 **앱 연결**을 선택한 뒤 **Amplitude** 항목을 선택합니다.
2. API 키, 비밀 키, 과거 데이터 수집 시작일을 입력합니다.
3. 테이블을 확인한 뒤 소스를 저장합니다.
4. 첫 실행이 완료될 때까지 **동기화 기록**을 확인합니다.

자격 증명은 비밀 정보로 저장됩니다. 레이크 열이 되거나 쿼리 결과에 나타나지 않습니다.

## 동기화 동작

첫 실행은 설정한 과거 데이터 수집 시작일부터 진행됩니다. 이후 실행은 마지막으로 완료한 구간에서 이어서 진행합니다.

새 소스는 연결할 때 동기화한 다음 설정된 일정을 따릅니다. 기본 반복 간격은 4시간입니다. 실행이 중단되어도 완료한 진행 상황을 유지하며 안전하게 재시도합니다.

모든 레이크 테이블에는 [시스템 열](/docs/concepts/your-lake#시스템-열)인 `_synced_at`과 `_deleted`도 있습니다. 아래 열 참조에는 소스 열만 나열합니다.

## 테이블 참조

### `events`

`titan.amplitude.events`의 소스 열 수는 40개입니다.

```columns table=amplitude.events
uuid                                    string pk           `uuid` 소스 필드.
event_id                                integer             `event_id` 소스 필드.
event_type                              string              `event_type` 소스 필드.
event_time                              datetime            `event_time` 소스 필드.
user_id                                 string              `user_id` 소스 필드.
session_id                              integer             `session_id` 소스 필드.
amplitude_id                            integer             `amplitude_id` 소스 필드.
amplitude_attribution_ids               string              `amplitude_attribution_ids` 소스 필드.
server_received_time                    datetime            `server_received_time` 소스 필드.
server_upload_time                      datetime            `server_upload_time` 소스 필드.
client_upload_time                      datetime            `client_upload_time` 소스 필드.
client_event_time                       datetime            `client_event_time` 소스 필드.
sample_rate                             string              `sample_rate` 소스 필드.
start_version                           string              `start_version` 소스 필드.
app                                     integer             `app` 소스 필드.
library                                 string              `library` 소스 필드.
device_carrier                          string              `device_carrier` 소스 필드.
processed_time                          datetime            `processed_time` 소스 필드.
version_name                            string              `version_name` 소스 필드.
paying                                  boolean             `paying` 소스 필드.
platform                                string              `platform` 소스 필드.
os_name                                 string              `os_name` 소스 필드.
os_version                              string              `os_version` 소스 필드.
device_id                               string              `device_id` 소스 필드.
device_type                             string              `device_type` 소스 필드.
device_family                           string              `device_family` 소스 필드.
language                                string              `language` 소스 필드.
country                                 string              `country` 소스 필드.
region                                  string              `region` 소스 필드.
city                                    string              `city` 소스 필드.
dma                                     string              `dma` 소스 필드.
ip_address                              string              `ip_address` 소스 필드.
data                                    json                `data` 소스 필드.
event_properties                        json                `event_properties` 소스 필드.
user_properties                         json                `user_properties` 소스 필드.
group_properties                        json                `group_properties` 소스 필드.
groups                                  json                `groups` 소스 필드.
location_lat                            float               `location_lat` 소스 필드.
location_lng                            float               `location_lng` 소스 필드.
insert_id                               string              `insert_id` 소스 필드.
```

## 삭제와 이력

행은 소스 키로 병합됩니다. 소스에서 행 삭제를 입증할 수 있으면 Supernova는 행을 유지하고 `_deleted`를 설정합니다. 따라서 쿼리에서 이력을 포함할지 선택할 수 있습니다. 현재 상태를 조회하는 쿼리에는 `where not _deleted` 필터를 사용하세요.