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

> Sincroniza eventos personalizados desde Starburst Enterprise a OneSignal para activar Journeys automatizados y campañas de mensajería personalizadas basadas en el comportamiento del usuario.

export const PLATFORM_0 = "Starburst Enterprise"

export const DATA_TYPE_0 = "event data"

export const COLUMN_HEADER_0 = "Starburst Column"

export const PROPERTIES_DESCRIPTION_0 = "Event metadata as JSON"

## Descripción general

La integración OneSignal + Starburst Enterprise habilita la sincronización de eventos personalizados desde tu clúster de Starburst Enterprise a OneSignal para activar campañas de mensajería automatizadas y Journeys basados en el comportamiento del usuario.

Starburst Enterprise es una distribución comercial de Trino diseñada para análisis empresarial y consultas de data lake a través de múltiples fuentes.

***

## Requisitos

* Access to [Event Streams](/docs/en/event-streams) for outbound message events (Plan limitations and overages apply)
* Access to [Custom Events](/docs/en/custom-events) for inbound event syncing (Plan limitations and overages apply)
* [Updated Account Plan](https://onesignal.com/pricing) (not available on free apps)

### Starburst Enterprise

* **Clúster de Starburst Enterprise** con acceso de red
* **Credenciales de usuario** con permisos apropiados
* **Soporte de conexión TLS** (requerido por OneSignal)
* **Datos de eventos** accesibles a través de catálogos de Starburst

***

## Configuración

<Steps>
  <Step title="Obtener detalles de conexión JDBC">
    Sigue la documentación de Starburst para obtener tu URL JDBC para tu clúster deseado.

    **Ejemplo de URL JDBC:**

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

    **Extraer hostname para OneSignal:**

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

    <Info>
      OneSignal usa JDBC para conectarse a Starburst Enterprise. Solo necesitas la porción de hostname de la URL JDBC.
    </Info>
  </Step>

  <Step title="Configurar conexión de Starburst Enterprise">
    In OneSignal, go to **Data > Integrations** and click **Add Integration**.

    Selecciona **Starburst Enterprise** y proporciona los siguientes detalles de conexión:

    * **Host:** El hostname de tu clúster de Starburst (del Paso 1)
    * **Username:** Tu nombre de usuario de Starburst
    * **Password:** Tu contraseña de Starburst
    * **Port:** 443 (predeterminado) o tu puerto personalizado
  </Step>

  <Step title="Configurar Motor de Sincronización Avanzado (Opcional)">
    Para rendimiento mejorado, configura un catálogo CENSUS dedicado:

    1. Crea un catálogo llamado `CENSUS` conteniendo un esquema llamado `CENSUS`
    2. Asegúrate de que tu conector soporte:
       * Operaciones `CREATE TABLE` y `DROP TABLE`
       * Escrituras de tabla (INSERT, DELETE, UPDATE)
       * Declaración `CREATE OR REPLACE TABLE`
    3. Otorga permisos completos en el esquema `CENSUS.CENSUS` a tu usuario de OneSignal

    <Info>
      Las configuraciones probadas incluyen conectores de MySQL, PostgreSQL, Snowflake, Iceberg y Starburst Delta Lake.
    </Info>
  </Step>
</Steps>

***

### Event data mapping

Map your {PLATFORM_0} {DATA_TYPE_0} to OneSignal's custom events format:

| OneSignal Field | {COLUMN_HEADER_0} | Description                | Required |
| --------------- | ----------------- | -------------------------- | -------- |
| `name`          | `event_name`      | Event identifier           | Yes      |
| `external_id`   | `user_id`         | User identifier            | Yes      |
| `timestamp`     | `event_timestamp` | When event occurred        | No       |
| `properties`    | `event_data`      | {PROPERTIES_DESCRIPTION_0} | No       |

### Ejemplo de consulta de eventos

```sql theme={null}
-- Ejemplo: Eventos recientes de alto valor a través de catálogos
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;
```

### Consultas de Data Lake empresarial

```sql theme={null}
-- Ejemplo: Consulta federada a través de fuentes de datos empresariales
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;
```

***

## Opciones de motor de sincronización

### Motor de Sincronización Básico

* Funciona con cualquier catálogo y conector de Starburst
* Seguimiento de estado gestionado por infraestructura de OneSignal
* Configuración más simple sin requisitos adicionales

### Motor de Sincronización Avanzado

* Rendimiento mejorado con seguimiento de estado local
* Requiere catálogo y esquema `CENSUS.CENSUS` dedicado
* Soporta conectores con operaciones de escritura de tabla
* Recomendado para procesamiento de eventos empresariales de alto volumen

***

## Conectores soportados

El Motor de Sincronización Avanzado de OneSignal ha sido probado con:

* **Conector MySQL** (modo lectura-escritura)
* **Conector PostgreSQL** (modo lectura-escritura)
* **Conector Snowflake** (modo lectura-escritura)
* **Conector Iceberg** (con S3 y AWS Glue)
* **Conector Starburst Delta Lake** (con catálogos de AWS Glue)

***

## Características empresariales

### Federación multi-fuente

* Consulta a través de fuentes de datos empresariales en una sola sincronización
* Combina datos de eventos de CRM, warehouse y data lake
* Perfiles de eventos de clientes unificados desde sistemas dispares

### Seguridad y cumplimiento

* Autenticación y autorización de grado empresarial
* Soporte de seguridad a nivel de fila y enmascaramiento de columnas
* Registro de auditoría para rastreo de acceso a datos

***

## Limitaciones

* Conexión TLS requerida (requisito de seguridad de OneSignal)
* El Motor de Sincronización Avanzado requiere soporte de `CREATE OR REPLACE TABLE`
* Warehouse Writeback aún no soportado (próximamente)
* No se pueden proporcionar opciones de tabla personalizadas en la cláusula `WITH`

***

## FAQ

### ¿Cómo obtengo mi hostname de Starburst Enterprise?

Sigue la documentación de Starburst para obtener tu URL JDBC, luego extrae solo la porción de hostname (sin el prefijo `jdbc:trino://`) para usar en OneSignal.

### ¿Puedo consultar múltiples fuentes de datos empresariales?

¡Sí! Las capacidades de consulta federada de Starburst Enterprise te permiten combinar datos de eventos de múltiples fuentes empresariales (Salesforce, SAP, Oracle, etc.) en una sola consulta.

### ¿Qué versión de Starburst soporta el Motor de Sincronización Avanzado?

Verifica las notas de versión de tu Starburst Enterprise para soporte de `CREATE OR REPLACE TABLE`, que es requerido para la funcionalidad del Motor de Sincronización Avanzado.