CREATE PARTITION FUNCTION (Transact-SQL)

Actualizado: 17 de julio de 2006

Crea una función en la base de datos actual que asigna las filas de una tabla o un índice a particiones según los valores de una columna especificada. El uso de CREATE PARTITION FUNCTION constituye el primer paso para la creación de una tabla o un índice con particiones.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

• partition_function_name
  Es el nombre de la función de partición. Los nombres de las funciones de partición deben ser exclusivos en la base de datos y ajustarse a las reglas para los identificadores.

• input_parameter_type
  Es el tipo de datos de la columna utilizada para la partición. Todos los tipos de datos, excepto text, ntext, image, xml, timestamp, varchar(max), nvarchar(max), varbinary(max), los tipos de datos de alias o los tipos definidos por el usuario CLR, se pueden utilizar como columnas de partición.

  La columna en sí, conocida como columna de partición, se especifica en la instrucción CREATE TABLE o CREATE INDEX.

• boundary_value
  Especifica los valores de límite para cada partición de una tabla o un índice con particiones que utiliza partition_function_name. Si boundary_value está vacío, la función de partición asigna la tabla o el índice completos mediante partition_function_name a una sola partición. Sólo es posible utilizar una columna de partición, especificada en una instrucción CREATE TABLE o CREATE INDEX.

  boundary_value es una expresión constante que puede hacer referencia a variables. Éstas incluyen variables o funciones de tipo definido por el usuario y funciones definidas por el usuario. No puede hacer referencia a expresiones de Transact-SQL. boundary_value debe coincidir o debe poderse convertir implícitamente al tipo de datos suministrado en input_parameter_type, y no se puede truncar durante la conversión implícita de forma que el tamaño y la escala del valor no coincidan con los del tipo input_parameter_type correspondiente.

  [!NOTA] Si boundary_value está compuesto por los literales datetime o smalldatetime, éstos se evalúan suponiendo que el idioma de la sesión sea us_english. Este comportamiento se ha desaprobado. Para comprobar que la definición de la función de partición se comporta como se espera en todos los idiomas de la sesión, se recomienda utilizar constantes que se interpreten de la misma forma en todas las configuraciones de idioma, como el formato yyyymmdd; o convierta literales de forma explícita a un estilo específico. Para obtener más información, vea Escribir instrucciones Transact-SQL internacionales. Para determinar el idioma de la sesión del servidor, ejecute SELECT @@LANGUAGE.

• ...n
  Especifica el número de valores proporcionado por boundary_value, que no debe superar los 999. El número de particiones creadas es igual a n + 1. Los valores no tienen que presentarse en orden. Si los valores no están en orden, el SQL Server 2005 Database Engine (Motor de base de datos de SQL Server 2005) de Microsoft los ordena, crea la función y muestra una advertencia de que los valores proporcionados no estaban en orden. Si n incluye valores duplicados, el motor de base de datos devuelve un error.

• LEFT | RIGHT
  Especifica el lado de cada intervalo de valores de límite, derecho o izquierdo, al que pertenece boundary_value [ ,...n ], cuando Database Engine (Motor de base de datos) ordena los valores del intervalo en orden ascendente de izquierda a derecha. Si no se especifica, el valor predeterminado es LEFT. Para obtener más información, vea Ejemplos.

Notas

El ámbito de una función de partición está limitado a la base de datos en la que se crea. En la base de datos, las funciones de partición residen en un espacio de nombres independiente de las otras funciones.

Las filas cuya columna de partición tenga valores NULL se colocan en la partición situada más a la izquierda, a menos que se especifique NULL como un valor de límite y se indique RIGHT. En este caso, la partición situada más a la izquierda es una partición vacía y los valores NULL se colocan en la siguiente.

Permisos

Para ejecutar CREATE PARTITION FUNCTION, se puede utilizar cualquiera de los siguientes permisos:

• Permiso ALTER ANY DATASPACE. Este permiso se concede a los miembros de la función fija de servidor sysadmin y a las funciones fijas de base de datos db_owner y db_ddladmin.
• Permiso CONTROL o ALTER en la base de datos en la que se está creando la función de partición.
• Permiso CONTROL SERVER o ALTER ANY DATABASE en el servidor de la base de datos en la que se está creando la función de partición.

Ejemplos

A. Crear una función de partición RANGE LEFT en una columna int

La siguiente función de partición realizará cuatro particiones en una tabla o un índice.

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

En la siguiente tabla se muestra cómo se crearían particiones en una tabla que utiliza esta función de partición en la columna de partición col1.

Partición	1	2	3	4
Valores	col1 <= 1	col1 > 1 AND col1 <= 100	col1 > 100 AND col1 <= 1000	col1 > 1000

B. Crear una función de partición RANGE RIGHT en una columna int

La siguiente función de partición utiliza los mismos valores para boundary_value [ ,...n ] que el ejemplo anterior, con la excepción de que especifica RANGE RIGHT.

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

En la siguiente tabla se muestra cómo se crearían particiones en una tabla que utiliza esta función de partición en la columna de partición col1.

Partición	1	2	3	4
Valores	col1 < 1	col1 >= 1 AND col1 < 100	col1 >= 100 AND col1 < 1000	col1 >= 1000

C. Crear una función de partición RANGE RIGHT en una columna datetime

La siguiente función de partición divide una tabla o un índice en 12 particiones, una para cada mes de un año natural de valores en una columna datetime.

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

En la siguiente tabla se muestra cómo se crearían particiones en una tabla o índice que utiliza esta función de partición en la columna de partición datecol.

Partición	1	2	...	11	12
Valores	datecol < February 1, 2003	datecol >= February 1, 2003 AND datecol < March 1, 2003		datecol >= November 1, 2003 AND col1 < December 1, 2003	col1 >= December 1, 2003

D. Crear una función de partición en una columna char

La siguiente función de partición realiza cuatro particiones en una tabla o un índice.

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

En la siguiente tabla se muestra cómo se crearían particiones en una tabla que utiliza esta función de partición en la columna de partición col1.

Partición	1	2	3	4
Valores	col1 < EX...	col1 >= EX AND col1 < RXE...	col1 >= RXE AND col1 < XR...	col1 >= XR

Vea también

Referencia

$PARTITION (Transact-SQL)
ALTER PARTITION FUNCTION (Transact-SQL)
DROP PARTITION FUNCTION (Transact-SQL)
CREATE PARTITION SCHEME (Transact-SQL)
CREATE TABLE (Transact-SQL)
CREATE INDEX (Transact-SQL)
ALTER INDEX (Transact-SQL)
EVENTDATA (Transact-SQL)
sys.partition_functions (Transact-SQL)
sys.partition_parameters (Transact-SQL)
sys.partition_range_values (Transact-SQL)
sys.partitions (Transact-SQL)
sys.tables (Transact-SQL)
sys.indexes (Transact-SQL)
sys.index_columns (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión	Historial
17 de julio de 2006	Contenido nuevo: Se ha agregado una nota en el argumento boundary_value para aclarar que los literales datetime o smalldatetime se evalúan suponiendo que el idioma de la sesión sea us_english. Se ha agregado el ejemplo C, en el que se muestra cómo crear una función de partición sobre una columna datetime.