Files
open-metadata--openmetadata/ingestion/tests/unit/observability/profiler/sqlalchemy/test_sample.py
T
wehub-resource-sync bf2343b7e4
Integration Tests - MySQL + Elasticsearch / Detect Changes (push) Has been cancelled
Integration Tests - MySQL + Elasticsearch / integration-tests-mysql-elasticsearch (push) Has been cancelled
Integration Tests - PostgreSQL + Elasticsearch + Redis / Detect Changes (push) Has been cancelled
Integration Tests - PostgreSQL + Elasticsearch + Redis / integration-tests-postgres-elasticsearch-redis (push) Has been cancelled
Integration Tests - PostgreSQL + OpenSearch / Detect Changes (push) Has been cancelled
Integration Tests - PostgreSQL + OpenSearch / integration-tests-postgres-opensearch (push) Has been cancelled
Java Checkstyle / java-checkstyle (push) Has been cancelled
Maven Collate Tests / maven-collate-ci (push) Has been cancelled
OpenMetadata Service Unit Tests / openmetadata-service-unit-tests-status (push) Has been cancelled
Publish Package to Maven Central Repository / publish-maven-packages (push) Has been cancelled
OpenMetadata Service Unit Tests / Detect Changes (push) Has been cancelled
OpenMetadata Service Unit Tests / openmetadata-service-unit-tests (push) Has been cancelled
OpenMetadata Service Unit Tests / k8s_operator-unit-tests (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:35:45 +08:00

525 lines
19 KiB
Python

# Copyright 2025 Collate
# Licensed under the Collate Community License, Version 1.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# https://github.com/open-metadata/OpenMetadata/blob/main/ingestion/LICENSE
# 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.
"""
Test Sample behavior
"""
import os
from unittest import TestCase
from unittest.mock import patch
from uuid import uuid4
from sqlalchemy import TEXT, Column, Integer, String, func
from sqlalchemy.orm import DeclarativeBase
from metadata.generated.schema.entity.data.table import Column as EntityColumn
from metadata.generated.schema.entity.data.table import ColumnName, DataType, Table
from metadata.generated.schema.entity.services.connections.database.sqliteConnection import (
SQLiteConnection,
SQLiteScheme,
)
from metadata.generated.schema.type.basic import ProfileSampleType
from metadata.generated.schema.type.samplingConfig import SampleConfigType
from metadata.generated.schema.type.staticSamplingConfig import StaticSamplingConfig
from metadata.profiler.interface.sqlalchemy.profiler_interface import (
SQAProfilerInterface,
)
from metadata.profiler.metrics.registry import Metrics
from metadata.profiler.orm.registry import CustomTypes
from metadata.profiler.processor.core import Profiler
from metadata.sampler.models import (
ProfileSampleConfig,
SampleConfig,
)
from metadata.sampler.sampler_config import DatabaseSamplerConfig
from metadata.sampler.sqlalchemy.sampler import SQASampler
class Base(DeclarativeBase):
pass
class User(Base):
__tablename__ = "users"
id = Column(Integer, primary_key=True)
name = Column(String(256))
fullname = Column(String(256))
nickname = Column(String(256))
comments = Column(TEXT)
age = Column(Integer)
@patch.object(SQASampler, "build_table_orm", return_value=User)
class SampleTest(TestCase):
"""
Run checks on different metrics
"""
db_path = os.path.join(os.path.dirname(__file__), f"{os.path.splitext(__file__)[0]}.db") # noqa: PTH118, PTH120, PTH122
sqlite_conn = SQLiteConnection(
scheme=SQLiteScheme.sqlite_pysqlite,
databaseMode=db_path + "?check_same_thread=False",
)
table_entity = Table(
id=uuid4(),
name="user",
columns=[
EntityColumn(
name=ColumnName("id"),
dataType=DataType.INT,
),
EntityColumn(
name=ColumnName("name"),
dataType=DataType.STRING,
),
EntityColumn(
name=ColumnName("fullname"),
dataType=DataType.STRING,
),
EntityColumn(
name=ColumnName("nickname"),
dataType=DataType.STRING,
),
EntityColumn(
name=ColumnName("comments"),
dataType=DataType.STRING,
),
EntityColumn(
name=ColumnName("age"),
dataType=DataType.INT,
),
],
)
@classmethod
@patch.object(SQASampler, "build_table_orm", return_value=User)
def setUpClass(cls, sampler_mock) -> None:
"""
Prepare Ingredients
"""
with patch.object(SQASampler, "build_table_orm", return_value=User):
cls.sampler = SQASampler(
service_connection_config=cls.sqlite_conn,
ometa_client=None,
entity=None,
config=DatabaseSamplerConfig(
sample_config=SampleConfig(
profileSampleConfig=ProfileSampleConfig(
sampleConfigType=SampleConfigType.STATIC,
config=StaticSamplingConfig(profileSample=50.0),
)
)
),
)
cls.dataset = cls.sampler.get_dataset()
cls.sqa_profiler_interface = SQAProfilerInterface(
cls.sqlite_conn,
None,
cls.table_entity,
None,
cls.sampler,
5,
43200,
)
cls.engine = cls.sqa_profiler_interface.session.get_bind()
cls.session = cls.sqa_profiler_interface.session
with patch.object(SQASampler, "build_table_orm", return_value=User):
cls.full_sampler = SQASampler(
service_connection_config=cls.sqlite_conn,
ometa_client=None,
entity=None,
)
cls.full_sqa_profiler_interface = SQAProfilerInterface(
cls.sqlite_conn,
None,
cls.table_entity,
None,
cls.full_sampler,
5,
43200,
)
User.__table__.create(bind=cls.engine)
# Insert 30 rows
for i in range(10): # noqa: B007
data = [
User(
name="John",
fullname="John Doe",
nickname="johnny b goode",
comments="no comments",
age=30,
),
User(
name="Jane",
fullname="Jone Doe",
nickname=None,
comments="maybe some comments",
age=31,
),
User(
name="John",
fullname="John Doe",
nickname=None,
comments=None,
age=None,
),
]
cls.session.add_all(data)
cls.session.commit()
def test_sampler(self, sampler_mock):
"""
The random sampler should be able to
generate a random subset of data
"""
random_sample = self.sampler.get_dataset()
res = self.session.query(func.count()).select_from(random_sample).first()
assert res[0] < 30
def test_sample_property(self, sampler_mock):
"""
Sample property should be properly generated
"""
dataset = self.sqa_profiler_interface.sampler.get_dataset()
res = self.session.query(func.count()).select_from(dataset).first()
assert res[0] < 30
def test_table_row_count(self, sampler_mock):
"""
Profile sample should be ignored in row count
"""
table_count = Metrics.rowCount.value
profiler = Profiler(
table_count,
profiler_interface=self.sqa_profiler_interface,
)
res = profiler.compute_metrics()._table_results
assert res.get(Metrics.rowCount.name) == 30
def test_random_sample_count(self, sampler_mock):
"""
Check we can properly sample data.
There's a random component, so we cannot ensure to always
get 15 rows, but for sure we should get less than 30.
"""
count = Metrics.valuesCount.value
profiler = Profiler(count, profiler_interface=self.sqa_profiler_interface)
res = profiler.compute_metrics()._column_results
assert res.get(User.name.name)[Metrics.valuesCount.name] < 30
def test_random_sample_histogram(self, sampler_mock):
"""
Histogram should run correctly
"""
hist = Metrics.histogram.value
count = Metrics.valuesCount.value
min = Metrics.min.value
max = Metrics.max.value
first_quartile = Metrics.firstQuartile.value
third_quartile = Metrics.thirdQuartile.value
iqr = Metrics.interQuartileRange.value
profiler = Profiler(
hist,
count,
min,
max,
first_quartile,
third_quartile,
iqr,
profiler_interface=self.sqa_profiler_interface,
)
res = profiler.compute_metrics()._column_results
# The sum of all frequencies should be sampled
assert sum(res.get(User.id.name)[Metrics.histogram.name]["frequencies"]) < 30
profiler = Profiler(
hist,
count,
min,
max,
first_quartile,
third_quartile,
iqr,
profiler_interface=self.full_sqa_profiler_interface,
)
res = profiler.compute_metrics()._column_results
# The sum of all frequencies should be sampled
assert sum(res.get(User.id.name)[Metrics.histogram.name]["frequencies"]) == 30.0
def test_random_sample_unique_count(self, sampler_mock):
"""
Unique count should run correctly
"""
hist = Metrics.uniqueCount.value
profiler = Profiler(
hist,
profiler_interface=self.sqa_profiler_interface,
)
res = profiler.compute_metrics()._column_results
# As sampling can yield unique rows on small dataset validate we get a value
assert res.get(User.name.name)[Metrics.uniqueCount.name] is not None
def test_sample_data(self, sampler_mock):
"""
We should be able to pick up sample data from the sampler
"""
sample_data = self.full_sampler.fetch_sample_data()
assert len(sample_data.columns) == 6
assert len(sample_data.rows) == 30
# Order matters, this is how we'll present the data
names = [str(col.root) for col in sample_data.columns]
assert names == ["id", "name", "fullname", "nickname", "comments", "age"]
def test_sample_data_binary(self, sampler_mock):
"""
We should be able to pick up sample data from the sampler
"""
class UserBinary(Base):
__tablename__ = "users_binary"
id = Column(Integer, primary_key=True)
name = Column(String(256))
fullname = Column(String(256))
nickname = Column(String(256))
comments = Column(TEXT)
age = Column(Integer)
password_hash = Column(CustomTypes.BYTES.value)
UserBinary.__table__.create(bind=self.engine)
for i in range(10): # noqa: B007
data = [
UserBinary(
name="John",
fullname="John Doe",
nickname="johnny b goode",
comments="no comments",
age=30,
password_hash=b"foo",
),
]
self.session.add_all(data)
self.session.commit()
with patch.object(SQASampler, "build_table_orm", return_value=UserBinary):
sampler = SQASampler(
service_connection_config=self.sqlite_conn,
ometa_client=None,
entity=None,
)
sample_data = sampler.fetch_sample_data()
assert len(sample_data.columns) == 7
assert len(sample_data.rows) == 10
names = [str(col.root) for col in sample_data.columns]
assert names == [
"id",
"name",
"fullname",
"nickname",
"comments",
"age",
"password_hash",
]
assert type(sample_data.rows[0][6]) == str # noqa: E721
UserBinary.__table__.drop(bind=self.engine)
def test_sample_from_user_query(self, sampler_mock):
"""
Test sample data are returned based on user query
"""
stmt = "SELECT id, name FROM users"
with patch.object(SQASampler, "build_table_orm", return_value=User):
sampler = SQASampler(
service_connection_config=self.sqlite_conn,
ometa_client=None,
entity=None,
config=DatabaseSamplerConfig(
sample_config=SampleConfig(
profileSampleConfig=ProfileSampleConfig(
sampleConfigType=SampleConfigType.STATIC,
config=StaticSamplingConfig(profileSample=50.0),
)
),
sample_query=stmt,
),
)
sample_data = sampler.fetch_sample_data()
assert len(sample_data.columns) == 2
names = [col.root for col in sample_data.columns]
assert names == ["id", "name"]
def test_full_percentage_randomized_uses_sample_query(self, sampler_mock):
"""100% PERCENTAGE + randomizedSample=True should go through
get_sample_query which adds ORDER BY on the random column."""
with patch.object(SQASampler, "build_table_orm", return_value=User):
sampler = SQASampler(
service_connection_config=self.sqlite_conn,
ometa_client=None,
entity=None,
config=DatabaseSamplerConfig(
sample_config=SampleConfig(
profileSampleConfig=ProfileSampleConfig(
sampleConfigType=SampleConfigType.STATIC,
config=StaticSamplingConfig(
profileSample=100,
profileSampleType=ProfileSampleType.PERCENTAGE,
),
),
randomizedSample=True,
),
sample_data_count=5,
),
)
with patch.object(sampler, "get_sample_query", wraps=sampler.get_sample_query) as mock_gsq:
sampler.fetch_sample_data()
assert mock_gsq.called
def test_full_percentage_not_randomized_skips_sample_query(self, sampler_mock):
"""100% PERCENTAGE + randomizedSample=False should short-circuit
to raw dataset and NOT call get_sample_query."""
with patch.object(SQASampler, "build_table_orm", return_value=User):
sampler = SQASampler(
service_connection_config=self.sqlite_conn,
ometa_client=None,
entity=None,
config=DatabaseSamplerConfig(
sample_config=SampleConfig(
profileSampleConfig=ProfileSampleConfig(
sampleConfigType=SampleConfigType.STATIC,
config=StaticSamplingConfig(
profileSample=100,
profileSampleType=ProfileSampleType.PERCENTAGE,
),
),
randomizedSample=False,
),
sample_data_count=5,
),
)
with patch.object(sampler, "get_sample_query", wraps=sampler.get_sample_query) as mock_gsq:
sampler.fetch_sample_data()
assert not mock_gsq.called
def test_full_percentage_none_randomized_skips_sample_query(self, sampler_mock):
"""100% PERCENTAGE + randomizedSample=None should short-circuit
(only explicit True enables randomization)."""
with patch.object(SQASampler, "build_table_orm", return_value=User):
sampler = SQASampler(
service_connection_config=self.sqlite_conn,
ometa_client=None,
entity=None,
config=DatabaseSamplerConfig(
sample_config=SampleConfig(
profileSampleConfig=ProfileSampleConfig(
sampleConfigType=SampleConfigType.STATIC,
config=StaticSamplingConfig(
profileSample=100,
profileSampleType=ProfileSampleType.PERCENTAGE,
),
),
randomizedSample=None,
),
sample_data_count=5,
),
)
with patch.object(sampler, "get_sample_query", wraps=sampler.get_sample_query) as mock_gsq:
sampler.fetch_sample_data()
assert not mock_gsq.called
def test_randomized_true_produces_non_deterministic_rows(self, sampler_mock):
"""With randomizedSample=True at 100% PERCENTAGE, multiple
fetch_sample_data calls should return rows in different orders."""
with patch.object(SQASampler, "build_table_orm", return_value=User):
sampler = SQASampler(
service_connection_config=self.sqlite_conn,
ometa_client=None,
entity=None,
config=DatabaseSamplerConfig(
sample_config=SampleConfig(
profileSampleConfig=ProfileSampleConfig(
sampleConfigType=SampleConfigType.STATIC,
config=StaticSamplingConfig(
profileSample=100,
profileSampleType=ProfileSampleType.PERCENTAGE,
),
),
randomizedSample=True,
),
sample_data_count=5,
),
)
results = [sampler.fetch_sample_data().rows for _ in range(20)]
assert any(results[i] != results[0] for i in range(1, len(results))), (
"Expected non-deterministic row ordering with randomizedSample=True"
)
def test_randomized_false_produces_deterministic_rows(self, sampler_mock):
"""With randomizedSample=False at 100% PERCENTAGE, multiple
fetch_sample_data calls should return rows in the same order."""
with patch.object(SQASampler, "build_table_orm", return_value=User):
sampler = SQASampler(
service_connection_config=self.sqlite_conn,
ometa_client=None,
entity=None,
config=DatabaseSamplerConfig(
sample_config=SampleConfig(
profileSampleConfig=ProfileSampleConfig(
sampleConfigType=SampleConfigType.STATIC,
config=StaticSamplingConfig(
profileSample=100,
profileSampleType=ProfileSampleType.PERCENTAGE,
),
),
randomizedSample=False,
),
sample_data_count=5,
),
)
results = [sampler.fetch_sample_data().rows for _ in range(5)]
assert all(results[i] == results[0] for i in range(1, len(results))), (
"Expected deterministic row ordering with randomizedSample=False"
)
@classmethod
def tearDownClass(cls) -> None:
os.remove(cls.db_path) # noqa: PTH107
return super().tearDownClass()