Browse files

Fixed #2064 -- Added 'Falling back to raw SQL' section to docs/db-ap…


git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
adrianholovaty committed Jun 2, 2006
1 parent fe4139d commit 1717b94fc85430a1b0b8626d9b932fda58563e50
Showing with 20 additions and 0 deletions.
  1. +20 −0 docs/db-api.txt
@@ -1578,3 +1578,23 @@ get_FOO_height() and get_FOO_width()
For every ``ImageField``, the object will have ``get_FOO_height()`` and
``get_FOO_width()`` methods, where ``FOO`` is the name of the field. This
returns the height (or width) of the image, as an integer, in pixels.
+Falling back to raw SQL
+If you find yourself needing to write an SQL query that is too complex for
+Django's database-mapper to handle, you can fall back into raw-SQL statement
+The preferred way to do this is by giving your model custom methods or custom
+manager methods that execute queries. Although there's nothing in Django that
+*requires* database queries to live in the model layer, this approach keeps all
+your data-access logic in one place, which is smart from an code-organization
+standpoint. For instructions, see `Executing custom SQL`_.
+Finally, it's important to note that the Django database layer is merely an
+interface to your database. You can access your database via other tools,
+programming languages or database frameworks; there's nothing Django-specific
+about your database.
+.. _Executing custom SQL:

0 comments on commit 1717b94

Please sign in to comment.