{-# OPTIONS_HADDOCK ignore-exports #-} -- | Responsible for translating and building an MSSQL execution plan for -- update mutations. -- -- This module is used by "Hasura.Backends.MSSQL.Instances.Execute". module Hasura.Backends.MSSQL.Execute.Update ( executeUpdate, ) where import Database.MSSQL.Transaction qualified as Tx import Hasura.Backends.MSSQL.Connection import Hasura.Backends.MSSQL.FromIr as TSQL import Hasura.Backends.MSSQL.FromIr.Constants (tempTableNameUpdated) import Hasura.Backends.MSSQL.FromIr.Expression (fromGBoolExp) import Hasura.Backends.MSSQL.FromIr.MutationResponse import Hasura.Backends.MSSQL.FromIr.SelectIntoTempTable qualified as TSQL import Hasura.Backends.MSSQL.FromIr.Update qualified as TSQL import Hasura.Backends.MSSQL.Plan import Hasura.Backends.MSSQL.SQL.Error import Hasura.Backends.MSSQL.ToQuery as TQ import Hasura.Backends.MSSQL.Types.Internal as TSQL import Hasura.Backends.MSSQL.Types.Update import Hasura.Base.Error import Hasura.EncJSON import Hasura.GraphQL.Parser import Hasura.Prelude import Hasura.RQL.IR import Hasura.RQL.IR qualified as IR import Hasura.RQL.Types import Hasura.Session -- | Executes an Update IR AST and return results as JSON. executeUpdate :: MonadError QErr m => UserInfo -> StringifyNumbers -> SourceConfig 'MSSQL -> AnnotatedUpdateG 'MSSQL Void (UnpreparedValue 'MSSQL) -> m (ExceptT QErr IO EncJSON) executeUpdate userInfo stringifyNum sourceConfig updateOperation = do let mssqlExecCtx = (_mscExecCtx sourceConfig) preparedUpdate <- traverse (prepareValueQuery $ _uiSession userInfo) updateOperation if null $ updateOperations . _auBackend $ updateOperation then pure $ pure $ IR.buildEmptyMutResp $ _auOutput preparedUpdate else pure $ (mssqlRunReadWrite mssqlExecCtx) (buildUpdateTx preparedUpdate stringifyNum) -- | Converts an Update IR AST to a transaction of three update sql statements. -- -- A GraphQL update mutation does two things: -- -- 1. Update rows in a table according to some predicate -- 2. (Potentially) returns the updated rows (including relationships) as JSON -- -- In order to complete these 2 things we need 3 SQL statements: -- -- 1. @SELECT INTO WHERE @ - creates a temporary table -- with the same schema as the original table in which we'll store the updated rows -- from the table we are deleting -- 2. @UPDATE SET FROM with OUTPUT@ - updates the rows from the table and inserts the -- updated rows to the temporary table from (1) -- 3. @SELECT@ - constructs the @returning@ query from the temporary table, including -- relationships with other tables. buildUpdateTx :: AnnotatedUpdate 'MSSQL -> StringifyNumbers -> Tx.TxET QErr IO EncJSON buildUpdateTx updateOperation stringifyNum = do let withAlias = "with_alias" createInsertedTempTableQuery = toQueryFlat $ TQ.fromSelectIntoTempTable $ TSQL.toSelectIntoTempTable tempTableNameUpdated (_auTable updateOperation) (_auAllCols updateOperation) RemoveConstraints -- Create a temp table Tx.unitQueryE defaultMSSQLTxErrorHandler createInsertedTempTableQuery let updateQuery = TQ.fromUpdate <$> TSQL.fromUpdate updateOperation updateQueryValidated <- toQueryFlat <$> runFromIr updateQuery -- Execute UPDATE statement Tx.unitQueryE mutationMSSQLTxErrorHandler updateQueryValidated mutationOutputSelect <- runFromIr $ mkMutationOutputSelect stringifyNum withAlias $ _auOutput updateOperation let checkCondition = _auCheck updateOperation -- The check constraint is translated to boolean expression checkBoolExp <- runFromIr $ runReaderT (fromGBoolExp checkCondition) (EntityAlias withAlias) let withSelect = emptySelect { selectProjections = [StarProjection], selectFrom = Just $ FromTempTable $ Aliased tempTableNameUpdated "updated_alias" } mutationOutputCheckConstraintSelect = selectMutationOutputAndCheckCondition withAlias mutationOutputSelect checkBoolExp finalSelect = mutationOutputCheckConstraintSelect {selectWith = Just $ With $ pure $ Aliased withSelect withAlias} -- Execute SELECT query to fetch mutation response and check constraint result (responseText, checkConditionInt) <- Tx.singleRowQueryE defaultMSSQLTxErrorHandler (toQueryFlat $ TQ.fromSelect finalSelect) -- Drop the temp table Tx.unitQueryE defaultMSSQLTxErrorHandler $ toQueryFlat $ dropTempTableQuery tempTableNameUpdated -- Raise an exception if the check condition is not met unless (checkConditionInt == (0 :: Int)) $ throw400 PermissionError "check constraint of an update permission has failed" pure $ encJFromText responseText