# Copyright 2021 Collate # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # http://www.apache.org/licenses/LICENSE-2.0 # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """ Population Standard deviation Metric definition """ from sqlalchemy.ext.compiler import compiles from sqlalchemy.sql.functions import FunctionElement from metadata.generated.schema.entity.services.databaseService import ( DatabaseServiceType, ) from metadata.orm_profiler.metrics.core import CACHE, StaticMetric, _label from metadata.orm_profiler.orm.registry import SQLALCHEMY_NUMERIC from metadata.orm_profiler.utils import logger logger = logger() class StdDevFn(FunctionElement): name = __qualname__ inherit_cache = CACHE @compiles(StdDevFn) def _(element, compiler, **kw): return "STDDEV_POP(%s)" % compiler.process(element.clauses, **kw) @compiles(StdDevFn, DatabaseServiceType.MSSQL.value.lower()) def _(element, compiler, **kw): return "STDEVP(%s)" % compiler.process(element.clauses, **kw) @compiles(StdDevFn, "sqlite") # Needed for unit tests def _(element, compiler, **kw): """ This actually returns the squared STD, but as it is only required for tests we can live with it. """ proc = compiler.process(element.clauses, **kw) return "AVG(%s * %s) - AVG(%s) * AVG(%s)" % ((proc,) * 4) class StdDev(StaticMetric): """ STD Metric Given a column, return the Standard Deviation value. """ def metric_type(self): return float @_label def fn(self): if self.col.type.__class__ not in SQLALCHEMY_NUMERIC: logger.info( f"{self.col} has type {self.col.type}, which is not listed as numeric." + " We won't compute STDDEV for it." ) return None return StdDevFn(self.col)