2022-05-02 08:03:12 +03:00
|
|
|
{-# OPTIONS_GHC -fno-warn-orphans #-}
|
|
|
|
|
2022-10-20 06:23:37 +03:00
|
|
|
module Hasura.Backends.DataConnector.Adapter.Backend
|
|
|
|
( CustomBooleanOperator (..),
|
|
|
|
columnTypeToScalarType,
|
2022-12-01 03:07:16 +03:00
|
|
|
parseValue,
|
2022-10-20 06:23:37 +03:00
|
|
|
)
|
|
|
|
where
|
2022-05-02 08:03:12 +03:00
|
|
|
|
2022-09-20 09:18:46 +03:00
|
|
|
import Data.Aeson qualified as J
|
2022-07-15 06:27:31 +03:00
|
|
|
import Data.Aeson.Extended (ToJSONKeyValue (..))
|
|
|
|
import Data.Aeson.Key (fromText)
|
2022-09-20 09:18:46 +03:00
|
|
|
import Data.Aeson.Types qualified as J
|
2022-10-27 03:42:49 +03:00
|
|
|
import Data.HashMap.Strict qualified as HashMap
|
2022-08-04 11:34:45 +03:00
|
|
|
import Data.List.NonEmpty qualified as NonEmpty
|
2022-12-01 03:07:16 +03:00
|
|
|
import Data.Scientific (fromFloatDigits)
|
2022-08-04 11:34:45 +03:00
|
|
|
import Data.Text qualified as Text
|
2022-05-26 14:54:30 +03:00
|
|
|
import Data.Text.Casing qualified as C
|
2022-08-04 11:34:45 +03:00
|
|
|
import Data.Text.Extended ((<<>))
|
2022-10-27 03:42:49 +03:00
|
|
|
import Hasura.Backends.DataConnector.API qualified as API
|
2022-09-20 09:18:46 +03:00
|
|
|
import Hasura.Backends.DataConnector.Adapter.Types qualified as DC
|
2023-01-10 04:54:40 +03:00
|
|
|
import Hasura.Backends.DataConnector.Adapter.Types.Mutations qualified as DC
|
2022-06-02 05:06:45 +03:00
|
|
|
import Hasura.Base.Error (Code (ValidationFailed), QErr, runAesonParser, throw400)
|
2023-01-30 19:04:56 +03:00
|
|
|
import Hasura.NativeQuery.Types (NativeQueryMetadata)
|
2022-05-02 08:03:12 +03:00
|
|
|
import Hasura.Prelude
|
2022-07-15 06:27:31 +03:00
|
|
|
import Hasura.RQL.IR.BoolExp
|
2023-02-03 19:27:44 +03:00
|
|
|
import Hasura.RQL.Types.Backend (Backend (..), ComputedFieldReturnType, HasSourceConfiguration (..), SupportedNamingCase (..), XDisable, XEnable)
|
2022-10-20 06:23:37 +03:00
|
|
|
import Hasura.RQL.Types.Column (ColumnType (..))
|
2022-10-20 04:32:54 +03:00
|
|
|
import Hasura.RQL.Types.ResizePool (ServerReplicas)
|
2022-05-02 08:03:12 +03:00
|
|
|
import Hasura.SQL.Backend (BackendType (DataConnector))
|
|
|
|
import Language.GraphQL.Draft.Syntax qualified as G
|
|
|
|
|
|
|
|
-- | An alias for '()' indicating that a particular associated type has not yet
|
|
|
|
-- been implemented for the 'DataConnector' backend.
|
|
|
|
--
|
|
|
|
-- '()' is used (rather than a type with an empty data constructor) because it
|
|
|
|
-- comes with many of the instances that these associated types require.
|
|
|
|
--
|
|
|
|
-- This alias should /not/ be exported from this module, and it's only defined
|
|
|
|
-- for clarity.
|
|
|
|
type Unimplemented = ()
|
|
|
|
|
|
|
|
instance Backend 'DataConnector where
|
2022-09-20 09:18:46 +03:00
|
|
|
type BackendConfig 'DataConnector = InsOrdHashMap DC.DataConnectorName DC.DataConnectorOptions
|
|
|
|
type BackendInfo 'DataConnector = HashMap DC.DataConnectorName DC.DataConnectorInfo
|
2022-05-02 08:03:12 +03:00
|
|
|
|
2022-09-20 09:18:46 +03:00
|
|
|
type TableName 'DataConnector = DC.TableName
|
|
|
|
type FunctionName 'DataConnector = DC.FunctionName
|
2022-05-02 08:03:12 +03:00
|
|
|
type RawFunctionInfo 'DataConnector = XDisable
|
2022-05-25 13:24:41 +03:00
|
|
|
type FunctionArgument 'DataConnector = XDisable
|
2022-09-20 09:18:46 +03:00
|
|
|
type ConstraintName 'DataConnector = DC.ConstraintName
|
|
|
|
type BasicOrderType 'DataConnector = DC.OrderDirection
|
2022-05-02 08:03:12 +03:00
|
|
|
type NullsOrderType 'DataConnector = Unimplemented
|
2022-09-20 09:18:46 +03:00
|
|
|
type CountType 'DataConnector = DC.CountAggregate
|
|
|
|
type Column 'DataConnector = DC.ColumnName
|
2022-09-06 07:24:46 +03:00
|
|
|
type ScalarValue 'DataConnector = J.Value
|
2022-09-20 09:18:46 +03:00
|
|
|
type ScalarType 'DataConnector = DC.ScalarType
|
2022-06-02 05:06:45 +03:00
|
|
|
|
|
|
|
-- This does not actually have to be the full IR Expression, in fact it is only
|
|
|
|
-- required to represent literals, so we use a special type for that.
|
|
|
|
-- The 'SQLExpression' type family should be removed in a future refactor
|
2022-09-20 09:18:46 +03:00
|
|
|
type SQLExpression 'DataConnector = DC.Literal
|
2022-05-03 11:58:56 +03:00
|
|
|
type ScalarSelectionArguments 'DataConnector = Void
|
2022-07-15 06:27:31 +03:00
|
|
|
type BooleanOperators 'DataConnector = CustomBooleanOperator
|
2022-05-02 08:03:12 +03:00
|
|
|
type ExtraTableMetadata 'DataConnector = Unimplemented
|
2022-05-04 17:52:29 +03:00
|
|
|
type ComputedFieldDefinition 'DataConnector = Unimplemented
|
2022-05-25 13:24:41 +03:00
|
|
|
type FunctionArgumentExp 'DataConnector = Const Unimplemented
|
|
|
|
type ComputedFieldImplicitArguments 'DataConnector = Unimplemented
|
|
|
|
type ComputedFieldReturn 'DataConnector = Unimplemented
|
2022-05-02 08:03:12 +03:00
|
|
|
|
2023-01-10 04:54:40 +03:00
|
|
|
type UpdateVariant 'DataConnector = DC.DataConnectorUpdateVariant
|
2022-12-12 07:41:36 +03:00
|
|
|
type BackendInsert 'DataConnector = DC.BackendInsert
|
|
|
|
|
2022-05-02 08:03:12 +03:00
|
|
|
type XComputedField 'DataConnector = XDisable
|
|
|
|
type XRelay 'DataConnector = XDisable
|
2022-07-20 08:20:49 +03:00
|
|
|
type XNodesAgg 'DataConnector = XEnable
|
2022-12-21 20:14:07 +03:00
|
|
|
type XEventTriggers 'DataConnector = XDisable
|
2022-05-02 08:03:12 +03:00
|
|
|
type XNestedInserts 'DataConnector = XDisable
|
|
|
|
type XStreamingSubscription 'DataConnector = XDisable
|
|
|
|
|
2022-09-02 09:33:21 +03:00
|
|
|
type HealthCheckTest 'DataConnector = Void
|
|
|
|
|
2022-05-02 08:03:12 +03:00
|
|
|
isComparableType :: ScalarType 'DataConnector -> Bool
|
2023-01-11 05:36:03 +03:00
|
|
|
isComparableType = const False
|
2022-05-02 08:03:12 +03:00
|
|
|
|
|
|
|
isNumType :: ScalarType 'DataConnector -> Bool
|
2023-01-11 05:36:03 +03:00
|
|
|
isNumType = const False
|
2022-05-02 08:03:12 +03:00
|
|
|
|
2022-12-12 07:41:36 +03:00
|
|
|
getCustomAggregateOperators :: DC.SourceConfig -> HashMap G.Name (HashMap DC.ScalarType DC.ScalarType)
|
|
|
|
getCustomAggregateOperators DC.SourceConfig {..} =
|
2022-10-27 03:42:49 +03:00
|
|
|
HashMap.foldrWithKey insertOps mempty scalarTypesCapabilities
|
|
|
|
where
|
2022-10-28 04:12:54 +03:00
|
|
|
scalarTypesCapabilities = API.unScalarTypesCapabilities $ API._cScalarTypes _scCapabilities
|
2022-10-27 03:42:49 +03:00
|
|
|
insertOps typeName API.ScalarTypeCapabilities {..} m =
|
|
|
|
HashMap.foldrWithKey insertOp m $
|
2022-10-28 04:12:54 +03:00
|
|
|
API.unAggregateFunctions _stcAggregateFunctions
|
2022-10-27 03:42:49 +03:00
|
|
|
where
|
|
|
|
insertOp funtionName resultTypeName =
|
|
|
|
HashMap.insertWith HashMap.union funtionName $
|
2022-12-01 03:07:16 +03:00
|
|
|
HashMap.singleton
|
|
|
|
(DC.mkScalarType _scCapabilities typeName)
|
|
|
|
(DC.mkScalarType _scCapabilities resultTypeName)
|
2022-10-27 03:42:49 +03:00
|
|
|
|
2022-05-02 08:03:12 +03:00
|
|
|
textToScalarValue :: Maybe Text -> ScalarValue 'DataConnector
|
|
|
|
textToScalarValue = error "textToScalarValue: not implemented for the Data Connector backend."
|
|
|
|
|
|
|
|
parseScalarValue :: ScalarType 'DataConnector -> J.Value -> Either QErr (ScalarValue 'DataConnector)
|
2022-09-20 09:18:46 +03:00
|
|
|
parseScalarValue type' value = runAesonParser (parseValue type') value
|
2022-05-02 08:03:12 +03:00
|
|
|
|
|
|
|
scalarValueToJSON :: ScalarValue 'DataConnector -> J.Value
|
2022-12-01 03:07:16 +03:00
|
|
|
scalarValueToJSON = id
|
2022-05-02 08:03:12 +03:00
|
|
|
|
|
|
|
functionToTable :: FunctionName 'DataConnector -> TableName 'DataConnector
|
|
|
|
functionToTable = error "functionToTable: not implemented for the Data Connector backend."
|
|
|
|
|
2022-05-04 17:52:29 +03:00
|
|
|
computedFieldFunction :: ComputedFieldDefinition 'DataConnector -> FunctionName 'DataConnector
|
|
|
|
computedFieldFunction = error "computedFieldFunction: not implemented for the Data Connector backend"
|
|
|
|
|
2022-05-25 13:24:41 +03:00
|
|
|
computedFieldReturnType :: ComputedFieldReturn 'DataConnector -> ComputedFieldReturnType 'DataConnector
|
|
|
|
computedFieldReturnType = error "computedFieldReturnType: not implemented for the Data Connector backend"
|
|
|
|
|
|
|
|
fromComputedFieldImplicitArguments :: v -> ComputedFieldImplicitArguments 'DataConnector -> [FunctionArgumentExp 'DataConnector v]
|
|
|
|
fromComputedFieldImplicitArguments = error "fromComputedFieldImplicitArguments: not implemented for the Data Connector backend"
|
|
|
|
|
2022-05-02 08:03:12 +03:00
|
|
|
-- phil said this was cursed
|
|
|
|
tableToFunction :: TableName 'DataConnector -> FunctionName 'DataConnector
|
|
|
|
tableToFunction = coerce
|
|
|
|
|
|
|
|
tableGraphQLName :: TableName 'DataConnector -> Either QErr G.Name
|
2022-08-04 11:34:45 +03:00
|
|
|
tableGraphQLName name = do
|
|
|
|
let snakedName = snakeCaseTableName @'DataConnector name
|
|
|
|
G.mkName snakedName
|
|
|
|
`onNothing` throw400 ValidationFailed ("TableName " <> snakedName <> " is not a valid GraphQL identifier")
|
2022-05-02 08:03:12 +03:00
|
|
|
|
|
|
|
functionGraphQLName :: FunctionName 'DataConnector -> Either QErr G.Name
|
|
|
|
functionGraphQLName = error "functionGraphQLName: not implemented for the Data Connector backend."
|
|
|
|
|
|
|
|
snakeCaseTableName :: TableName 'DataConnector -> Text
|
2022-09-20 09:18:46 +03:00
|
|
|
snakeCaseTableName = Text.intercalate "_" . NonEmpty.toList . DC.unTableName
|
2022-05-26 14:54:30 +03:00
|
|
|
|
|
|
|
getTableIdentifier :: TableName 'DataConnector -> Either QErr C.GQLNameIdentifier
|
2022-09-20 09:18:46 +03:00
|
|
|
getTableIdentifier name@(DC.TableName (prefix :| suffixes)) =
|
2022-08-17 15:46:36 +03:00
|
|
|
let identifier = do
|
|
|
|
namePrefix <- G.mkName prefix
|
|
|
|
nameSuffixes <- traverse G.mkNameSuffix suffixes
|
|
|
|
pure $ C.fromAutogeneratedTuple (namePrefix, nameSuffixes)
|
|
|
|
in identifier
|
|
|
|
`onNothing` throw400 ValidationFailed ("TableName " <> name <<> " is not a valid GraphQL identifier")
|
2022-05-26 14:54:30 +03:00
|
|
|
|
|
|
|
namingConventionSupport :: SupportedNamingCase
|
|
|
|
namingConventionSupport = OnlyHasuraCase
|
2022-07-15 06:27:31 +03:00
|
|
|
|
2022-10-17 11:04:54 +03:00
|
|
|
resizeSourcePools :: SourceConfig 'DataConnector -> ServerReplicas -> IO ()
|
|
|
|
resizeSourcePools _sourceConfig _serverReplicas =
|
|
|
|
-- Data connectors do not have concept of connection pools
|
|
|
|
pure ()
|
|
|
|
|
2022-12-21 20:14:07 +03:00
|
|
|
defaultTriggerOnReplication = Nothing
|
2022-11-29 20:41:41 +03:00
|
|
|
|
2023-02-03 19:27:44 +03:00
|
|
|
instance HasSourceConfiguration 'DataConnector where
|
|
|
|
type SourceConfig 'DataConnector = DC.SourceConfig
|
|
|
|
type SourceConnConfiguration 'DataConnector = DC.ConnSourceConfig
|
|
|
|
|
2023-01-30 19:04:56 +03:00
|
|
|
instance NativeQueryMetadata 'DataConnector
|
|
|
|
|
2022-07-15 06:27:31 +03:00
|
|
|
data CustomBooleanOperator a = CustomBooleanOperator
|
|
|
|
{ _cboName :: Text,
|
|
|
|
_cboRHS :: Maybe (Either (RootOrCurrentColumn 'DataConnector) a) -- TODO turn Either into a specific type
|
|
|
|
}
|
|
|
|
deriving stock (Eq, Generic, Foldable, Functor, Traversable, Show)
|
|
|
|
|
|
|
|
instance NFData a => NFData (CustomBooleanOperator a)
|
|
|
|
|
|
|
|
instance Hashable a => Hashable (CustomBooleanOperator a)
|
|
|
|
|
|
|
|
instance J.ToJSON a => ToJSONKeyValue (CustomBooleanOperator a) where
|
|
|
|
toJSONKeyValue CustomBooleanOperator {..} = (fromText _cboName, J.toJSON _cboRHS)
|
2022-09-20 09:18:46 +03:00
|
|
|
|
|
|
|
parseValue :: DC.ScalarType -> J.Value -> J.Parser J.Value
|
|
|
|
parseValue type' val =
|
|
|
|
case (type', val) of
|
|
|
|
(_, J.Null) -> pure J.Null
|
2023-01-11 05:36:03 +03:00
|
|
|
(DC.ScalarType _ graphQLType, value) -> case graphQLType of
|
2022-12-01 03:07:16 +03:00
|
|
|
Nothing -> pure value
|
|
|
|
Just DC.GraphQLInt -> (J.Number . fromIntegral) <$> J.parseJSON @Int value
|
|
|
|
Just DC.GraphQLFloat -> (J.Number . fromFloatDigits) <$> J.parseJSON @Double value
|
|
|
|
Just DC.GraphQLString -> J.String <$> J.parseJSON value
|
|
|
|
Just DC.GraphQLBoolean -> J.Bool <$> J.parseJSON value
|
|
|
|
Just DC.GraphQLID -> J.String <$> parseID value
|
|
|
|
where
|
|
|
|
parseID value = J.parseJSON @Text value <|> tshow <$> J.parseJSON @Int value
|
2022-10-20 06:23:37 +03:00
|
|
|
|
|
|
|
columnTypeToScalarType :: ColumnType 'DataConnector -> DC.ScalarType
|
|
|
|
columnTypeToScalarType = \case
|
|
|
|
ColumnScalar scalarType -> scalarType
|
2023-01-11 05:36:03 +03:00
|
|
|
-- Data connectors does not yet support enum tables.
|
|
|
|
-- If/when we add this support, we probably want to
|
|
|
|
-- embed the enum scalar type name within the `EnumReference` record type
|
|
|
|
ColumnEnumReference _ -> error "columnTypeToScalarType got enum"
|