Como é que o Django determina se deve realizar uma operação de inserção (insert) ou atualização (update)?

O Django determina se deve realizar uma operação de inserção ou atualização com base na presença ou ausência da chave primária (geralmente id) no objeto do modelo.

Ao chamar o método save():

1. Operação de inserção (insert): Se o valor da chave primária do objeto do modelo for None (ou igual ao valor padrão para AutoField, indicando que ainda não foi salvo), o Django assume que é um novo objeto a ser inserido na base de dados. Após uma inserção bem-sucedida, a base de dados gera o valor da chave primária, que é atribuído ao objeto.
2. Operação de atualização (update): Se o objeto do modelo já tiver um valor de chave primária definido (ou seja, não for None), o Django assume que é um objeto existente na base de dados que deve ser atualizado. O framework realiza uma operação UPDATE na linha correspondente.

Este comportamento é controlado pelo atributo pk (chave primária) do objeto.

Exemplo:

# Criando um novo objeto - pk será None
from yourappname.models import YourModel
new_obj = YourModel(some_field='value1')

# Ao chamar save() pela primeira vez, pk == None, realiza-se um INSERT
new_obj.save()

# Após salvar, pk agora contém o valor gerado pela base de dados
# Por exemplo, new_obj.id pode ser 1

# Modificando um objeto existente
existing_obj = YourModel.objects.get(pk=1)
existing_obj.some_field = 'new_value'

# Ao chamar save() novamente, pk != None, realiza-se um UPDATE
existing_obj.save()

É importante notar que o valor passado de chave primária para save() (se existir) indica implicitamente a intenção do Django de atualizar o registro existente com essa chave.

Este é o comportamento padrão do Django ORM, que simplifica o trabalho com dados, abstraindo detalhes das operações SQL.