Django3.0中向后不兼容的更改

3.0中向后不兼容的更改

本节描述了第三方数据库后端中可能需要的更改。

现在的第二个参数DatabaseIntrospection.get_geometry_type()是行描述，而不是列名。
DatabaseIntrospection.get_field_type() 可能不再返回元组。
如果数据库可以在添加字段的同一SQL语句中创建外键，请添加SchemaEditor.sql_create_column_inline_fk适当的SQL；否则，请添加相应的SQL。否则，设置。DatabaseFeatures.can_create_inline_fk = False
DatabaseFeatures.can_return_id_from_insert并且 can_return_ids_from_bulk_insert被重命名为 can_return_columns_from_insert和can_return_rows_from_bulk_insert。
现在，数据库函数可以处理datetime.timezone使用datetime.timedelta实例创建的格式（例如 timezone(timedelta(hours=5))输出'UTC+05:00'）。DateTimeField在，等中进行准备时datetime_cast_date_sql()，第三方后端应处理此格式 datetime_extract_sql()。
条目AutoField，BigAutoField和SmallAutoField被添加到 DatabaseOperations.integer_field_ranges支持关于这些字段类型的整数范围的验证。第三方后端可能需要自定义默认条目。
DatabaseOperations.fetch_returned_insert_id()替换为， fetch_returned_insert_columns()它返回语句返回的值列表，而不是单个值。INSERT … RETURNING
DatabaseOperations.return_insert_id()替换为 return_insert_columns()接受fields 参数的参数，该参数是插入后要返回的字段的可迭代项。通常，这只是自动生成的主键。

对PostgreSQL 9.4的上游支持将于2019年12月结束。Django3.0支持PostgreSQL 9.5和更高版本。

对Oracle 12.1的上游支持将于2021年7月结束。Django2.2将一直支持到2022年4月。Django3.0正式支持Oracle 12.2和18c。

尽管在Django 2.0中删除了对Python 2的支持，但并未从Django中删除某些私有API，因此第三方应用程序可以继续使用它们，直到Python 2终止使用为止。

由于我们希望应用在添加对Django 3.0的支持时会降低Python 2的兼容性，因此我们目前正在删除这些API。

django.test.utils.str_prefix() -Python 3中的字符串没有'u'前缀。
django.test.utils.patch_logger()- unittest.TestCase.assertLogs()改用。
django.utils.lru_cache.lru_cache()-的别名 functools.lru_cache()。
django.utils.decorators.available_attrs()-此函数返回 functools.WRAPPER_ASSIGNMENTS。
django.utils.decorators.ContextDecorator-的别名 contextlib.ContextDecorator。
django.utils._os.abspathu()-的别名os.path.abspath()。
django.utils._os.upath()和npath()-这些功能在Python 3上不起作用。
django.utils.six-删除此供应商库的使用或切换到六个。
django.utils.encoding.python_2_unicode_compatible()-的别名 six.python_2_unicode_compatible()。
django.utils.functional.curry()-使用functools.partial()或 functools.partialmethod。参见5b1c389603a353625ae1603。
django.utils.safestring.SafeBytes -自Django 2.0起未使用。

在旧版本中，该FILE_UPLOAD_PERMISSIONS设置默认为 None。使用默认值FILE_UPLOAD_HANDLERS，这会导致上载的文件具有不同的权限，具体取决于它们的大小和使用的上载处理程序。

FILE_UPLOAD_PERMISSION现在默认为0o644避免这种不一致。

为了使Django项目默认更安全，某些安全设置现在具有更安全的默认值：

有关这些更改的更多详细信息，请参见上面的“新增 安全性”部分。

ContentType.__str__()现在包含了该模型app_label，可在不同应用中消除同名模型的歧义。
因为不赞成在会话中而不是在cookie中访问语言，所以注销后不再在会话中LocaleMiddleware查找用户的语言，django.contrib.auth.logout()也不再保留会话的语言。
django.utils.html.escape()现在用于html.escape()转义HTML。这将转换'为'而不是先前的等效十进制代码'。
该选项现在工作作为选项，而不是作为一个快捷方式。django-admin test -kunittest -k--keepdb
pywatchman<1.2.0的支持已删除。
urlencode()现在可以对whener进行编码doseq=False，而不是对其进行迭代，从而使其与标准库urllib.parse.urlencode()函数保持一致。
intword模板过滤器现在转换1.0为单数短语，所有其他数值转换为复数形式。对于某些语言，这可能是不正确的。
现在，将值分配给模型的ForeignKey或属性会取消设置相应的字段。之后访问该字段将导致查询。OneToOneField '_id'
patch_vary_headers()现在 '*'根据RFC 7231＃section-7.1.4，即，如果标头字段名称列表包含星号，则Vary标头将由单个星号组成'*'。
在MySQL 8.0.16+，PositiveIntegerField而PositiveSmallIntegerField 现在包括检查约束，以防止数据库中的负值。
alias=None已添加到的签名 Expression.get_group_by_cols()。
sqlparse<0.2.2的支持已删除。