COLLATE (Transact-SQL)

Мақала
05/23/2023

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure хранилище платформы Аналитики Azure Synapse Analytics (PDW) в Microsoft Fabric

Определяет параметры сортировки базы данных или столбца таблицы либо операцию приведения параметров сортировки при использовании с выражением строки символов. Именем параметров сортировки может быть либо имя параметров сортировки Windows, либо имя параметров сортировки SQL. Если база данных не указана во время создания базы данных, она назначается параметры сортировки по умолчанию экземпляра SQL Server. Если не указывать его при создании столбца таблицы, столбцу назначаются параметры сортировки по умолчанию для базы данных.

Соглашения о синтаксисе Transact-SQL

Синтаксис

COLLATE { <collation_name> | database_default }
<collation_name> :: =
    { Windows_collation_name } | { SQL_collation_name }

Аргументы

collation_name — имена параметров сортировки, применяемых к выражению, определению столбца или определению базы данных. Аргументом collation_name может быть только заданное имя Windows_collation_name или SQL_collation_name. Аргумент collation_name должен быть литеральным значением. Имя collation_name не может быть представлено переменной или выражением.

Аргумент Windows_collation_name является именем параметров сортировки для Windows Collation Name.

Аргумент SQL_collation_name является именем параметров сортировки для SQL Server Collation Name.

Примечание.

В Microsoft Fabric разрешено только параметры сортировки: Latin1_General_100_BIN2_UTF8.

database_default — заставляет предложение COLLATE наследовать параметры сортировки текущей базы данных.

Замечания

Предложение COLLATE можно указывать на нескольких уровнях. следующие основные параметры.

Создание или изменение базы данных.

Предложение COLLATE можно использовать в инструкциях CREATE DATABASE и ALTER DATABASE для указания параметров сортировки по умолчанию для базы данных. Можно также указать параметры сортировки при создании базы данных с помощью SQL Server Management Studio. Если параметры сортировки не указаны, база данных назначается параметры сортировки по умолчанию экземпляра SQL Server.

Примечание.

Параметры сортировки Windows в Юникоде могут использоваться с предложением COLLATE только для типов данных nchar, nvarchar, and ntext на уровне столбцов и на уровне выражений. Ими нельзя пользоваться в предложении COLLATE для задания и изменения параметров сортировки базы данных или экземпляра сервера.
Создание или изменение столбца таблицы.

Параметры сортировки можно указать для каждого столбца строки символов с помощью предложения COLLATE в инструкциях CREATE TABLE и ALTER TABLE. При создании таблицы с помощью SQL Server Management Studio можно также указать параметры сортировки. Если не указывать параметры сортировки, столбцу присваиваются параметры сортировки по умолчанию для базы данных.

Кроме того, в предложении COLLATE можно использовать параметр database_default для указания того, что столбец во временной таблице должен использовать параметры сортировки текущей пользовательской базы данных, заданные по умолчанию для соединения, а не параметры сортировки базы данных tempdb.
Приведение параметров сортировки выражения.

Предложение COLLATE можно использовать для применения символьного выражения к определенным параметрам сортировки. Символьным литералам и переменным присваиваются параметры сортировки по умолчанию для текущей базы данных. Ссылкам столбцов присваивается определение параметров сортировки для столбца.

Параметры сортировки идентификатора зависят от уровня, для которого определен этот идентификатор. К идентификаторам объектов на уровне экземпляров, таких как имена входа и имена базы данных, применяются параметры сортировки по умолчанию для экземпляра. К идентификаторам объектов внутри базы данных, таких как таблицы, представления и имена столбцов, применяются параметры сортировки, используемые по умолчанию для базы данных. Например: две таблицы, имена которых отличаются только регистром, можно создать в базе данных с параметрами сортировки, учитывающими регистр букв, но нельзя создать в базе данных с параметрами сортировки без учета регистра. Дополнительные сведения см. в разделе Идентификаторы баз данных.

Переменные, метки GOTO, временные хранимые процедуры и временные таблицы можно создавать, если контекст соединения связан с одной базой данных, и ссылка на которую сохраняется, когда контекст переключается на другую базу данных. Идентификаторы переменных, меток GOTO, временных хранимых процедур и временных таблиц имеют параметры сортировки по умолчанию для экземпляра сервера.

Предложение COLLATE можно применять только к типам данных char, varchar, text, nchar, nvarchar и ntext.

COLLATE использует аргумент collate_name для ссылки на имя параметров сортировки SQL Server или Windows, которые применяются к выражению, определению столбца или определению базы данных. collation_name может быть только указанным Windows_collation_name или SQL_collation_name, и параметр должен содержать литеральное значение. Имя collation_name не может быть представлено переменной или выражением.

Параметры сортировки обычно определяются по имени, за исключением программы установки. В программе установки вместо имени указывается обозначение базовых параметров сортировки (языковой стандарт параметров сортировки) для параметров сортировки Windows, а затем определяются настройки сортировки с учетом или без учета регистра или диакритических знаков.

Чтобы получить список всех допустимых имен параметров сортировки для Windows и SQL Server, можно выполнить системную функцию fn_helpcollations:

SELECT name, description
FROM fn_helpcollations();

SQL Server может поддерживать только кодовую страницу, поддерживаемую базовой операционной системой. При выполнении действия, зависящее от параметров сортировки, параметры сортировки SQL Server, используемые ссылочным объектом, должны использовать кодовую страницу, поддерживаемую операционной системой, работающей на компьютере. Эти операции могут включать:

указание параметров сортировки по умолчанию для базы данных при ее создании или изменении;
указание параметров сортировки для столбца при создании или изменении таблицы;
при восстановлении или присоединении базы данных параметры сортировки по умолчанию и параметры сортировки всех столбцов типа char, varchar и text или параметров базы данных должны поддерживаться операционной системой.

Примечание.

Преобразование кодовых страниц поддерживается для типов данных char и varchar, однако поддержка типа данных text не предусмотрена. Сообщения о потере данных во время преобразования кодовых страниц не выводятся.

Если указанный параметр сортировки или параметры сортировки, используемые объектом, на который ссылается ссылка, использует кодовую страницу, не поддерживаемую Windows, SQL Server отображает ошибку.

Примеры

А. Указание параметров сортировки во время SELECT

В следующем примере создается простая таблица, а затем вставляются четыре строки. Затем в примере применяются два параметра сортировки при выборе данных из таблицы, при этом демонстрируется, что Chiapas сортируется по-разному.

CREATE TABLE Locations
(Place varchar(15) NOT NULL);
GO
INSERT Locations(Place) VALUES ('Chiapas'),('Colima')
                             , ('Cinco Rios'), ('California');
GO
--Apply an typical collation
SELECT Place FROM Locations
ORDER BY Place
COLLATE Latin1_General_CS_AS_KS_WS ASC;
GO
-- Apply a Spanish collation
SELECT Place FROM Locations
ORDER BY Place
COLLATE Traditional_Spanish_ci_ai ASC;
GO

Ниже приведены результаты первого запроса.

Place
-------------
California
Chiapas
Cinco Rios
Colima

Ниже приведены результаты второго запроса.

Place
-------------
California
Cinco Rios
Colima
Chiapas

B. Дополнительные примеры

Дополнительные примеры, в которых используется COLLATE, приведены в разделе Ж. Создание базы данных и назначение имени и параметров сортировки статьи CREATE DATABASE и в разделе Ф. Изменение параметров сортировки столбца статьи ALTER TABLE.

Бөлісу құралы: