SQL Server

​

Aperçu

​

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)

​

SQL Server

• Instance SQL Server avec accès réseau
• Utilisateur de base de données avec les autorisations appropriées
• Tables d’événements contenant des données comportementales structurées
• Connectivité réseau de OneSignal vers votre instance SQL Server

​

Configuration

-- Create census user with the ability to sign in with a password
CREATE USER CENSUS WITH PASSWORD = '<strong-unique-password>';

-- Give the census user the ability to connect to database
GRANT CONNECT TO CENSUS;

-- Give the census user the ability to read tables within the database
EXEC sp_addrolemember 'db_datareader', CENSUS;

-- Grant census user ability to read data from within a schema
-- Run this for each schema you intend OneSignal to access
GRANT SELECT, VIEW DEFINITION ON SCHEMA::<your-schema> TO CENSUS;

-- Create a private bookkeeping schema where Census can store sync state
CREATE SCHEMA CENSUS AUTHORIZATION CENSUS;

-- Give the census user full access to the bookkeeping schema
GRANT ALTER, DELETE, EXECUTE, INSERT, REFERENCES, SELECT,
          UPDATE, VIEW DEFINITION ON SCHEMA::CENSUS TO CENSUS;

-- Give the census user the ability to create tables within the database
GRANT CREATE TABLE TO CENSUS;

​

Mappage des données d’événement

​

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

-- Example SQL Server event table
CREATE TABLE analytics.user_events (
    event_id BIGINT IDENTITY(1,1) PRIMARY KEY,
    event_name NVARCHAR(100) NOT NULL,
    user_id NVARCHAR(255) NOT NULL,
    event_timestamp DATETIME2 DEFAULT GETUTCDATE(),
    event_data NVARCHAR(MAX),
    session_id NVARCHAR(255),
    device_type NVARCHAR(50)
);

​

Mode de requête SQL

-- Example: Recent high-value events
SELECT
    event_name,
    user_id,
    event_timestamp,
    event_data
FROM analytics.user_events
WHERE event_timestamp >= DATEADD(day, -7, GETUTCDATE())
    AND JSON_VALUE(event_data, '$.value') > 100
ORDER BY event_timestamp DESC;

​

Configuration réseau avancée

​

Options du moteur de synchronisation

​

Moteur de synchronisation de base

• Accès en lecture seule à vos données d’événements
• Suivi de l’état géré par l’infrastructure OneSignal
• Configuration plus simple avec des autorisations minimales

​

Moteur de synchronisation avancé

• Performances améliorées avec suivi d’état local
• Nécessite des autorisations supplémentaires pour créer des tables
• Recommandé pour le traitement d’événements à haut volume

​

Limitations

• Les requêtes complexes peuvent impacter les performances de la base de données pendant les périodes de fort trafic
• Les opérations JSON nécessitent SQL Server 2016 ou ultérieur pour des performances optimales
• Toutes les autorisations sont accordées au niveau de la base de données spécifiée lors de la configuration

​

FAQ

​

Puis-je me connecter à plusieurs schémas SQL Server ?

​

Quelles versions de SQL Server sont prises en charge ?

​

Dois-je utiliser le moteur de synchronisation avancé ?