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).

Consultare la sezione Schema per un elenco di oggetti disponibili per la replica.

Immagine di alto livello di questo connettore, inclusi collegamenti utili e funzionalità supportate.

Funzionalità/Capacità	Dettagli del supporto
Progetti Qlik Talend Data Integration supportati	Solo i progetti di replica. I progetti delle pipeline di dati non sono supportati.
Metodi di aggiornamento della destinazione	Attività di replica: Applica modifiche Archivia modifiche Trasferimento dei dati nelle attività di un data lake: Change Data Capture (CDC)
Gestione dei metadati	La generazione manuale dei metadati non è richiesta.
Evoluzione dello schema	È supportata solo l'operazione Cambia tipo di dati colonne.
Replica delle colonne LOB (NCLOB, CLOB e BLOB)	Operazione non supportata.
CDC pianificato	Operazione richiesta. In questo modo la destinazione viene aggiornata con le modifiche apportate alla sorgente. Per le attività di replica, vedere Pianificazione delle attività Per le attività di trasferimento su data lake, vedere Pianificazione CDC per le attività di trasferimento nel data lake
Notifiche	Operazione parzialmente supportata Impostare notifiche quando vengono apportate modifiche al funzionamento
Monitoraggio	Solo attività CDC, in quanto il caricamento completo non è rilevante per questo connettore. Monitoraggio di un singolo task di dati
Annullamento automatico della nidificazione dei payload nelle colonne JSON	Operazione non supportata. La nidificazione per i payload della colonna JSON nei set di dati di origine non viene annullata automaticamente nella destinazione.

Preparing for authentication

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

Assicurarsi che l'account utilizzata disponga di accesso di lettura per le tabelle che si desidera recuperare.

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

Per ulteriori informazioni, vedere Connessione alle applicazioni SaaS.

Inserire le proprietà di connessione richieste.
Fornire un nome per la connessione in Nome connessione.
Selezionare Apri metadati di connessione per definire i metadati della connessione al momento della creazione.
Fare clic su Crea.

Connection settings
Setting	Description
Data gateway	Selezionare un Gateway Data Movement se richiesto dal proprio caso di utilizzo. Nota informatica Questo campo non è disponibile con la sottoscrizione a Avvio Qlik Talend Cloud, poiché non supporta il Gateway Data Movement. Se si dispone di un altro livello di sottoscrizione e non si desidera utilizzare il Gateway Data Movement, selezionare Nessuno. Per informazioni sui vantaggi del Gateway Data Movement e quando è richiesto, vedere Qlik Data Gateway - Movimento dati.
Start Date	Inserire la data, nel formato `MM/DD/YYYY`, a partire dalla quale i dati devono essere replicati dalla sorgente alla destinazione.
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

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – ti pregiamo di farcelo sapere!

Lascia qui il tuo feedback