Segment

Segment is Twilio's Customer Data Platform (CDP). It collects customer event data from websites, mobile apps, and server-side systems and routes it to analytics tools, marketing platforms, and data warehouse destinations.

Segment integration replicates data using the Segment Public API.

This connector replicates workspace configuration and operational metrics from Segment. It does not replicate raw analytics events (track, identify, page, screen, or group calls).

복제 가능한 개체 목록은 Schema 섹션을 참조하십시오.

유용한 링크와 지원되는 기능을 포함하여 이 커넥터에 대한 전반적인 내용을 살펴보겠습니다.

특징/기능	지원 세부 정보
지원되는 Qlik Talend Data Integration 프로젝트	복제 프로젝트에만 해당됩니다. 데이터 파이프라인 프로젝트는 지원되지 않습니다.
대상 업데이트 방법	복제 작업: 변경 내용 적용 변경 내용 저장 데이터 레이크 작업에 데이터 랜딩: 데이터 변경 내용 캡처(CDC)
메타데이터 관리	수동 메타데이터 생성이 필요하지 않습니다.
스키마 진화	열 데이터 유형 변경 작업만 지원됩니다.
LOB 열(NCLOB, CLOB 및 BLOB) 복제	지원되지 않음.
예정된 CDC	필수. 이렇게 하면 소스의 변경 내용이 대상에 최신 상태로 유지됩니다. 복제 작업의 경우 작업 예약 을 참조하십시오. 레이크 랜딩 작업의 경우 레이크 랜딩 작업을 위한 CDC 예약을 참조하십시오.
알림	부분적으로 지원됨 작업 변경 알림 설정
모니터링 중	CDC에만 해당되며, 이 커넥터의 경우 전체 로드가 적용되지 않습니다. Monitoring an individual data task
JSON 열 페이로드의 자동 압축 해제	지원되지 않음. 소스 데이터 집합의 JSON 열 페이로드는 대상에서 자동으로 압축 해제되지 않습니다.

Preparing for authentication

To access your data, you need to authenticate the connection with a Segment Public API token.

사용하는 계정에 가져오려는 테이블에 대한 읽기 액세스 권한이 있는지 확인합니다.

To set up your Segment account, you need:

An active Segment workspace on a Team or Business tier plan. Free and Starter plans have limited Segment Public API support, and some streams may return 403 errors.
A Segment user with Workspace Owner or Workspace Member role (required to create API tokens).

To create an API token:

Log into your Segment account.
Navigate to Settings > Workspace settings.
Select the Access Management tab.
Click the Tokens tab.
Click + Create Token.
Enter a description for the token, for example QlikDataIntegration.
Select Workspace Member access, which is sufficient for read-only access to workspace data.
Click Create.
Copy and paste your API token into a secured file.

Creating the connection

자세한 내용은 SaaS 응용 프로그램에 연결을 참조하십시오.

필요한 연결 속성을 입력합니다.
연결 이름에 연결 이름을 입력합니다.
연결이 만들어질 때 연결에 대한 메타데이터를 정의하려면 연결 메타데이터 열기를 선택합니다.
만들기를 클릭합니다.

Connection settings
Setting	Description
Data gateway	사용 사례에 필요한 경우 데이터 이동 게이트웨이를 선택합니다. 정보 메모 이 필드는 데이터 이동 게이트웨이를 지원하지 않으므로 Qlik Talend Cloud 시작 구독에서는 사용할 수 없습니다. 다른 구독 계층이 있고 데이터 이동 게이트웨이를 사용하지 않으려면 없음을 선택합니다. 데이터 이동 게이트웨이의 이점과 이를 필요로 하는 사용 사례에 대한 자세한 내용은 Qlik 데이터 게이트웨이 - 데이터 이동를 참조하십시오.
Start Date	데이터를 소스에서 대상으로 복제해야 하는 날짜를 `MM/DD/YYYY` 형식으로 입력합니다.
API Token	API token.

Limitations and considerations

The Segment Public API requires a Team or Business tier plan for full access. Some endpoints may return 403 errors on Free or Starter plans.
The audit_events stream requires the Audit Trail feature, which is available on Business tier plans only. Team tier accounts and below should de-select audit_events before syncing to avoid 403 errors.
Usage metric streams (usage_api_calls_per_source_daily, usage_api_calls_workspace_daily, usage_mtu_per_source_daily, and usage_mtu_workspace_daily) paginate through data month by month from the configured start date. The day-of-month component of the start date is ignored for these streams — data is fetched from the first day of the calendar month containing the start date. Initial syncs may take longer when the start date is set far in the past.
As of February 1, 2024, Segment no longer supports creating Config API tokens. Only Public API tokens are supported.

Schema

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

Depending on your destination, table and column names may not appear as they are outlined below.

audit_events

The audit_events table contains the workspace audit trail, including user actions and configuration changes. Requires the Audit Trail feature (Business tier).

Replication Method	CDC
Primary Key	id
Replication Key	timestamp
Useful links	Segment Public API reference

catalog_destinations

The catalog_destinations table contains all available destination types from the Segment Destinations Catalog, across all workspaces.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

catalog_sources

The catalog_sources table contains all available source types from the Segment Sources Catalog, across all workspaces.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

catalog_warehouses

The catalog_warehouses table contains all available warehouse types from the Segment Warehouses Catalog, across all workspaces.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

destination_delivery_metrics_summary

The destination_delivery_metrics_summary table contains delivery metrics for each source-to-destination pair in the workspace.

Replication Method	Full Table
Primary Key	sourceId, destinationId
Useful links	Segment Public API reference

destination_subscriptions

The destination_subscriptions table contains event subscriptions configured per destination in the workspace.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

destinations

The destinations table contains data destinations configured in the workspace.

Replication Method	Full Table
Primary Key	id, sourceId
Useful links	Segment Public API reference

groups

The groups table contains user groups configured in the workspace.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

source_connected_destinations

The source_connected_destinations table contains source-to-destination connections in the workspace.

Replication Method	Full Table
Primary Key	id, sourceId
Useful links	Segment Public API reference

source_connected_warehouses

The source_connected_warehouses table contains source-to-warehouse connections in the workspace.

Replication Method	Full Table
Primary Key	sourceId
Useful links	Segment Public API reference

sources

The sources table contains data sources configured in the workspace.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

transformations

The transformations table contains data transformations configured in the workspace.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

usage_api_calls_per_source_daily

The usage_api_calls_per_source_daily table contains daily API call usage broken down by source.

Replication Method	CDC
Primary Key	sourceId
Replication Key	timestamp
Useful links	Segment Public API reference

usage_api_calls_workspace_daily

The usage_api_calls_workspace_daily table contains daily total API call usage for the workspace.

Replication Method	CDC
Primary Key	timestamp
Replication Key	timestamp
Useful links	Segment Public API reference

usage_mtu_per_source_daily

The usage_mtu_per_source_daily table contains daily Monthly Tracked Users (MTU) usage broken down by source.

Replication Method	CDC
Primary Key	sourceId
Replication Key	timestamp
Useful links	Segment Public API reference

usage_mtu_workspace_daily

The usage_mtu_workspace_daily table contains daily total Monthly Tracked Users (MTU) usage for the workspace.

Replication Method	CDC
Primary Key	timestamp
Replication Key	timestamp
Useful links	Segment Public API reference

users

The users table contains users with access to the workspace.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

warehouses

The warehouses table contains warehouse connections configured in the workspace.

Replication Method	Full Table
Primary Key	id
Useful links	Segment Public API reference

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!

여기에 피드백을 남겨주십시오.