[Checkins] SVN: zope2docs/trunk/zope2book/source/RelationalDatabases.rst added preliminary remark on ORMs

Andreas Jung andreas at andreas-jung.com
Sun Feb 22 03:51:52 EST 2009


Log message for revision 97007:
  added preliminary remark on ORMs
  

Changed:
  U   zope2docs/trunk/zope2book/source/RelationalDatabases.rst

-=-
Modified: zope2docs/trunk/zope2book/source/RelationalDatabases.rst
===================================================================
--- zope2docs/trunk/zope2book/source/RelationalDatabases.rst	2009-02-22 07:57:48 UTC (rev 97006)
+++ zope2docs/trunk/zope2book/source/RelationalDatabases.rst	2009-02-22 08:51:52 UTC (rev 97007)
@@ -1,6 +1,24 @@
 Relational Database Connectivity
 ================================
 
+Preliminary remark
+------------------
+This chapter explains you how to access a relational databases directly through
+SQL. The alternative and modern way integrating a RDBMS with Zope is using an
+Object-Relational-Mapper (ORM). An ORM abstracts the SQL layer and allows you
+to deal with database tables, rows etc. like standard Python objects.
+
+The most common and most flexible ORM in the
+Python world is `SQLAlchemy <http://www.sqlalchemy.org>`_ . You can not use
+SQLAlchemy directly within Zope because the transaction system of the RDBMS
+must participate with Zope transaction. This integration layer is implemented
+through the `zope.sqlalchemy <http://pypi.python.org/pypi/zope.sqlalchemy>`_
+module.
+
+Introduction
+------------
+
+
 The Zope Object Database (ZODB) is used to store all the pages,
 files and other objects you create. It is fast and requires almost
 no setting up or maintenance.  Like a filesystem, it is especially



More information about the Checkins mailing list