瀏覽代碼

Reverted "Fixed #30711 -- Doc'd django.contrib.postgres.fields.hstore.KeyTransform()."

This reverts commit 7faf25d682b8e8f4fd2006eb7dfc71ed2a2193b7. The same
can be achieved with F() so there is no need to expose an extra API.
Mariusz Felisiak 2 年之前
父節點
當前提交
cb06f5ef8c
共有 1 個文件被更改,包括 7 次插入16 次删除
  1. 7 16
      docs/ref/contrib/postgres/fields.txt

+ 7 - 16
docs/ref/contrib/postgres/fields.txt

@@ -343,22 +343,6 @@ transform do not change. For example::
     valid for a given field. This can be done using the
     :class:`~django.contrib.postgres.validators.KeysValidator`.
 
-KeyTransform() expression
--------------------------
-
-.. class:: hstore.KeyTransform(key_name, *args, **kwargs)
-
-Returns the value of the given ``key_name``. This allows you to annotate a key
-value. For example::
-
-    >>> from django.contrib.postgres.fields.hstore import KeyTransform
-    >>> Dog.objects.create(name="Rufus", data={"breed": "labrador"})
-    >>> Dog.objects.create(name="Meg", data={"breed": "collie", "owner": "Bob"})
-
-    >>> rufus = Dog.objects.annotate(breed=KeyTransform("breed", "data"))[0]
-    >>> rufus.breed
-    'labrador'
-
 Querying ``HStoreField``
 ------------------------
 
@@ -395,6 +379,13 @@ You can chain other lookups after key lookups::
     >>> Dog.objects.filter(data__breed__contains='l')
     <QuerySet [<Dog: Rufus>, <Dog: Meg>]>
 
+or use ``F()`` expressions to annotate a key value. For example::
+
+    >>> from django.db.models import F
+    >>> rufus = Dog.objects.annotate(breed=F("data__breed"))[0]
+    >>> rufus.breed
+    'labrador'
+
 If the key you wish to query by clashes with the name of another lookup, you
 need to use the :lookup:`hstorefield.contains` lookup instead.