Changes between Version 2 and Version 3 of DocPtDatabaseAPI

Timestamp:

Oct 8, 2006, 12:48:27 PM (19 years ago)

Author:

mario.caseiro at gmail.com

Comment:

--

DocPtDatabaseAPI

@@ -1 +1 @@
 {{{
 #!rst
+
+
+
+THIS TRANSLATION IS IN PROGRESS:
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
++-------------------------------------------------------------------------------------------------+
+|    This is an **in progress** translation document, that means there is somebody working on it. |
+|    For more information on translating documents please look at `TranslateDocumentation Wiki`_. |
+|    Please **do not** edit this page.                                                            |
+|                                                                                                 |
+| .. _TranslateDocumentation Wiki : http://code.djangoproject.com/wiki/TranslateDocumentation     |
++-------------------------------------------------------------------------------------------------+   
 
 ..
@@ -108 +120 @@
 ------------------------------------------------------
 
-Caso um modelo tenha um campo ``AutoField``, porém 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.
+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::
@@ -119 +131 @@
 
 
+Se você atribuir valores de chave-primária (auto-primary-keys)  manualmente, certifique-se de não usar um valor já existente de chave primária! Se você criar um novo objeto com um valor explícito da chave-primária que já exista no banco de dados, Django irá supor que você está mudando o registro existente ao invés de criar um novo. 
 
-=======================
-D E A R  F R I E N D S:
-=======================
- I have already translate more on this document, but didn't have more time to do all rST formating.
- I hope to finish the tranlating this week, since that happens i'll update this page.
+Dado o exemplo acima do blog ``'Cheddar Talk'`` , este exemplo substituiria o registro antigo do banco de dados:: 
+
+    b4 = Blog(id=3, name='Not Cheddar', tagline='Anything but cheese.')
+    b4.save()  # Overrides the previous blog with ID=3!
+
+Veja  _`Como Django decide entre UPDATE vs. INSERT`  , logo abaixo abaixo, para saber porque que isto acontece. 
+
+Especificar valores de chaves-primárias (auto-primary-keys) explicitamente é na maior parte útil para salvar grandes quantidades de objetos, uma vez que você está seguro que não terá conflitos de chaves-primárias
+
+
+Salvando alterações nos Objetos
+===================================
+
+Para salver alterações em um objeto que já exista no banco de dados, use ``save()``. 
+
+Dado a instância ``b5`` do ``Blog``, que já fora salvo no banco de dados, este exemplo altera seu nome e atualiza seu registro no banco de dados:: 
+
+    b5.name = 'New name'
+    b5.save()
+
+Isto executa uma declaração SQL  ``INSERT`` por detrás das cenas. Django não conecta ao banco de dados até que você chame explicitamente ``save()``. 
+
+O método ``save()`` não retorna valor algum.