Changes between Version 8 and Version 9 of DocPtDatabaseAPI

Timestamp:

Oct 20, 2006, 8:50:20 PM (18 years ago)

Author:

mario.caseiro at gmail.com

Comment:

--

DocPtDatabaseAPI

@@ -39 +39 @@
 
 
+
 .. _0.90: http://www.djangoproject.com/documentation/0_90/ 
+
+
 .. _0.91: http://www.djangoproject.com/documentation/0_91/ 
 
 Uma vez que você criou seus `data models`_, Django fornece automaticamente uma API de abstração de banco de dados para você criar, recuperar, atualizar e deletar objetos. Este documento descreve esta API .
+
 
 
@@ -125 +129 @@
 Caso tenha um modelo com um campo ``AutoField`` mas você queira definir o ID de um objeto explicitamente quando o salvar, é só defini-lo explicitamente antes de salvá-lo, ao invés de deixar a auto atribuição do ID.
 
+
 Exemplo::
 
@@ -189 +194 @@
 (``Managers`` são acessívei somente por via das classes modelos, e não pelas instâncias dos modelos, isto é para garantir a separação entre operações em níveis de tabelas ("table-level") das operações em níveis de registro ("record-level") )
 
+
 O ``Manager`` é a principal fonte de ``QuerySets`` para um determinado modelo (model). Ele age como uma "raiz" das ``QuerySet`` que descrevem todos os objetos em tabelas de um determinado modelo no banco de dados.
 Por exemplo, ``Blog.objects`` é a ``QuerySet`` inicial que contém todos os objetos ``Blog`` no banco de dados.
@@ -384 +390 @@
 ``distinct()``
 ~~~~~~~~~~~~~~
+
+
 
 Retorna um novo ``QuerySet`` que utiliza ``SELECT DISTINCT`` na query SQL. Isto elimina linhas duplicadas dos resultados da query.
@@ -506 +514 @@
 
 
+Especifique um ou mais dos seguintes ``params``, ``select``, ``where`` ou ``tables``. Nenhum dos argumentos é requerido, mas você deve usar pelo menos um deles. 
+
+``select``
+    The ``select`` argument lets you put extra fields in the ``SELECT`` clause.
+    It should be a dictionary mapping attribute names to SQL clauses to use to
+    calculate that attribute.
+
+    Exemplo::
+
+        Entry.objects.extra(select={'is_recent': "pub_date > '2006-01-01'"})
+
+
+    Como resultado, cada objeto ``Entry`` terá um atributo extra, ``is_recent``, uma representação booleana de  ``pub_date`` de entrada é maior do que janeiro 1, 2006.
+
+    Django insere o trecho SQL dado diretamente na declaração ``SELECT``, assim a SQL resultante do exemplo acima seria::
+
+        SELECT blog_entry.*, (pub_date > '2006-01-01')
+        FROM blog_entry;
+
+
+    O exemplo seguinte é mais avançado; faz uma subquery para dar a cada objeto ``Blog`` resultante um atributo ``entry_count``, um inteiro da contagem de objetos associados da ``Entry``::
+
+        Blog.objects.extra(
+            select={
+                'entry_count': 'SELECT COUNT(*) FROM blog_entry WHERE blog_entry.blog_id = blog_blog.id'
+            },
+        )
+
+    (Neste caso particular, nós estamos abusando do fato que a query já conterá a tabela ``blog_blog`` no sua cláusula ``FROM`` .)
+
+O SQL resultante do exemplo acima seria::
+
+        SELECT blog_blog.*, (SELECT COUNT(*) FROM blog_entry WHERE blog_entry.blog_id = blog_blog.id)
+        FROM blog_blog;
+
+Note que o parênteses requerido pela maioria dos engines de banco de dados ao redor das subqueries não são requeridos nas cláusulas ``select`` do Django . Note também que alguns backends de banco de dados , como algumas versões de MySQL, não suportam subqueries.
+
+``where`` / ``tables``
+    Você pode definir as cláusulas SQL ``WHERE`` explícitamente  -- talvez para executar joins não-explícitos -- usando ``where``. Pode também manualmente adicionar tabelas a cláusula  SQL ``FROM`` usando ``tables``.
+
+    ``where`` e ``tables`` ambos levam uma lista de strings. Todos parâmetros ``where``  são adicionados de "AND" para qualquer outro critério de busca.
+
+    Exemplo::
+
+        Entry.objects.extra(where=['id IN (3, 4, 5, 20)'])
+
+    ...traduz (aproximadamente) na seguinte SQL::
+
+        SELECT * FROM blog_entry WHERE id IN (3, 4, 5, 20);
+
+
+``params``
+    Os parâmetros  ``select`` e ``where`` descritos acima podem usar o padrão de placeholders de string para banco de dados do Python -- ``"%s"`` para indicar parâmetros que o engine de banco de dados deve adicionar  automaticamente aspas. O argumento ``params`` é uma lista de todos os parâmetros extra a serem substituídos.
+        
+
+    Exemplo::
+
+        Entry.objects.extra(where=['headline=%s'], params=['Lennon'])
+
+    Sempre  use ``params`` em vez de encaixar valores diretamente em ``select`` ou ``where`` porque os ``params`` assegurarão que os valores sejam adcionados de aspas corretamente de acordo com seu backend. (Por exemplo, as aspas serão escapadas corretamente.)
+
+    Ruim::
+
+        Entry.objects.extra(where=["headline='Lennon'"])
+
+    Bom::
+
+        Entry.objects.extra(where=['headline=%s'], params=['Lennon'])
+
 
 }}}