{-# LANGUAGE QuasiQuotes #-} {-# LANGUAGE TemplateHaskell #-} module Hasura.Backends.MSSQL.DDL.EventTrigger ( createTableEventTrigger, fetchUndeliveredEvents, setRetry, recordSuccess, recordError, recordError', dropTriggerQ, dropTriggerAndArchiveEvents, dropDanglingSQLTrigger, redeliverEvent, insertManualEvent, unlockEventsInSource, getMaintenanceModeVersion, qualifyTableName, createMissingSQLTriggers, checkIfTriggerExists, addCleanupSchedules, deleteAllScheduledCleanups, getCleanupEventsForDeletion, updateCleanupEventStatusToDead, updateCleanupEventStatusToPaused, updateCleanupEventStatusToCompleted, deleteEventTriggerLogs, ) where import Control.Monad.Trans.Control (MonadBaseControl) import Data.Aeson qualified as J import Data.ByteString qualified as B import Data.ByteString.Lazy qualified as BL import Data.FileEmbed (makeRelativeToProject) import Data.HashMap.Strict qualified as Map import Data.HashSet qualified as HashSet import Data.Set.NonEmpty qualified as NE import Data.Text qualified as T import Data.Text.Extended (ToTxt, commaSeparated, toTxt) import Data.Text.Lazy qualified as LT import Data.Text.NonEmpty (mkNonEmptyTextUnsafe) import Data.Time import Data.Time.Format.ISO8601 (iso8601Show) import Database.MSSQL.Transaction (TxE, TxET, multiRowQueryE, singleRowQueryE, unitQueryE) import Database.ODBC.SQLServer (Datetime2 (..), Datetimeoffset (..), rawUnescapedText, toSql) import Database.ODBC.TH qualified as ODBC import Hasura.Backends.MSSQL.Connection import Hasura.Backends.MSSQL.DDL.Source.Version import Hasura.Backends.MSSQL.SQL.Error qualified as HGE import Hasura.Backends.MSSQL.ToQuery (fromTableName, toQueryFlat) import Hasura.Backends.MSSQL.Types (SchemaName (..), TableName (..)) import Hasura.Backends.MSSQL.Types.Internal (columnNameText, geoTypes) import Hasura.Base.Error import Hasura.Eventing.Common import Hasura.Prelude import Hasura.RQL.Types.Column import Hasura.RQL.Types.Common import Hasura.RQL.Types.EventTrigger import Hasura.RQL.Types.Eventing (EventId (..), OpVar (..)) import Hasura.RQL.Types.Source import Hasura.RQL.Types.Table (PrimaryKey (..)) import Hasura.SQL.Backend import Hasura.SQL.Types import Hasura.Server.Types import Hasura.Session import Hasura.Tracing qualified as Tracing import Text.Builder qualified as TB import Text.Shakespeare.Text qualified as ST -- | creates a SQL Values list from haskell list (('123-abc'), ('456-vgh'), ('234-asd')) generateSQLValuesFromList :: (ToTxt a) => [a] -> Text generateSQLValuesFromList = generateSQLValuesFromListWith (\t -> "'" <> toTxt t <> "'") generateSQLValuesFromListWith :: (a -> Text) -> [a] -> Text generateSQLValuesFromListWith f events = commaSeparated values where values = map (\e -> "(" <> f e <> ")") events fetchUndeliveredEvents :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> SourceName -> [TriggerName] -> MaintenanceMode () -> FetchBatchSize -> m [Event 'MSSQL] fetchUndeliveredEvents sourceConfig sourceName triggerNames _ fetchBatchSize = do liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ fetchEvents sourceName triggerNames fetchBatchSize setRetry :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> Event 'MSSQL -> UTCTime -> MaintenanceMode MaintenanceModeVersion -> m () setRetry sourceConfig event retryTime maintenanceModeVersion = do liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ setRetryTx event retryTime maintenanceModeVersion insertManualEvent :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> TableName -> TriggerName -> J.Value -> UserInfo -> Tracing.TraceContext -> m EventId insertManualEvent sourceConfig tableName triggerName payload _userInfo _traceCtx = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ -- TODO: Include TraceContext in payload insertMSSQLManualEventTx tableName triggerName payload getMaintenanceModeVersion :: ( MonadIO m, MonadError QErr m ) => MSSQLSourceConfig -> m MaintenanceModeVersion getMaintenanceModeVersion sourceConfig = liftEitherM $ liftIO $ runMSSQLSourceReadTx sourceConfig $ getMaintenanceModeVersionTx recordSuccess :: (MonadIO m) => MSSQLSourceConfig -> Event 'MSSQL -> Invocation 'EventType -> MaintenanceMode MaintenanceModeVersion -> m (Either QErr ()) recordSuccess sourceConfig event invocation maintenanceModeVersion = liftIO $ runMSSQLSourceWriteTx sourceConfig $ do insertInvocation (tmName (eTrigger event)) invocation setSuccessTx event maintenanceModeVersion recordError :: (MonadIO m) => MSSQLSourceConfig -> Event 'MSSQL -> Invocation 'EventType -> ProcessEventError -> MaintenanceMode MaintenanceModeVersion -> m (Either QErr ()) recordError sourceConfig event invocation processEventError maintenanceModeVersion = recordError' sourceConfig event (Just invocation) processEventError maintenanceModeVersion recordError' :: (MonadIO m) => MSSQLSourceConfig -> Event 'MSSQL -> Maybe (Invocation 'EventType) -> ProcessEventError -> MaintenanceMode MaintenanceModeVersion -> m (Either QErr ()) recordError' sourceConfig event invocation processEventError maintenanceModeVersion = liftIO $ runMSSQLSourceWriteTx sourceConfig $ do for_ invocation $ insertInvocation (tmName (eTrigger event)) case processEventError of PESetRetry retryTime -> do setRetryTx event retryTime maintenanceModeVersion PESetError -> setErrorTx event maintenanceModeVersion redeliverEvent :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> EventId -> m () redeliverEvent sourceConfig eventId = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ do checkEventTx eventId markForDeliveryTx eventId dropTriggerAndArchiveEvents :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> TriggerName -> TableName -> m () dropTriggerAndArchiveEvents sourceConfig triggerName table = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ do dropTriggerQ triggerName (tableSchema table) archiveEvents triggerName dropDanglingSQLTrigger :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> TriggerName -> TableName -> HashSet Ops -> m () dropDanglingSQLTrigger sourceConfig triggerName table ops = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ do traverse_ (dropTriggerOp triggerName (tableSchema table)) ops createTableEventTrigger :: MonadIO m => ServerConfigCtx -> MSSQLSourceConfig -> TableName -> [ColumnInfo 'MSSQL] -> TriggerName -> TriggerOnReplication -> TriggerOpsDef 'MSSQL -> Maybe (PrimaryKey 'MSSQL (ColumnInfo 'MSSQL)) -> m (Either QErr ()) createTableEventTrigger _serverConfigCtx sourceConfig table columns triggerName triggerOnReplication opsDefinition primaryKeyMaybe = do liftIO $ runMSSQLSourceWriteTx sourceConfig $ do mkAllTriggersQ triggerName table triggerOnReplication columns opsDefinition primaryKeyMaybe createMissingSQLTriggers :: ( MonadIO m, MonadError QErr m, MonadBaseControl IO m ) => MSSQLSourceConfig -> TableName -> ([ColumnInfo 'MSSQL], Maybe (PrimaryKey 'MSSQL (ColumnInfo 'MSSQL))) -> TriggerName -> TriggerOnReplication -> TriggerOpsDef 'MSSQL -> m () createMissingSQLTriggers sourceConfig table@(TableName tableNameText (SchemaName schemaText)) (allCols, primaryKeyMaybe) triggerName triggerOnReplication opsDefinition = do liftEitherM $ runMSSQLSourceWriteTx sourceConfig $ do for_ (tdInsert opsDefinition) (doesSQLTriggerExist INSERT) for_ (tdUpdate opsDefinition) (doesSQLTriggerExist UPDATE) for_ (tdDelete opsDefinition) (doesSQLTriggerExist DELETE) where doesSQLTriggerExist op opSpec = do let triggerNameWithOp = "notify_hasura_" <> triggerNameToTxt triggerName <> "_" <> tshow op doesOpTriggerExist <- liftMSSQLTx $ singleRowQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| SELECT CASE WHEN EXISTS ( SELECT 1 FROM sys.triggers tr INNER join sys.tables tb on tr.parent_id = tb.object_id INNER join sys.schemas s on tb.schema_id = s.schema_id WHERE tb.name = $tableNameText AND tr.name = $triggerNameWithOp AND s.name = $schemaText ) THEN CAST(1 AS BIT) ELSE CAST(0 AS BIT) END; |] unless doesOpTriggerExist $ do case op of INSERT -> mkInsertTriggerQ triggerName table allCols triggerOnReplication opSpec UPDATE -> mkUpdateTriggerQ triggerName table allCols triggerOnReplication primaryKeyMaybe opSpec DELETE -> mkDeleteTriggerQ triggerName table allCols triggerOnReplication opSpec MANUAL -> pure () unlockEventsInSource :: MonadIO m => MSSQLSourceConfig -> NE.NESet EventId -> m (Either QErr Int) unlockEventsInSource sourceConfig eventIds = liftIO $ runMSSQLSourceWriteTx sourceConfig $ do unlockEventsTx $ toList eventIds -- Check if any trigger for any of the operation exists with the 'triggerName' checkIfTriggerExists :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> TriggerName -> HashSet Ops -> m Bool checkIfTriggerExists sourceConfig triggerName ops = do liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ fmap or (traverse (checkIfTriggerExistsQ triggerName) (HashSet.toList ops)) ---- DATABASE QUERIES --------------------- -- -- The API for our in-database work queue: ------------------------------------------- insertInvocation :: TriggerName -> Invocation 'EventType -> TxE QErr () insertInvocation tName invo = do unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| INSERT INTO hdb_catalog.event_invocation_logs (event_id, trigger_name, status, request, response) VALUES ($invoEventId, $invoTriggerName, $invoStatus, $invoRequest, $invoResponse) |] unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| UPDATE hdb_catalog.event_log SET tries = tries + 1 WHERE id = $invoEventId |] where invoEventId = unEventId $ iEventId invo invoStatus = fromIntegral <$> iStatus invo :: Maybe Int invoRequest = J.encode $ J.toJSON $ iRequest invo invoResponse = J.encode $ J.toJSON $ iResponse invo invoTriggerName = triggerNameToTxt tName insertMSSQLManualEventTx :: TableName -> TriggerName -> J.Value -> TxE QErr EventId insertMSSQLManualEventTx (TableName tableName (SchemaName schemaName)) triggerName rowData = do eventId <- singleRowQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| INSERT INTO hdb_catalog.event_log (schema_name, table_name, trigger_name, payload) OUTPUT CONVERT(varchar(MAX), inserted.id) VALUES ($schemaName, $tableName, $triggerNameTxt, $payload) |] return (EventId (bsToTxt eventId)) where triggerNameTxt = triggerNameToTxt triggerName payload = J.encode rowData setSuccessTx :: Event 'MSSQL -> MaintenanceMode MaintenanceModeVersion -> TxE QErr () setSuccessTx event = \case (MaintenanceModeEnabled PreviousMMVersion) -> throw500 "unexpected: no previous maintenance mode version found for MSSQL source" (MaintenanceModeEnabled CurrentMMVersion) -> latestVersionSetSuccess MaintenanceModeDisabled -> latestVersionSetSuccess where eventId = unEventId $ eId event latestVersionSetSuccess = unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| UPDATE hdb_catalog.event_log SET delivered = 1 , next_retry_at = NULL, locked = NULL WHERE id = $eventId |] setErrorTx :: Event 'MSSQL -> MaintenanceMode MaintenanceModeVersion -> TxE QErr () setErrorTx event = \case (MaintenanceModeEnabled PreviousMMVersion) -> throw500 "unexpected: there is no previous maintenance mode version supported for MSSQL event triggers" (MaintenanceModeEnabled CurrentMMVersion) -> latestVersionSetSuccess MaintenanceModeDisabled -> latestVersionSetSuccess where eventId = unEventId $ eId event latestVersionSetSuccess = unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| UPDATE hdb_catalog.event_log SET error = 1 , next_retry_at = NULL, locked = NULL WHERE id = $eventId |] -- See Note [UTCTIME not supported in SQL Server] setRetryTx :: Event 'MSSQL -> UTCTime -> MaintenanceMode MaintenanceModeVersion -> TxE QErr () setRetryTx event utcTime maintenanceMode = do time <- convertUTCToDatetime2 utcTime case maintenanceMode of (MaintenanceModeEnabled PreviousMMVersion) -> throw500 "unexpected: there is no previous maintenance mode version supported for MSSQL event triggers" (MaintenanceModeEnabled CurrentMMVersion) -> latestVersionSetRetry time MaintenanceModeDisabled -> latestVersionSetRetry time where eventId = unEventId $ eId event -- NOTE: Naveen: The following method to convert from Datetime to Datetimeoffset was -- taken from https://stackoverflow.com/questions/17866311/how-to-cast-datetime-to-datetimeoffset latestVersionSetRetry time = unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| UPDATE hdb_catalog.event_log SET next_retry_at = TODATETIMEOFFSET ($time, DATEPART(TZOFFSET, SYSDATETIMEOFFSET())), locked = NULL WHERE id = $eventId |] -- | Lock and return events not yet being processed or completed, up to some -- limit. Process events approximately in created_at order, but we make no -- ordering guarentees; events can and will race. Nevertheless we want to -- ensure newer change events don't starve older ones. fetchEvents :: SourceName -> [TriggerName] -> FetchBatchSize -> TxE QErr [Event 'MSSQL] fetchEvents source triggerNames (FetchBatchSize fetchBatchSize) = do -- The reason we do not inline the SQL but rather create a template string is due -- to the problem with `ODBC.sql` variable substitution. When you use a variable -- whose value is a text and it contains a single quote `'`, the `ODBC.sql` -- function escapes that single quote. i.e it converts `'` to `''` -- -- Note: A single quote in MSSQL is escaped by doubling it up (`''`) -- -- This is problematic, since we use a list of list of trigger names to fetch and -- lock the events. A list of trigger names in MSSQL looks like Eg: -- ('insert_test_books', 'et_test_bigint') -- -- We use this list of trigger names in the `IN` operator to fetch only those -- events. -- -- If we were to use the `ODBC.sql` function it would convert the list into -- something which is not a valid list. -- Eg: ('insert_test_books', 'et_test_bigint') -> (''insert_test_books'', ''et_test_bigint'') -- -- Due to the problematic variable substitution of `ODBC.sql` it is imperative that -- we resort to template strings, since that does not do any changes to the string. events <- multiRowQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText . LT.toStrict $ $(makeRelativeToProject "src-rsr/mssql/mssql_fetch_events.sql.shakespeare" >>= ST.stextFile) mapM uncurryEvent events where -- Creates a list of trigger names to be used for 'IN' operator -- Eg: ('insert_test_books', 'et_test_bigint') -- -- We cannot use 'commaseperated()' because it creates the Text as -- 'insert_test_books, et_test_bigint' which is not useful to compare values in -- 'IN' MSSQL operator. triggerNamesTxt = "(" <> commaSeparated (map (\t -> "'" <> toTxt t <> "'") triggerNames) <> ")" uncurryEvent (id', sn, tn, trn, payload' :: BL.ByteString, tries, created_at :: B.ByteString, next_retry_at :: Maybe B.ByteString) = do payload <- encodePayload payload' createdAt <- convertTime created_at retryAt <- traverse convertTime next_retry_at pure $ Event { eId = EventId (bsToTxt id'), eSource = source, eTable = (TableName tn (SchemaName sn)), eTrigger = TriggerMetadata (TriggerName $ mkNonEmptyTextUnsafe trn), eEvent = payload, eTries = tries, eCreatedAt = createdAt, eRetryAt = retryAt } -- Note: We do not have JSON datatype in SQL Server. But since in -- 'mkAllTriggersQ' we ensure that all the values in the payload column of -- hdb_catalog.event_log is always a JSON. We can directly decode the payload -- value and not worry that the decoding will fail. -- -- We ensure that the values in 'hd_catalog.event_log' is always a JSON is by -- using the 'FOR JSON PATH' MSSQL operand when inserting value into the -- 'hdb_catalog.event_log' table. encodePayload :: (J.FromJSON a, QErrM m) => BL.ByteString -> m a encodePayload payload = onLeft (J.eitherDecode payload) (\_ -> throw500 $ T.pack "payload decode failed while fetching MSSQL events") -- Note: The ODBC server does not have a FromJSON instance of UTCTime and only -- supports DateTime2 and SmallDateTime. But the above two data types do not -- have time offsets and 'Event' stores the time as UTCTime. But during -- 'mkAllTriggersQ' we do save them as UTC Time format. So we can directly decode -- the time we get from the DB as UTCTime and not worry about exception being -- thrown during decoding. -- -- We ensure that the time stored in 'create_at' column is a UTCTime, by -- defaulting the 'created_at' column to use 'SYSDATETIMEOFFSET()' MSSQL function -- in 'init_mssql_source.sql' file. The 'SYSDATETIMEOFFSET()' function returns -- value that contains the date and time of the computer on which the instance of -- SQL Server is running. The time zone offset is included. convertTime :: (QErrM m) => B.ByteString -> m UTCTime convertTime createdAt = onLeft (readEither (T.unpack $ bsToTxt createdAt) :: Either String UTCTime) (\_ -> throw500 $ T.pack "conversion to UTCTime failed while fetching MSSQL events") dropTriggerQ :: TriggerName -> SchemaName -> TxE QErr () dropTriggerQ triggerName schemaName = mapM_ (dropTriggerOp triggerName schemaName) [INSERT, UPDATE, DELETE] dropTriggerOp :: TriggerName -> SchemaName -> Ops -> TxE QErr () dropTriggerOp triggerName schemaName triggerOp = unitQueryE HGE.defaultMSSQLTxErrorHandler (rawUnescapedText $ getDropTriggerSQL triggerOp) where getDropTriggerSQL :: Ops -> Text getDropTriggerSQL op = "DROP TRIGGER IF EXISTS " <> qualifiedTriggerNameToText (QualifiedTriggerName schemaName (mkSQLTriggerName triggerName op)) archiveEvents :: TriggerName -> TxE QErr () archiveEvents triggerName = unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| UPDATE hdb_catalog.event_log SET archived = 1 WHERE trigger_name = $triggerNameTxt |] where triggerNameTxt = triggerNameToTxt triggerName checkEventTx :: EventId -> TxE QErr () checkEventTx eventId = do -- If an event got locked within the last 30 minutes then it means that the event -- got picked up by during the last fetch-event poll and is being processed. Hence -- we do not allow the redelivery of such an event. (events :: [Bool]) <- multiRowQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| SELECT CAST(CASE WHEN (l.locked IS NOT NULL AND l.locked >= DATEADD(MINUTE, -30, SYSDATETIMEOFFSET())) THEN 1 ELSE 0 END AS bit) FROM hdb_catalog.event_log l WHERE l.id = $eId |] event <- getEvent events assertEventUnlocked event where eId = unEventId $ eventId getEvent [] = throw400 NotExists "event not found" getEvent (x : _) = return x assertEventUnlocked locked = when locked $ throw400 Busy "event is already being processed" markForDeliveryTx :: EventId -> TxE QErr () markForDeliveryTx eventId = do unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| UPDATE hdb_catalog.event_log SET delivered = 0, error = 0, tries = 0 WHERE id = $eId |] where eId = unEventId $ eventId unlockEventsTx :: [EventId] -> TxE QErr Int unlockEventsTx eventIds = do numEvents <- singleRowQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText . LT.toStrict $ -- EventIds as list of VALUES (Eg: ('123-abc'), ('456-vgh'), ('234-asd')) let eventIdsValues = generateValuesFromEvents eventIds in $(makeRelativeToProject "src-rsr/mssql/mssql_unlock_events.sql.shakespeare" >>= ST.stextFile) return numEvents where generateValuesFromEvents :: [EventId] -> Text -- creates a list of event id's (('123-abc'), ('456-vgh'), ('234-asd')) generateValuesFromEvents events = commaSeparated values where values = map (\e -> "(" <> toTxt e <> ")") events getMaintenanceModeVersionTx :: TxE QErr MaintenanceModeVersion getMaintenanceModeVersionTx = do catalogVersion <- getSourceCatalogVersion if | catalogVersion == latestSourceCatalogVersion -> pure CurrentMMVersion | otherwise -> throw500 $ "Maintenance mode is only supported with catalog versions: " <> tshow latestSourceCatalogVersion <> " but received " <> tshow catalogVersion -- | Note: UTCTIME not supported in SQL Server -- -- Refer 'ToSql UTCTIME' instance of odbc package: -- https://github.com/fpco/odbc/blob/f4f04ea15d14e9a3ed455f7c728dc08734eef8ae/src/Database/ODBC/SQLServer.hs#L377 -- -- We use SYSDATETIMEOFFSET() to store time values along with it's time -- zone offset in event_log table. Since ODBC server does not support time zones, -- we use a workaround. -- -- We wrap the time value in Datetime2, but before we insert it into the -- event_log table we convert it into UTCTIME using the 'TODATETIMEOFFSET()' -- sql function. convertUTCToDatetime2 :: MonadIO m => UTCTime -> m Datetime2 convertUTCToDatetime2 utcTime = do timezone <- liftIO $ getTimeZone utcTime let localTime = utcToLocalTime timezone utcTime return $ Datetime2 localTime checkIfTriggerExistsQ :: TriggerName -> Ops -> TxE QErr Bool checkIfTriggerExistsQ triggerName op = do let triggerNameWithOp = "notify_hasura_" <> triggerNameToTxt triggerName <> "_" <> tshow op liftMSSQLTx $ singleRowQueryE HGE.defaultMSSQLTxErrorHandler -- We check the existence of trigger across the entire database irrespective of -- the schema of the table [ODBC.sql| SELECT CASE WHEN EXISTS ( SELECT 1 FROM sys.triggers WHERE name = $triggerNameWithOp ) THEN CAST(1 AS BIT) ELSE CAST(0 AS BIT) END; |] ---- MSSQL event trigger utility functions ----------------- -- | This will quote the object name (similar to the @QUOTENAME@ function in SQL -- server), i.e. -- -- >>> mssqlFmtIdentifier "object_name" "[object_name]" -- -- >>> mssqlFmtIdentifier "o]bject_nam[e" "[o]]bject_nam[e]" -- -- TODO: Use some external tool for quoting, we should not quote the names by -- ourselves. mssqlFmtIdentifier :: Text -> Text mssqlFmtIdentifier x = "[" <> T.replace "]" "]]" x <> "]" -- | A Representation of SQL Trigger name for an event trigger in MSSQL. newtype SQLTriggerName = SQLTriggerName {getSQLTriggerName :: Text} instance ToSQL SQLTriggerName where toSQL = TB.text . mssqlFmtIdentifier . getSQLTriggerName mkSQLTriggerName :: TriggerName -> Ops -> SQLTriggerName mkSQLTriggerName triggerName op = SQLTriggerName $ "notify_hasura_" <> (triggerNameToTxt triggerName) <> "_" <> tshow op -- | A Representation of qualified SQL trigger object (`schema_name.SQL_trigger_name`). data QualifiedTriggerName = QualifiedTriggerName { _qtnSchemaName :: SchemaName, _qtnTriggerName :: SQLTriggerName } instance ToSQL QualifiedTriggerName where toSQL (QualifiedTriggerName (SchemaName schemaName) triggerName) = TB.text (mssqlFmtIdentifier schemaName) <> "." <> toSQL triggerName qualifiedTriggerNameToText :: QualifiedTriggerName -> Text qualifiedTriggerNameToText = TB.run . toSQL -- | Store a fragment of SQL expression newtype SQLFragment = SQLFragment {unSQLFragment :: Text} mkAllTriggersQ :: MonadMSSQLTx m => TriggerName -> TableName -> TriggerOnReplication -> [ColumnInfo 'MSSQL] -> TriggerOpsDef 'MSSQL -> Maybe (PrimaryKey 'MSSQL (ColumnInfo 'MSSQL)) -> m () mkAllTriggersQ triggerName tableName triggerOnReplication allCols fullSpec primaryKey = do for_ (tdInsert fullSpec) (mkInsertTriggerQ triggerName tableName allCols triggerOnReplication) for_ (tdDelete fullSpec) (mkDeleteTriggerQ triggerName tableName allCols triggerOnReplication) for_ (tdUpdate fullSpec) (mkUpdateTriggerQ triggerName tableName allCols triggerOnReplication primaryKey) getApplicableColumns :: [ColumnInfo 'MSSQL] -> SubscribeColumns 'MSSQL -> [ColumnInfo 'MSSQL] getApplicableColumns allColumnInfos = \case SubCStar -> allColumnInfos SubCArray cols -> getColInfos cols allColumnInfos -- | Currently we do not support Event Triggers on columns of Spatial data types. -- We do this because, currently the graphQL API for these types is broken -- for MSSQL sources. Ref: https://github.com/hasura/graphql-engine-mono/issues/787 checkSpatialDataTypeColumns :: MonadMSSQLTx m => [ColumnInfo 'MSSQL] -> SubscribeOpSpec 'MSSQL -> m () checkSpatialDataTypeColumns allCols (SubscribeOpSpec listenCols deliveryCols) = do let listenColumns = getApplicableColumns allCols listenCols deliveryColumns = getApplicableColumns allCols $ fromMaybe SubCStar deliveryCols isGeoTypesInListenCols = any (isScalarColumnWhere isGeoType . ciType) listenColumns isGeoTypesInDeliversCols = any (isScalarColumnWhere isGeoType . ciType) deliveryColumns when (isGeoTypesInListenCols || isGeoTypesInDeliversCols) $ throw400 NotSupported "Event triggers for MS-SQL sources are not supported on tables having Geometry or Geography column types" where isGeoType = (`elem` geoTypes) mkInsertTriggerQ :: MonadMSSQLTx m => TriggerName -> TableName -> [ColumnInfo 'MSSQL] -> TriggerOnReplication -> SubscribeOpSpec 'MSSQL -> m () mkInsertTriggerQ triggerName table allCols triggerOnReplication subOpSpec@(SubscribeOpSpec _listenCols deliveryCols) = do checkSpatialDataTypeColumns allCols subOpSpec liftMSSQLTx $ do unitQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText . LT.toStrict $ do let deliveryColumns = getApplicableColumns allCols $ fromMaybe SubCStar deliveryCols mkInsertTriggerQuery table triggerName deliveryColumns triggerOnReplication mkDeleteTriggerQ :: MonadMSSQLTx m => TriggerName -> TableName -> [ColumnInfo 'MSSQL] -> TriggerOnReplication -> SubscribeOpSpec 'MSSQL -> m () mkDeleteTriggerQ triggerName table allCols triggerOnReplication subOpSpec@(SubscribeOpSpec _listenCols deliveryCols) = do checkSpatialDataTypeColumns allCols subOpSpec liftMSSQLTx $ do unitQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText . LT.toStrict $ do let deliveryColumns = getApplicableColumns allCols $ fromMaybe SubCStar deliveryCols mkDeleteTriggerQuery table triggerName deliveryColumns triggerOnReplication mkUpdateTriggerQ :: MonadMSSQLTx m => TriggerName -> TableName -> [ColumnInfo 'MSSQL] -> TriggerOnReplication -> Maybe (PrimaryKey 'MSSQL (ColumnInfo 'MSSQL)) -> SubscribeOpSpec 'MSSQL -> m () mkUpdateTriggerQ triggerName table allCols triggerOnReplication primaryKeyMaybe subOpSpec@(SubscribeOpSpec listenCols deliveryCols) = do checkSpatialDataTypeColumns allCols subOpSpec liftMSSQLTx $ do primaryKey <- onNothing primaryKeyMaybe (throw400 NotSupported "Update event triggers for MS-SQL sources are only supported on tables with primary keys") let deliveryColumns = getApplicableColumns allCols $ fromMaybe SubCStar deliveryCols listenColumns = getApplicableColumns allCols listenCols unitQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText . LT.toStrict $ mkUpdateTriggerQuery table triggerName listenColumns deliveryColumns primaryKey triggerOnReplication -- Create alias for columns -- eg: If colPrefixMaybe is defined then 'inserted.id as payload.data.old.id' -- else 'id as payload.data.old.id' -- We create such an alias for the columns of the table because it helps in -- structuring the JSON payload. generateColumnTriggerAlias :: OpVar -> Maybe Text -> ColumnInfo 'MSSQL -> SQLFragment generateColumnTriggerAlias op colPrefixMaybe colInfo = let opText = case op of OLD -> "old" NEW -> "new" -- Let's say we have a column 'id', dbColNameText returns the column name as -- text. i.e 'id' dbColNameText = columnNameText $ ciColumn colInfo joinPrefixedDbColNameText = case colPrefixMaybe of -- prefix with the joining table's name -- `id` -> `inserted.id` (prefix = 'inserted') Just colPrefix -> colPrefix <> "." <> dbColNameText -- do not prefix anthing to the column name Nothing -> dbColNameText -- create the alias for the column -- `payload.data.old.id` (opText = old) (dbColNameText = id) dbColAlias = "payload.data" <> "." <> opText <> "." <> dbColNameText in -- create the SQL alias using the `as` keyword -- If colPrefixMaybe existed then alias will be `inserted.id as payload.data.old.id` -- If no colPrefixMaybe was Nothing then alias will be 'id as payload.data.old.id` SQLFragment $ LT.toStrict $ [ST.stext| #{joinPrefixedDbColNameText} as [#{dbColAlias}]|] -- Converts tables name to the format [SCHEMA].[TABLENAME] -- eg: [dbo].[author], [hge].[books] qualifyTableName :: TableName -> Text qualifyTableName = toTxt . toQueryFlat . fromTableName mkInsertTriggerQuery :: TableName -> TriggerName -> [ColumnInfo 'MSSQL] -> TriggerOnReplication -> LT.Text mkInsertTriggerQuery table@(TableName tableName schema@(SchemaName schemaName)) triggerName columns triggerOnReplication = let qualifiedTriggerName = qualifiedTriggerNameToText $ QualifiedTriggerName schema $ mkSQLTriggerName triggerName INSERT triggerNameText = triggerNameToTxt triggerName qualifiedTableName = qualifyTableName table operation = tshow INSERT replicationClause :: String = if triggerOnReplication /= TOREnableTrigger then "NOT FOR REPLICATION" else "" deliveryColsSQLExpression :: Text = commaSeparated $ map (unSQLFragment . generateColumnTriggerAlias NEW Nothing) columns in $(makeRelativeToProject "src-rsr/mssql/mssql_insert_trigger.sql.shakespeare" >>= ST.stextFile) mkDeleteTriggerQuery :: TableName -> TriggerName -> [ColumnInfo 'MSSQL] -> TriggerOnReplication -> LT.Text mkDeleteTriggerQuery table@(TableName tableName schema@(SchemaName schemaName)) triggerName columns triggerOnReplication = let qualifiedTriggerName = qualifiedTriggerNameToText $ QualifiedTriggerName schema $ mkSQLTriggerName triggerName DELETE triggerNameText = triggerNameToTxt triggerName qualifiedTableName = qualifyTableName table operation = tshow DELETE replicationClause :: String = if triggerOnReplication /= TOREnableTrigger then "NOT FOR REPLICATION" else "" deliveryColsSQLExpression :: Text = commaSeparated $ map (unSQLFragment . generateColumnTriggerAlias OLD Nothing) columns in $(makeRelativeToProject "src-rsr/mssql/mssql_delete_trigger.sql.shakespeare" >>= ST.stextFile) -- Creates Primary Join key expression for UPDATE SQL Trigger -- eg: 'INSERTED.id = DELETED.id AND INSERTED.emp_code = DELETED.emp_code' mkPrimaryKeyJoinExp :: Text -> Text -> [ColumnInfo 'MSSQL] -> SQLFragment mkPrimaryKeyJoinExp lhsPrefix rhsPrefix columns = SQLFragment $ T.intercalate " AND " $ singleColExp <$> columns where singleColExp colInfo = let dbColNameText = columnNameText $ ciColumn colInfo in LT.toStrict $ [ST.stext| #{lhsPrefix}.#{dbColNameText} = #{rhsPrefix}.#{dbColNameText} |] -- Creates the WHERE clause for UPDATE SQL Trigger -- eg: If no listenColumns are defined then the where clause is an empty text -- else, 'WHERE INSERTED.id != DELETED.id OR INSERTED.name != DELTED.name' mkListenColumnsExp :: Text -> Text -> [ColumnInfo 'MSSQL] -> SQLFragment mkListenColumnsExp _ _ [] = SQLFragment "" mkListenColumnsExp lhsPrefix rhsPrefix columns = SQLFragment $ "where " <> T.intercalate " OR " (singleColExp <$> columns) where singleColExp colInfo = let dbColNameText = columnNameText $ ciColumn colInfo in LT.toStrict $ [ST.stext| #{lhsPrefix}.#{dbColNameText} != #{rhsPrefix}.#{dbColNameText} |] -- | Check if primary key is present in listen columns -- We use this in update event trigger, to check if the primary key has been updated -- and construct the payload accordingly. isPrimaryKeyInListenColumns :: [ColumnInfo 'MSSQL] -> PrimaryKey 'MSSQL (ColumnInfo 'MSSQL) -> SQLFragment isPrimaryKeyInListenColumns listenCols primaryKey = case (toList (_pkColumns primaryKey) `intersect` listenCols) of -- Do not fire Event Trigger if primary key not in listen column [] -> SQLFragment $ "1 != 1" -- Fire Event Trigger, since primary key is in listen column _ -> SQLFragment $ "1 = 1" {- Note [Update Event Trigger MSSQL Spec] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ An MS-SQL trigger is different from a postgres trigger in some ways * MS-SQL doesn't support triggers which trigger for each row, so in case of mutations which affect multiple rows, there'll only be a single trigger fired which will contain the data of all the rows that were affected. * MS-SQL maintains two logical tables, namely, [`inserted` and `deleted`](https://docs.microsoft.com/en-us/sql/relational-databases/triggers/use-the-inserted-and-deleted-tables?view=sql-server-ver15). The rows in the `inserted` table are copies of the new rows in the trigger table and similarly the `deleted` table contains the copies of the rows that were deleted from the trigger table. * When there's an update transaction, the old data (before the update) will be copied to the `deleted` table and the new data will be copied to the `inserted` table. Since we deliver the 'old' and 'new' data in the event trigger payload, we would need a way to correlate the values from `inserted` and `deleted` tables. And this is why, It is mandatory for a MSSQL Update trigger table to have a primary key. We use this primary key to correlate between `inserted` and `deleted` MSSQL UPDATE trigger's join clause depends on the fact that the primary key is never updated. But when the primary key is updated, you cannot join the 'INSERTED' and the 'DELETED' tables. Hence for those cases, we consider the old payload as NULL and the new payload will contain the updated row changes. To figure out if a primary key has been updated, we do the following: For each row present in the INSERTED table, we check if there are any rows in DELETED tabled that has the same primary key as that of the row in INSERTED table. If such a row does not exists, then it means that the primary key has been updated. The sample SQL which does this looks like: SELECT * FROM INSERTED WHERE NOT EXISTS (SELECT * FROM DELETED WHERE INSERTED.id = DELETED.id ) The spec for MSSQL UPDATE Event Trigger is as follows: 1. UPDATE Event Trigger can only be created on tables with a primary key. 2. When Primary Key is not updated during a UPDATE transaction then both 'data.new' and 'data.old' fields in payload will be constructed. 3. When Primary Key is updated during a UPDATE transaction then there are two cases: a. If the updated Primary key is equal to one of the already present primary key in the table then, we construct both the 'data.old' and 'data.new' b. If the updated primary key is not equal to any of the already present primary key in the table then, 'data.old' is NULL and only 'data.new' is constructed. -} mkUpdateTriggerQuery :: TableName -> TriggerName -> [ColumnInfo 'MSSQL] -> [ColumnInfo 'MSSQL] -> PrimaryKey 'MSSQL (ColumnInfo 'MSSQL) -> TriggerOnReplication -> LT.Text mkUpdateTriggerQuery table@(TableName tableName schema@(SchemaName schemaName)) triggerName listenColumns deliveryColumns primaryKey triggerOnReplication = let qualifiedTriggerName = qualifiedTriggerNameToText $ QualifiedTriggerName schema $ mkSQLTriggerName triggerName UPDATE triggerNameText = triggerNameToTxt triggerName qualifiedTableName = qualifyTableName table operation = tshow UPDATE replicationClause :: String = if triggerOnReplication /= TOREnableTrigger then "NOT FOR REPLICATION" else "" oldDeliveryColsSQLExp :: Text = commaSeparated $ map (unSQLFragment . generateColumnTriggerAlias OLD (Just "DELETED")) deliveryColumns newDeliveryColsSQLExp :: Text = commaSeparated $ map (unSQLFragment . generateColumnTriggerAlias NEW (Just "INSERTED")) deliveryColumns -- When Primary key is updated, then 'data.old' would be NULL -- See Note [Update Event Trigger MSSQL Spec] oldDeliveryColsSQLExpWhenPrimaryKeyUpdated :: Text = "NULL as [payload.data.old]" newDeliveryColsSQLExpWhenPrimaryKeyUpdated :: Text = commaSeparated $ map (unSQLFragment . generateColumnTriggerAlias NEW (Just "INSERTED")) deliveryColumns primaryKeyJoinExp = unSQLFragment $ mkPrimaryKeyJoinExp "INSERTED" "DELETED" (toList (_pkColumns primaryKey)) listenColumnExp = unSQLFragment $ mkListenColumnsExp "INSERTED" "DELETED" listenColumns isPrimaryKeyInListenColumnsExp = unSQLFragment $ isPrimaryKeyInListenColumns listenColumns primaryKey in $(makeRelativeToProject "src-rsr/mssql/mssql_update_trigger.sql.shakespeare" >>= ST.stextFile) -- | Add cleanup logs for given trigger names and cleanup configs. This will perform the following steps: -- -- 1. Get last scheduled cleanup event and count. -- 2. If count is less than 5, then add add more cleanup logs, else do nothing addCleanupSchedules :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> [(TriggerName, AutoTriggerLogCleanupConfig)] -> m () addCleanupSchedules sourceConfig triggersWithcleanupConfig = unless (null triggersWithcleanupConfig) $ do currTimeUTC <- liftIO getCurrentTime timeZone <- liftIO $ getTimeZone currTimeUTC let currTime = utcToZonedTime timeZone currTimeUTC triggerNames = map fst triggersWithcleanupConfig allScheduledCleanupsInDB <- liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ selectLastCleanupScheduledTimestamp triggerNames let triggerMap = Map.fromList $ allScheduledCleanupsInDB scheduledTriggersAndTimestamps = mapMaybe ( \(tName, cConfig) -> let lastScheduledTime = case Map.lookup tName triggerMap of Nothing -> Just currTime Just (count, lastTime) -> if count < 5 then (Just lastTime) else Nothing in fmap ( \lastScheduledTimestamp -> (tName, map (Datetimeoffset . utcToZonedTime timeZone) $ generateScheduleTimes (zonedTimeToUTC lastScheduledTimestamp) cleanupSchedulesToBeGenerated (_atlccSchedule cConfig)) ) lastScheduledTime ) triggersWithcleanupConfig unless (null scheduledTriggersAndTimestamps) $ liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ insertEventTriggerCleanupLogsTx scheduledTriggersAndTimestamps -- | Insert the cleanup logs for the given trigger name and schedules insertEventTriggerCleanupLogsTx :: [(TriggerName, [Datetimeoffset])] -> TxET QErr IO () insertEventTriggerCleanupLogsTx triggerNameWithSchedules = unitQueryE HGE.defaultMSSQLTxErrorHandler ( rawUnescapedText [ST.st| INSERT INTO hdb_catalog.hdb_event_log_cleanups(trigger_name, scheduled_at, status) VALUES #{sqlValues}; |] ) where sqlValues = commaSeparated $ map ( \(triggerName, schedules) -> generateSQLValuesFromListWith ( \schedule -> "'" <> triggerNameToTxt triggerName <> "', '" <> (T.pack . iso8601Show . unDatetimeoffset) schedule <> "', 'scheduled'" ) schedules ) triggerNameWithSchedules -- | Get the last scheduled timestamp for a given event trigger name selectLastCleanupScheduledTimestamp :: [TriggerName] -> TxET QErr IO [(TriggerName, (Int, ZonedTime))] selectLastCleanupScheduledTimestamp triggerNames = map ( \(triggerName, count, lastScheduledTime) -> (TriggerName (mkNonEmptyTextUnsafe triggerName), (count, lastScheduledTime)) ) <$> multiRowQueryE HGE.defaultMSSQLTxErrorHandler ( rawUnescapedText [ST.st| SELECT trigger_name, count(1), max(scheduled_at) FROM hdb_catalog.hdb_event_log_cleanups WHERE status='scheduled' AND trigger_name = ANY(SELECT n from (VALUES #{triggerNamesValues}) AS X(n)) GROUP BY trigger_name; |] ) where triggerNamesValues = generateSQLValuesFromList $ map triggerNameToTxt triggerNames deleteAllScheduledCleanupsTx :: TriggerName -> TxE QErr () deleteAllScheduledCleanupsTx triggerName = do let triggerNameText = triggerNameToTxt triggerName unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| DELETE from hdb_catalog.hdb_event_log_cleanups WHERE status = 'scheduled' AND trigger_name = $triggerNameText |] -- | @deleteAllScheduledCleanups@ deletes all scheduled cleanup logs for a given event trigger deleteAllScheduledCleanups :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> TriggerName -> m () deleteAllScheduledCleanups sourceConfig triggerName = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ deleteAllScheduledCleanupsTx triggerName getCleanupEventsForDeletionTx :: TxE QErr ([(Text, TriggerName)]) getCleanupEventsForDeletionTx = do latestEvents :: [(Text, TriggerName)] <- map (second (TriggerName . mkNonEmptyTextUnsafe)) <$> multiRowQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| select CAST(id AS nvarchar(36)), trigger_name from( SELECT id, trigger_name, ROW_NUMBER() OVER(PARTITION BY trigger_name ORDER BY scheduled_at DESC) AS rn FROM hdb_catalog.hdb_event_log_cleanups WHERE status = 'scheduled' AND scheduled_at < CURRENT_TIMESTAMP ) AS a WHERE rn = 1 |] let cleanupIDs = map fst latestEvents cleanupIDsSQLValue = generateSQLValuesFromList cleanupIDs unless (null cleanupIDs) $ do toDeadEvents <- multiRowQueryE HGE.defaultMSSQLTxErrorHandler ( rawUnescapedText [ST.st| SELECT CAST(id AS nvarchar(36)) FROM hdb_catalog.hdb_event_log_cleanups WHERE status = 'scheduled' AND scheduled_at < CURRENT_TIMESTAMP AND id NOT IN (SELECT n from (VALUES #{cleanupIDsSQLValue}) AS X(n)); |] ) markCleanupEventsAsDeadTx toDeadEvents pure latestEvents -- | @getCleanupEventsForDeletion@ returns the cleanup logs that are to be deleted. -- This will perform the following steps: -- -- 1. Get the scheduled cleanup events that were scheduled before current time. -- 2. If there are multiple entries for the same trigger name with different scheduled time, -- then fetch the latest entry and mark others as dead. getCleanupEventsForDeletion :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> m [(Text, TriggerName)] getCleanupEventsForDeletion sourceConfig = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ getCleanupEventsForDeletionTx markCleanupEventsAsDeadTx :: [Text] -> TxE QErr () markCleanupEventsAsDeadTx toDeadEvents = do let deadEventsValues = generateSQLValuesFromList toDeadEvents unless (null toDeadEvents) $ unitQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText $ [ST.st| UPDATE hdb_catalog.hdb_event_log_cleanups SET status = 'dead' WHERE id = ANY ( SELECT id from (VALUES #{deadEventsValues}) AS X(id)); |] updateCleanupEventStatusToDead :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> [Text] -> m () updateCleanupEventStatusToDead sourceConfig toDeadEvents = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ markCleanupEventsAsDeadTx toDeadEvents updateCleanupEventStatusToPausedTx :: Text -> TxE QErr () updateCleanupEventStatusToPausedTx cleanupLogId = unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| UPDATE hdb_catalog.hdb_event_log_cleanups SET status = 'paused' WHERE id = $cleanupLogId |] -- | @updateCleanupEventStatusToPaused@ updates the cleanup log status to `paused` if the event trigger configuration is paused. updateCleanupEventStatusToPaused :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> Text -> m () updateCleanupEventStatusToPaused sourceConfig cleanupLogId = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ updateCleanupEventStatusToPausedTx cleanupLogId updateCleanupEventStatusToCompletedTx :: Text -> DeletedEventLogStats -> TxE QErr () updateCleanupEventStatusToCompletedTx cleanupLogId (DeletedEventLogStats numEventLogs numInvocationLogs) = unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| UPDATE hdb_catalog.hdb_event_log_cleanups SET status = 'completed', deleted_event_logs = $numEventLogs, deleted_event_invocation_logs = $numInvocationLogs WHERE id = $cleanupLogId |] -- | @updateCleanupEventStatusToCompleted@ updates the cleanup log status after the event logs are deleted. -- This will perform the following steps: -- -- 1. Updates the cleanup config status to `completed`. -- 2. Updates the number of event logs and event invocation logs that were deleted for a trigger name updateCleanupEventStatusToCompleted :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> Text -> DeletedEventLogStats -> m () updateCleanupEventStatusToCompleted sourceConfig cleanupLogId delStats = liftEitherM $ liftIO $ runMSSQLSourceWriteTx sourceConfig $ updateCleanupEventStatusToCompletedTx cleanupLogId delStats deleteEventTriggerLogsTx :: TriggerLogCleanupConfig -> TxE QErr DeletedEventLogStats deleteEventTriggerLogsTx TriggerLogCleanupConfig {..} = do -- Setting the timeout unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| SET LOCK_TIMEOUT $qTimeout; |] -- Select all the dead events based on criteria set in the cleanup config. deadEventIDs :: [EventId] <- map EventId <$> multiRowQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| SELECT TOP ($qBatchSize) CAST(id AS nvarchar(36)) FROM hdb_catalog.event_log WITH (UPDLOCK, READPAST) WHERE ((delivered = 1 OR error = 1) AND trigger_name = $qTriggerName ) AND created_at < DATEADD(HOUR, - $qRetentionPeriod, CURRENT_TIMESTAMP) AND locked IS NULL |] if null deadEventIDs then pure $ DeletedEventLogStats 0 0 else do let eventIdsValues = generateSQLValuesFromList deadEventIDs -- Lock the events in the database so that other HGE instances don't pick them up for deletion. unitQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText $ [ST.st| UPDATE hdb_catalog.event_log SET locked = CURRENT_TIMESTAMP WHERE id = ANY ( SELECT id from (VALUES #{eventIdsValues}) AS X(id)) AND locked IS NULL |] -- Based on the config either delete the corresponding invocation logs or set trigger_name -- to appropriate value. Please note that the event_id won't exist anymore in the event_log -- table, but we are still retaining it for debugging purpose. deletedInvocationLogs :: [Int] <- -- This will be an array of 1 and is only used to count the number of deleted rows. multiRowQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText $ if tlccCleanInvocationLogs then [ST.st| DELETE FROM hdb_catalog.event_invocation_logs OUTPUT 1 WHERE event_id = ANY ( SELECT id from (VALUES #{eventIdsValues}) AS X(id)); |] else [ST.st| UPDATE hdb_catalog.event_invocation_logs SET trigger_name = '#{qTriggerName}' WHERE event_id = ANY ( SELECT id from (VALUES #{eventIdsValues}) AS X(id)); |] -- Finally delete the event logs. deletedEventLogs :: [Int] <- -- This will be an array of 1 and is only used to count the number of deleted rows. multiRowQueryE HGE.defaultMSSQLTxErrorHandler $ rawUnescapedText $ [ST.st| DELETE FROM hdb_catalog.event_log OUTPUT 1 WHERE id = ANY ( SELECT id from (VALUES #{eventIdsValues}) AS X(id)); |] -- Removing the timeout (-1 is the default timeout) unitQueryE HGE.defaultMSSQLTxErrorHandler [ODBC.sql| SET LOCK_TIMEOUT -1; |] pure $ DeletedEventLogStats (length deletedEventLogs) (length deletedInvocationLogs) where qTimeout = tlccTimeout * 1000 qTriggerName = triggerNameToTxt tlccEventTriggerName qRetentionPeriod = tlccClearOlderThan qBatchSize = tlccBatchSize -- | @deleteEventTriggerLogs@ deletes the event logs (and event invocation logs) based on the cleanup configuration given -- This will perform the following steps: -- -- 1. Select all the dead events based on criteria set in the cleanup config. -- 2. Lock the events in the database so that other HGE instances don't pick them up for deletion. -- 3. Based on the config, perform the delete action. deleteEventTriggerLogs :: (MonadIO m, MonadError QErr m) => MSSQLSourceConfig -> TriggerLogCleanupConfig -> IO (Maybe (TriggerLogCleanupConfig, EventTriggerCleanupStatus)) -> m DeletedEventLogStats deleteEventTriggerLogs sourceConfig oldCleanupConfig getLatestCleanupConfig = do deleteEventTriggerLogsInBatchesWith getLatestCleanupConfig oldCleanupConfig $ \cleanupConfig -> do runMSSQLSourceWriteTx sourceConfig $ deleteEventTriggerLogsTx cleanupConfig