mrkeyoor.com_
Tue 01 Sept 17:45 UTC
Dataevaluationupdated 25 Aug 2026

projeto-dados-ia-databricks review

Projeto Dados IA Databricks is a Portuguese-language workshop for building a fictional perfume distributor's analytics stack on Databricks Free Edition; no English documentation is provided. It teaches SQL, medallion layers, Asset Bundles, dashboards, Genie, and Claude Code through seeded business data with deliberate quality problems.

+77stars / 7d
Verdict

Our run installed 35 packages in 11 seconds and built in 3 seconds, but the repository supplied no automated test target. Portuguese-speaking beginners can learn a lot from its deliberate dirty data and exact Databricks failure notes. Wait if you need the unfinished third night, English materials, or a licensed production template.

We ran it

Lab card: what happened when we ran projeto-dados-ia-databricksScreenshot of projeto-dados-ia-databricks (github.com/lvgalvao/projeto-dados-ia-databricks)
Install✓ · 11s35 packages · 37 MB
Build✓ · 3s
Testsn/ano test script
Known vulns0(pip-audit)
Repo69 files~1,312 lines of source · 44.1 MB · 0 CI workflows

Answers from our run

Does projeto-dados-ia-databricks build from source?

Dependencies installed in 11 seconds (35 packages), and the build succeeded in 3 seconds. We cloned commit b4035d2 into a clean Debian container with 3 CPUs and no project-specific setup.

Does projeto-dados-ia-databricks have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does projeto-dados-ia-databricks have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use projeto-dados-ia-databricks?

English-only learners: the main README, lesson guides, column names, prompts, slides, and business vocabulary are in Portuguese, with no English guide.

What are the alternatives to projeto-dados-ia-databricks?

Data Engineering Zoomcamp, Databricks Bundle Examples, dbdemos. Our run installed 35 packages in 11 seconds and built in 3 seconds, but the repository supplied no automated test target.

Setup3/5Fast local steps; Databricks, Claude, profiles, and MCP add work
Docs4/5Excellent Portuguese walkthroughs, with no English edition
Community2/5189 stars and a fresh push, but no issues or release history
Maturity2/5Two lessons are detailed; night 3 and automated tests are absent

Who it’s for

Portuguese-speaking beginners who want a guided Databricks project with fixed expected results.
Instructors who need solved SQL, blank notebooks, slides, recordings, and a local fallback.
Data engineers learning Databricks Asset Bundles through repeated validate, deploy, and run cycles.
Claude Code users practicing project-scoped skills, MCP access, Git review, and destructive-command guards.

Who it’s NOT for

English-only learners: the main README, lesson guides, column names, prompts, slides, and business vocabulary are in Portuguese, with no English guide.
Anyone seeking a completed four-part course: the README marks night 3 as still to be built and says night 4 was removed from the calendar.
Teams looking for a cloud-neutral pipeline template: the exercises depend on Databricks Free Edition, Unity Catalog, serverless compute, Asset Bundles, AI/BI dashboards, and Genie.
Learners who want a tested Python package: our checkout had no test script or target, no tests directory, and no CI workflow.
Organizations that need clear reuse rights: GitHub reports no repository license, so copying course material into commercial training needs permission.

Setup reality

Our Python sandbox installed 35 packages in 11 seconds and used 37 MB, then the build step succeeded in 3 seconds. Pip-audit found 0 known vulnerabilities. The checkout was 44.1 MB across 69 files and about 1,312 source lines. There was no test target, so tests were skipped.

Running the lessons needs Python 3.10 through 3.12, the modern Databricks CLI, a Free Edition workspace, browser authentication saved under an explicit profile, serverless compute, and the generated dataset. Night 2 also expects uv, GitHub CLI, Claude Code, Databricks AI Dev Kit skills, and an MCP connection.

The provided bundle assumes catalog lakehouse_rotaperfume and Portuguese table names. Free Edition requires creating the catalog through SQL before bundle deployment, and quotas can stop compute. The reset script is dry-run by default but can delete the catalog, bundle, and local code when given --apagar, so read its target list before using that flag.

Two finished nights teach one Databricks sales pipeline

The repository is course material for a fictional B2B distributor of Arabic perfume. Night 1 introduces Databricks SQL, uploads raw CSV files, creates bronze tables, and asks revenue and customer questions. Night 2 turns the exercise into a scheduled Asset Bundle with raw, bronze, silver, and gold layers, then adds a versioned dashboard and Genie space. The main README marks night 3 as unfinished. It says the original fourth night was removed because deployment now happens throughout night 2.

Our checkout at commit b4035d2 held 69 files, about 1,312 source lines, and 44.1 MB. Much of that footprint comes from course assets such as slide decks and a zipped dataset rather than application code. Each lesson directory stands alone with a README, solved examples, and supporting files. Students can enter at the lesson level instead of decoding a generic scaffold.

Seed 42 turns dirty data into repeatable exercises

A local generator creates the same fictional dataset for every learner. It includes ERP and CRM tables with inconsistent dates, formatted tax IDs, duplicate customers, returns stored as negative quantities, and active accounts assigned to former salespeople. Bronze preserves incoming text. Silver cleans and labels anomalies. Gold produces dimensions, sales facts, marts, business views, and audit queries. Expected row counts and financial totals help students catch a wrong transformation.

The repo measured 44.1 MB before generation, while the README says the generated CSV set is roughly 14 MB. One local Python script calculates revenue without Databricks if the workshop workspace is unavailable. The business domain is specific enough to feel coherent, though all names, columns, currency, and explanations assume a Brazilian Portuguese audience.

Six deploy cycles expose Databricks-specific failure modes

Night 2 uses six prompts and six validate, deploy, and run loops. The final job has 12 tasks across ingestion, four silver transformations, dimensions, facts, marts, tests, business metrics, and metadata audit. Students create the catalog once, deploy the bundle, upload raw files after the volume exists, and run the pipeline through an explicit named profile.

The lab build step finished in 3 seconds, but we did not connect to Databricks or claim the course's cloud outputs as our measurements. The guide documents Free Edition catalog creation failing through the bundle API, development mode prefixing schema names, ANSI date parsing aborting on malformed values, and schema inference stripping leading zeros. These warnings explain failures learners are likely to see.

Claude Code is part of the lesson, not an optional aside

The course asks learners to install Claude Code, project-scoped Databricks AI Dev Kit skills, and an MCP connection. Six stored prompts create successive pipeline parts. Git is initialized first so students can inspect diffs and revert mistakes. The guide recommends denying bundle destruction, production deployment, recursive deletion, and force pushes, plus a deterministic hook against unsafe SQL mutations.

That adds prerequisites beyond the 35 packages installed in our sandbox. Students need the Databricks CLI, Python 3.10 through 3.12, uv, GitHub CLI, Claude Code, a browser-authenticated profile, and working MCP configuration. The README tells users to search for the AI Dev Kit rather than pinning an installer. A solo learner may spend time reconciling tool versions and account screens.

What happened when we ran it

Our run at commit b4035d2 installed 35 packages in 11 seconds, consuming 37 MB on disk. The build completed in 3 seconds, and pip-audit reported 0 known vulnerabilities. Tests were skipped because the repository has no test script or target. The unprivileged Python 3.12 Debian container had 3 CPUs, 8 GB of RAM, and no secrets.

The repository had 0 CI workflow files, no Dockerfile, and no tests directory. It does contain SQL quality checks inside the teaching pipeline, including reconciliation between silver and gold outputs. Those checks run in Databricks, apart from an automated repository suite. A typo in the generator, runner, bundle YAML, or dashboard asset has no checked-in CI gate in the version we measured.

Portuguese detail is excellent, while English coverage is zero

Both lesson guides include prerequisite versions, commands, expected errors, corrections, blank notebooks, solved SQL, dashboard JSON, slides, recordings, and a reset script. Night 2 explains why a plausible nonnegative revenue constraint failed on legitimate returns. The example shows that a quality rule can encode a false business assumption.

There is no English README, translated lesson, or glossary. GitHub showed 189 stars, no open issues or pull requests, a push on August 25, 2026, and no release. The repository also has no declared license. The fresh push supports its current workshop, while the unfinished third night and absent license argue against repackaging it as a settled curriculum.

Use it as a workshop, not as a production starter

The 11-second install and 3-second build make local inspection cheap. Databricks Free Edition, the tool chain, and careful cloud execution are the larger commitment. Choose official bundle examples for a concise reference or Data Engineering Zoomcamp for a broader English course. Choose this repository when its Portuguese classroom pacing fits, and accept that night 3 is not there yet.

Alternatives

ProjectWhat it isPick it when
Data Engineering ZoomcampA longer free course covering pipelines, warehouses, batch, streaming, and analytics engineering.pick this instead when you want a broader English curriculum that is not centered on Databricks.
Databricks Bundle ExamplesOfficial examples for common Databricks Asset Bundle configurations.pick this instead when you already know Databricks and need concise bundle references rather than a class.
dbdemosA large catalog of ready-to-run Databricks lakehouse demos across many use cases.pick this instead when you want varied platform demos rather than one guided sales dataset.

What people are saying

  1. [velocity-scout] lvgalvao/projeto-dados-ia-databricks

Sources

  1. Projeto Dados IA Databricks README
  2. Night 1 Databricks SQL guide
  3. Night 2 data engineering guide
  4. Repository facts

More data reviews

turso · TrackersListCollection · dash · getcontact-cli · awesome-zhuiju-free · iggy · the whole board →