CREATE PARTITION FUNCTION (Transact-SQL)

Sintaxe

CREATE PARTITION FUNCTION partition_function_name ( input_parameter_type )
AS RANGE [ LEFT | RIGHT ] 
FOR VALUES ( [ boundary_value [ ,...n ] ] ) 
[ ; ]

Argumentos

• partition_function_name
  É o nome da função de partição. Os nomes de funções de partição devem ser exclusivos no banco de dados e estar em conformidade com as regras para identificadores.

• input_parameter_type
  É o tipo de dados da coluna usada para particionamento. Todos os tipos de dados são válidos para uso como colunas de particionamento, com exceção de text, ntext, image, xml, timestamp, varchar(max), nvarchar(max), varbinary(max), tipos de dados de alias ou tipos de dados CLR definidos pelo usuário.

  A coluna real, conhecida como uma coluna de particionamento, é especificada na instrução CREATE TABLE ou CREATE INDEX.

• boundary_value
  Especifica os valores de limite para cada partição de uma tabela particionada ou índice que usa partition_function_name. Se boundary_value estiver vazio, a função de partição mapeará a tabela inteira ou o índice usando partition_function_name em uma única partição. É possível usar somente uma coluna de particionamento, especificada em uma instrução CREATE TABLE ou CREATE INDEX.

  boundary_value é uma expressão constante que pode fazer referência a variáveis. Isso inclui variáveis ou funções de tipo definido pelo usuário e funções definidas pelo usuário. Não pode fazer referência a expressões Transact-SQL. boundary_value deve corresponder ou ser implicitamente conversível no tipo de dados fornecido no input_parameter_type, e não pode ser truncado durante a conversão implícita de maneira que o tamanho e a escala do valor não correspondam ao de seu input_parameter_type correspondente.

  Observação

  Se boundary_value consistir em literais datetime ou smalldatetime, esses literais serão avaliados supondo que us_english é o idioma da sessão. Este comportamento é preterido. Para certificar-se de que a definição da função de partição se comporta conforme esperado para todos os idiomas de sessão, recomendamos usar constantes que sejam interpretadas da mesma maneira para todas as configurações de idioma, tal como o formato aaaammdd; ou converter explicitamente literais em um estilo específico. Para obter mais informações, consulte Gravando instruções Transact-SQL internacionais. Para determinar a sessão de idioma de seu servidor, execute SELECT @@LANGUAGE.

• ...n
  Especifica o número de valores fornecidos por boundary_value, que não deve exceder 999. O número de partições criadas é igual a n + 1. Os valores não precisam ser listados em ordem. Se os valores não estiverem em ordem, o Mecanismo de Banco de Dados os classifica, cria a função e retorna um aviso de que os valores não foram fornecidos em ordem. O Mecanismo de Banco de Dados retornará um erro se n incluir qualquer valor duplicado.

• LEFT | RIGHT
  Especifica a qual lado de cada intervalo de valor de limite, esquerdo ou direito, o boundary_value [ ,...n ] pertence, quando valores de intervalo forem classificados pelo Mecanismo de Banco de Dados em ordem crescente da esquerda para a direita. Se não for especificado, LEFT é o padrão. Para obter mais informações, consulte Exemplos.

Comentários

O escopo de uma função de partição está limitado ao banco de dados no qual ele for criado. No banco de dados, as funções de partição residem em um namespace separado das outras funções.

Quaisquer linhas cuja coluna de particionamento tenha valores nulos serão colocadas na partição mais à esquerda, a menos que NULL seja especificado como um valor de limite e RIGHT seja indicado. Nesse caso, a partição mais à esquerda será uma partição vazia e os valores NULL serão colocados na partição seguinte.

Permissões

Qualquer uma das permissões a seguir pode ser usada para executar CREATE PARTITION FUNCTION:

• Permissão ALTER ANY DATASPACE. Essa permissão tem como padrão os membros da função de servidor fixa sysadmin e das funções de banco de dados fixas db_owner e db_ddladmin.

• Permissão CONTROL ou ALTER no banco de dados no qual a função de partição está sendo criada.

• Permissão CONTROL SERVER ou ALTER ANY DATABASE no servidor do banco de dados no qual a função de partição está sendo criada.

Exemplos

A. Criando uma função de partição RANGE LEFT em uma coluna int

CREATE PARTITION FUNCTION myRangePF1 (int)
AS RANGE LEFT FOR VALUES (1, 100, 1000);

B. Criando uma função de partição RANGE RIGHT em uma coluna int

CREATE PARTITION FUNCTION myRangePF2 (int)
AS RANGE RIGHT FOR VALUES (1, 100, 1000);

C. Criando uma função de partição RANGE RIGHT em uma coluna datetime

CREATE PARTITION FUNCTION [myDateRangePF1] (datetime)
AS RANGE RIGHT FOR VALUES ('20030201', '20030301', '20030401',
               '20030501', '20030601', '20030701', '20030801', 
               '20030901', '20031001', '20031101', '20031201');

D. Criando uma função de partição em uma coluna char

CREATE PARTITION FUNCTION myRangePF3 (char(20))
AS RANGE RIGHT FOR VALUES ('EX', 'RXE', 'XR');

Consulte também

Referência