Funções de ordenação – COLLATIONPROPERTY (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse no Microsoft Fabric

Essa função retorna a propriedade solicitada de uma ordenação especificada.

Convenções de sintaxe de Transact-SQL

Sintaxe

COLLATIONPROPERTY( collation_name , property )  

Argumentos

collation_name
O nome da ordenação. O argumento collation_name tem um tipo de dados nvarchar (128) sem nenhum valor padrão.

property
A propriedade Collation. O argumento property tem um tipo de dados varchar (128) e pode ter qualquer um dos seguintes valores:

Nome da propriedade Descrição
CodePage Página de código de não Unicode da ordenação. É o conjunto de caracteres usado para dados varchar. Veja o Apêndice G: Tabelas de mapeamento do DBCS/Unicode e o Apêndice H: Páginas de código para converter esses valores e ver seus mapeamentos de caracteres.

Tipo de dados base: int
LCID ID de localidade do Windows da ordenação. É a cultura usada para regras de classificação e comparação. Veja a Estrutura de LCID para converter esses valores (você precisará converter varbinary primeiro).

Tipo de dados base: int
ComparisonStyle Estilo de comparação da ordenação do Windows. Retorna 0 para ordenações primárias – (_BIN) e (_BIN2) – bem como quando todas as propriedades são confidenciais – (_CS_AS_KS_WS) e (_CS_AS_KS_WS_SC) e (_CS_AS_KS_WS_VSS). Valores de bitmask:

Ignorar maiúsculas e minúsculas: 1

Ignorar acento: 2

Ignorar Kana: 65536

Ignorar largura: 131072

Observação: a opção _VSS (seletor sensível à variação) não é representada nesse valor, embora afete o comportamento da comparação.

Tipo de dados base: int
Versão A versão da ordenação. Retorna um valor entre 0 e 3.

Ordenações com "140" no nome retornam 3.

Ordenações com "100" no nome retornam 2.

Ordenações com "90" no nome retornam 1.

Todas as outras ordenações retornam 0.

Tipo de dados base: tinyint

Tipos de retorno

sql_variant

Exemplos

SELECT COLLATIONPROPERTY('Traditional_Spanish_CS_AS_KS_WS', 'CodePage');  

Veja a seguir o conjunto de resultados.

1252   

Azure Synapse Analytics e PDW (Analytics Platform System)

SELECT COLLATIONPROPERTY('Traditional_Spanish_CS_AS_KS_WS', 'CodePage')  

Veja a seguir o conjunto de resultados.

1252   

Confira também

sys.fn_helpcollations (Transact-SQL)
Suporte a ordenações e Unicode