Truthound โ Data Quality Workflow
Polars ๊ธฐ๋ฐ ์ ๋ก ์ค์ ๋ฐ์ดํฐ ํ์ง ํ๋ ์์ํฌ
Zero-Configuration Data Quality Framework Powered by Polars
Sniffs out bad data.

MCP๋ก ์ฌ์ฉํ๊ธฐ
Codex CLIยทClaude Code ํ๋ฌ๊ทธ์ธ๊ณผ ๋ณ๋ Claude Desktop ํ์ฅ ๋ชจ๋ Styxis Plugins์์ ์ค์น๋ฅผ ์์ํฉ๋๋ค. ๋ฐํ์๊ณผ MCP ์ค์ ์ ํ๋ฌ๊ทธ์ธ์ด ๊ด๋ฆฌํ๋ฉฐ, ์ค์น ํ ์ฌ์ฉํ ๋ฐ์ดํฐ ํด๋๋ฅผ ๋ณ๋๋ก ์น์ธํฉ๋๋ค.
| Truthound Local | Truthound Core |
|---|
 |  |
| ํ๋ฌ๊ทธ์ธ | Codex CLI | Claude Code |
|---|
| Truthound Local โ ๊ฒฐ์ธกยท์ค๋ณตยทํ๋กํ์ผ๋งยทPII ํ๋ณธ ๊ฒ์ฌ | codex plugin add truthound@styxis-plugin | claude plugin install truthound@styxis-plugin |
| Truthound Core โ ์คํค๋งยท๋๋ฆฌํํธยท๋ง์คํน ๋ฑ ์ถ๊ฐ ์์
| codex plugin add truthound-core@styxis-plugin | claude plugin install truthound-core@styxis-plugin |
Styxis Plugins์์ ์นดํ๋ก๊ทธ ์ฐ๊ฒฐยท์ค์น ์๋ด ๋ณด๊ธฐ โ
GitยทuvยทPython 3.11โ3.13๊ณผ ํ๋ฌ๊ทธ์ธ ์ง์ ํด๋ผ์ด์ธํธ๊ฐ ํ์ํฉ๋๋ค. Core์ ์์
๊ณต๊ฐยท์ด์์ ์ ์ดยท๋ฏผ๊ฐ ๊ฒฐ๊ณผ ๊ถํ์ ๋ณ๋ ์น์ธ ํญ๋ชฉ์ด๋ฉฐ ์ ์ฒด Core ๊ธฐ๋ฅ์ MCP ๋๋ฑ์ฑ์ ์์ง ๊ฒ์ฆ๋์ง ์์์ต๋๋ค.
๊ฐ์ (Overview)
Truthound๋ ๋ฐ์ดํฐ ํ์ง ๊ฒ์ฆ(Data Validation)๊ณผ ๋ฐ์ดํฐ ์ํฌํ๋ก์ฐ(Data Workflow)๋ฅผ ์ํ ์คํ์์ค ํ๋ ์์ํฌ์
๋๋ค. Polars ๊ธฐ๋ฐ์ ๊ฒ์ฆ ์ปค๋์ ์ค์ฌ์ผ๋ก, ์คํค๋ง ๊ฒ์ฆยท์ฌ์ฉ์ ์ ์ ๊ท์นยทํ์ง ๊ฒ์ฌยท์ด์ ๋ฐ์ดํฐ ํ์ง๋ฅผ ์ฝ๋๋ก ์ ์ธํ๊ณ , ๊ทธ ๊ฒฐ๊ณผ๋ฅผ ์ฌํ ๊ฐ๋ฅํ๊ฒ ๊ด๋ฆฌํฉ๋๋ค.
Truthound is an open-source framework for data validation and data quality workflows, built on a Polars-first validation kernel.
th.scan()์ ๋ฌธ์์ด ์ปฌ๋ผ๋ณ ์ฒซ 1,000๊ฐ ๋น๊ฒฐ์ธก๊ฐ์ ๊ฒ์ฌํ๋ PII ํ๋ณธ ํ์ง์
๋๋ค. ์ ์ฒด ํ๋ ์ ์ ์ฌ ์์ด ์ง๊ณยท์ ํ ํ๋ณธ์ ์ฌ์ฉํ๋ฉฐ ๋ฐ๊ฒฌ ๊ฑด์๋ ์ถ์ ์น์
๋๋ค. ์์ ํ Parquet footer ํต๊ณ๊ฐ ์์ผ๋ฉด ์ปฌ๋ผ๋ณ ํ๋ณธ ํ๋ณด ํ ์ฝ๊ธฐ๋ฅผ ์ข
๋ฃํ๊ณ , ํต๊ณ๊ฐ ์์ผ๋ฉด ๋ฐฐ์น ์ ์ฒด๋ฅผ ๊ณ์ํฉ๋๋ค. PII API๋ฅผ ์ฐธ๊ณ ํ์ธ์.
English Readme: English README
๋ฌธ์ (Documentation): www.truthound-docs.tech
ํํ์ ๊ฒ์ฆ์ ํต๊ณผํ ๊ฒ์ฌ๋ฅผ ์๋ตํด๋ ์คํจ ์ํยท๋น๋ยทํ์ ํด๋น ์ปฌ๋ผ์ ์ฐ๊ฒฐํฉ๋๋ค.
3.3.0์ aiยทmcpยทall extra๋ Pydantic 2.11 ์ด์์ ์๊ตฌํฉ๋๋ค.
Truthound Local ํ๋ฌ๊ทธ์ธ 0.1.11๊ณผ ๋ณ๋ truthound-core 0.2.6 ํ๋ฌ๊ทธ์ธ์ Core 3.3.4๋ฅผ ๊ณ ์ ํ๋ฉฐ ๋ฐ์ดํฐยท์์
๊ณต๊ฐยท์น์ธ ์ ์ฅ์ยท๋ฏผ๊ฐ ๊ฒฐ๊ณผ ๊ถํ์ ๋ช
์์ ์ผ๋ก ์ค์ ํ๊ณ ๋ณ๊ฒฝ ํ ์ฌ์ฐ๊ฒฐํฉ๋๋ค.
ํ๋ก์ ํธ ์๊ฐ (Introduction)
Truthound๋ Polars ๊ธฐ๋ฐ์ ์คํ์์ค ๋ฐ์ดํฐ ๊ฒ์ฆ ํ๋ ์์ํฌ์ ์ํฌํ๋ก์ฐ ์ค์ผ์คํธ๋ ์ด์
์ ์ ๊ณตํ๋ ํ๋ก์ ํธ์
๋๋ค. ๋ฐ์ดํฐ ์คํค๋ง ๊ฒ์ฆ, ์ฌ์ฉ์ ์ ์ ๊ท์น, ํ์ง ๊ฒ์ฌ, ์ด์ ๋ฐ์ดํฐ ํ์ง ๋ฑ ๋ค์ํ ๊ฒ์ฆ ๊ธฐ๋ฅ์ ์ง์ํ๋ฉฐ, Airflow, Dagster, Prefect ๋ฑ ์ฃผ์ ์ํฌํ๋ก์ฐ ํ๊ฒฝ๊ณผ ์ฐ๊ณํ์ฌ ๊ฒ์ฆ ์ ์ฐจ๋ฅผ ์๋ํํ ์ ์์ต๋๋ค. ์ฝ๋ ์ค์ฌ์ ์ ์ธ์ ๊ฒ์ฆ ๋ฐฉ์์ ํตํด ๋ฐ์ดํฐ ํ์ง ๊ด๋ฆฌ์ ์ฌํ์ฑ๊ณผ ์ ์ง๋ณด์์ฑ์ ๋์ด๊ณ , ๋ค์ํ ๋ฐ์ดํฐ ํ์ดํ๋ผ์ธ์์ ์ฝ๊ฒ ํ์ฉํ ์ ์๋๋ก ์ค๊ณ๋์์ต๋๋ค.
Truthound๋ ๋ ๊ฐ์ ์ ์ฅ์๋ก ๊ตฌ์ฑ๋ ํ๋์ ์คํ์์ค ์ํ๊ณ์
๋๋ค.
| ๊ตฌ์ฑ ์์ | ์ ์ฅ์ | ์ญํ |
|---|
| Truthound | truthound | ๊ฒ์ฆ ์ปค๋ โ th.check(), ValidationRunResult, ํ๋๋/๋ฐํ์, ์ ๋ก ์ค์ ์ํฌ์คํ์ด์ค, ๋ฆฌํฌํฐ, ์ฒดํฌํฌ์ธํธ |
| Truthound Orchestration | truthound-orchestration | Airflow, Dagster, Prefect, dbt, Mage, Kestra ๋ฑ ์ํฌํ๋ก์ฐ ํ๊ฒฝ ์ฐ๋ ๋ ์ด์ด |
์ฃผ์ ํน์ง (Key Features)
- Polars ์ฐ์ ์คํ: ๋ก์ปฌ ๊ฒ์ฆ์ Polars
LazyFrame์ ๊ธฐ์ค ๊ฒฝ๋ก๋ก ์ฌ์ฉํฉ๋๋ค. ๋ฐฐ์น ํํ์ยท๊ณต์ ๋ฉํธ๋ฆญ ์ ํธ๋ฆฌํฐ๋ ์ ๊ณตํ์ง๋ง, ๊ธฐ๋ณธ th.check() ๊ฒฝ๋ก๊ฐ ๋ชจ๋ ๊ฒ์ฆ๊ธฐ ๋ฉํธ๋ฆญ์ ์๋์ผ๋ก ๋จ์ผ ์ง๊ณ๋ก ํฉ์น๋ ๊ฒ์ ์๋๋๋ค.
- ์ ๋ก ์ค์ (Zero-Configuration):
th.check(data) ํ ์ค๋ก ๋ก์ปฌ .truthound/ ์ํฌ์คํ์ด์ค๋ฅผ ์๋ ์์ฑยท์ฌ์ฌ์ฉํฉ๋๋ค.
- ๊ฒฐ์ ๋ก ์ ์๋ ๊ฒ์ฆ ์ค์ํธ: ์คํค๋งยท๋ ํ์ฉยทํ์
ยท๋ฒ์ยทํค ํด๋ฆฌ์คํฑ์ ๊ธฐ์ค์ผ๋ก ํ์ํ ๊ฒ์ฌ๋ง ์ ํํฉ๋๋ค ("์ ๋ถ ์คํ"์ด ์๋).
- ๋จ์ผ ๊ฒฐ๊ณผ ๋ชจ๋ธ:
ValidationRunResult ํ๋๋ฅผ ์ฒดํฌํฌ์ธํธ, ๋ฆฌํฌํฐ, ๊ฒ์ฆ ๋ฌธ์, ํ๋ฌ๊ทธ์ธ์ด ๊ณต์ ํฉ๋๋ค.
- ๋ช
์์ ๊ณ์ฝ(Contract): ์ปจํ
์คํธ, ์ฒดํฌ ํฉํ ๋ฆฌ, ๋ฐฑ์๋, ์ํฐํฉํธ ์์ฑ์ ๋ํ ์์ ์ ์ธ ์ธํฐํ์ด์ค๋ฅผ ์ ๊ณตํฉ๋๋ค.
- ์ํฌํ๋ก์ฐ ์ฐ๊ณ: Truthound Orchestration์ ํตํด ์ค์ผ์ค๋ฌ/์ํฌํ๋ก์ฐ ํ๊ฒฝ์์ ํธ์คํธ ๋ค์ดํฐ๋ธ๋ก ์คํ๋ฉ๋๋ค.
AI ๊ฒํ ๊ธฐ๋ฅ์ ์ ํ์ ๋ณด์กฐ ๋ ์ด์ด๋ก ์ ๊ณต๋ฉ๋๋ค. Truthound์ ํต์ฌ์ ๋ฐ์ดํฐ ํ์ง ์ํฌํ๋ก์ฐ์ด๋ฉฐ, AI๋ ํ๋กฌํํธ ๊ธฐ๋ฐ ๊ฒ์ฆ ์ ์ยท์คํ ๋ถ์ ๋ฑ์ ์ฌ๋์ด ๊ฒํ ํ๋ ํํ๋ก ๋ณด์กฐํ ๋ฟ์
๋๋ค. AI ์์ด๋ ๋ชจ๋ ํต์ฌ ๊ธฐ๋ฅ์ด ๋์ํฉ๋๋ค.
๋ฒค์น๋งํฌ (Benchmark)
์๋ ํ๋ ๊ธฐ์กด์ ๊ณต๊ฐ๋ ๊ณ ์ ๋ฌ๋ release artifact set์ ์ญ์ฌ์ ์ธก์ ๊ฒฐ๊ณผ์
๋๋ค. ๋น์ ๋์ผ ์กฐ๊ฑด์ 8๊ฐ ์ํฌ๋ก๋์์ ์ ํ์ฑ์ ์ ์งํ๋ฉด์ Great Expectations ๋๋น ๋ ๋น ๋ฅธ ์คํ ์๊ฐ๊ณผ ๋ ๋ฎ์ ๋ฉ๋ชจ๋ฆฌ ์ฌ์ฉ์ ์ธก์ ํ์ผ๋ฉฐ, ์ดํ ๋ฒ์ ์ด๋ ๋ณ๊ฒฝ๋ ์ธก์ ๋ฐฉ์์ ์ฑ๋ฅ ํต๊ณผ๋ฅผ ๋ปํ์ง ์์ต๋๋ค.
| ์ํฌ๋ก๋ | Truthound Warm (s) | GX Warm (s) | ์๋ ํฅ์ | ๋ฉ๋ชจ๋ฆฌ ๋น์จ |
|---|
| local-mixed-core-suite | 0.028240 | 0.075232 | 2.66x | 44.29% |
| local-null | 0.016487 | 0.024964 | 1.51x | 43.62% |
| local-range | 0.002470 | 0.013219 | 5.35x | 43.84% |
| local-schema | 0.001479 | 0.017303 | 11.70x | 35.88% |
| local-unique | 0.002023 | 0.013785 | 6.81x | 42.28% |
| sqlite-null | 0.007370 | 0.032909 | 4.47x | 48.16% |
| sqlite-range | 0.006053 | 0.022355 | 3.69x | 43.80% |
| sqlite-unique | 0.002066 | 0.015655 | 7.58x | 42.12% |
์ด ๋น๊ต๋ ๊ฒฐ์ ๋ก ์ ํต์ฌ ๊ฒ์ฌ์ SQLite ํธ์๋ค์ด ์ํฌ๋ก๋๋ก ๋ฒ์๋ฅผ ํ์ ํ ๊ฒฐ๊ณผ์ด๋ฉฐ, ๋ชจ๋ ๊ธฐ๋ฅ ์์ญ์ ๋ํ ์ผ๋ฐํ๋ ์ฃผ์ฅ์ด ์๋๋๋ค. ์ ์ฅ์ ์์ .truthound/benchmarks/artifacts์๋ ์ผ๋ถ ์์ observation๋ง ๋จ์ ์์ ์ ์์ผ๋ฏ๋ก, ๊ณต์ ์์น๋ release artifact set๊ณผ Latest Verified Benchmark Summary๋ฅผ ๊ธฐ์ค์ผ๋ก ํด์ํด์ผ ํฉ๋๋ค.
์ ๋ฒค์น๋งํฌ์ ๊ธฐ๋ณธ ์ธก์ ๋ฐฉ์์ truthound-parity-thread-budget-v2์
๋๋ค. ๋ ํ๋ ์์ํฌ์ ๋์ผํ worker thread budget 1์ ์ ์ฉํ๊ณ , cold 1ํ์ warm 7ํ์ ์ ํ์ฑ ๋ฐ ๋ชจ๋ warm ์ธก์ ๊ฐ์ ๋ณด์กดํฉ๋๋ค. ๊ธฐ์กด ๊ฒฐ๊ณผ๋ ๋ฎ์ด์ฐ์ง ์์ผ๋ฉฐ, methodologyยท์ํฌ๋ก๋ ๊ณ์ฝยท๋ฐ์ดํฐยทbackendยทexactness๊ฐ ๋ค๋ฅธ ๊ฒฐ๊ณผ๋ฅผ ์ง์ ์ฑ๋ฅ ๋น๊ตํ์ง ์์ต๋๋ค. ๊ณต๊ฐ wheel์ ์์ ๋ ์ธก์ ๋๊ตฌ๋ก ์ฌ๊ฒ์ฆํ ๋๋ wheel ๋ฒ์ ยทdigest์ ๋๊ตฌ revision์ ๋ณ๋๋ก ๊ธฐ๋กํฉ๋๋ค. ๊ณต์ ๋ฆด๋ฆฌ์ค ๊ฒ์ฆ์๋ ์ ์ฒด ๊ธฐ๋ณธ methodology์ ๋ณ๊ฒฝํ์ง ์์ threshold๊ฐ ํ์ํ๋ฉฐ, ์ฌ์ฉ์ ์ง์ methodology๋ ์ฐธ๊ณ ์ฉ์
๋๋ค. ์ ๋ฐฉ์์ ์ฑ๋ฅ ํต๊ณผ๋ ์ค์ ๊ฒ์ฆ artifact๊ฐ ์์ด์ผ ์ธ์ ๋ฉ๋๋ค. ์์ธํ ๊ธฐ์ค์ Benchmark Methodology๋ฅผ ์ฐธ๊ณ ํ์ธ์.
์ฑ๋ฅ ์ฐจ์ด์ ์ฃผ์ ์์ธ:
- Polars
LazyFrame ๊ธฐ๋ฐ ๋ก์ปฌ ์คํ๊ณผ SQL ํธ์๋ค์ด ๊ฒฝ๋ก
- ์ผ๋ถ ๊ฒ์ฆ๊ธฐ์ ๊ณ ๊ธ ์ ํธ๋ฆฌํฐ์์ ์ ๊ณต๋๋ ๋ฐฐ์น ํํ์ยท๊ณต์ ๋ฉํธ๋ฆญ ์ต์ ํ
- ๊ธฐ๋ณธ ์์
์ ์ ํํ๊ณ ๊ด๋ จ์ฑ ์๊ฒ ์ ์งํ๋ ๊ฒฐ์ ๋ก ์ ์๋ ์ค์ํธ ์ ํ
- ๋ฌด๊ฑฐ์ด ํ๋ก์ ํธ ๋ถํธ์คํธ๋ฉ ์์ด ๋ฒ ์ด์ค๋ผ์ธ๊ณผ ์ํฐํฉํธ๋ฅผ ์ ์งํ๋ ๊ฐ๋ฒผ์ด ์ ๋ก ์ค์ ์ปจํ
์คํธ
- ๋ฆฌํฌํฐยท์ฒดํฌํฌ์ธํธยท๊ฒ์ฆ ๋ฌธ์๊ฐ ๊ณต์ ํ๋ ๋จ์ผ ๊ฒฐ๊ณผ ๊ณ์ฝ
๋น ๋ฅธ ์์ (Quick Start)
์ค์น (Installation)
pip install truthound[ai]
uv sync --extra dev --extra docs
Python API
import truthound as th
from truthound.datadocs import generate_validation_report
from truthound.reporters import get_reporter
from truthound.drift import compare
run = th.check(
{"customer_id": [1, 2, 2], "email": ["a@example.com", None, "c@example.com"]},
)
print(run.execution_mode)
print([check.name for check in run.checks])
print(run.metadata["context_root"])
json_report = get_reporter("json").render(run)
validation_docs = generate_validation_report(run, title="Customer Quality Overview", locale="ko")
context = th.get_context()
schema = th.learn({"id": [1, 2], "status": ["active", "inactive"]})
masked = th.mask(
{"email": ["a@example.com", "b@example.com"]},
columns=["email"],
strategy="hash",
)
drift = compare({"score": [0.1, 0.2]}, {"score": [0.1, 0.8]})
- ๋ณด๊ณ ์: A4 HTML/PDF๋ฅผ ์์ฑํ๋ฉฐ ๊ณต๊ฐ ํ
๋ง๋
lightยทdarkยทminimal์
๋๋ค. ๋ฒํธ๊ฐ ๋ถ์ ํยท๊ทธ๋ฆผยท๋ถ๋ก๊ณผ ํ์ง ์ฐจ์ยท์ง๋จ ๊ธฐ์คยท์๊ณ๊ฐ์ ์ ๊ณตํฉ๋๋ค.
- PDF ๋ฐฐ์น: ๊ธด ํยท์น์
์ ํ์ด์ง๋ณ๋ก ๋๋๊ณ , ํ ํ์ด์ง์ ๋ค์ด๊ฐ๋ ์นด๋๋ ํจ๊ป ๋ฐฐ์นํฉ๋๋ค. ๊ธด ์ปฌ๋ผ๋ช
๊ณผ JSON ์์๋ ์๋ต ์์ด ์ค๋ฐ๊ฟํฉ๋๋ค.
- ์๋ฃํยทํต๊ณ: ์๋ฃํ์
inferred_type โ physical_type โ dtype ์์ผ๋ก ํ์ํ๋ฉฐ, ์์ผ๋ฉด unknown์
๋๋ค. ์ ์๋์ง ์์ ์๋ยท์ฒจ๋๋ JSON null๋ก ํํํ๊ณ ์๋ณธ ๊ฐ๊ณผ ๋ค๋ฅธ ํต๊ณ๋ ์ ์งํฉ๋๋ค.
- ๊ณ ๊ธ ์ฐ๋:
ReportDocument๋ก ๊ตฌ์กฐ๋ฅผ ๊ฒ์ฌํ๋ฉฐ generate_html_report, HTMLReportBuilder, export_to_pdf ํธํ์ฑ์ ์ ์งํฉ๋๋ค.
CLI
truthound check data.csv --validators null,unique
truthound check --connection "sqlite:///warehouse.db" --table users --pushdown
truthound scan pii.csv
truthound profile data.csv
truthound doctor . --workspace
truthound plugins list --json
truthound ai suggest-suite data.csv --prompt "Require customer_id to be unique"
truthound ai proposals list
truthound ai explain-run --run-id <run_id>
์ ๋ก ์ค์ ์ํฌํ๋ก์ฐ (Zero-Config Workflow)
Truthound๋ ํ๋ก์ ํธ ๋ฃจํธ์ .truthound/ ์ํฌ์คํ์ด์ค๋ฅผ ์๋์ผ๋ก ์์ฑํฉ๋๋ค. ๊ธฐ๋ณธ์ ์ผ๋ก ๋ค์์ ๊ด๋ฆฌํฉ๋๋ค.
.truthound/config.yaml: ํด์๋ ํ๋ก์ ํธ ๊ธฐ๋ณธ๊ฐ
.truthound/catalog/: ์์ฐ ํ๊ฑฐํ๋ฆฐํธ์ ์์ค ์๊ทธ๋์ฒ
.truthound/baselines/: ํ์ต๋ ์คํค๋ง์ ๋ฉํธ๋ฆญ ํ์คํ ๋ฆฌ
.truthound/runs/: ์ ์ฅ๋ ValidationRunResult ๋ฉํ๋ฐ์ดํฐ
.truthound/docs/: ์์ฑ๋ ๊ฒ์ฆ ๋ฌธ์
.truthound/plugins/: ํด์๋ ํ๋ฌ๊ทธ์ธ ๋งค๋ํ์คํธ์ ์ ๋ขฐ ๋ฉํ๋ฐ์ดํฐ
th.check(data)๋ง ํธ์ถํด๋ Truthound๋ ๋ค์ ์์๋ก ๋์ํฉ๋๋ค.
- ์์ฐ/๋ฐฑ์๋ ๊ฐ์ง
- ํ์ฑ
TruthoundContext ํด์
- ๋ฒ ์ด์ค๋ผ์ธ ๋ก๋ ๋๋ ์์ฑ
- ์๋ ๊ฒ์ฆ ์ค์ํธ ํฉ์ฑ
- ๊ฒ์ฆ ๊ณํ ์๋ฆฝ ๋ฐ ์คํ
- (ํ์ฑํ ์) ์คํ ๊ฒฐ๊ณผ์ ๊ฒ์ฆ ๋ฌธ์ ์ ์ฅ
truthound doctor . --workspace๋ก ๋ก์ปฌ .truthound/ ๋ ์ด์์๊ณผ ์ธ๋ฑ์ค, ๋ฒ ์ด์ค๋ผ์ธ, ์ ์ฅ๋ ์คํ ์ํฐํฉํธ์ ๊ตฌ์กฐ์ ๋ฌด๊ฒฐ์ฑ์ ์ ๊ฒํ ์ ์์ต๋๋ค.
๊ณต๊ฐ API (Public Surface)
Lineage sample ๋ฉํ๋ฐ์ดํฐ๋ ๋ช
์์ ํ์ฑํ ์์๋ง ํยท๋ฐ์ดํธ ์ ํ ์์์ ๋ณต์ฌํ๋ฉฐ ์๋ณธ ์์ฐ์ ์๋์ผ๋ก ์ํ๋งํ์ง ์์ต๋๋ค.
๊ณ ๊ธ Arrow ๋ณํ์ ๋ณด๊ด๋ ์ธ๋ฑ์คยทnullยท์๊ฐ ์ ์ฑ
๊ณผ ํยท๋ฐ์ดํธ ์ ํ์ ์ ์ฉํฉ๋๋ค. materialization ํ๊ณ๋ ๋ถ์ฐ ํ๋กํ์ผ๋ง ๊ฐ์ด๋์ ์ค๋ช
๋์ด ์์ต๋๋ค.
ํ์ผ ์ ์ฅ์์ suite ์ฟผ๋ฆฌ๋ ์ ํํ ์ ๋ ฌ ๋ค ํ์ด์ง๋ฅผ ๋๋๋ฉฐ, ๋ชจํธํ JSON ๊ธฐ๋ก์ ์ธ๋ฑ์ค ์ฌ๊ตฌ์ถ์์๋ ๊ฑฐ๋ถํฉ๋๋ค.
๋ฃจํธ ํจํค์ง๋ ์๋์ ์ผ๋ก ์์ API๋ง ๋
ธ์ถํฉ๋๋ค.
๊ณต๊ฐ ํจ์์ ํ์
์ ์ฒซ ์ ๊ทผ ์ ๋ก๋ํ๋ฉฐ ๊ธฐ์กด Core ๊ฐ์ฒด์ ๋์์ ์ ์งํฉ๋๋ค.
- ์์ ํ์ฌ๋:
check, scan, mask, profile, learn, read, get_context
- ํต์ฌ ํ์
:
TruthoundContext, ValidationSuite, CheckSpec, SchemaSpec, ValidationRunResult, CheckResult
th.check()๋ ValidationRunResult๋ฅผ ์ง์ ๋ฐํํฉ๋๋ค.
- ์ ์ฅ์ ์๋ณต์ ๊ฒ์ฌ๋ณ ๊ทผ๊ฑฐ๋ฅผ ๋ณด์กดํ๋ฉฐ ์คํ ํ์ผ ๋ก๋ฉ์ ๋๋ฝ๋ ํ์ ์ ๊ฑฐ๋ถํฉ๋๋ค. ๊ฒฐ๊ณผ ์ ์ฅยท๋ณต์ ๊ณ์ฝ์ ์ฐธ๊ณ ํ์ธ์.
- 3.1.14๋ถํฐ issue ์์ธ๊ฐ ์์ด๋ ๋ช
์์ ์ผ๋ก ์คํจํ check๋ฅผ ์คํจ๋ก ๋ณด์กดํฉ๋๋ค. ์ค์น๋ ๋ฒ์ ์ ํ์ธํด์ผ ํฉ๋๋ค.
- ์ฒดํฌํฌ์ธํธ ๊ฒฐ๊ณผ:
CheckpointResult.validation_run์ด ์ ์์ด๋ฉฐ, CheckpointResult.validation_view๋ ๋ ๊ฑฐ์ ํธํ ํ๋ก์ ์
์
๋๋ค.
- ๋ฆฌํฌํฐ ํ์
:
truthound.reporters.RunPresentation, truthound.reporters.ReporterContext
- ๊ฒ์ฆ ๋ฌธ์ ์ง์
์ :
truthound.datadocs.ValidationDocsBuilder, truthound.datadocs.generate_validation_report
- 3.1.13๋ถํฐ
locale="en"(๊ธฐ๋ณธ๊ฐ) ๋๋ locale="ko"๋ ๋ณธ๋ฌธ ์ ๋ชฉยทํ ๋จธ๋ฆฌ๊ธยท์๋ฆผ์ ๋ฒ์ญํฉ๋๋ค. ํ์ง ์์นยท์ํ ์ฝ๋ยท์ฌ์ฉ์ ๋ฐ์ดํฐ๋ ๋ฐ๊พธ์ง ์์ผ๋ฉฐ ๋ฏธ์ง์ locale์ ValueError์
๋๋ค. ์ด์ ๋ฒ์ ์๋ ์ด ์ต์
์ด ์์ต๋๋ค.
- ๋๋ฆฌํํธ ๋น๊ต:
truthound.drift.compare; ๋ช
์ํ 0 ์๊ณ๊ฐ์ ์ ์งํ๋ฉฐ ์๋ชป๋ ์ค์ ๊ณผ ์ ํํ์ง ์์ ์ซ์ ์
๋ ฅ์ ์ค๋ฅ๋ก ๋ณด๊ณ ํฉ๋๋ค.
- ERD ๊ฐ์ฌ(๊ฐ๋ฐ ์ค):
truthound.schema_audit์ ๋ถ๋ณ ๋ชจ๋ธยทJSONยทdigest, ํ์คโ์ค๊ณ ๊ฐ์ฌ A, ์ค๊ณโ์นดํ๋ก๊ทธ ๊ฐ์ฌ B์ ์ ํ๋ PG14/17 ์ฝ๊ธฐ ์ ์ฉ ์์ง๊ธฐ. Consoleยท์ ์ ์ธ๊ฐยท์น์ธ ๊ถํ์ ๋ณ๋์
๋๋ค.
- ๊ณ ๊ธ ์์คํ
: ๋ค์์คํ์ด์ค๋ก ์ํฌํธ (์:
truthound.ml, truthound.lineage, truthound.realtime, truthound.datadocs) ๋ค์ดํฐ๋ธ ๋ชจ๋ธ ์์ฑ์๋ ์ค์ ์ ๋ณต์ฌํ๊ณ ์ ์ ์๋ override๋ฅผ ๊ฑฐ๋ถํฉ๋๋ค. ํ์ต ํ๋ณธ์ ์๋๋ฅผ ์ ์ฉํ๊ณ ๋ด์ฅ ํ์ง๊ธฐ์ ์ฌํ์ต ์คํจ ์ ๊ธฐ์กด ๋ชจ๋ธ์ ๋ณด์กดํฉ๋๋ค. ๊ฐ๋
๋๋ฆฌํํธ๋ ์๊ด๊ด๊ณ ๊ธฐ๋ณธ๊ฐ๊ณผ ์ค์ River DDMยทADWINยทPage-Hinkley ์คํธ๋ฆผ ๋น๊ต๋ฅผ ์ ๊ณตํฉ๋๋ค(๊ณ์ฝ). ๊ณ๋ณด ์ถ์ ์ ๋ช
์์ ํ ์์นยท์ปจํ
์คํธ ์ฐ๊ฒฐยท์ฌ๊ฐ ๊ฐ๋ฅํ ์๋ ์ ์ฅยท๋ช
์์ ์ผ๋ก ์ ๊ณตํ ์ ํ๋ ํ๋ณธ์ ์ง์ํ๋ฉฐ OpenLineage ์ ์ก์ ๊ฒฐ๊ณผ ๋ถ๋ช
์ ํ์ ๋ณด์กดํ๊ณ ์ข
๋ฃ ์ ์์ ์์ฒญ์ ํ์ํฉ๋๋ค(๊ณ์ฝ).
- ์ ํ์ AI ๋ ์ด์ด:
truthound[ai] ์ค์น ํ truthound.ai ์ํฌํธ
๋ฌธ์ (Documentation)
๋ผ์ด์ ์ค (License)
Apache License 2.0. ์์ธํ ๋ด์ฉ์ LICENSE๋ฅผ ์ฐธ๊ณ ํ์ธ์.