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

Применимо к: SQL Server Azure SQL DatabaseУправляемый экземпляр SQL AzureAzure Synapse Analytics AnalyticsPlatform 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 и text замените элементами с типами данных nchar, nvarchar и nvarchar(max). При использовании параметров сортировки с поддержкой дополнительных символов данные кодируются с помощью UTF-16. Использование параметров сортировки, не поддерживающих дополнительные символы, приводит к кодированию данных с использованием UCS-2. Это позволяет избежать проблемы преобразования кодовых страниц. Дополнительные сведения см. в статье Collation and Unicode Support.

    Важно!

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

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

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

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

      { ts'yyyy-mm-ddhh: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 с явным параметром стиля для всех преобразований между типами данных time, date, date, smalldate, datetime, datetime2 и datetimeoffset и типами данных символьной строки. Например, следующая инструкция интерпретируется одинаково для любых настроек языка и формата даты в соединении:

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

См. также раздел

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