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

> Starburst Enterprise에서 OneSignal로 사용자 지정 이벤트를 동기화하여 사용자 행동을 기반으로 자동화된 저니 및 개인화된 메시징 캠페인을 트리거하세요.

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"

## 개요

OneSignal + Starburst Enterprise 통합을 통해 Starburst Enterprise 클러스터에서 OneSignal로 사용자 지정 이벤트를 동기화하여 사용자 행동을 기반으로 자동화된 메시징 캠페인 및 저니를 트리거할 수 있습니다.

Starburst Enterprise는 여러 소스에 걸친 엔터프라이즈 분석 및 데이터 레이크 쿼리를 위해 설계된 Trino의 상용 배포판입니다.

***

## 요구사항

* 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

* 네트워크 액세스 권한이 있는 **Starburst Enterprise 클러스터**
* 적절한 권한이 있는 **사용자 자격 증명**
* **TLS 연결** 지원(OneSignal 필수)
* Starburst 카탈로그를 통해 액세스할 수 있는 **이벤트 데이터**

***

## 설정

<Steps>
  <Step title="JDBC 연결 세부정보 가져오기">
    원하는 클러스터의 JDBC URL을 얻으려면 Starburst 문서를 따르세요.

    **JDBC URL 예시:**

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

    **OneSignal용 호스트 이름 추출:**

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

    <Info>
      OneSignal은 JDBC를 사용하여 Starburst Enterprise에 연결합니다. JDBC URL의 호스트 이름 부분만 필요합니다.
    </Info>
  </Step>

  <Step title="Starburst Enterprise 연결 구성">
    OneSignal에서 **Data > Integrations**으로 이동하여 **Add Integration**을 클릭합니다.

    **Starburst Enterprise**를 선택하고 다음 연결 세부정보를 제공하세요:

    * **호스트:** Starburst 클러스터 호스트 이름(1단계에서)
    * **사용자 이름:** Starburst 사용자 이름
    * **비밀번호:** Starburst 비밀번호
    * **포트:** 443(기본값) 또는 사용자 지정 포트
  </Step>

  <Step title="고급 동기화 엔진 구성(선택 사항)">
    향상된 성능을 위해 전용 CENSUS 카탈로그를 설정하세요:

    1. `CENSUS`라는 스키마를 포함하는 `CENSUS`라는 카탈로그를 생성하세요
    2. 커넥터가 다음을 지원하는지 확인하세요:
       * `CREATE TABLE` 및 `DROP TABLE` 작업
       * 테이블 쓰기(INSERT, DELETE, UPDATE)
       * `CREATE OR REPLACE TABLE` 문
    3. OneSignal 사용자에게 `CENSUS.CENSUS` 스키마에 대한 전체 권한을 부여하세요

    <Info>
      테스트된 구성에는 MySQL, PostgreSQL, Snowflake, Iceberg 및 Starburst Delta Lake 커넥터가 포함됩니다.
    </Info>
  </Step>
</Steps>

***

### 이벤트 데이터 매핑

{PLATFORM_0} {DATA_TYPE_0}를 OneSignal의 사용자 지정 이벤트 형식에 매핑합니다:

| OneSignal 필드  | {COLUMN_HEADER_0} | 설명                         | 필수  |
| ------------- | ----------------- | -------------------------- | --- |
| `name`        | `event_name`      | 이벤트 식별자                    | Yes |
| `external_id` | `user_id`         | 사용자 식별자                    | Yes |
| `timestamp`   | `event_timestamp` | 이벤트가 발생한 시간                | No  |
| `properties`  | `event_data`      | {PROPERTIES_DESCRIPTION_0} | No  |

### 예시 이벤트 쿼리

```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;
```

### 엔터프라이즈 데이터 레이크 쿼리

```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;
```

***

## 동기화 엔진 옵션

### 기본 동기화 엔진

* 모든 Starburst 카탈로그 및 커넥터와 작동
* OneSignal 인프라에서 관리하는 상태 추적
* 추가 요구사항 없이 더 간단한 설정

### 고급 동기화 엔진

* 로컬 상태 추적으로 향상된 성능
* 전용 `CENSUS.CENSUS` 카탈로그 및 스키마 필요
* 테이블 쓰기 작업이 있는 커넥터 지원
* 대용량 엔터프라이즈 이벤트 처리에 권장

***

## 지원되는 커넥터

OneSignal의 고급 동기화 엔진은 다음으로 테스트되었습니다:

* **MySQL 커넥터**(읽기-쓰기 모드)
* **PostgreSQL 커넥터**(읽기-쓰기 모드)
* **Snowflake 커넥터**(읽기-쓰기 모드)
* **Iceberg 커넥터**(S3 및 AWS Glue 포함)
* **Starburst Delta Lake 커넥터**(AWS Glue 카탈로그 포함)

***

## 엔터프라이즈 기능

### 다중 소스 페더레이션

* 단일 동기화에서 엔터프라이즈 데이터 소스 간 쿼리
* CRM, 웨어하우스 및 데이터 레이크 이벤트 데이터 결합
* 서로 다른 시스템의 통합 고객 이벤트 프로필

### 보안 및 규정 준수

* 엔터프라이즈급 인증 및 권한 부여
* 행 수준 보안 및 열 마스킹 지원
* 데이터 액세스 추적을 위한 감사 로깅

***

## 제한사항

* TLS 연결 필요(OneSignal 보안 요구사항)
* 고급 동기화 엔진은 `CREATE OR REPLACE TABLE` 지원 필요
* 웨어하우스 라이트백은 아직 지원되지 않음(곧 출시 예정)
* `WITH` 절에서 사용자 지정 테이블 옵션을 제공할 수 없음

***

## FAQ

### Starburst Enterprise 호스트 이름을 어떻게 얻나요?

JDBC URL을 얻으려면 Starburst 문서를 따른 다음 OneSignal에서 사용하기 위해 호스트 이름 부분만(`jdbc:trino://` 접두사 제외) 추출하세요.

### 여러 엔터프라이즈 데이터 소스를 쿼리할 수 있나요?

예! Starburst Enterprise의 페더레이션 쿼리 기능을 사용하면 단일 쿼리에서 여러 엔터프라이즈 소스(Salesforce, SAP, Oracle 등)의 이벤트 데이터를 결합할 수 있습니다.

### 어떤 Starburst 릴리스가 고급 동기화 엔진을 지원하나요?

고급 동기화 엔진 기능에 필요한 `CREATE OR REPLACE TABLE` 지원에 대해서는 Starburst Enterprise 릴리스 노트를 확인하세요.