PostgreSQL

​

Vue d’ensemble

​

Exigences

• Accès aux 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 pour la synchronisation des événements entrants (Les limitations de forfait et les dépassements s’appliquent)
• Forfait de compte mis à jour (non disponible sur les applications gratuites)

​

PostgreSQL

• PostgreSQL 9.6+ ou base de données compatible
• Utilisateur de base de données avec les permissions appropriées
• Accès réseau de OneSignal à votre instance PostgreSQL
• Tables d’événements contenant des données comportementales structurées

​

Configuration

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

​

Mappage des données d’événement

​

Exemple de schéma de table d’événements

-- 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()
);

​

Mode requête 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;

​

Configuration réseau avancée

• Listes blanches d’IP : Ajoutez les adresses IP de OneSignal à votre pare-feu et pg_hba.conf
• Tunneling SSH : Connectez-vous via un hôte bastion pour les réseaux privés
• Configuration VPC : Connexion directe dans les environnements cloud
• Chiffrement TLS : Connexions sécurisées utilisant SSL/TLS

​

Configuration du tunnel SSH

1. Créer un utilisateur SSH : Configurez un utilisateur dédié sur votre hôte SSH
2. Configurer le tunnel : Activez “Utiliser le tunnel SSH” dans les paramètres d’intégration OneSignal
3. Installer la paire de clés : Ajoutez la clé publique de OneSignal à ~/.ssh/authorized_keys
4. Tester la connexion : Vérifiez la connectivité du tunnel

​

Notes

• Plusieurs schémas : Répétez les octrois de permissions pour chaque schéma contenant des données d’événements
• Vues avec références inter-schémas : Peuvent nécessiter des permissions de lecture supplémentaires dans les anciennes versions de PostgreSQL
• Azure PostgreSQL : Utilisez le format username@hostname pour les instances Azure
• AWS RDS : Utilisez le format standard username
• Performance : Envisagez d’utiliser des réplicas en lecture pour le traitement d’événements à grande échelle

​

Limitations

• Évitez de vous connecter aux bases de données de production en raison de la surcharge des requêtes analytiques
• Les requêtes complexes inter-schémas peuvent nécessiter des permissions supplémentaires
• Le pooling de connexions est recommandé pour le traitement d’événements à haute fréquence

​

FAQ

​

Dois-je utiliser le mode lecture seule ?

​

Comment gérer plusieurs schémas d’événements ?