> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Starburst Enterprise

> Synchronisez les événements personnalisés depuis Starburst Enterprise vers OneSignal pour déclencher des Journeys automatisés et des campagnes de messagerie personnalisées basées sur le comportement des utilisateurs.

export const DATA_TYPE_0 = "event data"

export const PLATFORM_0 = "Starburst Enterprise"

export const COLUMN_HEADER_0 = "Starburst Column"

export const PROPERTIES_DESCRIPTION_0 = "Event metadata as JSON"

## Aperçu

L'intégration OneSignal + Starburst Enterprise permet la synchronisation d'événements personnalisés depuis votre cluster Starburst Enterprise vers OneSignal pour déclencher des campagnes de messagerie automatisées et des Journeys basés sur le comportement des utilisateurs.

Starburst Enterprise est une distribution commerciale de Trino conçue pour l'analyse d'entreprise et l'interrogation de lac de données sur plusieurs sources.

***

## Exigences

* Accès aux [Event Streams](/docs/en/event-streams) pour les événements de message sortants (Les limitations de forfait et les dépassements s'appliquent)
* Accès aux [Événements personnalisés](/docs/en/custom-events) pour la synchronisation des événements entrants (Les limitations de forfait et les dépassements s'appliquent)
* [Forfait de compte mis à jour](https://onesignal.com/pricing) (non disponible sur les applications gratuites)

### Starburst Enterprise

* **Cluster Starburst Enterprise** avec accès réseau
* **Identifiants utilisateur** avec les autorisations appropriées
* Prise en charge de **connexion TLS** (requis par OneSignal)
* **Données d'événements** accessibles via les catalogues Starburst

***

## Configuration

<Steps>
  <Step title="Obtenir les détails de connexion JDBC">
    Suivez la documentation de Starburst pour obtenir votre URL JDBC pour votre cluster souhaité.

    **Exemple d'URL JDBC :**

    ```
    jdbc:trino://census-example-cluster.trino.galaxy.starburst.io:[email protected]/accountadmin
    ```

    **Extraire le nom d'hôte pour OneSignal :**

    ```
    census-example-cluster.trino.galaxy.starburst.io
    ```

    <Info>
      OneSignal utilise JDBC pour se connecter à Starburst Enterprise. Vous n'avez besoin que de la partie nom d'hôte de l'URL JDBC.
    </Info>
  </Step>

  <Step title="Configurer la connexion Starburst Enterprise">
    Dans OneSignal, allez dans **Data > Integrations** et cliquez sur **Add Integration**.

    Sélectionnez **Starburst Enterprise** et fournissez les détails de connexion suivants :

    * **Hôte :** Le nom d'hôte de votre cluster Starburst (depuis l'étape 1)
    * **Nom d'utilisateur :** Votre nom d'utilisateur Starburst
    * **Mot de passe :** Votre mot de passe Starburst
    * **Port :** 443 (par défaut) ou votre port personnalisé
  </Step>

  <Step title="Configurer le moteur de synchronisation avancé (Optionnel)">
    Pour des performances améliorées, configurez un catalogue CENSUS dédié :

    1. Créez un catalogue nommé `CENSUS` contenant un schéma nommé `CENSUS`
    2. Assurez-vous que votre connecteur prend en charge :
       * Les opérations `CREATE TABLE` et `DROP TABLE`
       * Les écritures de table (INSERT, DELETE, UPDATE)
       * L'instruction `CREATE OR REPLACE TABLE`
    3. Accordez toutes les autorisations sur le schéma `CENSUS.CENSUS` à votre utilisateur OneSignal

    <Info>
      Les configurations testées incluent les connecteurs MySQL, PostgreSQL, Snowflake, Iceberg et Starburst Delta Lake.
    </Info>
  </Step>
</Steps>

***

### Mappage des données d'événement

Mappez vos {DATA_TYPE_0} {PLATFORM_0} au format des événements personnalisés de OneSignal :

| Champ OneSignal | {COLUMN_HEADER_0} | Description                     | Requis |
| --------------- | ----------------- | ------------------------------- | ------ |
| `name`          | `event_name`      | Identifiant de l'événement      | Oui    |
| `external_id`   | `user_id`         | Identifiant de l'utilisateur    | Oui    |
| `timestamp`     | `event_timestamp` | Quand l'événement s'est produit | Non    |
| `properties`    | `event_data`      | {PROPERTIES_DESCRIPTION_0}      | Non    |

### Exemple de requête d'événements

```sql theme={null}
-- Example: Recent high-value events across catalogs
SELECT
    event_name,
    user_id,
    event_timestamp,
    CAST(event_properties AS JSON) as event_properties
FROM catalog.schema.user_events
WHERE event_timestamp >= current_timestamp - INTERVAL '7' DAY
    AND JSON_EXTRACT_SCALAR(event_properties, '$.value') > '100'
ORDER BY event_timestamp DESC;
```

### Requêtes de lac de données d'entreprise

```sql theme={null}
-- Example: Federated query across enterprise data sources
SELECT
    'enterprise_activity' as event_name,
    u.user_id,
    current_timestamp as event_timestamp,
    JSON_FORMAT(JSON_OBJECT(
        'crm_interactions', c.interaction_count,
        'warehouse_orders', w.order_count,
        'lake_analytics', l.score_value
    )) as event_properties
FROM salesforce_catalog.users.accounts u
LEFT JOIN crm_catalog.interactions.summary c ON u.user_id = c.user_id
LEFT JOIN warehouse_catalog.orders.summary w ON u.user_id = w.user_id
LEFT JOIN datalake_catalog.analytics.scores l ON u.user_id = l.user_id
WHERE u.created_date >= current_date - INTERVAL '30' DAY;
```

***

## Options du moteur de synchronisation

### Moteur de synchronisation de base

* Fonctionne avec n'importe quel catalogue et connecteur Starburst
* Suivi de l'état géré par l'infrastructure OneSignal
* Configuration plus simple sans exigences supplémentaires

### Moteur de synchronisation avancé

* Performances améliorées avec suivi d'état local
* Nécessite un catalogue et un schéma `CENSUS.CENSUS` dédiés
* Prend en charge les connecteurs avec opérations d'écriture de table
* Recommandé pour le traitement d'événements d'entreprise à haut volume

***

## Connecteurs pris en charge

Le moteur de synchronisation avancé de OneSignal a été testé avec :

* **Connecteur MySQL** (mode lecture-écriture)
* **Connecteur PostgreSQL** (mode lecture-écriture)
* **Connecteur Snowflake** (mode lecture-écriture)
* **Connecteur Iceberg** (avec S3 et AWS Glue)
* **Connecteur Starburst Delta Lake** (avec catalogues AWS Glue)

***

## Fonctionnalités d'entreprise

### Fédération multisource

* Interrogez plusieurs sources de données d'entreprise en une seule synchronisation
* Combinez les données d'événements CRM, d'entrepôt et de lac de données
* Profils d'événements clients unifiés provenant de systèmes disparates

### Sécurité et conformité

* Authentification et autorisation de niveau entreprise
* Prise en charge de la sécurité au niveau des lignes et du masquage de colonnes
* Journalisation d'audit pour le suivi de l'accès aux données

***

## Limitations

* Connexion TLS requise (exigence de sécurité OneSignal)
* Le moteur de synchronisation avancé nécessite la prise en charge de `CREATE OR REPLACE TABLE`
* Warehouse Writeback pas encore pris en charge (prochainement)
* Impossible de fournir des options de table personnalisées dans la clause `WITH`

***

## FAQ

### Comment obtenir le nom d'hôte de mon Starburst Enterprise ?

Suivez la documentation de Starburst pour obtenir votre URL JDBC, puis extrayez uniquement la partie nom d'hôte (sans le préfixe `jdbc:trino://`) pour l'utiliser dans OneSignal.

### Puis-je interroger plusieurs sources de données d'entreprise ?

Oui ! Les capacités de requête fédérée de Starburst Enterprise vous permettent de combiner des données d'événements provenant de plusieurs sources d'entreprise (Salesforce, SAP, Oracle, etc.) en une seule requête.

### Quelle version de Starburst prend en charge le moteur de synchronisation avancé ?

Consultez les notes de version de Starburst Enterprise pour la prise en charge de `CREATE OR REPLACE TABLE`, qui est requise pour la fonctionnalité du moteur de synchronisation avancé.
