--- title: Klaviyo description: Klaviyo에 연결하고 동기화 동작을 파악하며 기록되는 모든 테이블과 열을 쿼리합니다. species: reference --- # Klaviyo 비공개 API 키를 사용해 Klaviyo에 연결합니다. 이 소스는 `titan.klaviyo` 아래에 고정 테이블 9개를 기록합니다. ```sql select id, email, first_name from titan.klaviyo.profiles limit 10 ``` ## Klaviyo 연결 1. **앱**을 열고 **앱 연결**을 선택한 뒤 **Klaviyo** 항목을 선택합니다. 2. 비공개 API 키를 입력합니다. 3. 테이블을 확인한 뒤 소스를 저장합니다. 4. 첫 실행이 완료될 때까지 **동기화 기록**을 확인합니다. 자격 증명은 비밀 정보로 저장됩니다. 레이크 열이 되거나 쿼리 결과에 나타나지 않습니다. ## 동기화 동작 프로필, 목록, 캠페인, 플로, 지표, 이벤트, 세그먼트, 템플릿, 카탈로그 항목을 함께 동기화합니다. 새 소스는 연결할 때 동기화한 다음 설정된 일정을 따릅니다. 기본 반복 간격은 4시간입니다. 실행이 중단되어도 완료한 진행 상황을 유지하며 안전하게 재시도합니다. 모든 레이크 테이블에는 [시스템 열](/docs/concepts/your-lake#시스템-열)인 `_synced_at`과 `_deleted`도 있습니다. 아래 열 참조에는 소스 열만 나열합니다. ## 테이블 참조 ### `profiles` `titan.klaviyo.profiles`의 소스 열 수는 8개입니다. ```columns table=klaviyo.profiles id string pk `id` 소스 필드. email string `email` 소스 필드. first_name string `firstName` 소스 필드. last_name string `lastName` 소스 필드. phone string `phone` 소스 필드. created datetime `created` 소스 필드. updated datetime `updated` 소스 필드. properties json `properties` 소스 필드. ``` ### `lists` `titan.klaviyo.lists`의 소스 열 수는 4개입니다. ```columns table=klaviyo.lists id string pk `id` 소스 필드. name string `name` 소스 필드. created datetime `created` 소스 필드. updated datetime `updated` 소스 필드. ``` ### `campaigns` `titan.klaviyo.campaigns`의 소스 열 수는 6개입니다. ```columns table=klaviyo.campaigns id string pk `id` 소스 필드. name string `name` 소스 필드. status string `status` 소스 필드. created_at datetime `createdAt` 소스 필드. updated_at datetime `updatedAt` 소스 필드. send_time datetime `sendTime` 소스 필드. ``` ### `flows` `titan.klaviyo.flows`의 소스 열 수는 6개입니다. ```columns table=klaviyo.flows id string pk `id` 소스 필드. name string `name` 소스 필드. status string `status` 소스 필드. created datetime `created` 소스 필드. updated datetime `updated` 소스 필드. trigger_type string `triggerType` 소스 필드. ``` ### `metrics` `titan.klaviyo.metrics`의 소스 열 수는 5개입니다. ```columns table=klaviyo.metrics id string pk `id` 소스 필드. name string `name` 소스 필드. integration json `integration` 소스 필드. created datetime `created` 소스 필드. updated datetime `updated` 소스 필드. ``` ### `events` `titan.klaviyo.events`의 소스 열 수는 5개입니다. ```columns table=klaviyo.events id string pk `id` 소스 필드. metric_id string `metricId` 소스 필드. profile_id string `profileId` 소스 필드. datetime datetime `datetime` 소스 필드. event_properties json `eventProperties` 소스 필드. ``` ### `segments` `titan.klaviyo.segments`의 소스 열 수는 4개입니다. ```columns table=klaviyo.segments id string pk `id` 소스 필드. name string `name` 소스 필드. created datetime `created` 소스 필드. updated datetime `updated` 소스 필드. ``` ### `templates` `titan.klaviyo.templates`의 소스 열 수는 6개입니다. ```columns table=klaviyo.templates id string pk `id` 소스 필드. name string `name` 소스 필드. editor_type string `editorType` 소스 필드. html string `html` 소스 필드. created datetime `created` 소스 필드. updated datetime `updated` 소스 필드. ``` ### `catalog_items` `titan.klaviyo.catalog_items`의 소스 열 수는 6개입니다. ```columns table=klaviyo.catalog_items id string pk `id` 소스 필드. title string `title` 소스 필드. description string `description` 소스 필드. url string `url` 소스 필드. created datetime `created` 소스 필드. updated datetime `updated` 소스 필드. ``` ## 삭제와 이력 행은 소스 키로 병합됩니다. 소스에서 행 삭제를 입증할 수 있으면 Supernova는 행을 유지하고 `_deleted`를 설정합니다. 따라서 쿼리에서 이력을 포함할지 선택할 수 있습니다. 현재 상태를 조회하는 쿼리에는 `where not _deleted` 필터를 사용하세요.