PostgreSQL

​

개요

​

요구 사항

• Access to Event Streams for outbound message events (Plan limitations and overages apply)
• Access to Custom Events for inbound event syncing (Plan limitations and overages apply)
• Updated Account Plan (not available on free apps)

​

PostgreSQL

• PostgreSQL 9.6+ 또는 호환 가능한 데이터베이스
• 적절한 권한이 있는 데이터베이스 사용자
• OneSignal에서 PostgreSQL 인스턴스로의 네트워크 액세스
• 구조화된 행동 데이터가 포함된 이벤트 테이블

​

설정

-- Create OneSignal user with strong password
CREATE USER CENSUS WITH PASSWORD '<strong-unique-password>';

-- Create private bookkeeping schema for sync state (skip if read-only mode)
CREATE SCHEMA CENSUS;

-- Grant full access to bookkeeping schema (skip if read-only mode)
GRANT ALL ON SCHEMA CENSUS TO CENSUS;

-- Ensure access to existing objects in bookkeeping schema (skip if read-only mode)
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA CENSUS TO CENSUS;

-- Grant schema access (repeat for each schema with event data)
GRANT USAGE ON SCHEMA "<your_schema>" TO CENSUS;

-- Grant read access to existing tables
GRANT SELECT ON ALL TABLES IN SCHEMA "<your_schema>" TO CENSUS;

-- Grant read access to future tables
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_schema>" GRANT SELECT ON TABLES TO CENSUS;

-- Grant execute permissions on functions
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA "<your_schema>" TO CENSUS;
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_schema>" GRANT EXECUTE ON FUNCTIONS TO CENSUS;

​

이벤트 데이터 매핑

​

예시 이벤트 테이블 스키마

-- Example PostgreSQL event table
CREATE TABLE analytics.user_events (
    event_id SERIAL PRIMARY KEY,
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    event_timestamp TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    event_data JSONB,
    session_id VARCHAR(255),
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);

​

SQL 쿼리 모드

-- Example: Recent purchase events
SELECT
    event_name,
    user_id,
    event_timestamp,
    event_data
FROM analytics.user_events
WHERE event_timestamp >= NOW() - INTERVAL '7 days'
    AND event_name = 'purchase'
ORDER BY event_timestamp DESC;

​

고급 네트워크 구성

• IP 허용 목록: 방화벽 및 pg_hba.conf에 OneSignal의 IP 주소를 추가하세요
• SSH 터널링: 프라이빗 네트워크를 위해 베스천 호스트를 통해 연결하세요
• VPC 구성: 클라우드 환경 내에서 직접 연결하세요
• TLS 암호화: SSL/TLS를 사용하여 안전한 연결을 구성하세요

​

SSH 터널 설정

1. SSH 사용자 생성: SSH 호스트에서 전용 사용자를 설정하세요
2. 터널 구성: OneSignal 통합 설정에서 “Use SSH Tunnel”을 활성화하세요
3. 키 페어 설치: OneSignal의 공개 키를 ~/.ssh/authorized_keys에 추가하세요
4. 연결 테스트: 터널 연결을 확인하세요

​

참고 사항

• 다중 스키마: 이벤트 데이터가 포함된 각 스키마에 대해 권한 부여를 반복하세요
• 교차 스키마 참조가 있는 뷰: 이전 PostgreSQL 버전에서는 추가 읽기 권한이 필요할 수 있습니다
• Azure PostgreSQL: Azure 인스턴스의 경우 username@hostname 형식을 사용하세요
• AWS RDS: 표준 username 형식을 사용하세요
• 성능: 대규모 이벤트 처리를 위해 읽기 복제본 사용을 고려하세요

​

제한 사항

• 분석 쿼리 오버헤드로 인해 프로덕션 데이터베이스에 연결하지 마세요
• 복잡한 교차 스키마 쿼리에는 추가 권한이 필요할 수 있습니다
• 고빈도 이벤트 처리에는 연결 풀링을 권장합니다

​

FAQ

​

읽기 전용 모드를 사용해야 하나요?

​

여러 이벤트 스키마를 어떻게 처리하나요?