02 filter

%23%20%2F%2F%2F%20script%0A%23%20requires-python%20%3D%20%22%3E%3D3.13%22%0A%23%20dependencies%20%3D%20%5B%0A%23%20%20%20%20%20%22marimo%22%2C%0A%23%20%20%20%20%20%22marimo-learn%3E%3D0.7.0%22%2C%0A%23%20%20%20%20%20%22polars%3D%3D1.24.0%22%2C%0A%23%20%20%20%20%20%22sqlalchemy%22%2C%0A%23%20%5D%0A%23%20%2F%2F%2F%0A%0Aimport%20marimo%0A%0A__generated_with%20%3D%20%220.21.1%22%0Aapp%20%3D%20marimo.App(width%3D%22medium%22)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_()%3A%0A%20%20%20%20import%20marimo%20as%20mo%0A%20%20%20%20import%20marimo_learn%20as%20mol%0A%20%20%20%20import%20sqlalchemy%0A%0A%20%20%20%20db_path%20%3D%20mol.localize_file(%22penguins.db%22)%0A%20%20%20%20DATABASE_URL%20%3D%20f%22sqlite%3A%2F%2F%2F%7Bdb_path%7D%22%0A%20%20%20%20engine%20%3D%20sqlalchemy.create_engine(DATABASE_URL)%0A%20%20%20%20return%20engine%2C%20mo%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_()%3A%0A%20%20%20%20from%20marimo_learn%20import%20MatchingWidget%2C%20MultipleChoiceWidget%0A%0A%20%20%20%20return%20MatchingWidget%2C%20MultipleChoiceWidget%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%20Filtering%0A%0A%20%20%20%20The%20previous%20tutorial%20showed%20how%20to%20select%20specific%20columns%20from%20a%20database%20table%2C%20and%20how%20to%20page%20through%20the%20data%20that%20a%20query%20returns.%20However%2C%20people%20almost%20always%20**filter**%20data%20based%20on%20its%20properties%20rather%20than%20on%20its%20position%20in%20a%20table.%20To%20see%20how%20this%20works%2C%20let's%20look%20at%20the%20combinations%20of%20species%2C%20island%2C%20and%20sex%20in%20the%20%60penguins%60%20table.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(engine%2C%20mo)%3A%0A%20%20%20%20_df%20%3D%20mo.sql(%0A%20%20%20%20%20%20%20%20f%22%22%22%0A%20%20%20%20%20%20%20%20select%20distinct%20species%2C%20island%2C%20sex%20from%20penguins%3B%0A%20%20%20%20%20%20%20%20%22%22%22%2C%0A%20%20%20%20%20%20%20%20engine%3Dengine%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Equality%0A%0A%20%20%20%20Suppose%20we%20only%20want%20to%20see%20penguins%20from%20Dream%20island%2C%20regardless%20of%20their%20species%20or%20sex.%20To%20get%20this%2C%20we%20add%20a%20%60where%60%20clause%20to%20our%20query.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(engine%2C%20mo)%3A%0A%20%20%20%20_df%20%3D%20mo.sql(%0A%20%20%20%20%20%20%20%20f%22%22%22%0A%20%20%20%20%20%20%20%20select%20distinct%20species%2C%20island%2C%20sex%20%0A%20%20%20%20%20%20%20%20from%20penguins%0A%20%20%20%20%20%20%20%20where%20island%20%3D%20%22Dream%22%3B%0A%20%20%20%20%20%20%20%20%22%22%22%2C%0A%20%20%20%20%20%20%20%20engine%3Dengine%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20There%20are%20several%20noteworthy%20things%20in%20this%20query%3A%0A%0A%20%20%20%201.%20We%20don't%20have%20to%20use%20%60distinct%60.%20If%20we%20leave%20it%20out%2C%20we%20get%20*all*%20the%20penguins%20on%20Dream%20island.%20(We%20included%20it%20to%20make%20the%20output%20easier%20to%20read%20without%20paging.)%0A%20%20%20%202.%20The%20%60where%60%20clause%20*must*%20come%20after%20the%20%60from%60%20clause.%20SQL%20is%20very%20picky%20about%20ordering%E2%80%A6%0A%20%20%20%203.%20We%20don't%20put%20quotation%20marks%20around%20%60island%60%20because%20it's%20the%20name%20of%20a%20column.%20We%20*do*%20put%20quotes%20around%20%60%22Dream%22%60%20because%20it's%20an%20actual%20literal%20piece%20of%20text.%0A%20%20%20%204.%20We%20use%20a%20single%20equals%20sign%20%60%3D%60%20to%20check%20for%20equality.%20This%20is%20different%20from%20most%20programming%20languages%2C%20which%20use%20%60%3D%3D%60.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20Write%20a%20query%20to%20select%20all%20the%20Chinstrap%20penguins%20regardless%20of%20what%20island%20they're%20on.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%201.%20Change%20the%20column%20name%20%60island%60%20to%20%60ISLAND%60%20and%20re-run%20the%20query%3A%20what%20happens%3F%0A%20%20%20%20%3E%202.%20Change%20the%20text%20value%20%60%22Dream%22%60%20to%20%60%22DREAM%22%60%3A%20what%20happens%3F%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Comparisons%0A%0A%20%20%20%20We%20can%20do%20all%20of%20the%20usual%20comparisons%20in%20SQL%3A%0A%0A%20%20%20%20%7C%20name%20%7C%20symbol%20%7C%20example%20%7C%0A%20%20%20%20%7C%20%3A---%20%7C%20------%20%7C%20%3A------%20%7C%0A%20%20%20%20%7C%20less%20than%20%7C%20%60%3C%60%20%7C%20%60body_mass_g%20%3C%203300%60%20%7C%0A%20%20%20%20%7C%20less%20than%20or%20equal%20%7C%20%60%3C%3D%60%20%7C%20%60flipper_length_mm%20%3C%20200.0%60%20%7C%0A%20%20%20%20%7C%20equal%20%7C%20%60%3D%60%20%7C%20%60species%20%3D%20%22Gentoo%22%60%20%7C%0A%20%20%20%20%7C%20not%20equal%20%7C%20%60!%3D%60%20or%20%60%3C%3E%60%20%7C%20%60species%20!%3D%20%22Gentoo%22%60%20%7C%0A%20%20%20%20%7C%20greater%20than%20or%20equal%20%7C%20%60%3E%3D%60%20%7C%20%60flipper_length_mm%20%3E%3D%20200.0%60%20%7C%0A%20%20%20%20%7C%20greater%20than%20%7C%20%60%3E%60%20%7C%20%60body_mass_g%20%3E%203300%60%20%7C%0A%0A%20%20%20%20Comparing%20numbers%20is%20straightforward.%20When%20we%20compare%20text%2C%20the%20comparison%20uses%20dictionary%20order%3A%20A%20is%20less%20than%20B%2C%20AA%20is%20than%20AB%2C%20and%20so%20on.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20Find%20all%20the%20penguins%20that%20_aren't_%20on%20Torgersen%20island.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20Use%20%60where%60%2C%20%60order%20by%60%2C%20and%20%60limit%60%20to%20find%20the%20heaviest%20penguin.%20Use%20it%20again%20to%20find%20the%20lightest.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20What%20happens%20if%20we%20accidentally%20compare%20a%20number%20to%20text%3F%20For%20example%2C%20what%20happens%20if%20we%20select%20penguins%20where%20%60species%60%20is%20less%20than%203000%2C%20or%20where%20%60body_mass_g%60%20is%20greater%20than%20the%20letter%20'M'%3F%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Combining%20Conditions%0A%0A%20%20%20%20We%20can%20combine%20conditions%20using%20%60and%60%20and%20%60or%60.%20%60and%60%20is%20the%20simpler%20of%20the%20two%3A%20when%20we%20write%20%60where%20condition_1%20and%20condition_2%60%2C%20we%20get%20the%20rows%20where%20*both*%20conditions%20are%20true.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(engine%2C%20mo)%3A%0A%20%20%20%20_df%20%3D%20mo.sql(%0A%20%20%20%20%20%20%20%20f%22%22%22%0A%20%20%20%20%20%20%20%20select%20*%20from%20penguins%0A%20%20%20%20%20%20%20%20where%20species%20%3D%20'Gentoo'%20and%20body_mass_g%20%3E%206000.0%3B%0A%20%20%20%20%20%20%20%20%22%22%22%2C%0A%20%20%20%20%20%20%20%20engine%3Dengine%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20If%20we%20use%20%60or%60%2C%20we%20get%20rows%20where%20*either%20or%20both*%20condition%20is%20true.%20This%20is%20different%20from%20common%20English%20usage%3A%20if%20you%20tell%20a%20child%20that%20they%20can%20have%20an%20ice%20cream%20cone%20or%20a%20chocolate%20bar%2C%20you%20mean%20%22either%2For%22.%20When%20you%20use%20%60or%60%20in%20SQL%2C%20on%20the%20other%20hand%2C%20it%20means%20%22if%20any%20of%20the%20conditions%20is%20true%22.%20For%20example%2C%20the%20query%20below%20gets%20all%20of%20the%20penguins%20on%20Biscoe%20island%2C%20as%20well%20as%20all%20of%20the%20Gentoo%20penguins.%20Some%20penguins%20satisfy%20both%20conditions%20(the%20Adelie%20penguins%20on%20Biscoe%20island)%2C%20some%20satisfy%20just%20one%20(the%20Adelies%20on%20Torgersen%20and%20the%20Gentoos%20on%20Biscoe).%20Penguins%20that%20don't%20satisfy%20either%2C%20like%20Chinstrap%20penguins%20on%20Dream%20island%2C%20don't%20show%20up%20at%20all.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(engine%2C%20mo)%3A%0A%20%20%20%20_df%20%3D%20mo.sql(%0A%20%20%20%20%20%20%20%20f%22%22%22%0A%20%20%20%20%20%20%20%20select%20distinct%20species%2C%20island%20from%20penguins%0A%20%20%20%20%20%20%20%20where%20species%20%3D%20'Adelie'%20or%20island%20%3D%20'Biscoe'%3B%0A%20%20%20%20%20%20%20%20%22%22%22%2C%0A%20%20%20%20%20%20%20%20engine%3Dengine%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20We%20have%20written%20our%20%60where%60%20conditions%20as%20we%20would%20say%20them.%20Many%20programmers%20would%20wrap%20each%20condition%20in%20parentheses%20to%20make%20them%20easier%20to%20read.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(engine%2C%20mo)%3A%0A%20%20%20%20_df%20%3D%20mo.sql(%0A%20%20%20%20%20%20%20%20f%22%22%22%0A%20%20%20%20%20%20%20%20select%20distinct%20species%2C%20island%20from%20penguins%0A%20%20%20%20%20%20%20%20where%20(species%20%3D%20'Adelie')%20or%20(island%20%3D%20'Biscoe')%3B%0A%20%20%20%20%20%20%20%20%22%22%22%2C%0A%20%20%20%20%20%20%20%20engine%3Dengine%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20The%20more%20complex%20our%20conditions%20are%2C%20the%20more%20important%20it%20is%20to%20use%20parentheses%20to%20make%20sure%20everyone%20reading%20the%20query%20(including%20ourselves)%20understands%20what%20it%20means.%20The%20query%20below%20shows%20an%20example.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(engine%2C%20mo)%3A%0A%20%20%20%20_df%20%3D%20mo.sql(%0A%20%20%20%20%20%20%20%20f%22%22%22%0A%20%20%20%20%20%20%20%20select%20distinct%20species%2C%20island%20from%20penguins%0A%20%20%20%20%20%20%20%20where%20((species%20%3D%20'Adelie')%20and%20(island%20%3D%20'Biscoe'))%20or%20(species%20%3D%20'Chinstrap')%3B%0A%20%20%20%20%20%20%20%20%22%22%22%2C%0A%20%20%20%20%20%20%20%20engine%3Dengine%0A%20%20%20%20)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20Explain%20in%20simple%20terms%20what%20the%20condition%20in%20the%20query%20above%20is%20selecting.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20We%20can%20put%20%60not%60%20in%20front%20of%20a%20condition%20to%20invert%20its%20meaning.%20Use%20this%20to%20write%20a%20query%20that%20fetches%20the%20same%20rows%20as%20one%20with%20the%20condition%20%60species%20!%3D%20'Chinstrap'%60%2C%20but%20which%20uses%20%60%3D%60%20instead%20of%20%60!%3D%60.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20Does%20the%20expression%20%60species%20not%20%3D%20'Gentoo'%60%20work%3F%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%201.%20Write%20a%20query%20to%20find%20all%20of%20the%20penguins%20whose%20bill%20length%20is%20greater%20than%20their%20bill%20depth.%0A%20%20%20%20%3E%202.%20Write%20another%20query%20to%20find%20all%20of%20the%20penguins%20whose%20bill%20length%20is%20less%20than%20their%20bill%20depth.%20What%20do%20you%20notice%20about%20the%20output%20of%20this%20query%3F%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%3E%20The%20previous%20tutorial%20showed%20how%20to%20do%20calculations%20on%20the%20fly%20to%20(for%20example)%20produce%20a%20column%20called%20%60mass_kg%60%20showing%20the%20body%20mass%20of%20each%20penguin%20in%20kilograms.%20Can%20these%20on-the-fly%20columns%20be%20used%20in%20%60where%60%20conditions%3F%20To%20find%20out%2C%20write%20a%20query%20that%20finds%20all%20of%20the%20penguins%20that%20weight%20more%20than%204.0%20kg.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Check%20Understanding%0A%0A%20%20%20%20!%5Bconcept%20map%5D(%2Fpublic%2F02_concepts.svg)%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(MatchingWidget%2C%20mo)%3A%0A%20%20%20%20_widget%20%3D%20mo.ui.anywidget(%0A%20%20%20%20%20%20%20%20MatchingWidget(%0A%20%20%20%20%20%20%20%20%20%20%20%20question%3D%22Match%20each%20SQL%20comparison%20operator%20to%20its%20meaning.%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20left%3D%5B%22%3C%22%2C%20%22!%3D%22%2C%20%22%3E%3D%22%2C%20%22%3D%22%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20right%3D%5B%22equal%20to%22%2C%20%22not%20equal%20to%22%2C%20%22less%20than%22%2C%20%22greater%20than%20or%20equal%20to%22%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20correct_matches%3D%7B0%3A%202%2C%201%3A%201%2C%202%3A%203%2C%203%3A%200%7D%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20)%0A%20%20%20%20_widget%0A%20%20%20%20return%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(MultipleChoiceWidget%2C%20mo)%3A%0A%20%20%20%20_widget%20%3D%20mo.ui.anywidget(%0A%20%20%20%20%20%20%20%20MultipleChoiceWidget(%0A%20%20%20%20%20%20%20%20%20%20%20%20question%3D%22A%20query%20uses%20%60WHERE%20species%20%3D%20'Adelie'%20OR%20island%20%3D%20'Biscoe'%60.%20Which%20rows%20does%20it%20return%3F%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20options%3D%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22Only%20rows%20where%20both%20conditions%20are%20true%20(Adelie%20penguins%20on%20Biscoe)%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22Rows%20where%20either%20condition%20is%20true%2C%20or%20both%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22Rows%20where%20species%20is%20Adelie%20but%20island%20is%20not%20Biscoe%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22Rows%20where%20island%20is%20Biscoe%20but%20species%20is%20not%20Adelie%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%5D%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20correct_answer%3D1%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20explanation%3D%22In%20SQL%2C%20OR%20returns%20every%20row%20where%20at%20least%20one%20condition%20is%20true.%20This%20includes%20rows%20satisfying%20just%20the%20first%20condition%2C%20just%20the%20second%2C%20or%20both%20simultaneously.%22%2C%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20)%0A%20%20%20%20_widget%0A%20%20%20%20return%0A%0A%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20app.run()%0A