... ここから派生しています: Lookup : フィールドをルックアップします (例えば field_name__exact の exact ) Transform : フィールドをトランスフォーム（変換）します。 ルックアップ式は3つの部分で構成されています: Fields part, e.g. Book.objects.filter(author__best_friends__fi ... rst_name... ); トランスフォーム（変換）部分（省略可） ( lower__first3chars__reversed など); ルックアップ部分 ( __icontains など)。省略した場合のデフォルトは ... ます。代表的な例は Field で、これはすべてのモデルフィールドの基底クラスです。 Transform もその一つで、これはすべての Django トランスフォームの基底クラスです。 class lookups. RegisterLookupMixin ¶ クラスのルックアップ API を実装するミックスインです。 classmethod re ... ... nc サブクラス（下記）があります。たとえば Trunc(..., kind='year') の代わりに TruncYear(...) が使えます。 サブクラスはすべてトランスフォームとして定義されていますが、ルックアップ名は Extract サブクラスによってすでに予約されているため、フィールドは登録されていません ... eField() TruncDate は、組み込みの SQL の切り捨て関数を使わずに、 expression を日付にキャストします。また、 DateTimeField のトランスフォームとして __date が登録されています。 class TruncTime ( expression , tzinfo = None , ** extra ) [ソース] ¶ lookup_name = 'time' ... imeField() TruncTime は、組み込み SQL の切り捨て関数を使わずに、 expression を時刻にキャストします。また、 DateTimeField のトランスフォームとして __time が登録されています。 class TruncDay ( expression , output_field = None , tzinfo = None , ** extra ) [ソース] ¶ ... ... nc サブクラス（下記）があります。たとえば Trunc(..., kind='year') の代わりに TruncYear(...) が使えます。 サブクラスはすべてトランスフォームとして定義されていますが、ルックアップ名は Extract サブクラスによってすでに予約されているため、フィールドは登録されていません ... eField() TruncDate は、組み込みの SQL の切り捨て関数を使わずに、 expression を日付にキャストします。また、 DateTimeField のトランスフォームとして __date が登録されています。 class TruncTime ( expression , tzinfo = None , ** extra ) [ソース] ¶ lookup_name = 'time' ... imeField() TruncTime は、組み込み SQL の切り捨て関数を使わずに、 expression を時刻にキャストします。また、 DateTimeField のトランスフォームとして __time が登録されています。 class TruncDay ( expression , output_field = None , tzinfo = None , ** extra ) [ソース] ¶ ... ... ここから派生しています: Lookup : フィールドをルックアップします (例えば field_name__exact の exact ) Transform : フィールドをトランスフォーム（変換）します。 ルックアップ式は3つの部分で構成されています: Fields part, e.g. Book.objects.filter(author__best_friends__fi ... rst_name... ); トランスフォーム（変換）部分（省略可） ( lower__first3chars__reversed など); ルックアップ部分 ( __icontains など)。省略した場合のデフォルトは ... ます。代表的な例は Field で、これはすべてのモデルフィールドの基底クラスです。 Transform もその一つで、これはすべての Django トランスフォームの基底クラスです。 class lookups. RegisterLookupMixin ¶ クラスのルックアップ API を実装するミックスインです。 classmethod re ... ... す。例えばこのようにします: >>> F ( "somefield" ) . bitand ( 16 ) Oracle オラクルはXORビット演算をサポートしていません。 式はトランスフォーム（Transform）を参照できる ¶ Django は式でトランスフォーム（変換）を使うことをサポートしています。 たとえば、次のコードは最終 ... めします。詳しくは 非同期サポート を参照してください。 JSONField へのクエリ ¶ JSONField では、ルックアップの実装は主にキーのトランスフォーム（変換）の存在によって異なります。デモンストレーションのために、次のモデル例を使います: from django.db import models class D ... s a custom encoder is used. If you don't want to use a custom encoder, use None instead. キー、インデックス、パス（経路）のトランスフォーム（変換） ¶ 指定された辞書のキーに基づいてクエリを実行するには、そのキーをルックアップ名として使います: >>> Dog . objects . c ... ... す。例えばこのようにします: >>> F ( "somefield" ) . bitand ( 16 ) Oracle オラクルはXORビット演算をサポートしていません。 式はトランスフォーム（Transform）を参照できる ¶ Django は式でトランスフォーム（変換）を使うことをサポートしています。 たとえば、次のコードは最終 ... めします。詳しくは 非同期サポート を参照してください。 JSONField へのクエリ ¶ JSONField では、ルックアップの実装は主にキーのトランスフォーム（変換）の存在によって異なります。デモンストレーションのために、次のモデル例を使います: from django.db import models class D ... s a custom encoder is used. If you don't want to use a custom encoder, use None instead. キー、インデックス、パス（経路）のトランスフォーム（変換） ¶ 指定された辞書のキーに基づいてクエリを実行するには、そのキーをルックアップ名として使います: >>> Dog . objects . c ... ... SQL 式にまとめ、クエリのすべてのパラメータを指定します。その後、生成された SQL 文字列とパラメータを含むタプルを返します。 トランスフォーム（ Transform : 変換）の例 ¶ 上記のカスタムルックアップは素晴らしいですが、場合によってはルックアップを一緒に連結したいことも ... でしたが、より複雑な型（たとえば、原点に関連する点や複素数）を表すフィールドに AbsoluteValue を適用すると仮定します。 次に、トランスフォームが次のルックアップのために FloatField 型を返すように指定したいかもしれません。これは、次のようにトランスフォームに output_fi ... では、 abs(change) にインデックスを追加することをお勧めします。これにより、これらのクエリは非常に効率的になります。 双方向のトランスフォームの例 ¶ 前に説明した AbsoluteValue の例は、ルックアップの左側に適用される変換です。 変換を左側と右側の両方に適用したい場合があ ... ... ドをnullable にし、値を None でパディングする必要があります。 ArrayField へのクエリ ¶ ArrayField には、カスタムルックアップやトランスフォームがいくつかあります。以下のモデル例を使用します。 from django.contrib.postgres.fields import ArrayField from django.db import ... ost" , tags = [ "thoughts" ]) >>> Post . objects . filter ( tags__len = 1 ) <QuerySet [<Post: Second post>]> インデックスのトランスフォーム ¶ インデックスは配列内のインデックスに変換されます。非負の整数ならどれでも使用できます。配列の size 属性を超えていてもエラ ... インデックスと slices で使用されるインデックスは、Pythonとの一貫性を保つために0から始まるインデックスを使用します。 スライス トランスフォーム ¶ スライス トランスフォームは、配列の一部を切り取ります。 2つの非負整数をアンダースコアで区切って使用できます。トランスフォ ... ... ドをnullable にし、値を None でパディングする必要があります。 ArrayField へのクエリ ¶ ArrayField には、カスタムルックアップやトランスフォームがいくつかあります。以下のモデル例を使用します。 from django.contrib.postgres.fields import ArrayField from django.db import ... ost" , tags = [ "thoughts" ]) >>> Post . objects . filter ( tags__len = 1 ) <QuerySet [<Post: Second post>]> インデックスのトランスフォーム ¶ インデックスは配列内のインデックスに変換されます。非負の整数ならどれでも使用できます。配列の size 属性を超えていてもエラ ... インデックスと slices で使用されるインデックスは、Pythonとの一貫性を保つために0から始まるインデックスを使用します。 スライス トランスフォーム ¶ スライス トランスフォームは、配列の一部を切り取ります。 2つの非負整数をアンダースコアで区切って使用できます。トランスフォ ... ... SQL 式にまとめ、クエリのすべてのパラメータを指定します。その後、生成された SQL 文字列とパラメータを含むタプルを返します。 トランスフォーム（ Transform : 変換）の例 ¶ 上記のカスタムルックアップは素晴らしいですが、場合によってはルックアップを一緒に連結したいことも ... でしたが、より複雑な型（たとえば、原点に関連する点や複素数）を表すフィールドに AbsoluteValue を適用すると仮定します。 次に、トランスフォームが次のルックアップのために FloatField 型を返すように指定したいかもしれません。これは、次のようにトランスフォームに output_fi ... では、 abs(change) にインデックスを追加することをお勧めします。これにより、これらのクエリは非常に効率的になります。 双方向のトランスフォームの例 ¶ 前に説明した AbsoluteValue の例は、ルックアップの左側に適用される変換です。 変換を左側と右側の両方に適用したい場合があ ... 2026年10月08日