rst sucks
parent
0944c887e0
commit
23a405a6af
55
README.rst
55
README.rst
|
|
@ -1,55 +0,0 @@
|
|||
====================
|
||||
django-database-view
|
||||
====================
|
||||
|
||||
A simple pluggable application that allows to work with database views.
|
||||
|
||||
So far only MySQL is supported as backend, but more could be added if necessary.
|
||||
|
||||
Quick start
|
||||
-----------
|
||||
|
||||
1. Add "dbview" to your INSTALLED_APPS settings like this::
|
||||
|
||||
INSTALLED_APPS = (
|
||||
...
|
||||
'dbview',
|
||||
)
|
||||
|
||||
|
||||
2. In your models.py create classes which extend dbview.models.DbView
|
||||
like this::
|
||||
|
||||
.. code-block:: python
|
||||
from django.db import models
|
||||
from dbview.models import DbView
|
||||
|
||||
class ModelA(models.Model):
|
||||
fielda = models.CharField()
|
||||
fieldc = models.IntegerField()
|
||||
|
||||
|
||||
class MyView(DbView):
|
||||
fieldA = models.OneToOneField(ModelA, primary_key=True,
|
||||
db_column='fielda__id')
|
||||
fieldB = models.IntegerField(blank=True, null=True, db_column='fieldb')
|
||||
|
||||
@classmethod
|
||||
def view(klass):
|
||||
'''
|
||||
This method returns the SQL string that creates the view, in this
|
||||
example fieldB is the result of annotating another column
|
||||
'''
|
||||
qs = modelA.objects.all().\
|
||||
annotate(fieldb=models.Sum('fieldc')) .\
|
||||
annotate(fielda__id=models.F('pk')) .\
|
||||
order_by('fielda__id') .\
|
||||
values('fielda__id', 'fieldb')
|
||||
return str(qs.query)
|
||||
|
||||
3. Then create a migration point for your view generation, edit that migration
|
||||
and modify it, add: `from dbview.helpers import CreateView` and replace the line
|
||||
the call to migrations.CreateModel with CreateView.
|
||||
|
||||
|
||||
4. Migrate your database and start using your database views.
|
||||
Loading…
Reference in New Issue