> ## 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 Galaxy

> Synchronisez les événements personnalisés depuis Starburst Galaxy 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 Galaxy"

export const COLUMN_HEADER_0 = "Galaxy Column"

export const PROPERTIES_DESCRIPTION_0 = "Event metadata as JSON"

## Aperçu

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

Starburst Galaxy est une plateforme d'analytique cloud entièrement gérée basée sur Trino, conçue pour des requêtes SQL rapides sur les lacs de données et entrepôts cloud.

***

## 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 Galaxy

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

***

## Configuration

<Steps>
  <Step title="Obtenir les détails de connexion JDBC Galaxy">
    Dans votre console Starburst Galaxy, accédez aux détails de connexion de votre cluster.

    **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 Galaxy. Vous n'avez besoin que de la partie nom d'hôte de l'URL JDBC de Galaxy.
    </Info>
  </Step>

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

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

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

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

    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 catalogues MySQL, PostgreSQL, Snowflake, Iceberg et Starburst Galaxy.
    </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 Galaxy 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 cloud

```sql theme={null}
-- Example: Federated query across cloud data sources
SELECT
    'cloud_activity' as event_name,
    u.user_id,
    current_timestamp as event_timestamp,
    JSON_FORMAT(JSON_OBJECT(
        's3_interactions', s.interaction_count,
        'snowflake_orders', sf.order_count,
        'bigquery_analytics', bq.score_value
    )) as event_properties
FROM s3_catalog.users.profiles u
LEFT JOIN s3_catalog.interactions.summary s ON u.user_id = s.user_id
LEFT JOIN snowflake_catalog.orders.summary sf ON u.user_id = sf.user_id
LEFT JOIN bigquery_catalog.analytics.scores bq ON u.user_id = bq.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 Galaxy
* 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 cloud à 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)
* **Catalogue Starburst Galaxy** (stockage natif Galaxy)

***

## Fonctionnalités de la plateforme cloud

### Fédération multicloud

* Interrogez des sources de données AWS, Azure et GCP
* Combinez les données S3, Snowflake, BigQuery et Azure
* Analytique d'événements unifiée sur tous les fournisseurs cloud

### Infrastructure gérée

* Clusters Trino entièrement gérés avec mise à l'échelle automatique
* Fonctionnalités de sécurité et de conformité intégrées
* Aucune gestion d'infrastructure requise

### Catalogues natifs Galaxy

* Stockage natif Galaxy haute performance
* Intégration transparente avec l'écosystème Galaxy
* Optimisé pour les charges de travail d'analytique cloud

***

## Limitations

* Connexion TLS requise (intégré pour Galaxy)
* 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 cluster Galaxy ?

Dans votre console Starburst Galaxy, accédez aux détails de connexion de votre cluster et copiez l'URL JDBC. 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 cloud ?

Oui ! Les capacités de requête fédérée de Starburst Galaxy vous permettent de combiner des données d'événements provenant de plusieurs sources cloud (S3, Snowflake, BigQuery, etc.) en une seule requête.

### Galaxy prend-il en charge la mise à l'échelle automatique pour les charges de travail OneSignal ?

Oui, Starburst Galaxy met automatiquement à l'échelle les clusters en fonction de la charge de requête, garantissant des performances optimales pour votre traitement d'événements OneSignal sans intervention manuelle.
