Написание инструкций Transact-SQL, адаптированных к международному использованию

  • Статья

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Базы данных и приложения базы данных, использующие инструкции Transact-SQL, становятся более переносимыми с одного языка на другой или поддерживают несколько языков, если следуют следующие рекомендации:

  • Начиная с SQL Server 2019 (15.x) и в База данных SQL Azure используйте:

    • типы данных char, varchar и varchar(max) с параметрами сортировки с поддержкой символов UTF-8; данные кодируются с помощью UTF-8;
    • типы данных nchar, nvarchar и nvarchar(max) с параметрами сортировки с поддержкой дополнительных символов; данные кодируются с помощью UTF-16. Использование параметров сортировки, не поддерживающих дополнительные символы, приводит к кодированию данных с использованием UCS-2.

    Это позволяет избежать проблемы преобразования кодовых страниц. См. подробнее о различиях в хранении для символов UTF-8 и UTF-16.

  • До SQL Server 2017 (14.x), замените все типы данных char, varchar и varchar(max) nchar, nvarchar и nvarchar(max). При использовании параметров сортировки с поддержкой дополнительных символов данные кодируются с помощью UTF-16. Использование параметров сортировки, не поддерживающих дополнительные символы, приводит к кодированию данных с использованием UCS-2. Это позволяет избежать проблемы преобразования кодовых страниц. Дополнительные сведения см. в статье Collation and Unicode Support.

    Внимание

    Тип данных text является устаревшим, и его не следует использовать в новых разработках. Запланируйте преобразование данных типа text в varchar(max).

  • При выполнении сравнения и других операций со значениями месяцев и дней недели следует использовать числовые эквиваленты вместо строковых имен. При различных языковых настройках возвращаются различные названия месяцев и дней недели. Например, возвращаетсяMay, DATENAME(MONTH,GETDATE()) когда для языка задано значение "Английский", возвращается, когда для языка задано значение "Немецкий", и возвращается Mai mai, когда для языка задано значение "Французский". Вместо нее следует использовать функцию наподобие DATEPART, в которой вместо названия месяца используется его номер. При выводе результирующих наборов пользователю лучше использовать названия из функции DATEPART(), так как они зачастую более информативны, чем числовое представление даты. Однако не следует кодировать какую-либо логику, зависящую от отображаемых названий на том или ином языке.

  • При указании дат для сравнения либо ввода с помощью инструкций INSERT или UPDATE следует использовать константы, интерпретируемые одним и тем же образом для всех языковых настроек.

    • В приложениях ADO, OLE DB и ODBC следует использовать принятые в ODBC форматы отметок времени, даты и времени:

      { ts' yyyy - mm - dd hh : mm : ss [.fff] '}, например: { ts'1998-09-24 10:02:20'}

      { d' yyyy - mm - dd '}, например: { d'1998-09-24'}

      { t' hh : mm : ss '}, например: { t'10:02:20'}

    • Приложения, использующие другие API-интерфейсы или скрипты Transact-SQL, хранимые процедуры и триггеры, должны использовать неуправляемые числовые строки. Например, yyyymmdd в виде 19980924.

    • Приложения, использующие другие API или скрипты Transact-SQL, хранимые процедуры и триггеры, должны использовать инструкцию CONVERT с явным параметром стиля для всех преобразований между временем, датой, небольшим числом, датой, датой, datetime2 и типами данных datetimeoffset и типами строковых строк. Например, следующая инструкция интерпретируется одинаково для любых настроек языка и формата даты в соединении:

      SELECT *  
FROM AdventureWorks2022.Sales.SalesOrderHeader  
WHERE OrderDate = CONVERT(DATETIME, '20060719', 101)

См. также

CAST и CONVERT (Transact-SQL)
DATEPART (Transact-SQL)
Поддержка параметров сортировки и Юникода