Django field to SQL Server type mappings

この記事では、mssql-djangoバックエンドを使用した場合にDjangoモデルのフィールドタイプがSQL Serverデータ型にどのようにマッピングされるかを記述しています。

フィールドタイプマッピングテーブル

SQL Server固有の動作

一部のDjangoフィールドタイプは、SQL Serverで使用するとプラットフォーム固有の動作を示します。

オートフィールド制限

移行時にモデルフィールドを AutoField から変更することはサポートされていません。 主キータイプを変更する必要がある場合は、新しいフィールドを作成して手動でデータを移行してください。

BooleanField と bit

SQL Serverビットタイプのストアは0と1です。 Djangoはこれらの値に True/False マッピングします。 NULL BooleanField(null=True)でサポートされています。

DateTimeFieldとタイムゾーンサポート

Djangoの設定でUSE_TZ=Trueすると、DateTimeFieldはdatetimeoffsetを使ってタイムゾーンに対応した日付を保存します。 USE_TZ=False時はdatetime2を使用します。

列を作成後に USE_TZ を有効にする場合は、既存の datetime2 列を 手動でdatetimeoffsetに移行する必要があります。 詳細は mssql-djangoのタイムゾーンサポートをご覧ください。

TextFieldとCharFieldの比較

SQL ServerはナヴァルチャルへのTextFieldとCharFieldの両方をマッピングしています。 TextField nvarchar(max)を使い、CharFieldはnvarchar(N)を使い、Nはmax_lengthです。

すべての文字列フィールドはnvarchar(Unicode)を使用しています。

mssql-djangoバックエンドは、すべてのDjango文字列フィールド(CharField、TextField、EmailField、URLField、SlugFieldなど)をUnicodeの文字列型nvarcharにマッピングします。 varchar(非Unicode)を使うための組み込みオプションはありません。

これは仕様です。 Djangoの文字列処理は全線Unicodeで、 nvarchar は言語やエンコーディングに関係なくすべての文字が正しく格納されることを保証します。 nvarcharを使うことで、文字セットの不一致によるデータ損失を避けられます。

トレードオフ:

• nvarchar は1文字あたり2バイトを使用しますが、1バイトのコレーションで使う varchar は1文字あたり1バイトです。
• インデックスキーサイズの制限が適用されます(クラスタ化されていないインデックスは900バイト)。 nvarchar(450)列は900バイト(450×2バイト)の制限に達し、varchar(900)列はシングルバイト文字で同じ制限に達します。
• もしデータが完全にASCIIであれば、 nvarchar は varcharに比べてストレージ容量が2倍になります。

ヴァルチャールの柱が必要なら:

レガシーデータベースや厳格なストレージ要件がある場合は、以下の db_typeを上書きするカスタムフィールドを作成します。

from django.db import models

class VarcharField(models.CharField):
    def db_type(self, connection):
        return f"varchar({self.max_length})"

class LegacyProduct(models.Model):
    sku = VarcharField(max_length=50)  # Creates varchar(50) instead of nvarchar(50)

    class Meta:
        managed = False  # For existing tables
        db_table = "LegacyProduct"

関連するコンテンツ

• JSONField with SQL Server
• mssql-djangoによるデータベース移行
• mssql-djangoの制限事項およびサポートされていない機能
• ジャンゴモデルフィールド参照