| Offset 1, 5 lines modified | Offset 1, 5 lines modified | ||
| 1 | · | 1 | ·a9d07aad0784f5e68858537e33b02d63·3956116·doc·optional·python-sqlalchemy-doc_2.0.32+ds1-1_all.deb |
| 2 | ·6be7382861298efb5a82b60405fa7f83·1748792·debug·optional·python3-sqlalchemy-ext-dbgsym_2.0.32+ds1-1_i386.deb | 2 | ·6be7382861298efb5a82b60405fa7f83·1748792·debug·optional·python3-sqlalchemy-ext-dbgsym_2.0.32+ds1-1_i386.deb |
| 3 | ·b5c87ce5c170577275eeeed1855128e0·219664·python·optional·python3-sqlalchemy-ext_2.0.32+ds1-1_i386.deb | 3 | ·b5c87ce5c170577275eeeed1855128e0·219664·python·optional·python3-sqlalchemy-ext_2.0.32+ds1-1_i386.deb |
| 4 | ·e1c78ec120d9d481e2a5c4c579530013·1196072·python·optional·python3-sqlalchemy_2.0.32+ds1-1_all.deb | 4 | ·e1c78ec120d9d481e2a5c4c579530013·1196072·python·optional·python3-sqlalchemy_2.0.32+ds1-1_all.deb |
| Offset 1, 3 lines modified | Offset 1, 3 lines modified | ||
| 1 | -rw-r--r--···0········0········0········4·2024-08-23·07:52:58.000000·debian-binary | 1 | -rw-r--r--···0········0········0········4·2024-08-23·07:52:58.000000·debian-binary |
| 2 | -rw-r--r--···0········0········0····139 | 2 | -rw-r--r--···0········0········0····13908·2024-08-23·07:52:58.000000·control.tar.xz |
| 3 | -rw-r--r--···0········0········0··394 | 3 | -rw-r--r--···0········0········0··3942016·2024-08-23·07:52:58.000000·data.tar.xz |
| Offset 9239, 15 lines modified | Offset 9239, 22 lines modified | ||
| 9239 | <div·class="admonition·seealso"> | 9239 | <div·class="admonition·seealso"> |
| 9240 | <p·class="admonition-title">See·also</p> | 9240 | <p·class="admonition-title">See·also</p> |
| 9241 | <p><a·class="reference·internal"·href="migration_14.html#change-4710-core"><span·class="std·std-ref">RowProxy·is·no·longer·a·“proxy”;·is·now·called·Row·and·behaves·like·an·enhanced·named·tuple</span></a></p> | 9241 | <p><a·class="reference·internal"·href="migration_14.html#change-4710-core"><span·class="std·std-ref">RowProxy·is·no·longer·a·“proxy”;·is·now·called·Row·and·behaves·like·an·enhanced·named·tuple</span></a></p> |
| 9242 | </div> | 9242 | </div> |
| 9243 | <p>References:·<a·class="reference·external"·href="https://www.sqlalchemy.org/trac/ticket/4710">#4710</a></p> | 9243 | <p>References:·<a·class="reference·external"·href="https://www.sqlalchemy.org/trac/ticket/4710">#4710</a></p> |
| 9244 | </p> | 9244 | </p> |
| 9245 | </li> | 9245 | </li> |
| 9246 | <li><p·class="caption"·id="change-1.4.0b1-54"><span·class="target"·id="change-6bc91a2bef8d8afd244e6dbd38439c4d"><strong>[engine]·[performance]</strong>·<a·class="changelog-reference·headerlink·reference·internal"·href="#change-6bc91a2bef8d8afd244e6dbd38439c4d">¶</a></span><p>The·pool·“pre-ping”·feature·has·been·refined·to·not·invoke·for·a·DBAPI | ||
| 9247 | connection·that·was·just·opened·in·the·same·checkout·operation.··pre·ping | ||
| 9248 | only·applies·to·a·DBAPI·connection·that’s·been·checked·into·the·pool | ||
| 9249 | and·is·being·checked·out·again.</p> | ||
| 9250 | <p>References:·<a·class="reference·external"·href="https://www.sqlalchemy.org/trac/ticket/4524">#4524</a></p> | ||
| 9251 | </p> | ||
| 9252 | </li> | ||
| 9246 | <li><p·class="caption"·id="change-1.4.0b1-5 | 9253 | <li><p·class="caption"·id="change-1.4.0b1-55"><span·class="target"·id="change-d3650b27f4c852ac687ea55326051ed0"><strong>[engine]·[performance]·[change]·[py3k]</strong>·<a·class="changelog-reference·headerlink·reference·internal"·href="#change-d3650b27f4c852ac687ea55326051ed0">¶</a></span><p>Disabled·the·“unicode·returns”·check·that·runs·on·dialect·startup·when |
| 9247 | running·under·Python·3,·which·for·many·years·has·occurred·in·order·to·test | 9254 | running·under·Python·3,·which·for·many·years·has·occurred·in·order·to·test |
| 9248 | the·current·DBAPI’s·behavior·for·whether·or·not·it·returns·Python·Unicode | 9255 | the·current·DBAPI’s·behavior·for·whether·or·not·it·returns·Python·Unicode |
| 9249 | or·Py2K·strings·for·the·VARCHAR·and·NVARCHAR·datatypes.··The·check·still | 9256 | or·Py2K·strings·for·the·VARCHAR·and·NVARCHAR·datatypes.··The·check·still |
| 9250 | occurs·by·default·under·Python·2,·however·the·mechanism·to·test·the | 9257 | occurs·by·default·under·Python·2,·however·the·mechanism·to·test·the |
| 9251 | behavior·will·be·removed·in·SQLAlchemy·2.0·when·Python·2·support·is·also | 9258 | behavior·will·be·removed·in·SQLAlchemy·2.0·when·Python·2·support·is·also |
| 9252 | removed.</p> | 9259 | removed.</p> |
| 9253 | <p>This·logic·was·very·effective·when·it·was·needed,·however·now·that·Python·3 | 9260 | <p>This·logic·was·very·effective·when·it·was·needed,·however·now·that·Python·3 |
| Offset 9258, 21 lines modified | Offset 9265, 14 lines modified | ||
| 9258 | dialect·flags·by·setting·the·dialect·level·flag·<code·class="docutils·literal·notranslate"><span·class="pre">returns_unicode_strings</span></code> | 9265 | dialect·flags·by·setting·the·dialect·level·flag·<code·class="docutils·literal·notranslate"><span·class="pre">returns_unicode_strings</span></code> |
| 9259 | to·one·of·<code·class="xref·py·py-attr·docutils·literal·notranslate"><span·class="pre">String.RETURNS_CONDITIONAL</span></code>·or | 9266 | to·one·of·<code·class="xref·py·py-attr·docutils·literal·notranslate"><span·class="pre">String.RETURNS_CONDITIONAL</span></code>·or |
| 9260 | <code·class="xref·py·py-attr·docutils·literal·notranslate"><span·class="pre">String.RETURNS_BYTES</span></code>,·both·of·which·will·enable·Unicode·conversion | 9267 | <code·class="xref·py·py-attr·docutils·literal·notranslate"><span·class="pre">String.RETURNS_BYTES</span></code>,·both·of·which·will·enable·Unicode·conversion |
| 9261 | even·under·Python·3.</p> | 9268 | even·under·Python·3.</p> |
| 9262 | <p>References:·<a·class="reference·external"·href="https://www.sqlalchemy.org/trac/ticket/5315">#5315</a></p> | 9269 | <p>References:·<a·class="reference·external"·href="https://www.sqlalchemy.org/trac/ticket/5315">#5315</a></p> |
| 9263 | </p> | 9270 | </p> |
| 9264 | </li> | 9271 | </li> |
| 9265 | <li><p·class="caption"·id="change-1.4.0b1-55"><span·class="target"·id="change-6bc91a2bef8d8afd244e6dbd38439c4d"><strong>[engine]·[performance]</strong>·<a·class="changelog-reference·headerlink·reference·internal"·href="#change-6bc91a2bef8d8afd244e6dbd38439c4d">¶</a></span><p>The·pool·“pre-ping”·feature·has·been·refined·to·not·invoke·for·a·DBAPI | ||
| 9266 | connection·that·was·just·opened·in·the·same·checkout·operation.··pre·ping | ||
| 9267 | only·applies·to·a·DBAPI·connection·that’s·been·checked·into·the·pool | ||
| 9268 | and·is·being·checked·out·again.</p> | ||
| 9269 | <p>References:·<a·class="reference·external"·href="https://www.sqlalchemy.org/trac/ticket/4524">#4524</a></p> | ||
| 9270 | </p> | ||
| 9271 | </li> | ||
| 9272 | <li><p·class="caption"·id="change-1.4.0b1-56"><span·class="target"·id="change-f8a130923cff752e26f7be9cf1ea18eb"><strong>[engine]·[bug]</strong>·<a·class="changelog-reference·headerlink·reference·internal"·href="#change-f8a130923cff752e26f7be9cf1ea18eb">¶</a></span><p>Revised·the·<a·class="reference·internal"·href="../core/connections.html#sqlalchemy.engine.Connection.execution_options.params.schema_translate_map"·title="sqlalchemy.engine.Connection.execution_options"><code·class="xref·py·py-paramref·docutils·literal·notranslate"><span·class="pre">Connection.execution_options.schema_translate_map</span></code></a> | 9272 | <li><p·class="caption"·id="change-1.4.0b1-56"><span·class="target"·id="change-f8a130923cff752e26f7be9cf1ea18eb"><strong>[engine]·[bug]</strong>·<a·class="changelog-reference·headerlink·reference·internal"·href="#change-f8a130923cff752e26f7be9cf1ea18eb">¶</a></span><p>Revised·the·<a·class="reference·internal"·href="../core/connections.html#sqlalchemy.engine.Connection.execution_options.params.schema_translate_map"·title="sqlalchemy.engine.Connection.execution_options"><code·class="xref·py·py-paramref·docutils·literal·notranslate"><span·class="pre">Connection.execution_options.schema_translate_map</span></code></a> |
| 9273 | feature·such·that·the·processing·of·the·SQL·statement·to·receive·a·specific | 9273 | feature·such·that·the·processing·of·the·SQL·statement·to·receive·a·specific |
| 9274 | schema·name·occurs·within·the·execution·phase·of·the·statement,·rather·than | 9274 | schema·name·occurs·within·the·execution·phase·of·the·statement,·rather·than |
| 9275 | at·the·compile·phase.···This·is·to·support·the·statement·being·efficiently | 9275 | at·the·compile·phase.···This·is·to·support·the·statement·being·efficiently |
| 9276 | cached.···Previously,·the·current·schema·being·rendered·into·the·statement | 9276 | cached.···Previously,·the·current·schema·being·rendered·into·the·statement |
| 9277 | for·a·particular·run·would·be·considered·as·part·of·the·cache·key·itself, | 9277 | for·a·particular·run·would·be·considered·as·part·of·the·cache·key·itself, |
| 9278 | meaning·that·for·a·run·against·hundreds·of·schemas,·there·would·be·hundreds | 9278 | meaning·that·for·a·run·against·hundreds·of·schemas,·there·would·be·hundreds |
| Offset 6354, 15 lines modified | Offset 6354, 21 lines modified | ||
| 6354 | returned·by·the·ResultProxy·is·now·the·LegacyRow·subclass,·which·maintains | 6354 | returned·by·the·ResultProxy·is·now·the·LegacyRow·subclass,·which·maintains |
| 6355 | mapping/tuple·hybrid·behavior,·however·the·base·_\x8R_\x8o_\x8w·class·now·behaves·more | 6355 | mapping/tuple·hybrid·behavior,·however·the·base·_\x8R_\x8o_\x8w·class·now·behaves·more |
| 6356 | fully·like·a·named·tuple. | 6356 | fully·like·a·named·tuple. |
| 6357 | See·also | 6357 | See·also |
| 6358 | _\x8R_\x8o_\x8w_\x8P_\x8r_\x8o_\x8x_\x8y_\x8·_\x8i_\x8s_\x8·_\x8n_\x8o_\x8·_\x8l_\x8o_\x8n_\x8g_\x8e_\x8r_\x8·_\x8a_\x8·_\x8“_\x8p_\x8r_\x8o_\x8x_\x8y_\x8”_\x8;_\x8·_\x8i_\x8s_\x8·_\x8n_\x8o_\x8w_\x8·_\x8c_\x8a_\x8l_\x8l_\x8e_\x8d_\x8·_\x8R_\x8o_\x8w_\x8·_\x8a_\x8n_\x8d_\x8·_\x8b_\x8e_\x8h_\x8a_\x8v_\x8e_\x8s_\x8·_\x8l_\x8i_\x8k_\x8e_\x8·_\x8a_\x8n_\x8·_\x8e_\x8n_\x8h_\x8a_\x8n_\x8c_\x8e_\x8d | 6358 | _\x8R_\x8o_\x8w_\x8P_\x8r_\x8o_\x8x_\x8y_\x8·_\x8i_\x8s_\x8·_\x8n_\x8o_\x8·_\x8l_\x8o_\x8n_\x8g_\x8e_\x8r_\x8·_\x8a_\x8·_\x8“_\x8p_\x8r_\x8o_\x8x_\x8y_\x8”_\x8;_\x8·_\x8i_\x8s_\x8·_\x8n_\x8o_\x8w_\x8·_\x8c_\x8a_\x8l_\x8l_\x8e_\x8d_\x8·_\x8R_\x8o_\x8w_\x8·_\x8a_\x8n_\x8d_\x8·_\x8b_\x8e_\x8h_\x8a_\x8v_\x8e_\x8s_\x8·_\x8l_\x8i_\x8k_\x8e_\x8·_\x8a_\x8n_\x8·_\x8e_\x8n_\x8h_\x8a_\x8n_\x8c_\x8e_\x8d |
| 6359 | _\x8n_\x8a_\x8m_\x8e_\x8d_\x8·_\x8t_\x8u_\x8p_\x8l_\x8e | 6359 | _\x8n_\x8a_\x8m_\x8e_\x8d_\x8·_\x8t_\x8u_\x8p_\x8l_\x8e |
| 6360 | References:·_\x8#_\x84_\x87_\x81_\x80 | 6360 | References:·_\x8#_\x84_\x87_\x81_\x80 |
| 6361 | [\x8[e\x8en\x8ng\x8gi\x8in\x8ne\x8e]\x8]·[\x8[p\x8pe\x8er\x8rf\x8fo\x8or\x8rm\x8ma\x8an\x8nc\x8ce\x8e]\x8]·_\x8¶ | ||
| 6362 | The·pool·“pre-ping”·feature·has·been·refined·to·not·invoke·for·a·DBAPI | ||
| 6363 | connection·that·was·just·opened·in·the·same·checkout·operation.·pre·ping·only | ||
| 6364 | applies·to·a·DBAPI·connection·that’s·been·checked·into·the·pool·and·is·being | ||
| 6365 | checked·out·again. | ||
| 6366 | References:·_\x8#_\x84_\x85_\x82_\x84 | ||
| 6361 | [\x8[e\x8en\x8ng\x8gi\x8in\x8ne\x8e]\x8]·[\x8[ | 6367 | [\x8[e\x8en\x8ng\x8gi\x8in\x8ne\x8e]\x8]·[\x8[p.pe.er.rf.fo.or.rm.ma.an.nc.ce.e].]·[.[c.ch.ha.an.ng.ge\x8e]\x8]·[\x8[p\x8py\x8y3\x83k\x8k]\x8]·_\x8¶ |
| 6362 | Disabled·the·“unicode·returns”·check·that·runs·on·dialect·startup·when·running | 6368 | Disabled·the·“unicode·returns”·check·that·runs·on·dialect·startup·when·running |
| 6363 | under·Python·3,·which·for·many·years·has·occurred·in·order·to·test·the·current | 6369 | under·Python·3,·which·for·many·years·has·occurred·in·order·to·test·the·current |
| 6364 | DBAPI’s·behavior·for·whether·or·not·it·returns·Python·Unicode·or·Py2K·strings | 6370 | DBAPI’s·behavior·for·whether·or·not·it·returns·Python·Unicode·or·Py2K·strings |
| 6365 | for·the·VARCHAR·and·NVARCHAR·datatypes.·The·check·still·occurs·by·default·under | 6371 | for·the·VARCHAR·and·NVARCHAR·datatypes.·The·check·still·occurs·by·default·under |
| 6366 | Python·2,·however·the·mechanism·to·test·the·behavior·will·be·removed·in | 6372 | Python·2,·however·the·mechanism·to·test·the·behavior·will·be·removed·in |
| 6367 | SQLAlchemy·2.0·when·Python·2·support·is·also·removed. | 6373 | SQLAlchemy·2.0·when·Python·2·support·is·also·removed. |
| 6368 | This·logic·was·very·effective·when·it·was·needed,·however·now·that·Python·3·is | 6374 | This·logic·was·very·effective·when·it·was·needed,·however·now·that·Python·3·is |
| Offset 6370, 20 lines modified | Offset 6376, 14 lines modified | ||
| 6370 | datatypes.·In·the·unlikely·case·that·a·third·party·DBAPI·does·not·support·this, | 6376 | datatypes.·In·the·unlikely·case·that·a·third·party·DBAPI·does·not·support·this, |
| 6371 | the·conversion·logic·within·_\x8S_\x8t_\x8r_\x8i_\x8n_\x8g·is·still·available·and·the·third·party | 6377 | the·conversion·logic·within·_\x8S_\x8t_\x8r_\x8i_\x8n_\x8g·is·still·available·and·the·third·party |
| 6372 | dialect·may·specify·this·in·its·upfront·dialect·flags·by·setting·the·dialect | 6378 | dialect·may·specify·this·in·its·upfront·dialect·flags·by·setting·the·dialect |
| 6373 | level·flag·returns_unicode_strings·to·one·of·String.RETURNS_CONDITIONAL·or | 6379 | level·flag·returns_unicode_strings·to·one·of·String.RETURNS_CONDITIONAL·or |
| 6374 | String.RETURNS_BYTES,·both·of·which·will·enable·Unicode·conversion·even·under | 6380 | String.RETURNS_BYTES,·both·of·which·will·enable·Unicode·conversion·even·under |
| 6375 | Python·3. | 6381 | Python·3. |
| 6376 | References:·_\x8#_\x85_\x83_\x81_\x85 | 6382 | References:·_\x8#_\x85_\x83_\x81_\x85 |
| 6377 | [\x8[e\x8en\x8ng\x8gi\x8in\x8ne\x8e]\x8]·[\x8[p\x8pe\x8er\x8rf\x8fo\x8or\x8rm\x8ma\x8an\x8nc\x8ce\x8e]\x8]·_\x8¶ | ||
| 6378 | The·pool·“pre-ping”·feature·has·been·refined·to·not·invoke·for·a·DBAPI | ||
| 6379 | connection·that·was·just·opened·in·the·same·checkout·operation.·pre·ping·only | ||
| 6380 | applies·to·a·DBAPI·connection·that’s·been·checked·into·the·pool·and·is·being | ||
| 6381 | checked·out·again. | ||
| 6382 | References:·_\x8#_\x84_\x85_\x82_\x84 | ||
| 6383 | [\x8[e\x8en\x8ng\x8gi\x8in\x8ne\x8e]\x8]·[\x8[b\x8bu\x8ug\x8g]\x8]·_\x8¶ | 6383 | [\x8[e\x8en\x8ng\x8gi\x8in\x8ne\x8e]\x8]·[\x8[b\x8bu\x8ug\x8g]\x8]·_\x8¶ |
| 6384 | Revised·the·_\x8C_\x8o_\x8n_\x8n_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8._\x8e_\x8x_\x8e_\x8c_\x8u_\x8t_\x8i_\x8o_\x8n_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n_\x8s_\x8._\x8s_\x8c_\x8h_\x8e_\x8m_\x8a_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8l_\x8a_\x8t_\x8e_\x8__\x8m_\x8a_\x8p·feature·such·that | 6384 | Revised·the·_\x8C_\x8o_\x8n_\x8n_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8._\x8e_\x8x_\x8e_\x8c_\x8u_\x8t_\x8i_\x8o_\x8n_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n_\x8s_\x8._\x8s_\x8c_\x8h_\x8e_\x8m_\x8a_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8l_\x8a_\x8t_\x8e_\x8__\x8m_\x8a_\x8p·feature·such·that |
| 6385 | the·processing·of·the·SQL·statement·to·receive·a·specific·schema·name·occurs | 6385 | the·processing·of·the·SQL·statement·to·receive·a·specific·schema·name·occurs |
| 6386 | within·the·execution·phase·of·the·statement,·rather·than·at·the·compile·phase. | 6386 | within·the·execution·phase·of·the·statement,·rather·than·at·the·compile·phase. |
| 6387 | This·is·to·support·the·statement·being·efficiently·cached.·Previously,·the | 6387 | This·is·to·support·the·statement·being·efficiently·cached.·Previously,·the |
| 6388 | current·schema·being·rendered·into·the·statement·for·a·particular·run·would·be | 6388 | current·schema·being·rendered·into·the·statement·for·a·particular·run·would·be |
| 6389 | considered·as·part·of·the·cache·key·itself,·meaning·that·for·a·run·against | 6389 | considered·as·part·of·the·cache·key·itself,·meaning·that·for·a·run·against |
| Offset 319, 29 lines modified | Offset 319, 29 lines modified | ||
| 319 | </ul> | 319 | </ul> |
| 320 | </p> | 320 | </p> |
| 321 | </section> | 321 | </section> |
| 322 | <section·id="module-examples.asyncio"> | 322 | <section·id="module-examples.asyncio"> |
| 323 | <span·id="asyncio-integration"></span><span·id="examples-asyncio"></span><h3>Asyncio·Integration<a·class="headerlink"·href="#module-examples.asyncio"·title="Link·to·this·heading">¶</a></h3> | 323 | <span·id="asyncio-integration"></span><span·id="examples-asyncio"></span><h3>Asyncio·Integration<a·class="headerlink"·href="#module-examples.asyncio"·title="Link·to·this·heading">¶</a></h3> |
| 324 | <p>Examples·illustrating·the·asyncio·engine·feature·of·SQLAlchemy.</p> | 324 | <p>Examples·illustrating·the·asyncio·engine·feature·of·SQLAlchemy.</p> |
| 325 | <p>Listing·of·files:<ul·class="simple"> | 325 | <p>Listing·of·files:<ul·class="simple"> |
| 326 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/async_orm_writeonly.html">async_orm_writeonly.py</a>·-·Illustrates·using·<strong>write·only·relationships</strong>·for·simpler·handling | ||
| 327 | of·ORM·collections·under·asyncio.</p> | ||
| 328 | </p></li> | ||
| 326 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/async_orm.html">async_orm.py</a>·-·Illustrates·use·of·the·<code·class="docutils·literal·notranslate"><span·class="pre">sqlalchemy.ext.asyncio.AsyncSession</span></code>·object | 329 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/async_orm.html">async_orm.py</a>·-·Illustrates·use·of·the·<code·class="docutils·literal·notranslate"><span·class="pre">sqlalchemy.ext.asyncio.AsyncSession</span></code>·object |
| 327 | for·asynchronous·ORM·use.</p> | 330 | for·asynchronous·ORM·use.</p> |
| 328 | </p></li> | 331 | </p></li> |
| 329 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/ | 332 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/greenlet_orm.html">greenlet_orm.py</a>·-·Illustrates·use·of·the·sqlalchemy.ext.asyncio.AsyncSession·object |
| 333 | for·asynchronous·ORM·use,·including·the·optional·run_sync()·method.</p> | ||
| 330 | </p></li> | 334 | </p></li> |
| 335 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/basic.html">basic.py</a>·-·Illustrates·the·asyncio·engine·/·connection·interface.</p> | ||
| 331 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/async_orm_writeonly.html">async_orm_writeonly.py</a>·-·Illustrates·using·<strong>write·only·relationships</strong>·for·simpler·handling | ||
| 332 | of·ORM·collections·under·asyncio.</p> | ||
| 333 | </p></li> | 336 | </p></li> |
| 334 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/gather_orm_statements.html">gather_orm_statements.py</a>·-·Illustrates·how·to·run·many·statements·concurrently·using·<code·class="docutils·literal·notranslate"><span·class="pre">asyncio.gather()</span></code> | 337 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/gather_orm_statements.html">gather_orm_statements.py</a>·-·Illustrates·how·to·run·many·statements·concurrently·using·<code·class="docutils·literal·notranslate"><span·class="pre">asyncio.gather()</span></code> |
| 335 | along·many·asyncio·database·connections,·merging·ORM·results·into·a·single | 338 | along·many·asyncio·database·connections,·merging·ORM·results·into·a·single |
| 336 | <code·class="docutils·literal·notranslate"><span·class="pre">AsyncSession</span></code>.</p> | 339 | <code·class="docutils·literal·notranslate"><span·class="pre">AsyncSession</span></code>.</p> |
| 337 | </p></li> | 340 | </p></li> |
| 338 | <li><p><p><a·class="reference·external"·href="../_modules/examples/asyncio/greenlet_orm.html">greenlet_orm.py</a>·-·Illustrates·use·of·the·sqlalchemy.ext.asyncio.AsyncSession·object | ||
| 339 | for·asynchronous·ORM·use,·including·the·optional·run_sync()·method.</p> | ||
| 340 | </p></li> | ||
| 341 | </ul> | 341 | </ul> |
| 342 | </p> | 342 | </p> |
| 343 | </section> | 343 | </section> |
| 344 | <section·id="module-examples.graphs"> | 344 | <section·id="module-examples.graphs"> |
| 345 | <span·id="directed-graphs"></span><h3>Directed·Graphs<a·class="headerlink"·href="#module-examples.graphs"·title="Link·to·this·heading">¶</a></h3> | 345 | <span·id="directed-graphs"></span><h3>Directed·Graphs<a·class="headerlink"·href="#module-examples.graphs"·title="Link·to·this·heading">¶</a></h3> |
| 346 | <p>An·example·of·persistence·for·a·directed·graph·structure.···The | 346 | <p>An·example·of·persistence·for·a·directed·graph·structure.···The |
| 347 | graph·is·stored·as·a·collection·of·edges,·each·referencing·both·a | 347 | graph·is·stored·as·a·collection·of·edges,·each·referencing·both·a |
| Offset 378, 37 lines modified | Offset 378, 37 lines modified | ||
| 378 | subclassing·the·<code·class="docutils·literal·notranslate"><span·class="pre">HasAddresses</span></code>·mixin,·which·ensures·that·the | 378 | subclassing·the·<code·class="docutils·literal·notranslate"><span·class="pre">HasAddresses</span></code>·mixin,·which·ensures·that·the |
| 379 | parent·class·is·provided·with·an·<code·class="docutils·literal·notranslate"><span·class="pre">addresses</span></code>·collection | 379 | parent·class·is·provided·with·an·<code·class="docutils·literal·notranslate"><span·class="pre">addresses</span></code>·collection |
| 380 | which·contains·<code·class="docutils·literal·notranslate"><span·class="pre">Address</span></code>·objects.</p> | 380 | which·contains·<code·class="docutils·literal·notranslate"><span·class="pre">Address</span></code>·objects.</p> |
| 381 | <p>The·<a·class="reference·external"·href="../_modules/examples/generic_associations/discriminator_on_association.html">discriminator_on_association.py</a>·and·<a·class="reference·external"·href="../_modules/examples/generic_associations/generic_fk.html">generic_fk.py</a>·scripts | 381 | <p>The·<a·class="reference·external"·href="../_modules/examples/generic_associations/discriminator_on_association.html">discriminator_on_association.py</a>·and·<a·class="reference·external"·href="../_modules/examples/generic_associations/generic_fk.html">generic_fk.py</a>·scripts |
| 382 | are·modernized·versions·of·recipes·presented·in·the·2007·blog·post | 382 | are·modernized·versions·of·recipes·presented·in·the·2007·blog·post |
| 383 | <a·class="reference·external"·href="https://techspot.zzzeek.org/2007/05/29/polymorphic-associations-with-sqlalchemy/">Polymorphic·Associations·with·SQLAlchemy</a>.</p> | 383 | <a·class="reference·external"·href="https://techspot.zzzeek.org/2007/05/29/polymorphic-associations-with-sqlalchemy/">Polymorphic·Associations·with·SQLAlchemy</a>.</p> |
| 384 | <p>Listing·of·files:<ul·class="simple"> | 384 | <p>Listing·of·files:<ul·class="simple"> |
| 385 | <li><p><p><a·class="reference·external"·href="../_modules/examples/generic_associations/discriminator_on_association.html">discriminator_on_association.py</a>·-·Illustrates·a·mixin·which·provides·a·generic·association | ||
| 386 | using·a·single·target·table·and·a·single·association·table, | ||
| 387 | referred·to·by·all·parent·tables.··The·association·table | ||
| 388 | contains·a·“discriminator”·column·which·determines·what·type·of | ||
| 389 | parent·object·associates·to·each·particular·row·in·the·association | ||
| 390 | table.</p> | ||
| 391 | </p></li> | ||
| 392 | <li><p><p><a·class="reference·external"·href="../_modules/examples/generic_associations/table_per_related.html">table_per_related.py</a>·-·Illustrates·a·generic·association·which·persists·association | ||
| 393 | objects·within·individual·tables,·each·one·generated·to·persist | ||
| 394 | those·objects·on·behalf·of·a·particular·parent·class.</p> | ||
| 395 | </p></li> | ||
| 385 | <li><p><p><a·class="reference·external"·href="../_modules/examples/generic_associations/generic_fk.html">generic_fk.py</a>·-·Illustrates·a·so-called·“generic·foreign·key”,·in·a·similar·fashion | 396 | <li><p><p><a·class="reference·external"·href="../_modules/examples/generic_associations/generic_fk.html">generic_fk.py</a>·-·Illustrates·a·so-called·“generic·foreign·key”,·in·a·similar·fashion |
| 386 | to·that·of·popular·frameworks·such·as·Django,·ROR,·etc.··This | 397 | to·that·of·popular·frameworks·such·as·Django,·ROR,·etc.··This |
| 387 | approach·bypasses·standard·referential·integrity | 398 | approach·bypasses·standard·referential·integrity |
| 388 | practices,·in·that·the·“foreign·key”·column·is·not·actually | 399 | practices,·in·that·the·“foreign·key”·column·is·not·actually |
| 389 | constrained·to·refer·to·any·particular·table;·instead, | 400 | constrained·to·refer·to·any·particular·table;·instead, |
| 390 | in-application·logic·is·used·to·determine·which·table·is·referenced.</p> | 401 | in-application·logic·is·used·to·determine·which·table·is·referenced.</p> |
| 391 | </p></li> | 402 | </p></li> |
| 392 | <li><p><p><a·class="reference·external"·href="../_modules/examples/generic_associations/table_per_association.html">table_per_association.py</a>·-·Illustrates·a·mixin·which·provides·a·generic·association | 403 | <li><p><p><a·class="reference·external"·href="../_modules/examples/generic_associations/table_per_association.html">table_per_association.py</a>·-·Illustrates·a·mixin·which·provides·a·generic·association |
| 393 | via·a·individually·generated·association·tables·for·each·parent·class. | 404 | via·a·individually·generated·association·tables·for·each·parent·class. |
| 394 | The·associated·objects·themselves·are·persisted·in·a·single·table | 405 | The·associated·objects·themselves·are·persisted·in·a·single·table |
| 395 | shared·among·all·parents.</p> | 406 | shared·among·all·parents.</p> |
| 396 | </p></li> | 407 | </p></li> |
| 397 | <li><p><p><a·class="reference·external"·href="../_modules/examples/generic_associations/table_per_related.html">table_per_related.py</a>·-·Illustrates·a·generic·association·which·persists·association | ||
| 398 | objects·within·individual·tables,·each·one·generated·to·persist | ||
| 399 | those·objects·on·behalf·of·a·particular·parent·class.</p> | ||
| 400 | </p></li> | ||
| 401 | <li><p><p><a·class="reference·external"·href="../_modules/examples/generic_associations/discriminator_on_association.html">discriminator_on_association.py</a>·-·Illustrates·a·mixin·which·provides·a·generic·association | ||
| 402 | using·a·single·target·table·and·a·single·association·table, | ||
| 403 | referred·to·by·all·parent·tables.··The·association·table | ||
| 404 | contains·a·“discriminator”·column·which·determines·what·type·of | ||
| 405 | parent·object·associates·to·each·particular·row·in·the·association | ||
| 406 | table.</p> | ||
| 407 | </p></li> | ||
| 408 | </ul> | 408 | </ul> |
| 409 | </p> | 409 | </p> |
| 410 | </section> | 410 | </section> |
| 411 | <section·id="module-examples.materialized_paths"> | 411 | <section·id="module-examples.materialized_paths"> |
| 412 | <span·id="materialized-paths"></span><h3>Materialized·Paths<a·class="headerlink"·href="#module-examples.materialized_paths"·title="Link·to·this·heading">¶</a></h3> | 412 | <span·id="materialized-paths"></span><h3>Materialized·Paths<a·class="headerlink"·href="#module-examples.materialized_paths"·title="Link·to·this·heading">¶</a></h3> |
| 413 | <p>Illustrates·the·“materialized·paths”·pattern·for·hierarchical·data·using·the | 413 | <p>Illustrates·the·“materialized·paths”·pattern·for·hierarchical·data·using·the |
| 414 | SQLAlchemy·ORM.</p> | 414 | SQLAlchemy·ORM.</p> |
| Offset 477, 33 lines modified | Offset 477, 33 lines modified | ||
| 477 | <div·class="admonition·seealso"> | 477 | <div·class="admonition·seealso"> |
| 478 | <p·class="admonition-title">See·also</p> | 478 | <p·class="admonition-title">See·also</p> |
| 479 | <p><a·class="reference·internal"·href="../faq/performance.html#faq-how-to-profile"><span·class="std·std-ref">How·can·I·profile·a·SQLAlchemy·powered·application?</span></a></p> | 479 | <p><a·class="reference·internal"·href="../faq/performance.html#faq-how-to-profile"><span·class="std·std-ref">How·can·I·profile·a·SQLAlchemy·powered·application?</span></a></p> |
| 480 | </div> | 480 | </div> |
| 481 | <section·id="file-listing"> | 481 | <section·id="file-listing"> |
| 482 | <h4>File·Listing<a·class="headerlink"·href="#file-listing"·title="Link·to·this·heading">¶</a></h4> | 482 | <h4>File·Listing<a·class="headerlink"·href="#file-listing"·title="Link·to·this·heading">¶</a></h4> |
| 483 | <p>Listing·of·files:<ul·class="simple"> | 483 | <p>Listing·of·files:<ul·class="simple"> |
| 484 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/bulk_updates.html">bulk_updates.py</a>·-·This·series·of·tests·will·illustrate·different·ways·to·UPDATE·a·large·number | ||
| 485 | of·rows·in·bulk·(under·construction!·there’s·just·one·test·at·the·moment)</p> | ||
| 486 | </p></li> | ||
| 487 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/bulk_inserts.html">bulk_inserts.py</a>·-·This·series·of·tests·illustrates·different·ways·to·INSERT·a·large·number | ||
| 488 | of·rows·in·bulk.</p> | ||
| 489 | </p></li> | ||
| 490 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/__main__.html">__main__.py</a>·-·Allows·the·examples/performance·package·to·be·run·as·a·script.</p> | ||
| 491 | </p></li> | ||
| 492 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/large_resultsets.html">large_resultsets.py</a>·-·In·this·series·of·tests,·we·are·looking·at·time·to·load·a·large·number | ||
| 493 | of·very·small·and·simple·rows.</p> | ||
| 494 | </p></li> | ||
| 495 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/single_inserts.html">single_inserts.py</a>·-·In·this·series·of·tests,·we’re·looking·at·a·method·that·inserts·a·row | 484 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/single_inserts.html">single_inserts.py</a>·-·In·this·series·of·tests,·we’re·looking·at·a·method·that·inserts·a·row |
| 496 | within·a·distinct·transaction,·and·afterwards·returns·to·essentially·a | 485 | within·a·distinct·transaction,·and·afterwards·returns·to·essentially·a |
| 497 | “closed”·state.···This·would·be·analogous·to·an·API·call·that·starts·up | 486 | “closed”·state.···This·would·be·analogous·to·an·API·call·that·starts·up |
| 498 | a·database·connection,·inserts·the·row,·commits·and·closes.</p> | 487 | a·database·connection,·inserts·the·row,·commits·and·closes.</p> |
| 499 | </p></li> | 488 | </p></li> |
| 500 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/short_selects.html">short_selects.py</a>·-·This·series·of·tests·illustrates·different·ways·to·SELECT·a·single | 489 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/short_selects.html">short_selects.py</a>·-·This·series·of·tests·illustrates·different·ways·to·SELECT·a·single |
| 501 | record·by·primary·key</p> | 490 | record·by·primary·key</p> |
| 502 | </p></li> | 491 | </p></li> |
| 492 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/__main__.html">__main__.py</a>·-·Allows·the·examples/performance·package·to·be·run·as·a·script.</p> | ||
| 493 | </p></li> | ||
| 494 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/bulk_inserts.html">bulk_inserts.py</a>·-·This·series·of·tests·illustrates·different·ways·to·INSERT·a·large·number | ||
| 495 | of·rows·in·bulk.</p> | ||
| 496 | </p></li> | ||
| 497 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/large_resultsets.html">large_resultsets.py</a>·-·In·this·series·of·tests,·we·are·looking·at·time·to·load·a·large·number | ||
| 498 | of·very·small·and·simple·rows.</p> | ||
| 499 | </p></li> | ||
| 500 | <li><p><p><a·class="reference·external"·href="../_modules/examples/performance/bulk_updates.html">bulk_updates.py</a>·-·This·series·of·tests·will·illustrate·different·ways·to·UPDATE·a·large·number | ||
| 501 | of·rows·in·bulk·(under·construction!·there’s·just·one·test·at·the·moment)</p> | ||
| 502 | </p></li> | ||
| 503 | </ul> | 503 | </ul> |
| 504 | </p> | 504 | </p> |
| 505 | </section> | 505 | </section> |
| 506 | <section·id="running-all-tests-with-time"> | 506 | <section·id="running-all-tests-with-time"> |
| 507 | <h4>Running·all·tests·with·time<a·class="headerlink"·href="#running-all-tests-with-time"·title="Link·to·this·heading">¶</a></h4> | 507 | <h4>Running·all·tests·with·time<a·class="headerlink"·href="#running-all-tests-with-time"·title="Link·to·this·heading">¶</a></h4> |
| 508 | <p>This·is·the·default·form·of·run:</p> | 508 | <p>This·is·the·default·form·of·run:</p> |
| Max diff block lines reached; 8995/19293 bytes (46.62%) of diff not shown. | |||
| Offset 109, 24 lines modified | Offset 109, 24 lines modified | ||
| 109 | values,·which·conceal·the·underlying·mapped·classes. | 109 | values,·which·conceal·the·underlying·mapped·classes. |
| 110 | _\x8p_\x8r_\x8o_\x8x_\x8i_\x8e_\x8d_\x8__\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8._\x8p_\x8y·-·Same·example·as·basic_association,·adding·in·usage·of | 110 | _\x8p_\x8r_\x8o_\x8x_\x8i_\x8e_\x8d_\x8__\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8._\x8p_\x8y·-·Same·example·as·basic_association,·adding·in·usage·of |
| 111 | _\x8s_\x8q_\x8l_\x8a_\x8l_\x8c_\x8h_\x8e_\x8m_\x8y_\x8._\x8e_\x8x_\x8t_\x8._\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8p_\x8r_\x8o_\x8x_\x8y·to·make·explicit·references·to·OrderItem | 111 | _\x8s_\x8q_\x8l_\x8a_\x8l_\x8c_\x8h_\x8e_\x8m_\x8y_\x8._\x8e_\x8x_\x8t_\x8._\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8p_\x8r_\x8o_\x8x_\x8y·to·make·explicit·references·to·OrderItem |
| 112 | optional. | 112 | optional. |
| 113 | *\x8**\x8**\x8**\x8*·A\x8As\x8sy\x8yn\x8nc\x8ci\x8io\x8o·I\x8In\x8nt\x8te\x8eg\x8gr\x8ra\x8at\x8ti\x8io\x8on\x8n_\x8?\x8¶·*\x8**\x8**\x8**\x8* | 113 | *\x8**\x8**\x8**\x8*·A\x8As\x8sy\x8yn\x8nc\x8ci\x8io\x8o·I\x8In\x8nt\x8te\x8eg\x8gr\x8ra\x8at\x8ti\x8io\x8on\x8n_\x8?\x8¶·*\x8**\x8**\x8**\x8* |
| 114 | Examples·illustrating·the·asyncio·engine·feature·of·SQLAlchemy. | 114 | Examples·illustrating·the·asyncio·engine·feature·of·SQLAlchemy. |
| 115 | Listing·of·files: | 115 | Listing·of·files: |
| 116 | ····*·_\x8a_\x8s_\x8y_\x8n_\x8c_\x8__\x8o_\x8r_\x8m_\x8__\x8w_\x8r_\x8i_\x8t_\x8e_\x8o_\x8n_\x8l_\x8y_\x8._\x8p_\x8y·-·Illustrates·using·w\x8wr\x8ri\x8it\x8te\x8e·o\x8on\x8nl\x8ly\x8y·r\x8re\x8el\x8la\x8at\x8ti\x8io\x8on\x8ns\x8sh\x8hi\x8ip\x8ps\x8s·for | ||
| 117 | ······simpler·handling·of·ORM·collections·under·asyncio. | ||
| 116 | 118 | _\x8a_\x8s_\x8y_\x8n_\x8c_\x8__\x8o_\x8r_\x8m_\x8._\x8p_\x8y·-·Illustrates·use·of·the·sqlalchemy.ext.asyncio.AsyncSession | |
| 117 | 119 | object·for·asynchronous·ORM·use. | |
| 120 | _\x8g_\x8r_\x8e_\x8e_\x8n_\x8l_\x8e_\x8t_\x8__\x8o_\x8r_\x8m_\x8._\x8p_\x8y·-·Illustrates·use·of·the·sqlalchemy.ext.asyncio.AsyncSession | ||
| 121 | object·for·asynchronous·ORM·use,·including·the·optional·run_sync()·method. | ||
| 118 | _\x8b_\x8a_\x8s_\x8i_\x8c_\x8._\x8p_\x8y·-·Illustrates·the·asyncio·engine·/·connection·interface. | 122 | _\x8b_\x8a_\x8s_\x8i_\x8c_\x8._\x8p_\x8y·-·Illustrates·the·asyncio·engine·/·connection·interface. |
| 119 | _\x8a_\x8s_\x8y_\x8n_\x8c_\x8__\x8o_\x8r_\x8m_\x8__\x8w_\x8r_\x8i_\x8t_\x8e_\x8o_\x8n_\x8l_\x8y_\x8._\x8p_\x8y·-·Illustrates·using·w\x8wr\x8ri\x8it\x8te\x8e·o\x8on\x8nl\x8ly\x8y·r\x8re\x8el\x8la\x8at\x8ti\x8io\x8on\x8ns\x8sh\x8hi\x8ip\x8ps\x8s·for·simpler | ||
| 120 | handling·of·ORM·collections·under·asyncio. | ||
| 121 | _\x8g_\x8a_\x8t_\x8h_\x8e_\x8r_\x8__\x8o_\x8r_\x8m_\x8__\x8s_\x8t_\x8a_\x8t_\x8e_\x8m_\x8e_\x8n_\x8t_\x8s_\x8._\x8p_\x8y·-·Illustrates·how·to·run·many·statements·concurrently | 123 | _\x8g_\x8a_\x8t_\x8h_\x8e_\x8r_\x8__\x8o_\x8r_\x8m_\x8__\x8s_\x8t_\x8a_\x8t_\x8e_\x8m_\x8e_\x8n_\x8t_\x8s_\x8._\x8p_\x8y·-·Illustrates·how·to·run·many·statements·concurrently |
| 122 | using·asyncio.gather()·along·many·asyncio·database·connections,·merging·ORM | 124 | using·asyncio.gather()·along·many·asyncio·database·connections,·merging·ORM |
| 123 | results·into·a·single·AsyncSession. | 125 | results·into·a·single·AsyncSession. |
| 124 | _\x8g_\x8r_\x8e_\x8e_\x8n_\x8l_\x8e_\x8t_\x8__\x8o_\x8r_\x8m_\x8._\x8p_\x8y·-·Illustrates·use·of·the·sqlalchemy.ext.asyncio.AsyncSession | ||
| 125 | object·for·asynchronous·ORM·use,·including·the·optional·run_sync()·method. | ||
| 126 | *\x8**\x8**\x8**\x8*·D\x8Di\x8ir\x8re\x8ec\x8ct\x8te\x8ed\x8d·G\x8Gr\x8ra\x8ap\x8ph\x8hs\x8s_\x8?\x8¶·*\x8**\x8**\x8**\x8* | 126 | *\x8**\x8**\x8**\x8*·D\x8Di\x8ir\x8re\x8ec\x8ct\x8te\x8ed\x8d·G\x8Gr\x8ra\x8ap\x8ph\x8hs\x8s_\x8?\x8¶·*\x8**\x8**\x8**\x8* |
| 127 | An·example·of·persistence·for·a·directed·graph·structure.·The·graph·is·stored | 127 | An·example·of·persistence·for·a·directed·graph·structure.·The·graph·is·stored |
| 128 | as·a·collection·of·edges,·each·referencing·both·a·“lower”·and·an·“upper”·node | 128 | as·a·collection·of·edges,·each·referencing·both·a·“lower”·and·an·“upper”·node |
| 129 | in·a·table·of·nodes.·Basic·persistence·and·querying·for·lower-·and·upper- | 129 | in·a·table·of·nodes.·Basic·persistence·and·querying·for·lower-·and·upper- |
| 130 | neighbors·are·illustrated: | 130 | neighbors·are·illustrated: |
| 131 | n2·=·Node(2) | 131 | n2·=·Node(2) |
| 132 | n5·=·Node(5) | 132 | n5·=·Node(5) |
| Offset 148, 32 lines modified | Offset 148, 31 lines modified | ||
| 148 | Supplier,·both·subclassing·the·HasAddresses·mixin,·which·ensures·that·the | 148 | Supplier,·both·subclassing·the·HasAddresses·mixin,·which·ensures·that·the |
| 149 | parent·class·is·provided·with·an·addresses·collection·which·contains·Address | 149 | parent·class·is·provided·with·an·addresses·collection·which·contains·Address |
| 150 | objects. | 150 | objects. |
| 151 | The·_\x8d_\x8i_\x8s_\x8c_\x8r_\x8i_\x8m_\x8i_\x8n_\x8a_\x8t_\x8o_\x8r_\x8__\x8o_\x8n_\x8__\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8._\x8p_\x8y·and·_\x8g_\x8e_\x8n_\x8e_\x8r_\x8i_\x8c_\x8__\x8f_\x8k_\x8._\x8p_\x8y·scripts·are·modernized | 151 | The·_\x8d_\x8i_\x8s_\x8c_\x8r_\x8i_\x8m_\x8i_\x8n_\x8a_\x8t_\x8o_\x8r_\x8__\x8o_\x8n_\x8__\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8._\x8p_\x8y·and·_\x8g_\x8e_\x8n_\x8e_\x8r_\x8i_\x8c_\x8__\x8f_\x8k_\x8._\x8p_\x8y·scripts·are·modernized |
| 152 | versions·of·recipes·presented·in·the·2007·blog·post·_\x8P_\x8o_\x8l_\x8y_\x8m_\x8o_\x8r_\x8p_\x8h_\x8i_\x8c_\x8·_\x8A_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8s | 152 | versions·of·recipes·presented·in·the·2007·blog·post·_\x8P_\x8o_\x8l_\x8y_\x8m_\x8o_\x8r_\x8p_\x8h_\x8i_\x8c_\x8·_\x8A_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8s |
| 153 | _\x8w_\x8i_\x8t_\x8h_\x8·_\x8S_\x8Q_\x8L_\x8A_\x8l_\x8c_\x8h_\x8e_\x8m_\x8y. | 153 | _\x8w_\x8i_\x8t_\x8h_\x8·_\x8S_\x8Q_\x8L_\x8A_\x8l_\x8c_\x8h_\x8e_\x8m_\x8y. |
| 154 | Listing·of·files: | 154 | Listing·of·files: |
| 155 | ····*·_\x8d_\x8i_\x8s_\x8c_\x8r_\x8i_\x8m_\x8i_\x8n_\x8a_\x8t_\x8o_\x8r_\x8__\x8o_\x8n_\x8__\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8._\x8p_\x8y·-·Illustrates·a·mixin·which·provides·a | ||
| 156 | ······generic·association·using·a·single·target·table·and·a·single·association | ||
| 157 | ······table,·referred·to·by·all·parent·tables.·The·association·table·contains·a | ||
| 158 | ······“discriminator”·column·which·determines·what·type·of·parent·object | ||
| 159 | ······associates·to·each·particular·row·in·the·association·table. | ||
| 160 | _\x8t_\x8a_\x8b_\x8l_\x8e_\x8__\x8p_\x8e_\x8r_\x8__\x8r_\x8e_\x8l_\x8a_\x8t_\x8e_\x8d_\x8._\x8p_\x8y·-·Illustrates·a·generic·association·which·persists | ||
| 161 | association·objects·within·individual·tables,·each·one·generated·to·persist | ||
| 162 | those·objects·on·behalf·of·a·particular·parent·class. | ||
| 155 | 163 | _.g_.e_.n_.e_.r_.i_.c_.__.f_.k_.._.p_.y·-·Illustrates·a·so-called·“generic·foreign·key”,·in·a·similar | |
| 156 | 164 | fashion·to·that·of·popular·frameworks·such·as·Django,·ROR,·etc.·This·approach | |
| 157 | 165 | bypasses·standard·referential·integrity·practices,·in·that·the·“foreign·key” | |
| 166 | column·is·not·actually·constrained·to·refer·to·any·particular·table;·instead, | ||
| 167 | in-application·logic·is·used·to·determine·which·table·is·referenced. | ||
| 158 | ······the·“foreign·key”·column·is·not·actually·constrained·to·refer·to·any | ||
| 159 | ······particular·table;·instead,·in-application·logic·is·used·to·determine | ||
| 160 | ······which·table·is·referenced. | ||
| 161 | _\x8t_\x8a_\x8b_\x8l_\x8e_\x8__\x8p_\x8e_\x8r_\x8__\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8._\x8p_\x8y·-·Illustrates·a·mixin·which·provides·a·generic | 168 | _\x8t_\x8a_\x8b_\x8l_\x8e_\x8__\x8p_\x8e_\x8r_\x8__\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8._\x8p_\x8y·-·Illustrates·a·mixin·which·provides·a·generic |
| 162 | association·via·a·individually·generated·association·tables·for·each·parent | 169 | association·via·a·individually·generated·association·tables·for·each·parent |
| 163 | class.·The·associated·objects·themselves·are·persisted·in·a·single·table·shared | 170 | class.·The·associated·objects·themselves·are·persisted·in·a·single·table·shared |
| 164 | among·all·parents. | 171 | among·all·parents. |
| 165 | _\x8t_\x8a_\x8b_\x8l_\x8e_\x8__\x8p_\x8e_\x8r_\x8__\x8r_\x8e_\x8l_\x8a_\x8t_\x8e_\x8d_\x8._\x8p_\x8y·-·Illustrates·a·generic·association·which·persists | ||
| 166 | association·objects·within·individual·tables,·each·one·generated·to·persist | ||
| 167 | those·objects·on·behalf·of·a·particular·parent·class. | ||
| 168 | _\x8d_\x8i_\x8s_\x8c_\x8r_\x8i_\x8m_\x8i_\x8n_\x8a_\x8t_\x8o_\x8r_\x8__\x8o_\x8n_\x8__\x8a_\x8s_\x8s_\x8o_\x8c_\x8i_\x8a_\x8t_\x8i_\x8o_\x8n_\x8._\x8p_\x8y·-·Illustrates·a·mixin·which·provides·a·generic | ||
| 169 | association·using·a·single·target·table·and·a·single·association·table, | ||
| 170 | referred·to·by·all·parent·tables.·The·association·table·contains·a | ||
| 171 | “discriminator”·column·which·determines·what·type·of·parent·object·associates | ||
| 172 | to·each·particular·row·in·the·association·table. | ||
| 173 | *\x8**\x8**\x8**\x8*·M\x8Ma\x8at\x8te\x8er\x8ri\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·P\x8Pa\x8at\x8th\x8hs\x8s_\x8?\x8¶·*\x8**\x8**\x8**\x8* | 172 | *\x8**\x8**\x8**\x8*·M\x8Ma\x8at\x8te\x8er\x8ri\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·P\x8Pa\x8at\x8th\x8hs\x8s_\x8?\x8¶·*\x8**\x8**\x8**\x8* |
| 174 | Illustrates·the·“materialized·paths”·pattern·for·hierarchical·data·using·the | 173 | Illustrates·the·“materialized·paths”·pattern·for·hierarchical·data·using·the |
| 175 | SQLAlchemy·ORM. | 174 | SQLAlchemy·ORM. |
| 176 | Listing·of·files: | 175 | Listing·of·files: |
| 177 | ····*·_\x8m_\x8a_\x8t_\x8e_\x8r_\x8i_\x8a_\x8l_\x8i_\x8z_\x8e_\x8d_\x8__\x8p_\x8a_\x8t_\x8h_\x8s_\x8._\x8p_\x8y·-·Illustrates·the·“materialized·paths”·pattern. | 176 | ····*·_\x8m_\x8a_\x8t_\x8e_\x8r_\x8i_\x8a_\x8l_\x8i_\x8z_\x8e_\x8d_\x8__\x8p_\x8a_\x8t_\x8h_\x8s_\x8._\x8p_\x8y·-·Illustrates·the·“materialized·paths”·pattern. |
| 178 | *\x8**\x8**\x8**\x8*·N\x8Ne\x8es\x8st\x8te\x8ed\x8d·S\x8Se\x8et\x8ts\x8s_\x8?\x8¶·*\x8**\x8**\x8**\x8* | 177 | *\x8**\x8**\x8**\x8*·N\x8Ne\x8es\x8st\x8te\x8ed\x8d·S\x8Se\x8et\x8ts\x8s_\x8?\x8¶·*\x8**\x8**\x8**\x8* |
| 179 | Illustrates·a·rudimentary·way·to·implement·the·“nested·sets”·pattern·for | 178 | Illustrates·a·rudimentary·way·to·implement·the·“nested·sets”·pattern·for |
| Offset 221, 28 lines modified | Offset 220, 29 lines modified | ||
| 221 | $·python·-m·examples.performance·bulk_inserts·\ | 220 | $·python·-m·examples.performance·bulk_inserts·\ |
| 222 | ····--dburl·mysql+mysqldb://scott:tiger@localhost/test·\ | 221 | ····--dburl·mysql+mysqldb://scott:tiger@localhost/test·\ |
| 223 | ····--profile·--num·1000 | 222 | ····--profile·--num·1000 |
| 224 | See·also | 223 | See·also |
| 225 | _\x8H_\x8o_\x8w_\x8·_\x8c_\x8a_\x8n_\x8·_\x8I_\x8·_\x8p_\x8r_\x8o_\x8f_\x8i_\x8l_\x8e_\x8·_\x8a_\x8·_\x8S_\x8Q_\x8L_\x8A_\x8l_\x8c_\x8h_\x8e_\x8m_\x8y_\x8·_\x8p_\x8o_\x8w_\x8e_\x8r_\x8e_\x8d_\x8·_\x8a_\x8p_\x8p_\x8l_\x8i_\x8c_\x8a_\x8t_\x8i_\x8o_\x8n_\x8? | 224 | _\x8H_\x8o_\x8w_\x8·_\x8c_\x8a_\x8n_\x8·_\x8I_\x8·_\x8p_\x8r_\x8o_\x8f_\x8i_\x8l_\x8e_\x8·_\x8a_\x8·_\x8S_\x8Q_\x8L_\x8A_\x8l_\x8c_\x8h_\x8e_\x8m_\x8y_\x8·_\x8p_\x8o_\x8w_\x8e_\x8r_\x8e_\x8d_\x8·_\x8a_\x8p_\x8p_\x8l_\x8i_\x8c_\x8a_\x8t_\x8i_\x8o_\x8n_\x8? |
| 226 | *\x8**\x8**\x8*·F\x8Fi\x8il\x8le\x8e·L\x8Li\x8is\x8st\x8ti\x8in\x8ng\x8g_\x8?\x8¶·*\x8**\x8**\x8* | 225 | *\x8**\x8**\x8*·F\x8Fi\x8il\x8le\x8e·L\x8Li\x8is\x8st\x8ti\x8in\x8ng\x8g_\x8?\x8¶·*\x8**\x8**\x8* |
| 227 | Listing·of·files: | 226 | Listing·of·files: |
| 228 | ····*·_\x8b_\x8u_\x8l_\x8k_\x8__\x8u_\x8p_\x8d_\x8a_\x8t_\x8e_\x8s_\x8._\x8p_\x8y·-·This·series·of·tests·will·illustrate·different·ways·to | ||
| 229 | ······UPDATE·a·large·number·of·rows·in·bulk·(under·construction!·there’s·just | ||
| 230 | ····· | 227 | ····*·_.s_.i_.n_.g_.l_.e_.__.i_.n_.s_.e_.r_.t_.s_.._.p_.y·-·In·this·series·of·tests,·we’re·looking·at·a·method |
| 228 | ······that·inserts·a·row·within·a·distinct·transaction,·and·afterwards·returns | ||
| 229 | ······to·essentially·a·“closed”·state.·This·would·be·analogous·to·an·API·call | ||
| 230 | ······that·starts·up·a·database·connection,·inserts·the·row,·commits·and | ||
| 231 | ······closes. | ||
| 232 | _\x8s_\x8h_\x8o_\x8r_\x8t_\x8__\x8s_\x8e_\x8l_\x8e_\x8c_\x8t_\x8s_\x8._\x8p_\x8y·-·This·series·of·tests·illustrates·different·ways·to·SELECT·a | ||
| 233 | single·record·by·primary·key | ||
| 234 | _\x8__\x8__\x8m_\x8a_\x8i_\x8n_\x8__\x8__\x8._\x8p_\x8y·-·Allows·the·examples/performance·package·to·be·run·as·a·script. | ||
| 231 | _\x8b_\x8u_\x8l_\x8k_\x8__\x8i_\x8n_\x8s_\x8e_\x8r_\x8t_\x8s_\x8._\x8p_\x8y·-·This·series·of·tests·illustrates·different·ways·to·INSERT·a | 235 | _\x8b_\x8u_\x8l_\x8k_\x8__\x8i_\x8n_\x8s_\x8e_\x8r_\x8t_\x8s_\x8._\x8p_\x8y·-·This·series·of·tests·illustrates·different·ways·to·INSERT·a |
| 232 | large·number·of·rows·in·bulk. | 236 | large·number·of·rows·in·bulk. |
| 233 | _\x8__\x8__\x8m_\x8a_\x8i_\x8n_\x8__\x8__\x8._\x8p_\x8y·-·Allows·the·examples/performance·package·to·be·run·as·a·script. | ||
| 234 | _\x8l_\x8a_\x8r_\x8g_\x8e_\x8__\x8r_\x8e_\x8s_\x8u_\x8l_\x8t_\x8s_\x8e_\x8t_\x8s_\x8._\x8p_\x8y·-·In·this·series·of·tests,·we·are·looking·at·time·to·load·a | 237 | _\x8l_\x8a_\x8r_\x8g_\x8e_\x8__\x8r_\x8e_\x8s_\x8u_\x8l_\x8t_\x8s_\x8e_\x8t_\x8s_\x8._\x8p_\x8y·-·In·this·series·of·tests,·we·are·looking·at·time·to·load·a |
| 235 | large·number·of·very·small·and·simple·rows. | 238 | large·number·of·very·small·and·simple·rows. |
| 239 | _\x8b_\x8u_\x8l_\x8k_\x8__\x8u_\x8p_\x8d_\x8a_\x8t_\x8e_\x8s_\x8._\x8p_\x8y·-·This·series·of·tests·will·illustrate·different·ways·to·UPDATE | ||
| 240 | a·large·number·of·rows·in·bulk·(under·construction!·there’s·just·one·test·at | ||
| 241 | the·moment) | ||
| 236 | _\x8s_\x8i_\x8n_\x8g_\x8l_\x8e_\x8__\x8i_\x8n_\x8s_\x8e_\x8r_\x8t_\x8s_\x8._\x8p_\x8y·-·In·this·series·of·tests,·we’re·looking·at·a·method·that | ||
| 237 | inserts·a·row·within·a·distinct·transaction,·and·afterwards·returns·to | ||
| 238 | essentially·a·“closed”·state.·This·would·be·analogous·to·an·API·call·that | ||
| 239 | starts·up·a·database·connection,·inserts·the·row,·commits·and·closes. | ||
| 240 | _\x8s_\x8h_\x8o_\x8r_\x8t_\x8__\x8s_\x8e_\x8l_\x8e_\x8c_\x8t_\x8s_\x8._\x8p_\x8y·-·This·series·of·tests·illustrates·different·ways·to·SELECT·a | ||
| 241 | single·record·by·primary·key | ||
| 242 | *\x8**\x8**\x8*·R\x8Ru\x8un\x8nn\x8ni\x8in\x8ng\x8g·a\x8al\x8ll\x8l·t\x8te\x8es\x8st\x8ts\x8s·w\x8wi\x8it\x8th\x8h·t\x8ti\x8im\x8me\x8e_\x8?\x8¶·*\x8**\x8**\x8* | 242 | *\x8**\x8**\x8*·R\x8Ru\x8un\x8nn\x8ni\x8in\x8ng\x8g·a\x8al\x8ll\x8l·t\x8te\x8es\x8st\x8ts\x8s·w\x8wi\x8it\x8th\x8h·t\x8ti\x8im\x8me\x8e_\x8?\x8¶·*\x8**\x8**\x8* |
| 243 | This·is·the·default·form·of·run: | 243 | This·is·the·default·form·of·run: |
| 244 | $·python·-m·examples.performance·single_inserts | 244 | $·python·-m·examples.performance·single_inserts |
| 245 | Tests·to·run:·test_orm_commit,·test_bulk_save, | 245 | Tests·to·run:·test_orm_commit,·test_bulk_save, |
| 246 | ··············test_bulk_insert_dictionaries,·test_core, | 246 | ··············test_bulk_insert_dictionaries,·test_core, |
| 247 | ··············test_core_query_caching,·test_dbapi_raw_w_connect, | 247 | ··············test_core_query_caching,·test_dbapi_raw_w_connect, |
| 248 | ··············test_dbapi_raw_w_pool | 248 | ··············test_dbapi_raw_w_pool |
| Offset 468, 22 lines modified | Offset 468, 22 lines modified | ||
| 468 | Several·examples·that·illustrate·the·technique·of·intercepting·changes·that | 468 | Several·examples·that·illustrate·the·technique·of·intercepting·changes·that |
| 469 | would·be·first·interpreted·as·an·UPDATE·on·a·row,·and·instead·turning·it·into | 469 | would·be·first·interpreted·as·an·UPDATE·on·a·row,·and·instead·turning·it·into |
| 470 | an·INSERT·of·a·new·row,·leaving·the·previous·row·intact·as·a·historical | 470 | an·INSERT·of·a·new·row,·leaving·the·previous·row·intact·as·a·historical |
| 471 | version. | 471 | version. |
| 472 | Compare·to·the·_\x8V_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n_\x8i_\x8n_\x8g_\x8·_\x8w_\x8i_\x8t_\x8h_\x8·_\x8a_\x8·_\x8H_\x8i_\x8s_\x8t_\x8o_\x8r_\x8y_\x8·_\x8T_\x8a_\x8b_\x8l_\x8e·example·which·writes·a·history | 472 | Compare·to·the·_\x8V_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n_\x8i_\x8n_\x8g_\x8·_\x8w_\x8i_\x8t_\x8h_\x8·_\x8a_\x8·_\x8H_\x8i_\x8s_\x8t_\x8o_\x8r_\x8y_\x8·_\x8T_\x8a_\x8b_\x8l_\x8e·example·which·writes·a·history |
| 473 | row·to·a·separate·history·table. | 473 | row·to·a·separate·history·table. |
| 474 | Listing·of·files: | 474 | Listing·of·files: |
| 475 | ····*·_\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n_\x8e_\x8d_\x8__\x8u_\x8p_\x8d_\x8a_\x8t_\x8e_\x8__\x8o_\x8l_\x8d_\x8__\x8r_\x8o_\x8w_\x8._\x8p_\x8y·-·Illustrates·the·same·UPDATE·into·INSERT | ||
| 476 | ······technique·of·versioned_rows.py,·but·also·emits·an·UPDATE·on·the·o\x8ol\x8ld\x8d·row | ||
| 477 | ······to·affect·a·change·in·timestamp.·Also·includes·a | ||
| 478 | ······_\x8S_\x8e_\x8s_\x8s_\x8i_\x8o_\x8n_\x8E_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8d_\x8o_\x8__\x8o_\x8r_\x8m_\x8__\x8e_\x8x_\x8e_\x8c_\x8u_\x8t_\x8e_\x8(_\x8)·hook·to·limit·queries·to·only·the·most | ||
| 479 | ······recent·version. | ||
| 475 | 480 | _.v_.e_.r_.s_.i_.o_.n_.e_.d_.__.r_.o_.w_.s_.__.w_.__.v_.e_.r_.s_.i_.o_.n_.i_.d_.._.p_.y·-·Illustrates·a·method·to·intercept·changes·on | |
| 476 | 481 | objects,·turning·an·UPDATE·statement·on·a·single·row·into·an·INSERT·statement, | |
| 477 | 482 | so·that·a·new·row·is·inserted·with·the·new·data,·keeping·the·old·row·intact. | |
| 478 | ······old·row·intact. | ||
| Max diff block lines reached; 5530/16021 bytes (34.52%) of diff not shown. | |||