CREATE TABLE (Transact-SQL)

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance

Crea una nueva tabla en SQL Server y Azure SQL Database.

Convenciones de sintaxis de Transact-SQL

Opciones de sintaxis

Sintaxis común

Sintaxis SIMPLE CREATE TABLE (común si no usa opciones):

CREATE TABLE
    { database_name.schema_name.table_name | schema_name.table_name | table_name }
    ( { <column_definition> } [ ,... n ] )
[ ; ]

Sintaxis completa

Sintaxis CREATE TABLE basada en disco:

CREATE TABLE
    { database_name.schema_name.table_name | schema_name.table_name | table_name }
    [ AS FileTable ]
    ( { <column_definition>
        | <computed_column_definition>
        | <column_set_definition>
        | [ <table_constraint> ] [ ,... n ]
        | [ <table_index> ] }
          [ ,... n ]
          [ PERIOD FOR SYSTEM_TIME ( system_start_time_column_name
             , system_end_time_column_name ) ]
      )
    [ ON { partition_scheme_name ( partition_column_name )
           | filegroup
           | "default" } ]
    [ TEXTIMAGE_ON { filegroup | "default" } ]
    [ FILESTREAM_ON { partition_scheme_name
           | filegroup
           | "default" } ]
    [ WITH ( <table_option> [ ,... n ] ) ]
[ ; ]

<column_definition> ::=
column_name <data_type>
    [ FILESTREAM ]
    [ COLLATE collation_name ]
    [ SPARSE ]
    [ MASKED WITH ( FUNCTION = 'mask_function' ) ]
    [ [ CONSTRAINT constraint_name ] DEFAULT constant_expression ]
    [ IDENTITY [ ( seed , increment ) ]
    [ NOT FOR REPLICATION ]
    [ GENERATED ALWAYS AS { ROW | TRANSACTION_ID | SEQUENCE_NUMBER } { START | END } [ HIDDEN ] ]
    [ [ CONSTRAINT constraint_name ] {NULL | NOT NULL} ]
    [ ROWGUIDCOL ]
    [ ENCRYPTED WITH
        ( COLUMN_ENCRYPTION_KEY = key_name ,
          ENCRYPTION_TYPE = { DETERMINISTIC | RANDOMIZED } ,
          ALGORITHM = 'AEAD_AES_256_CBC_HMAC_SHA_256'
        ) ]
    [ <column_constraint> [ ,... n ] ]
    [ <column_index> ]

<data_type> ::=
[ type_schema_name. ] type_name
    [ ( precision [ , scale ] | max |
        [ { CONTENT | DOCUMENT } ] xml_schema_collection ) ]

<column_constraint> ::=
[ CONSTRAINT constraint_name ]
{
   { PRIMARY KEY | UNIQUE }
        [ CLUSTERED | NONCLUSTERED ]
        [ ( <column_name> [ ,... n ] ) ]
        [
            WITH FILLFACTOR = fillfactor
          | WITH ( <index_option> [ ,... n ] )
        ]
        [ ON { partition_scheme_name ( partition_column_name )
            | filegroup | "default" } ]

  | [ FOREIGN KEY ]
        REFERENCES [ schema_name. ] referenced_table_name [ ( ref_column ) ]
        [ ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ]
        [ ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ]
        [ NOT FOR REPLICATION ]

  | CHECK [ NOT FOR REPLICATION ] ( logical_expression )
}

<column_index> ::=
 INDEX index_name [ CLUSTERED | NONCLUSTERED ]
    [ WITH ( <index_option> [ ,... n ] ) ]
    [ ON { partition_scheme_name ( column_name )
         | filegroup_name
         | default
         }
    ]
    [ FILESTREAM_ON { filestream_filegroup_name | partition_scheme_name | "NULL" } ]

<computed_column_definition> ::=
column_name AS computed_column_expression
[ PERSISTED [ NOT NULL ] ]
[
    [ CONSTRAINT constraint_name ]
    { PRIMARY KEY | UNIQUE }
        [ CLUSTERED | NONCLUSTERED ]
        [
            WITH FILLFACTOR = fillfactor
          | WITH ( <index_option> [ ,... n ] )
        ]
        [ ON { partition_scheme_name ( partition_column_name )
        | filegroup | "default" } ]

    | [ FOREIGN KEY ]
        REFERENCES referenced_table_name [ ( ref_column ) ]
        [ ON DELETE { NO ACTION | CASCADE } ]
        [ ON UPDATE { NO ACTION } ]
        [ NOT FOR REPLICATION ]

    | CHECK [ NOT FOR REPLICATION ] ( logical_expression )
]

<column_set_definition> ::=
column_set_name XML COLUMN_SET FOR ALL_SPARSE_COLUMNS

<table_constraint> ::=
[ CONSTRAINT constraint_name ]
{
    { PRIMARY KEY | UNIQUE }
        [ CLUSTERED | NONCLUSTERED ]
        ( column_name [ ASC | DESC ] [ ,... n ] )
        [
            WITH FILLFACTOR = fillfactor
           | WITH ( <index_option> [ ,... n ] )
        ]
        [ ON { partition_scheme_name (partition_column_name)
            | filegroup | "default" } ]
    | FOREIGN KEY
        ( column_name [ ,... n ] )
        REFERENCES referenced_table_name [ ( ref_column [ ,... n ] ) ]
        [ ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ]
        [ ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT } ]
        [ NOT FOR REPLICATION ]
    | CHECK [ NOT FOR REPLICATION ] ( logical_expression )
}

<table_index> ::=
{
    {
      INDEX index_name [ UNIQUE ] [ CLUSTERED | NONCLUSTERED ]
         ( column_name [ ASC | DESC ] [ ,... n ] )
    | INDEX index_name CLUSTERED COLUMNSTORE [ ORDER (column_name [ , ...n ] ) ]
    | INDEX index_name [ NONCLUSTERED ] COLUMNSTORE ( column_name [ ,... n ] )
    }
    [ INCLUDE ( column_name [ ,... n ] ) ]
    [ WHERE <filter_predicate> ]
    [ WITH ( <index_option> [ ,... n ] ) ]
    [ ON { partition_scheme_name ( column_name )
         | filegroup_name
         | default
         }
    ]
    [ FILESTREAM_ON { filestream_filegroup_name | partition_scheme_name | "NULL" } ]
}

<table_option> ::=
{
    [ DATA_COMPRESSION = { NONE | ROW | PAGE }
      [ ON PARTITIONS ( { <partition_number_expression> | <range> }
      [ ,... n ] ) ] ]
    [ XML_COMPRESSION = { ON | OFF }
      [ ON PARTITIONS ( { <partition_number_expression> | <range> }
      [ ,... n ] ) ] ]
    [ FILETABLE_DIRECTORY = <directory_name> ]
    [ FILETABLE_COLLATE_FILENAME = { <collation_name> | database_default } ]
    [ FILETABLE_PRIMARY_KEY_CONSTRAINT_NAME = <constraint_name> ]
    [ FILETABLE_STREAMID_UNIQUE_CONSTRAINT_NAME = <constraint_name> ]
    [ FILETABLE_FULLPATH_UNIQUE_CONSTRAINT_NAME = <constraint_name> ]
    [ SYSTEM_VERSIONING = ON
        [ ( HISTORY_TABLE = schema_name.history_table_name
          [ , DATA_CONSISTENCY_CHECK = { ON | OFF } ]
    ) ]
    ]
    [ REMOTE_DATA_ARCHIVE =
      {
        ON [ ( <table_stretch_options> [ ,... n] ) ]
        | OFF ( MIGRATION_STATE = PAUSED )
      }
    ]
    [ DATA_DELETION = ON
          { (
             FILTER_COLUMN = column_name,
             RETENTION_PERIOD = { INFINITE | number { DAY | DAYS | WEEK | WEEKS
                              | MONTH | MONTHS | YEAR | YEARS }
        ) }
    ]
    [ LEDGER = ON [ ( <ledger_option> [ ,... n ] ) ]
    | OFF
    ]
}

<ledger_option>::=
{
    [ LEDGER_VIEW = schema_name.ledger_view_name [ ( <ledger_view_option> [ ,... n ] ) ] ]
    [ APPEND_ONLY = ON | OFF ]
}

<ledger_view_option>::=
{
    [ TRANSACTION_ID_COLUMN_NAME = transaction_id_column_name ]
    [ SEQUENCE_NUMBER_COLUMN_NAME = sequence_number_column_name ]
    [ OPERATION_TYPE_COLUMN_NAME = operation_type_id column_name ]
    [ OPERATION_TYPE_DESC_COLUMN_NAME = operation_type_desc_column_name ]
}

<table_stretch_options> ::=
{
    [ FILTER_PREDICATE = { NULL | table_predicate_function } , ]
      MIGRATION_STATE = { OUTBOUND | INBOUND | PAUSED }
 }

<index_option> ::=
{
    PAD_INDEX = { ON | OFF }
  | FILLFACTOR = fillfactor
  | IGNORE_DUP_KEY = { ON | OFF }
  | STATISTICS_NORECOMPUTE = { ON | OFF }
  | STATISTICS_INCREMENTAL = { ON | OFF }
  | ALLOW_ROW_LOCKS = { ON | OFF }
  | ALLOW_PAGE_LOCKS = { ON | OFF }
  | OPTIMIZE_FOR_SEQUENTIAL_KEY = { ON | OFF }
  | COMPRESSION_DELAY = { 0 | delay [ Minutes ] }
  | DATA_COMPRESSION = { NONE | ROW | PAGE | COLUMNSTORE | COLUMNSTORE_ARCHIVE }
       [ ON PARTITIONS ( { partition_number_expression | <range> }
       [ ,... n ] ) ]
  | XML_COMPRESSION = { ON | OFF }
      [ ON PARTITIONS ( { <partition_number_expression> | <range> }
      [ ,... n ] ) ]
}

<range> ::=
<partition_number_expression> TO <partition_number_expression>

Sintaxis para las tablas optimizadas para memoria

Sintaxis CREATE TABLE optimizada para memoria:

CREATE TABLE
    { database_name.schema_name.table_name | schema_name.table_name | table_name }
    ( { <column_definition>
    | [ <table_constraint> ] [ ,... n ]
    | [ <table_index> ]
      [ ,... n ] }
      [ PERIOD FOR SYSTEM_TIME ( system_start_time_column_name
        , system_end_time_column_name ) ]
)
    [ WITH ( <table_option> [ ,... n ] ) ]
 [ ; ]

<column_definition> ::=
column_name <data_type>
    [ COLLATE collation_name ]
    [ GENERATED ALWAYS AS ROW { START | END } [ HIDDEN ] ]
    [ NULL | NOT NULL ]
    [ [ CONSTRAINT constraint_name ] DEFAULT memory_optimized_constant_expression ]
    | [ IDENTITY [ ( 1, 1 ) ] ]
    [ <column_constraint> ]
    [ <column_index> ]

<data_type> ::=
 [type_schema_name. ] type_name [ (precision [ , scale ]) ]

<column_constraint> ::=
 [ CONSTRAINT constraint_name ]
{
  { PRIMARY KEY | UNIQUE }
      { NONCLUSTERED
        | NONCLUSTERED HASH WITH ( BUCKET_COUNT = bucket_count )
      }
  [ ( <column_name> [ ,... n ] ) ]
  | [ FOREIGN KEY ]
        REFERENCES [ schema_name. ] referenced_table_name [ ( ref_column ) ]
  | CHECK ( logical_expression )
}

<table_constraint> ::=
 [ CONSTRAINT constraint_name ]
{
   { PRIMARY KEY | UNIQUE }
     {
       NONCLUSTERED ( column_name [ ASC | DESC ] [ ,... n ])
       | NONCLUSTERED HASH ( column_name [ ,... n ] ) WITH ( BUCKET_COUNT = bucket_count )
                    }
    | FOREIGN KEY
        ( column_name [ ,... n ] )
        REFERENCES referenced_table_name [ ( ref_column [ ,... n ] ) ]
    | CHECK ( logical_expression )
}

<column_index> ::=
  INDEX index_name
{ [ NONCLUSTERED ] | [ NONCLUSTERED ] HASH WITH ( BUCKET_COUNT = bucket_count ) }

<table_index> ::=
  INDEX index_name
{   [ NONCLUSTERED ] HASH ( column_name [ ,... n ] ) WITH ( BUCKET_COUNT = bucket_count )
  | [ NONCLUSTERED ] ( column_name [ ASC | DESC ] [ ,... n ] )
      [ ON filegroup_name | default ]
  | CLUSTERED COLUMNSTORE [ WITH ( COMPRESSION_DELAY = { 0 | delay [ Minutes ] } ) ]
      [ ON filegroup_name | default ]

}

<table_option> ::=
{
    MEMORY_OPTIMIZED = ON
  | DURABILITY = { SCHEMA_ONLY | SCHEMA_AND_DATA }
  | SYSTEM_VERSIONING = ON [ ( HISTORY_TABLE = schema_name.history_table_name
        [, DATA_CONSISTENCY_CHECK = { ON | OFF } ] ) ]

}

Argumentos

database_name

El nombre de la base de datos en la que se crea la tabla. database_name debe especificar el nombre de una base de datos existente. Si no se especifica, database_name usa de manera predeterminada la base de datos actual. El inicio de sesión de la conexión actual debe estar asociado a un identificador de usuario existente en la base de datos especificada por database_name, y ese identificador de usuario debe tener permisos CREATE TABLE.

schema_name

El nombre del esquema al que pertenece la nueva tabla.

table_name

Nombre de la nueva tabla. Los nombres de las tablas deben seguir las reglas de los identificadores. table_name puede contener un máximo de 128 caracteres, excepto para los nombres de tablas temporales locales (nombres precedidos de un único signo de número (#)) que no puede superar los 116 caracteres.

AS FileTable

Válido para : SQL Server 2012 (11.x) y versiones posteriores.

Crea la nueva tabla como un objeto FileTable. No es necesario especificar columnas porque un objeto FileTable tiene un esquema fijo. Para obtener más información, vea FileTables.

column_name AS computed_column_expression

Una expresión que define el valor de una columna calculada. Una columna calculada es una columna virtual que no está almacenada físicamente en la tabla, a menos que la columna esté marcada con PERSISTED. La columna se calcula a partir de una expresión que utiliza otras columnas de la misma tabla. Por ejemplo, una columna calculada puede tener la definición:cost AS price * qty. La expresión puede ser un nombre de columna no calculada, una constante, una función, una variable o cualquier combinación de estos elementos conectados mediante uno o más operadores. La expresión no puede ser una subconsulta ni contener tipos de datos de alias.

Las columnas calculadas se pueden usar en listas de selección, cláusulas WHERE, cláusulas ORDER BY u otras ubicaciones en que se puedan emplear expresiones regulares, con las siguientes excepciones:

• Las columnas calculadas deben marcarse como PERSISTED para que puedan participar en restricciones FOREIGN KEY o CHECK.

• Es posible usar una columna calculada como columna de clave en un índice o como parte de una restricción PRIMARY KEY o UNIQUE, si el valor de la columna calculada se define mediante una expresión determinista y el tipo de datos del resultado está permitido en columnas de índice.

  Por ejemplo, si la tabla contiene las columnas de enteros a y b, la columna calculada a + b puede estar indizada, pero la columna calculada a + DATEPART(dd, GETDATE()) no puede indizarse porque el valor puede cambiar en las siguientes invocaciones.

• Una columna calculada no puede ser el destino de una instrucción INSERT o UPDATE.

En función de las expresiones utilizadas, la nulabilidad de las columnas calculadas la determina automáticamente el Motor de base de datos. Se considera que el resultado de la mayoría de las expresiones admite valores NULL incluso si únicamente están presentes columnas que no admiten valores NULL, ya que los posibles subdesbordamientos o desbordamientos también dan como resultado valores NULL. Use la función COLUMNPROPERTY con la propiedad AllowsNull para determinar la nulabilidad de las columnas calculadas de la tabla. Una expresión que admita valores NULL se puede convertir en una expresión que no los admita especificando ISNULL con la constante check_expression, donde la constante es un valor distinto de NULL que se sustituye por cualquier resultado NULL. Requiere el permiso REFERENCES sobre el tipo para las columnas calculadas basadas en expresiones de tipo definido por el usuario de Common Language Runtime (CLR).

PERSISTED

Especifica que Motor de base de datos de SQL Server almacena físicamente los valores calculados en la tabla y actualiza los valores cuando se actualizan las columnas de las que depende la columna calculada. El hecho de marcar la columna calculada como PERSISTED le permite crear un índice en una columna calculada que es determinista, pero no precisa. Para obtener más información, vea Indexes on Computed Columns. Las columnas calculadas que se utilizan como columnas de partición en una tabla con particiones deben establecerse explícitamente en PERSISTED. computed_column_expression debe ser determinista cuando se especifique PERSISTED.

ON { partition_scheme | filegroup | "default" }

Especifica el esquema de partición o el grupo de archivos en que se almacena la tabla. Si se especifica partition_scheme, la tabla será una tabla con particiones cuyas particiones se almacenan en un conjunto de uno o más grupos de archivos especificados en partition_scheme. Si se especifica filegroup, la tabla se almacena en el grupo de archivos con nombre. El grupo de archivos debe existir en la base de datos. Si se especifica "default" o si ON no se especifica en ninguna parte, la tabla se almacena en el grupo de archivos predeterminado. El mecanismo de almacenamiento de una tabla según se especifica en CREATE TABLE no se puede modificar posteriormente.

ON {partition_scheme | filegroup"default" } se puede especificar también en una restricción PRIMARY KEY o UNIQUE. Estas restricciones crean índices. Si se especifica filegroup, el índice se almacena en el grupo de archivos con nombre. Si se especifica "default" o si ON no se especifica en ninguna parte, el índice se almacena en el mismo grupo de archivos que la tabla. Si la restricción PRIMARY KEY o UNIQUE crea un índice clúster, las páginas de datos de la tabla se almacenan en el mismo grupo de archivos que el índice. Si se especifica CLUSTERED o la restricción crea un índice clúster, y se especifica un elemento partition_scheme distinto del partition_scheme o filegroup de la definición de tabla, o viceversa, únicamente se respeta la definición de restricción y se omite el resto.

TEXTIMAGE_ON { filegroup | "default" }

Indica que las columnas text, ntext, image, xml, varchar(max), nvarchar(max), varbinary(max) y de tipo definido por el usuario CLR (incluidos los tipos geometry y geography) se almacenan en el grupo de archivos especificado.

No se permite TEXTIMAGE_ON si no hay columnas de valores grandes en la tabla. No se puede especificar TEXTIMAGE_ON si se especifica partition_scheme. Si se especifica "default" o si TEXTIMAGE_ON no se especifica en ninguna parte, las columnas de valores grandes se almacenan en el grupo de archivos predeterminado. El almacenamiento de los datos de columna de valores grandes especificados en CREATE TABLE no se puede modificar posteriormente.

FILESTREAM_ON { partition_scheme_name | filegroup | "default" }

Se aplica a:: SQL Server 2008 R2 (10.50.x) y versiones posteriores. Azure SQL Database y Azure SQL Managed Instance no son compatibles con FILESTREAM.

Especifica el grupo de archivos para los datos FILESTREAM.

Si la tabla contiene datos FILESTREAM y se crean particiones de la tabla, debe incluirse la cláusula FILESTREAM_ON y debe especificarse un esquema de partición de grupos de archivos FILESTREAM. Este esquema de partición debe utilizar la misma función de partición y las mismas columnas de partición que el esquema de partición para la tabla; de lo contrario, se produce un error.

Si la tabla no tiene particiones, no se pueden crear particiones en la columna FILESTREAM. Los datos FILESTREAM para la tabla deben almacenarse en un grupo de archivos único. Este grupo de archivos se especifica en la cláusula FILESTREAM_ON.

Si la tabla no tiene particiones y no se especifica la cláusula FILESTREAM_ON, se utiliza el grupo de archivos FILESTREAM que tenga la propiedad DEFAULT establecida. Si no hay ningún grupo de archivos FILESTREAM, se produce un error.

Al igual que con ON y TEXTIMAGE_ON, el valor establecido utilizando CREATE TABLE para FILESTREAM_ON no se puede cambiar, excepto en los casos siguientes:

• Una instrucción CREATE INDEX convierte un montón en un índice agrupado. En este caso, se puede especificar un grupo de archivos FILESTREAM diferente, un esquema de partición o NULL.
• Una instrucción DROP INDEX convierte un índice agrupado en un montón. En este caso, se puede especificar otro grupo de archivos FILESTREAM, otro esquema de partición o "default" .

El grupo de archivos en la cláusula FILESTREAM_ON <filegroup>, o cada grupo de archivos FILESTREAM que se mencione en el esquema de partición, debe tener un archivo definido para el grupo de archivos. Este archivo se debe definir mediante una instrucción CREATE DATABASE o ALTER DATABASE; en caso contrario, se produce un error.

Si quiere consultar artículos sobre FILESTREAM relacionados, vea Datos de objeto binario grande (Blob) (SQL Server).

[ type_schema_name. ] type_name

Especifica el tipo de datos de la columna y el esquema al que pertenece. Para las tablas basadas en disco, use uno de los siguientes tipos de datos:

• Un tipo de datos del sistema
• Un tipo de alias basado en un tipo de datos del sistema de SQL Server. Los tipos de datos de alias se crean con la instrucción CREATE TYPE antes de que puedan utilizarse en una definición de tabla. La asignación NULL o NOT NULL de un tipo de datos de alias puede invalidarse durante la instrucción CREATE TABLE. No obstante, la especificación de longitud no se puede cambiar; la longitud del tipo de datos de alias no se puede especificar en una instrucción CREATE TABLE.
• Un tipo definido por el usuario CLR. Los tipos definidos por el usuario CLR se crean con la instrucción CREATE TYPE para poder utilizarlos en una definición de tabla. Para crear una columna en un tipo definido por el usuario CLR, se necesita el permiso REFERENCES para el tipo.

Si no se especifica type_schema_name, Motor de base de datos de SQL Server hace referencia a type_name en este orden:

• El tipo de datos del sistema de SQL Server.
• El esquema predeterminado del usuario actual en la base de datos actual.
• El esquema dbo en la base de datos actual.

Para las tablas optimizadas para memoria, vea Tipos de datos admitidos para OLTP en memoria para obtener una lista de tipos del sistema admitidos.

• precisión

  La precisión del tipo de datos especificado. Para más información sobre los valores de precisión válidos, vea Precisión, escala y longitud.

• scale

  La escala del tipo de datos especificado. Para más información sobre los valores de escala válidos, vea Precisión, escala y longitud.

• max

  Solo se aplica a los tipos de datos varchar, nvarchar y varbinary para el almacenamiento de 2^31 bytes de caracteres y datos binarios, y 2^30 bytes de datos Unicode.

CONTENT

Especifica que cada instancia del tipo de datos xml en column_name puede incluir varios elementos de nivel superior. CONTENT se aplica solamente al tipo de datos xml y únicamente se puede especificar si también se especifica xml_schema_collection. Si no se especifica, CONTENT es el comportamiento predeterminado.

DOCUMENT

Especifica que cada instancia del tipo de datos xml en column_name puede incluir un solo elemento de nivel superior. DOCUMENT se aplica solamente al tipo de datos xml y únicamente se puede especificar si también se especifica xml_schema_collection.

xml_schema_collection

Solo se aplica al tipo de datos xml para asociar una colección de esquemas XML al tipo. Antes de escribir una columna xml para un esquema, primero debe crear el esquema en la base de datos mediante CREATE XML SCHEMA COLLECTION.

DEFAULT

Especifica el valor suministrado para la columna cuando no se ha especificado explícitamente un valor durante una inserción. Las definiciones DEFAULT se pueden aplicar a cualquier columna, excepto las definidas como timestamp o aquellas que tengan la propiedad IDENTITY. Si se especifica un valor predeterminado para una columna de un tipo definido por el usuario, dicho tipo debe admitir la conversión implícita de constant_expression al tipo definido por el usuario. Las definiciones DEFAULT desaparecen cuando se quita la tabla. Como valor predeterminado solo se puede utilizar un valor constante, por ejemplo una cadena de caracteres, una función escalar (función del sistema, definida por el usuario o CLR) o NULL. Para mantener la compatibilidad con las versiones anteriores de SQL Server, se puede asignar un nombre de restricción a DEFAULT.

• constant_expression

  Una constante, NULL o una función del sistema que se utiliza como valor predeterminado de una columna.

• memory_optimized_constant_expression

  Una constante, NULL o una función del sistema que se admite como valor predeterminado de una columna. Debe admitirse en los procedimientos almacenados compilados de forma nativa. Para más información sobre las funciones integradas en procedimientos almacenados compilados de forma nativa, vea Características admitidas en los módulos T-SQL compilados de forma nativa.

IDENTITY

Indica que la nueva columna es una columna de identidad. Cuando se agrega una fila nueva a la tabla, el Motor de base de datos proporciona un valor incremental único para la columna. Las columnas de identidad se utilizan normalmente con las restricciones PRIMARY KEY como identificadores de fila únicos de la tabla. La propiedad IDENTITY se puede asignar a columnas tinyint, smallint, int, bigint, decimal(p, 0) o numeric(p, 0). Solo se puede crear una columna de identidad para cada tabla. Las restricciones DEFAULT y los valores predeterminados enlazados no se pueden utilizar con columnas de identidad. En este caso, deben especificarse el valor de inicialización y el incremento, o ninguno de esto valores. Si no se especifica ninguno, el valor predeterminado es (1,1).

• seed

  Es el valor que se usa para la primera fila cargada en la tabla.

• increment

  El valor incremental que se agrega al valor de identidad de la fila cargada anterior.

NOT FOR REPLICATION

En la instrucción CREATE TABLE, la cláusula NOT FOR REPLICATION se puede especificar para la propiedad IDENTITY, las restricciones FOREIGN KEY y las restricciones CHECK. Si se especifica esta cláusula para la propiedad IDENTITY, los valores no se incrementan en las columnas de identidad cuando los agentes de replicación realizan inserciones. Si se especifica esta cláusula para una restricción, la restricción no se aplica cuando los agentes de replicación realizan operaciones de inserción, actualización o eliminación.

GENERATED ALWAYS AS { ROW | TRANSACTION_ID | SEQUENCE_NUMBER } { START | END } [ HIDDEN ] [ NOT NULL ]

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

Especifica una columna utilizada por el sistema para registrar automáticamente información sobre las versiones de fila de la tabla y su tabla de historial (si la tabla tiene versiones del sistema y tiene una tabla de historial). Use este argumento con el parámetro WITH SYSTEM_VERSIONING = ON para crear tablas con control de versiones del sistema: tablas temporales o de libro de contabilidad. Para obtener más información, vea tablas de libro de contabilidad actualizables y tablas temporales.

Parámetro	Tipo de datos necesario	Nulabilidad requerida	Descripción
ROW	datetime2	START: NOT NULL END: NOT NULL	La hora de inicio para la que una versión de fila sea válida (START) o la hora de finalización para la que una versión de fila sea válida (END). Use este argumento con el argumento PERIOD FOR SYSTEM_TIME para crear una tabla temporal.
TRANSACTION_ID	bigint	START: NOT NULL END: NULL	Se aplica a: SQL Server 2022 (16.x) y versiones posteriores, y a Azure SQL Database. Id. de la transacción que crea (START) o invalida (END) una versión de fila. Si la tabla es una tabla de libro de contabilidad, el identificador hace referencia a una fila de la vista sys.database_ledger_transactions
SEQUENCE_NUMBER	bigint	START: NOT NULL END: NULL	Se aplica a: SQL Server 2022 (16.x) y versiones posteriores, y a Azure SQL Database. Número de secuencia de una operación que crea (START) o elimina (END) una versión de fila. Este valor es único dentro de la transacción.

Si intenta especificar una columna que no cumple los requisitos de tipo de datos o nulabilidad anteriores, el sistema generará un error. Si no especifica explícitamente la nulabilidad, el sistema definirá la columna como NULL o NOT NULL de acuerdo con los requisitos anteriores.

Los usuarios pueden marcar una o ambas columnas de período con la marca HIDDEN para ocultarlas implícitamente, de modo que SELECT * FROM <table> no devuelva ningún valor para esas columnas. De forma predeterminada, no se ocultan las columnas de período. Para poder usar las columnas ocultas, deben incluirse explícitamente en todas las consultas que hacen referencia directa a la tabla temporal. Para cambiar el atributo HIDDEN para una columna de período existente, debe quitarse PERIOD y volver a crearlo con una etiqueta oculta distinta.

INDEX index_name [ CLUSTERED | NONCLUSTERED ] (column_name [ ASC | DESC ] [ ,... n ] )

Se aplica a: SQL Server 2014 (12.x) y versiones posteriores, y Azure SQL Database

Especifica que se creará un índice en la tabla. Puede tratarse de un índice agrupado o un índice que no esté en clúster. El índice incluirá las columnas enumeradas y ordenará los datos en orden ascendente o descendente.

INDEX index_name CLUSTERED COLUMNSTORE

Se aplica a: SQL Server 2014 (12.x) y versiones posteriores, y Azure SQL Database

Especifica que se almacenará toda la tabla en formato de columnas con un índice de almacén de columnas agrupado. Esto siempre incluye todas las columnas de la tabla. Los datos no se ordenan en orden alfabético o numérico, ya que las filas se organizan para obtener las ventajas de la compresión de almacén de columnas.

En Azure Synapse Analytics, Analytics Platform System (PDW) y SQL Server 2022 (16.x) y versiones posteriores, puede determinar el orden de las columnas para un índice de almacén de columnas agrupado. Para más información, consulte Uso de un índice de almacén de columnas agrupado ordenado para tablas de almacenamiento de datos grandes.

INDEX index_name [ NONCLUSTERED ] COLUMNSTORE ( column_name [ ,... n ] )

Se aplica a: SQL Server 2014 (12.x) y versiones posteriores, y Azure SQL Database

Especifica que se creará un índice de almacén de columnas no en clúster en la tabla. La tabla subyacente puede ser un montón de almacenamiento de filas o un índice agrupado, o incluso puede ser un índice de almacén de columnas agrupado. En todos los casos, al crear un índice de almacén de columnas no en clúster en una tabla, se almacena una segunda copia de los datos de las columnas en el índice.

El índice de almacén de columnas no en clúster se almacena y administra como un índice de almacén de columnas agrupado. Se denomina índice de almacén de columnas no en clúster porque las columnas pueden ser limitadas y está presente como un índice secundario en una tabla.

ON partition_scheme_name ( column_name )

Especifica el esquema de partición que define los grupos de archivos a los que se asignarán las particiones de un índice con particiones. El esquema de partición debe existir dentro de la base de datos mediante la ejecución de CREATE PARTITION SCHEME o ALTER PARTITION SCHEME. column_name especifica la columna en la que se van a crear las particiones de un índice con particiones. Esta columna debe coincidir con el tipo de datos, la longitud y la precisión del argumento de la función de partición que partition_scheme_name emplea. column_name no está limitado a las columnas de la definición de índice. Se puede especificar cualquier columna de la tabla base, excepto en el caso de partición de un índice UNIQUE, en el que se debe elegir column_name entre las columnas usadas como clave única. Esta restricción permite que Motor de base de datos compruebe la unicidad de los valores de clave en una única partición solamente.

Si no se especificó partition_scheme_name o filegroup y se crearon particiones en la tabla, el índice se coloca en el mismo esquema de partición y usa la misma columna de partición que en la tabla subyacente.

Para más información sobre los índices con particiones, vea Tablas e índices con particiones.

ON filegroup_name

Crea el índice especificado en el grupo de archivos especificado. Si no se ha especificado una ubicación y la tabla o vista no tiene particiones, el índice usa el mismo grupo de archivos que la tabla o vista subyacente. El grupo de archivos debe existir previamente.

ON "default"

Crea el índice especificado en el grupo de archivos predeterminado.

[ FILESTREAM_ON { filestream_filegroup_name | partition_scheme_name | "NULL" } ]

Se aplica a:: SQL Server 2008 R2 (10.50.x) y versiones posteriores.

Especifica la posición de datos FILESTREAM para la tabla cuando se crea un índice clúster. La cláusula FILESTREAM_ON permite mover los datos FILESTREAM a otro esquema de partición o a otro grupo de archivos FILESTREAM.

filestream_filegroup_name es el nombre de un grupo de archivos FILESTREAM. El grupo de archivos debe tener un archivo definido para el grupo de archivos, usando para ello las instrucciones CREATE DATABASE o ALTER DATABASE; en caso contrario, se produce un error.

Si se crean particiones de la tabla, la cláusula FILESTREAM_ON deberá incluirse y especificar un esquema de partición de grupos de archivos FILESTREAM que utilice la misma función de partición y columnas de partición que el esquema de partición para la tabla. En caso contrario, se produce un error.

Si la tabla no tiene particiones, no se pueden crear particiones en la columna FILESTREAM. Los datos FILESTREAM para la tabla deben estar almacenados en un grupo de archivos único que se especifica en la cláusula FILESTREAM_ON.

FILESTREAM_ON NULL se puede especificar en una instrucción CREATE INDEX si se va a crear un índice agrupado y la tabla no contiene una columna FILESTREAM.

Para obtener más información, vea FILESTREAM.

ROWGUIDCOL

Indica que la nueva columna es una columna de GUID de filas. Solo se puede designar una columna uniqueidentifier por tabla como columna ROWGUIDCOL. Si se aplica la propiedad ROWGUIDCOL, se puede hacer referencia a la columna mediante $ROWGUID. La propiedad ROWGUIDCOL únicamente se puede asignar a una columna uniqueidentifier. Las columnas de tipos de datos definidos por el usuario no se pueden designar con ROWGUIDCOL.

La propiedad ROWGUIDCOL no exige que los valores almacenados en la columna sean únicos. ROWGUIDCOL tampoco genera automáticamente valores para nuevas filas insertadas en la tabla. Para generar valores únicos para cada columna, use la función NEWID or NEWSEQUENTIALID en instrucciones INSERT o use estas funciones como valor predeterminado de la columna.

ENCRYPTED WITH

Especifica columnas de cifrado mediante la característica Always Encrypted.

• COLUMN_ENCRYPTION_KEY = key_name

  Especifica la clave de cifrado de columna. Para obtener más información, vea CREATE COLUMN ENCRYPTION KEY.

• ENCRYPTION_TYPE = { DETERMINISTIC | RANDOMIZED }

  El cifrado determinista usa un método que genera siempre el mismo valor cifrado para cualquier valor de texto no cifrado concreto. Al usar cifrado determinista se pueden realizar búsquedas mediante comparación de igualdad, agrupar y unir tablas mediante combinaciones de igualdad basadas en valores cifrados, y además se puede permitir a usuarios no autorizados que averigüen la información sobre valores cifrados mediante el análisis de patrones en la columna cifrada. La combinación de dos tablas en columnas cifradas de manera determinista solo es posible si ambas columnas están cifradas con la misma clave de cifrado de columna. El cifrado determinista debe usar una intercalación de columna con un criterio de ordenación binario 2 para columnas de caracteres.

  Elcifrado aleatorio utiliza un método que cifra los datos de una manera menos predecible. El cifrado aleatorio es más seguro, pero impide todos los cálculos y la indexación en columnas cifradas, a menos que la instancia de SQL Server admita Always Encrypted con enclaves seguros. Para obtener más información, vea Always Encrypted con enclaves seguros.

  Si usa Always Encrypted (sin los enclaves seguros), utilice el cifrado determinista para que se busquen columnas con parámetros o parámetros de agrupación, por ejemplo, un número de identificación gubernamental. Use el cifrado aleatorio para datos como números de tarjeta de crédito, que no estén agrupados con otros registros ni se estén usando para combinar tablas, y en los que no se realicen búsquedas porque se estén usando otras columnas (por ejemplo, un número de transacción) para buscar la fila que contiene la columna cifrada en cuestión.

  Si usa Always Encrypted con enclaves seguros, se recomienda, por ejemplo, el cifrado aleatorio.

  Las columnas deben ser de un tipo de datos aplicable.

• ALGORITHM

  Válido para : SQL Server 2016 (13.x) y versiones posteriores.

  Debe ser 'AEAD_AES_256_CBC_HMAC_SHA_256'.

  Para más información, incluidas restricciones de características, vea Always Encrypted.

SPARSE

Indica que la columna es una columna dispersa. El almacenamiento de columnas dispersas está optimizado para los valores NULL. Las columnas dispersas no se pueden designar como NOT NULL. Para conocer otras restricciones y leer más información sobre columnas dispersas, vea Usar columnas dispersas.

MASKED WITH ( FUNCTION = 'mask_function' )

Válido para : SQL Server 2016 (13.x) y versiones posteriores.

Especifica una máscara dinámica de datos. mask_function es el nombre de la función de máscara con los parámetros adecuados. Hay cuatro funciones disponibles:

• default()
• email()
• partial()
• random()

Requiere el permiso ALTER ANY MASK.

Para conocer más parámetros de función, vea Enmascaramiento de datos dinámicos.

FILESTREAM

Se aplica a:: SQL Server 2008 R2 (10.50.x) y versiones posteriores.

Válido únicamente para columnas varbinary (max) . Especifica el almacenamiento FILESTREAM para los datos de BLOB varbinary(max) .

La tabla también debe tener una columna del tipo de datos uniqueidentifier que tenga el atributo ROWGUIDCOL. Esta columna no debe permitir valores nulos y debe tener una restricción de columna única UNIQUE o PRIMARY KEY. El valor de GUID de la columna lo debe proporcionar una aplicación cuando se inserten datos o una restricción DEFAULT que use la función NEWID ().

No se puede quitar la columna ROWGUIDCOL ni se pueden cambiar las restricciones relacionadas si hay definida una columna FILESTREAM para la tabla. Solamente se puede quitar la columna ROWGUIDCOL después de quitarse la última columna FILESTREAM.

Si se especifica el atributo de almacenamiento FILESTREAM para una columna, todos los valores para dicha columna se almacenan en un contenedor de datos de FILESTREAM del sistema de archivos.

COLLATE collation_name

Especifica la intercalación de la columna. El nombre de intercalación puede ser un nombre de intercalación de Windows o un nombre de intercalación de SQL. collation_name se aplica solo a columnas de tipos de datos char, varchar, text, nchar, nvarchar y ntext. Si no se especifica, se asignará a la columna la intercalación del tipo de datos definido por el usuario, si la columna es de uno de estos tipos, o la intercalación predeterminada de la base de datos.

Para más información sobre los nombres de intercalación de Windows y SQL, vea Nombre de intercalación de Windows y Nombre de intercalación de SQL.

Para obtener más información, vea COLLATE.

CONSTRAINT

Una palabra clave opcional que indica el principio de la definición de una restricción PRIMARY KEY, NOT NULL, UNIQUE, FOREIGN KEY o CHECK.

• constraint_name

  El nombre de una restricción. Los nombres de restricción deben ser únicos en el esquema al que pertenece la tabla.

• NULL | NOT NULL

  Determina si se permiten valores NULL en la columna. NULL no es estrictamente una restricción, pero se puede especificar, al igual que NOT NULL. NOT NULL solo puede especificarse para las columnas si también se especifica PERSISTED.

• PRIMARY KEY

  Una restricción que exige la integridad de entidad para una o varias columnas especificadas a través de un índice único. Solo se puede crear una restricción PRIMARY KEY para cada tabla.

• UNIQUE

  Una restricción que proporciona la integridad de entidad para una o varias columnas especificadas a través de un índice único. Las tablas pueden tener varias restricciones UNIQUE.

• CLUSTERED | NONCLUSTERED

  Indica que se ha creado un índice clúster o no clúster para la restricción PRIMARY KEY o UNIQUE. De forma predeterminada, el valor de las restricciones PRIMARY KEY es CLUSTERED, y el de las restricciones UNIQUE es NONCLUSTERED.

  En una instrucción CREATE TABLE, se puede especificar CLUSTERED tan solo para una restricción. Si se especifica CLUSTERED para una restricción UNIQUE y se especifica también una restricción PRIMARY KEY, el valor predeterminado de PRIMARY KEY es NONCLUSTERED.

• FOREIGN KEY REFERENCES

  Una restricción que proporciona integridad referencial para los datos de la columna o columnas. Las restricciones FOREIGN KEY requieren que cada valor de la columna exista en la columna o columnas de referencia correspondientes de la tabla a la que se hace referencia. Las restricciones FOREIGN KEY pueden hacer referencia solo a columnas que sean restricciones PRIMARY KEY o UNIQUE en la tabla de referencia o a columnas a las que se haga referencia en UNIQUE INDEX en la tabla de referencia. Las claves externas en las columnas calculadas deben marcarse también como PERSISTED.

• [ [ schema_name. ] referenced_table_name ]

  El nombre de la tabla a la que hace referencia la restricción FOREIGN KEY y el esquema al que pertenece.

• ( ref_column [ ,... n ] )

  Una columna o lista de columnas de la tabla a la que hace referencia la restricción FOREIGN KEY.

• ON DELETE { NO ACTION | CASCADE | SET NULL | SET DEFAULT }

  Especifica la acción que tiene lugar en las filas de la tabla creada si dichas filas tienen una relación referencial y la fila a la que se hace referencia se elimina de la tabla primaria. El valor predeterminado es NO ACTION.

• NO ACTION

  El Motor de base de datos genera un error y se revierte la acción de eliminación de la fila de la tabla primaria.

• CASCADE

  Si esa fila se elimina de la tabla primaria, las filas correspondientes se eliminan de la tabla de referencia.

• SET NULL

  Todos los valores que forman la clave externa se establecen en NULL si se elimina la fila correspondiente de la tabla primaria. Para que esta restricción se ejecute, las columnas de clave externa deben aceptar valores NULL.

• SET DEFAULT

  Cuando se elimina la fila correspondiente en la tabla primaria, todos los valores que componen la clave externa se establecen en sus valores predeterminados. Para que esta restricción se ejecute, todas las columnas de clave externa deben tener definiciones predeterminadas. Si una columna acepta valores NULL y no se ha establecido un valor predeterminado explícito, NULL se convierte en el valor predeterminado explícito de dicha columna.

  No especifique CASCADE si la tabla se va a incluir en una publicación de combinación que utiliza registros lógicos. Para obtener más información sobre los registros lógicos, vea Agrupar cambios en filas relacionadas con registros lógicos.

  ON DELETE CASCADE no se puede definir si ya existe en la tabla un desencadenador INSTEAD OFON DELETE.

  Por ejemplo, en la base de datos AdventureWorks2022, la tabla ProductVendor tiene una relación referencial con la tabla Vendor. La ProductVendor.BusinessEntityID clave externa hace referencia a la Vendor.BusinessEntityID clave principal.

  Si se ejecuta una instrucción DELETE en una fila de la tabla Vendor y se especifica una acción ON DELETE CASCADE para ProductVendor.BusinessEntityID, Motor de base de datos comprueba si hay alguna fila dependiente en la tabla ProductVendor. Si las hay, las filas dependientes de la tabla ProductVendor se eliminan, así como la fila a la que se hace referencia en la tabla Vendor.

  Por el contrario, si se especifica NO ACTION, Motor de base de datos genera un error y revierte la acción de eliminación de la fila Vendor si hay al menos una fila en la tabla ProductVendor que hace referencia a ella.

• ON UPDATE { NO ACTION | CASCADE | SET NULL | SET DEFAULT }

  Especifica la acción que se produce en las filas de la tabla modificada cuando esas filas tienen una relación referencial y la fila a la que se hace referencia se actualiza en la tabla primaria. El valor predeterminado es NO ACTION.

• NO ACTION

  El Motor de base de datos genera un error y se revierte la acción de actualización de la fila de la tabla primaria.

• CASCADE

  Si esa fila se actualiza en la tabla primaria, las filas correspondientes se actualizan en la tabla de referencia.

• SET NULL

  Cuando se actualiza la fila correspondiente en la tabla primaria, todos los valores que componen la clave externa se establecen en NULL. Para que esta restricción se ejecute, las columnas de clave externa deben aceptar valores NULL.

• SET DEFAULT

  Cuando se actualiza la fila correspondiente en la tabla primaria, todos los valores que componen la clave externa se establecen en sus valores predeterminados. Para que esta restricción se ejecute, todas las columnas de clave externa deben tener definiciones predeterminadas. Si una columna acepta valores NULL y no se ha establecido un valor predeterminado explícito, NULL se convierte en el valor predeterminado explícito de dicha columna.

  No especifique CASCADE si la tabla se va a incluir en una publicación de combinación que utiliza registros lógicos. Para obtener más información sobre los registros lógicos, vea Agrupar cambios en filas relacionadas con registros lógicos.

  No se puede definir la acción ON UPDATE CASCADE, SET NULL o SET DEFAULT si ya existe un desencadenador INSTEAD OFON UPDATE en la tabla que se está modificando.

  Por ejemplo, en la base de datos AdventureWorks2022, la tabla ProductVendor tiene una relación referencial con la tabla Vendor: La clave externa ProductVendor.BusinessEntity hace referencia a la clave principal Vendor.BusinessEntityID.

  Si se ejecuta una instrucción UPDATE en una fila de la tabla Vendor y se especifica una acción ON UPDATE CASCADE para ProductVendor.BusinessEntityID, Motor de base de datos comprueba si hay una o más filas dependientes de la tabla ProductVendor. Si las hay, las filas dependientes de la tabla ProductVendor se actualizan, así como la fila a la que se hace referencia en la tabla Vendor.

  Por el contrario, si se especifica NO ACTION, Motor de base de datos genera un error y revierte la acción de actualización de la fila Vendor si hay al menos una fila en la tabla ProductVendor que hace referencia a ella.

• CHECK

  Es una restricción que exige la integridad del dominio limitando los valores posibles que se pueden escribir en una o varias columnas. Las restricciones CHECK en las columnas calculadas deben marcarse también como PERSISTED.

• logical_expression

  Es una expresión lógica que devuelve TRUE o FALSE. Los tipos de datos de alias no pueden formar parte de la expresión.

• column_name

  Una columna o lista de columnas, entre paréntesis, que se utiliza en las restricciones de tabla para indicar las columnas que se están utilizando en la definición de la restricción.

• [ ASC | DESC ]

  Especifica cómo se ordenan la columna o las columnas que participan en las restricciones de la tabla. El valor predeterminado es ASC.

• partition_scheme_name

  El nombre del esquema de partición que define los grupos de archivos a los que se van a asignar las particiones de una tabla con particiones. El esquema de partición debe existir en la base de datos.

• [ partition_column_name. ]

  Especifica la columna en la que se van a crear las particiones de la tabla con particiones. La columna debe coincidir con la especificada en la función de partición que partition_scheme_name está usando en términos de tipo de datos, longitud y precisión. Una columna calculada que participa en una función de partición se debe marcar como PERSISTED de forma explícita.

  Importante

  Se recomienda especificar NOT NULL en la columna de partición de las tablas con particiones y también de las tablas sin particiones que sean orígenes o destinos de operaciones ALTER TABLE...SWITCH. De esta forma se garantiza que las restricciones CHECK en columnas de partición no tengan que comprobar si hay valores NULL.

• WITH FILLFACTOR = fillfactor

  Especifica en qué medida el Motor de base de datos debe llenar cada página de índice que se va a utilizar para almacenar los datos de índice. Los valores de fillfactor especificados por el usuario pueden estar comprendidos entre 1 y 100. Si no se especifica, el valor predeterminado es 0. Los valores de fill factor 0 y 100 son idénticos.

  Importante

  La documentación de WITH FILLFACTOR = fillfactor como la única opción de índice que se aplica a las restricciones PRIMARY KEY o UNIQUE se mantiene por compatibilidad con versiones anteriores, pero no se documentará de esta forma en futuras versiones.

column_set_name XML COLUMN_SET FOR ALL_SPARSE_COLUMNS

El nombre del conjunto de columnas. Un conjunto de columnas es una representación XML sin tipo que combina todas las columnas dispersas de una tabla en una salida estructurada. Para obtener más información sobre los conjuntos de columnas, vea Usar conjuntos de columnas.

PERIOD FOR SYSTEM_TIME ( system_start_time_column_name , system_end_time_column_name )

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, y Azure SQL Database.

Especifica los nombres de las columnas que el sistema usará para registrar el período durante el que un registro es válido. Use este argumento con los argumentos GENERATED ALWAYS AS ROW { START | END } y WITH SYSTEM_VERSIONING = ON para crear una tabla temporal. Para obtener más información, consulte Temporal Tables.

COMPRESSION_DELAY

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, y Azure SQL Database.

Para una optimización en memoria, el retraso especifica el número mínimo de minutos que debe permanecer una fila en la tabla, sin cambios, antes de que sea válida para la compresión en el índice de almacén de columnas. SQL Server selecciona filas específicas para comprimirlas según la hora de su última actualización. Por ejemplo, si va a cambiar filas con frecuencia durante un período de dos horas, puede establecer COMPRESSION_DELAY = 120 Minutes para asegurarse de que las actualizaciones se completan antes de que SQL Server comprima la fila.

Para las tablas basadas en disco, el retraso especifica el número mínimo de minutos que debe permanecer un grupo de filas delta con estado CLOSED en el grupo de filas delta antes de que SQL Server pueda comprimirlo en el grupo de filas comprimido. Puesto que las tablas basadas en disco no realizan el seguimiento de los tiempos de inserción y actualización de filas individuales, SQL Server aplica el retraso a los grupos de filas delta en el estado CLOSED.

El valor predeterminado es 0 minutos.

Para obtener recomendaciones sobre cuándo usar COMPRESSION_DELAY, vea Introducción al almacén de columnas para análisis operativos en tiempo real

<table_option> ::=

Especifica una o varias opciones de tabla.

DATA_COMPRESSION

Especifica la opción de compresión de datos para la tabla, el número de partición o el intervalo de particiones especificados. Las opciones son las siguientes:

• Ninguno

  No se comprimen la tabla ni las particiones especificadas.

• ROW

  La tabla o las particiones especificadas se comprimen utilizando la compresión de fila.

• PAGE

  La tabla o las particiones especificadas se comprimen utilizando la compresión de página.

• COLUMNSTORE

  Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, y Azure SQL Database.

  Solo se aplica a los índices de almacén de columnas, incluidos los clúster y no clúster. COLUMNSTORE especifica que se comprimirá con la compresión de almacén de columnas que ofrezca el mejor rendimiento. Es la elección habitual.

• COLUMNSTORE_ARCHIVE

  Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, y Azure SQL Database.

  Solo se aplica a los índices de almacén de columnas, incluidos los clúster y no clúster. COLUMNSTORE_ARCHIVE comprimirá aún más la partición o la tabla especificada a un tamaño mínimo. Esto se puede usar para el archivado o para otras situaciones que requieran un tamaño de almacenamiento mínimo y pueda permitirse más tiempo para el almacenamiento y recuperación.

Para obtener más información, consulte Data Compression.

XML_COMPRESSION

Se aplica a SQL Server 2022 (16.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

Especifica la opción de compresión XML de las columnas de tipo de datos xml de la tabla. Las opciones son las siguientes:

• ACTIVAR

  Las columnas que usan el tipo de datos xml se comprimen.

• Apagado

  Las columnas que usan el tipo de datos xml no se comprimen.

ON PARTITIONS ( { <partition_number_expression> | [ ,... n ] )

Especifica las particiones a las que se aplica el valor DATA_COMPRESSION o XML_COMPRESSION. Si la tabla no se particiona, el argumento ON PARTITIONS generará un error. Si no se proporciona la cláusula ON PARTITIONS, la opción DATA_COMPRESSION se aplicará a todas las particiones de una tabla con particiones.

partition_number_expression se puede especificar de estas maneras:

• Proporcione el número de partición de una partición, por ejemplo: ON PARTITIONS (2)
• Proporcionando los números de partición para varias particiones individuales separadas por comas, como por ejemplo: ON PARTITIONS (1, 5)
• Proporcionando ambos intervalos y particiones individuales, como por ejemplo: ON PARTITIONS (2, 4, 6 TO 8)

<range> se puede especificar como números de partición separados por la palabra TO, como por ejemplo: ON PARTITIONS (6 TO 8).

Para establecer diferentes tipos de compresión de datos para distintas particiones, especifique la opción DATA_COMPRESSION más de una vez, por ejemplo:

WITH
(
    DATA_COMPRESSION = NONE ON PARTITIONS (1),
    DATA_COMPRESSION = ROW ON PARTITIONS (2, 4, 6 TO 8),
    DATA_COMPRESSION = PAGE ON PARTITIONS (3, 5)
);

También puede especificar la opción XML_COMPRESSION más de una vez, por ejemplo:

WITH
(
    XML_COMPRESSION = OFF ON PARTITIONS (1),
    XML_COMPRESSION = ON ON PARTITIONS (2, 4, 6 TO 8),
    XML_COMPRESSION = OFF ON PARTITIONS (3, 5)
);

<index_option> ::=

Especifica una o varias opciones de índice. Si le interesa una descripción completa de estas opciones, vea CREATE INDEX.

PAD_INDEX = { ON | OFF }

Cuando es ON, el porcentaje de espacio disponible especificado por FILLFACTOR se aplica a las páginas de nivel intermedio del índice. Cuando es OFF o no se especifica ningún valor de FILLFACTOR, las páginas de nivel intermedio se rellenan casi al máximo de su capacidad dejando espacio suficiente para al menos una fila del tamaño máximo que el índice puede contener teniendo en cuenta el conjunto de claves de las páginas intermedias. El valor predeterminado es OFF.

FILLFACTOR = fillfactor

Especifica un porcentaje que indica cuánto debe llenar el Motor de base de datos el nivel hoja de cada página de índice durante la creación o modificación de los índices. fillfactor debe ser un valor entero comprendido entre 1 y 100. El valor predeterminado es 0. Los valores de fill factor 0 y 100 son idénticos.

IGNORE_DUP_KEY = { ON | OFF }

Especifica la respuesta de error cuando una operación de inserción intenta insertar valores de clave duplicados en un índice único. La opción IGNORE_DUP_KEY se aplica solamente a operaciones de inserción realizadas tras crear o volver a generar el índice. La opción no tiene efecto cuando se ejecutan CREATE INDEX, ALTER INDEX o UPDATE. El valor predeterminado es OFF.

• ACTIVAR

  Se producirá un mensaje de advertencia cuando se inserten valores de clave duplicados en un índice único. Solo las filas que infrinjan la restricción de unicidad darán error.

• Apagado

  Se producirá un mensaje de error cuando se inserten valores de clave duplicados en un índice único. Toda la operación INSERT se revertirá.

IGNORE_DUP_KEY no se puede establecer en ON para los índices creados en una vista, los índices que no sean únicos, los índices XML, los índices espaciales y los índices filtrados.

Para ver IGNORE_DUP_KEY, utilice sys.indexes.

En la sintaxis compatible con versiones anteriores, WITH IGNORE_DUP_KEY es equivalente a WITH IGNORE_DUP_KEY = ON.

STATISTICS_NORECOMPUTE = { ON | OFF }

Si es ON, las estadísticas de índices no actualizadas no se vuelven a calcular automáticamente. Si es OFF, se habilita la actualización automática de estadísticas. El valor predeterminado es OFF.

ALLOW_ROW_LOCKS = { ON | OFF }

Si es ON, los bloqueos de fila se permiten al tener acceso al índice. El Motor de base de datos determina cuándo se usan los bloqueos de fila. Si es OFF, no se utilizan bloqueos de fila. El valor predeterminado es ON.

ALLOW_PAGE_LOCKS = { ON | OFF }

Si es ON, los bloqueos de página se permiten al tener acceso al índice. Motor de base de datos determina el momento en que se usan los bloqueos de página. Si es OFF, no se utilizan bloqueos de página. El valor predeterminado es ON.

OPTIMIZE_FOR_SEQUENTIAL_KEY = { ON | OFF }

Se aplica a: SQL Server 2019 (15.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

Especifica si se deben optimizar la contención de inserción de la última página. El valor predeterminado es OFF. Consulte la sección Claves secuenciales de la página CREATE INDEX para obtener más información.

FILETABLE_DIRECTORY = directory_name

Válido para : SQL Server 2012 (11.x) y versiones posteriores.

Especifica el nombre de directorio de FileTable compatible con Windows. Este nombre debe ser único entre todos los nombres de directorio de FileTable en la base de datos. La comparación de unicidad no distingue mayúsculas de minúsculas, independientemente de la configuración de intercalación. Si no se especifica este valor, se usa el nombre de la tabla de archivos.

FILETABLE_COLLATE_FILENAME = { collation_name | database_default }

Válido para : SQL Server 2012 (11.x) y versiones posteriores. Azure SQL Database y Azure SQL Managed Instance no son compatibles con FILETABLE.

Especifica el nombre de la intercalación que se va a aplicar a la columna Name en la FileTable. La intercalación no debe distinguir mayúsculas de minúsculas para cumplir con la semántica de nomenclatura de archivos del sistema operativo Windows. Si no se especifica este valor, se usa la intercalación predeterminada de la base de datos. Si la intercalación predeterminada de la base de datos distingue mayúsculas de minúsculas, se genera un error en la operación CREATE TABLE.

• collation_name

  El nombre de una intercalación sin distinción entre mayúsculas y minúsculas.

• database_default

  Especifica que se debe usar la intercalación predeterminada de la base de datos. Esta intercalación no debe distinguir mayúsculas de minúsculas.

FILETABLE_PRIMARY_KEY_CONSTRAINT_NAME = constraint_name

Válido para : SQL Server 2012 (11.x) y versiones posteriores. Azure SQL Database y Azure SQL Managed Instance no son compatibles con FILETABLE.

Especifica el nombre que se debe usar para la restricción de clave primaria creada automáticamente en el objeto FileTable. Si no se especifica este valor, el sistema genera un nombre para la restricción.

FILETABLE_STREAMID_UNIQUE_CONSTRAINT_NAME = constraint_name

Válido para : SQL Server 2012 (11.x) y versiones posteriores. Azure SQL Database y Azure SQL Managed Instance no son compatibles con FILETABLE.

Especifica el nombre que se debe usar para la restricción única creada automáticamente en la columna stream_id del objeto FileTable. Si no se especifica este valor, el sistema genera un nombre para la restricción.

FILETABLE_FULLPATH_UNIQUE_CONSTRAINT_NAME = constraint_name

Válido para : SQL Server 2012 (11.x) y versiones posteriores. Azure SQL Database y Azure SQL Managed Instance no son compatibles con FILETABLE.

Especifica el nombre que se debe usar para la restricción única creada automáticamente en las columnas parent_path_locator y name del objeto FileTable. Si no se especifica este valor, el sistema genera un nombre para la restricción.

SYSTEM_VERSIONING = ON [ ( HISTORY_TABLE = schema_name.history_table_name [ , DATA_CONSISTENCY_CHECK = { ON | OFF } ] ) ]

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

Permite el control de versiones del sistema de la tabla si se cumplen los requisitos de tipo de datos, restricción de nulabilidad y restricción de clave principal. El sistema registrará el historial de cada registro de la tabla con control de versiones del sistema en una tabla de historial independiente. Si no se usa el argumento HISTORY_TABLE, el nombre de esta tabla de historial será MSSQL_TemporalHistoryFor<primary_table_object_id>. Si el nombre de una tabla de historial se especifica durante su creación, debe determinar el nombre del esquema y la tabla.

Si la tabla de historial no existe, el sistema genera una nueva tabla de historial que coincide con el esquema de la tabla actual en el mismo grupo de archivos que la tabla actual, creando un vínculo entre las dos tablas, y permite que el sistema registre el historial de cada registro de la tabla actual en la tabla de historial. De forma predeterminada, es la tabla de historial PAGE es comprimida.

Si se usa el argumento HISTORY_TABLE para crear un vínculo a un historial existente y usarlo, dicho vínculo se crea entre la tabla actual y la tabla especificada. Si la tabla actual tiene particiones, la tabla de historial se crea en el grupo de archivos predeterminado, ya que la configuración de particiones no se replica automáticamente desde la tabla actual a la de historial. Al crear un vínculo a una tabla de historial existente, puede realizar una comprobación de coherencia de datos. Esta comprobación de coherencia de datos garantiza que los registros existentes no se superponen. La comprobación de coherencia de datos se realiza de manera predeterminada.

Utilice este argumento con los argumentos PERIOD FOR SYSTEM_TIME y GENERATED ALWAYS AS ROW { START | END } para habilitar el control de versiones del sistema en una tabla. Para obtener más información, consulte Temporal Tables. Use este argumento con el argumento WITH LEDGER = ON para crear una tabla de libro de contabilidad actualizable. No se permite el uso de tablas de historial existentes con tablas de libro de contabilidad.

REMOTE_DATA_ARCHIVE = { ON [ ( table_stretch_options [ ,... n ] ) ] | OFF ( MIGRATION_STATE = PAUSED ) }

Válido para : SQL Server 2016 (13.x) y versiones posteriores.

Crea una nueva tabla con Stretch Database habilitado o deshabilitado. Para obtener más información, vea Stretch Database.

Habilitar Stretch Database para una tabla

Al habilitar Stretch para una tabla especificando ON, si lo prefiere puede especificar MIGRATION_STATE = OUTBOUND para empezar a migrar los datos inmediatamente o MIGRATION_STATE = PAUSED para posponer la migración de datos. El valor predeterminado es MIGRATION_STATE = OUTBOUND. Para más información sobre la habilitación de Stretch para una tabla, vea Enable Stretch Database for a table (Habilitar Stretch Database para una tabla).

Requisitos previos. Para poder habilitar Stretch para una tabla, primero tiene que habilitar Stretch en el servidor y en la base de datos. Para obtener más información, vea Enable Stretch Database for a database.

Permisos. Para habilitar Stretch para una base de datos o una tabla se necesitan permisos db_owner. Además, para habilitar Stretch para una tabla se necesitan permisos ALTER en la tabla.

[ FILTER_PREDICATE = { NULL | predicate } ]

Válido para : SQL Server 2016 (13.x) y versiones posteriores.

Especifica opcionalmente un predicado de filtro para seleccionar las filas que se migrarán desde una tabla que contiene datos históricos y datos actuales. El predicado debe llamar a una función determinista con valores de tabla insertada. Para más información, vea Enable Stretch Database para una tabla (Habilitar Stretch Database para una tabla) y Seleccionar las filas que se van a migrar mediante una función de filtro (Stretch Database).

Si no se especifica un predicado de filtro, se migrará toda la tabla.

Cuando se especifica un predicado de filtro, también hay que especificar MIGRATION_STATE.

MIGRATION_STATE = { OUTBOUND | INBOUND | PAUSED }

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

• Especifique OUTBOUND para migrar datos de SQL Server a Azure SQL Database.

• Especifique INBOUND para copiar los datos remotos de la tabla de Azure SQL Database a SQL Server y deshabilite Stretch para la tabla. Para obtener más información, vea Deshabilitar Stretch Database y recuperar datos remotos.

  Esta operación provoca costos de transferencia de datos y no se puede cancelar.

• Especifique PAUSED para pausar o posponer la migración de datos. Para obtener más información, vea Pausa y reanudación de la migración de datos (Stretch Database).

[ DATA_DELETION = ON { ( FILTER_COLUMN = column_name, RETENTION_PERIOD = { INFINITE | number { DAY | DAYS | WEEK | WEEKS | MONTH | MONTHS | YEAR | YEARS } ) } ]

Se aplica a:solo para Azure SQL Edge

Habilita la limpieza basada en la directiva de retención de los datos obsoletos o antiguos de las tablas de una base de datos. Para obtener más información, consulte Habilitación y deshabilitación de la retención de datos. Para habilitar la retención de datos se deben especificar los parámetros siguientes.

• FILTER_COLUMN = { nombre_columna }

  Especifica la columna que se debe usar para determinar si las filas de la tabla son obsoletas o no. Se permiten los tipos de datos siguientes para la columna de filtro.

  • date
  • datetime
  • datetime2
  • smalldatetime
  • datetimeoffset

• RETENTION_PERIOD = { INFINITE | number {DAY | DAYS | WEEK | WEEKS | MONTH | MONTHS | YEAR | YEARS }}

  Especifica la directiva del período de retención para la tabla. El período de retención se especifica como una combinación de un valor entero positivo y la unidad de la parte de la fecha.

MEMORY_OPTIMIZED

Se aplica a: SQL Server 2014 (12.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance. Instancia administrada de Azure SQL no es compatible con las tablas optimizadas para memoria del nivel De uso general.

El valor ON indica si la tabla está optimizada para memoria. Las tablas optimizadas para memoria forman parte de la característica OLTP en memoria, que se usa para mejorar el rendimiento del procesamiento de transacciones. Para empezar a trabajar con OLTP en memoria vea Inicio rápido 1: Tecnologías de OLTP en memoria para acelerar el rendimiento de Transact-SQL. Para más información sobre las tablas optimizadas para memoria, vea Tablas con optimización para memoria.

El valor predeterminado OFF indica que la tabla está basada en disco.

DURABILITY

Se aplica a: SQL Server 2014 (12.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

El valor de SCHEMA_AND_DATA indica que la tabla es duradera, lo que significa que los cambios se conservan en disco y sobreviven al reinicio o la conmutación por error. SCHEMA_AND_DATA es el valor predeterminado.

El valor de SCHEMA_ONLY indica que la tabla no es perdurable. El esquema de la tabla se conserva, pero no se conserva ninguna actualización de datos tras un reinicio o una conmutación por error de la base de datos. DURABILITY = SCHEMA_ONLY solo se permite con MEMORY_OPTIMIZED = ON.

BUCKET_COUNT

Se aplica a: SQL Server 2014 (12.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

Indica el número de cubos que se deben crear en el índice hash. El valor máximo para BUCKET_COUNT en índices hash es 1 073 741 824. Para más información sobre los números de cubos, vea Índices de las tablas con optimización para memoria.

Bucket_count es un argumento requerido.

INDEX

Se aplica a: SQL Server 2014 (12.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

Los índices de columna y de tabla se pueden especificar como parte de la instrucción CREATE TABLE. Para más información sobre cómo agregar y quitar índices en tablas optimizadas para memoria, vea Modificar tablas con optimización para memoria.

• HASH

  Se aplica a: SQL Server 2014 (12.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

  Indica que se ha creado un índice HASH.

  Los índices hash solo se admiten en las tablas optimizadas para memoria.

LEDGER = ON ( <ledger_option> [ ,... n ] ) | OFF

Se aplica a: SQL Server 2022 (16.x), Azure SQL Database y Azure SQL Managed Instance.

Indica si la tabla que se va a crear es una tabla de libro de contabilidad (ON) o no (OFF). El valor predeterminado es OFF. Si se especifica la opción APPEND_ONLY = ON, el sistema crea una tabla de libro de contabilidad de solo anexar que solo permite insertar nuevas filas. De lo contrario, el sistema crea una tabla de libro de contabilidad actualizable. Una tabla de libro de contabilidad actualizable también requiere el argumento SYSTEM_VERSIONING = ON. Una tabla de libro de contabilidad actualizable también debe ser una tabla con control de versiones del sistema. Sin embargo, una tabla de libro de contabilidad actualizable no tiene que ser una tabla temporal (no requiere el parámetro PERIOD FOR SYSTEM_TIME). Si la tabla de historial se especifica con LEDGER = ON y SYSTEM_VERSIONING = ON, no debe hacer referencia a una tabla existente.

Una base de datos de libro de contabilidad (una base de datos creada con la opción LEDGER = ON) solo permite la creación de tablas de libro de contabilidad. Los intentos de crear una tabla con LEDGER = OFF producirán un error. Cada nueva tabla se crea de forma predeterminada como una tabla de libro de contabilidad actualizable, incluso si no se especifica LEDGER = ON, y se creará con valores predeterminados para todos los demás parámetros.

Una tabla de libro de contabilidad actualizable debe contener cuatro columnas GENERATED ALWAYS, exactamente una columna definida con cada uno de los argumentos siguientes:

• GENERATED ALWAYS AS TRANSACTION_ID START
• GENERATED ALWAYS AS TRANSACTION_ID END
• GENERATED ALWAYS AS SEQUENCE_NUMBER START
• GENERATED ALWAYS AS SEQUENCE_NUMBER END

Una tabla de libro de contabilidad de solo anexar debe contener exactamente una columna definida con cada uno de los argumentos siguientes:

• GENERATED ALWAYS AS TRANSACTION_ID START
• GENERATED ALWAYS AS SEQUENCE_NUMBER START

Si alguna de las columnas siempre generadas necesaria no está definida en la instrucción CREATE TABLE y la instrucción incluye LEDGER = ON, el sistema intentará agregar automáticamente la columna mediante una definición de columna aplicable de la lista siguiente. Si hay un conflicto de nombres con una columna ya definida, el sistema producirá un error.

[ledger_start_transaction_id] BIGINT GENERATED ALWAYS AS TRANSACTION_ID START HIDDEN NOT NULL
[ledger_end_transaction_id] BIGINT GENERATED ALWAYS AS TRANSACTION_ID END HIDDEN NULL
[ledger_start_sequence_number] BIGINT GENERATED ALWAYS AS SEQUENCE_NUMBER START HIDDEN NOT NULL
[ledger_end_sequence_number] BIGINT GENERATED ALWAYS AS SEQUENCE_NUMBER END HIDDEN NULL

<ledger_view_option> especifica el esquema y el nombre de la vista de libro de contabilidad que el sistema crea y vincula a la tabla automáticamente. Si no se especifica la opción, el sistema genera el nombre de la vista de libro de contabilidad anexando _Ledger al nombre de la tabla que se crea (database_name.schema_name.table_name). Si existe una vista con el nombre especificado o generado, el sistema generará un error. Si la tabla es una tabla de libro de contabilidad actualizable, la vista de libro de contabilidad se crea como una unión en la tabla y su tabla de historial.

Cada fila de la vista de libro de contabilidad representa la creación o eliminación de una versión de fila en la tabla del libro de contabilidad. La vista de libro de contabilidad contiene todas las columnas de la tabla de libro de contabilidad, excepto las columnas siempre generadas enumeradas anteriormente. La vista de libro de contabilidad también contiene las siguientes columnas adicionales:

Nombre de la columna	Tipo de datos	Descripción
Se especifica mediante la opción TRANSACTION_ID_COLUMN_NAME. ledger_transaction_id si no se especifica.	bigint	Identificador de la transacción que creó o eliminó una versión de fila.
Se especifica mediante la opción SEQUENCE_NUMBER_COLUMN_NAME. ledger_sequence_number si no se especifica.	bigint	Número de secuencia de una operación de nivel de fila dentro de la transacción de la tabla.
Se especifica mediante la opción OPERATION_TYPE_COLUMN_NAME. ledger_operation_type si no se especifica.	TINYINT	Contiene 1 (INSERT) o 2 (DELETE). La inserción de una fila en la tabla de libro de contabilidad genera una nueva fila en la vista de libro de contabilidad que contiene 1 en esta columna. Al eliminar una fila de la tabla de libro de contabilidad, se genera una nueva fila en la vista de libro de contabilidad que contiene 2 en esta columna. Al actualizar una fila de la tabla de libro de contabilidad, se generan dos nuevas filas en la vista de libro de contabilidad. Una fila contiene 2 (DELETE) y la otra 1 (INSERT) en esta columna.
Se especifica mediante la opción OPERATION_TYPE_DESC_COLUMN_NAME. ledger_operation_type_desc si no se especifica.	nvarchar(128)	Contiene INSERT o DELETE. Consulte anteriormente para más información.

Las transacciones que incluyen la creación de una tabla de libro de contabilidad se capturan en sys.database_ledger_transactions.

<ledger_option> ::=

Especifica una opción de libro de contabilidad.

[ LEDGER_VIEW = schema_name.ledger_view_name [ ( <ledger_view_option> [ ,... n ] ) ]

Especifica el nombre de la vista de libro de contabilidad y los nombres de columnas adicionales que el sistema agrega a la vista de libro de contabilidad.

[ APPEND_ONLY = ON | OFF ]

Especifica si la tabla de libro de contabilidad que se va a crear es de solo anexar o actualizable. El valor predeterminado es OFF.

<ledger_view_option> ::=

Especifica una o varias opciones de vista de libro de contabilidad. Cada una de las opciones de vista de libro de contabilidad especifica un nombre de columna, que el sistema agregará a la vista, además de las columnas definidas en la tabla de libro de contabilidad.

[ TRANSACTION_ID_COLUMN_NAME = transaction_id_column_name ]

Especifica el nombre de la columna que almacena el identificador de la transacción que creó o eliminó una versión de fila. El nombre de columna predeterminado es ledger_transaction_id.

[ SEQUENCE_NUMBER_COLUMN_NAME = sequence_number_column_name ]

Especifica el nombre de las columnas que almacenan el número de secuencia de una operación de nivel de fila dentro de la transacción de la tabla. El nombre de columna predeterminado es ledger_sequence_number.

[ OPERATION_TYPE_COLUMN_NAME = operation_type_id column_name ]

Especifica el nombre de las columnas que almacenan el identificador del tipo de operación. El nombre de columna predeterminado es ledger_operation_type.

[ OPERATION_TYPE_DESC_COLUMN_NAME = operation_type_desc_column_name ]

Especifica el nombre de las columnas que almacenan la descripción del tipo de operación. El nombre de columna predeterminado es ledger_operation_type_desc.

Observaciones

Para más información sobre el número de tablas, columnas, restricciones e índices permitidos, vea Especificaciones de capacidad máxima para SQL Server.

Normalmente, el espacio se asigna a las tablas e índices en incrementos de una extensión cada vez. Cuando la opción SET MIXED_PAGE_ALLOCATION de ALTER DATABASE se establece en TRUE, o siempre antes que SQL Server 2016 (13.x), cuando se crea una tabla o un índice, se le asignan páginas de extensiones mixtas hasta que tiene suficientes páginas para llenar una extensión uniforme. Una vez que haya suficientes páginas para llenar una extensión uniforme, se asigna otra extensión cada vez que se llenan las extensiones asignadas actualmente. Para obtener un informe sobre la cantidad de espacio asignado y usado por una tabla, ejecute sp_spaceused.

El Motor de base de datos no exige el orden en que DEFAULT, IDENTITY, ROWGUIDCOL o las restricciones de columna se especifican en una definición de columna.

Al crear una tabla, la opción QUOTED IDENTIFIER siempre se almacena como ON en los metadatos de la tabla incluso si la opción está establecida en OFF al crear la tabla.

Tablas temporales

Se pueden crear tablas temporales locales y globales. Las tablas temporales locales son visibles solo en la sesión actual y las tablas temporales globales son visibles para todas las sesiones. No se pueden crear particiones en las tablas temporales.

Coloque un prefijo de signo de número único (#table_name) en los nombres de las tablas temporales locales y un prefijo de signo de número doble (##table_name) en los nombres de las tablas temporales globales.

Las instrucciones Transact-SQL hacen referencia a la tabla temporal mediante el valor especificado para table_name en la instrucción CREATE TABLE, por ejemplo:

CREATE TABLE #MyTempTable (
    col1 INT PRIMARY KEY
);

INSERT INTO #MyTempTable
VALUES (1);

Si se ha creado más de una tabla temporal en un único procedimiento almacenado o lote, deben tener nombres distintos.

Si incluye un elemento schema_name al crear una tabla temporal o acceder a ella, se omite. Todas las tablas temporales se crean en el esquema dbo.

Si se crea una tabla temporal local en un procedimiento almacenado o una aplicación que varias sesiones pueden ejecutar al mismo tiempo, Motor de base de datos tiene que ser capaz de distinguir las tablas creadas por las distintas sesiones. El Motor de base de datos realiza esto anexando internamente un sufijo numérico a cada nombre de tabla temporal local. El nombre completo de una tabla temporal tal como se almacena en la tabla sys.sysobjects de tempdb consta del nombre de la tabla especificado en la instrucción CREATE TABLE y el sufijo numérico generado por el sistema. Para permitir que se agregue el sufijo, el parámetro table_name especificado para un nombre temporal local no puede superar los 116 caracteres.

Las tablas temporales se quitan automáticamente cuando están fuera de ámbito, a menos que ya se hayan quitado explícitamente mediante el uso de DROP TABLE:

• Una tabla temporal local creada en un procedimiento almacenado se quita automáticamente cuando se completa el procedimiento almacenado. Cualquiera de los procedimientos almacenados anidados ejecutados por el procedimiento almacenado que creó la tabla puede hacer referencia a la tabla. El proceso que llamó al procedimiento almacenado que creó la tabla no puede hacer referencia a la tabla.
• Las demás tablas temporales se quitan automáticamente al final de la sesión actual.
• Las tablas temporales globales se quitan automáticamente cuando la sesión que creó la tabla finaliza y las tareas restantes han dejado de hacer referencia a ellas. La asociación entre una tarea y una tabla se mantiene solo durante la vida de una única instrucción Transact-SQL. Esto significa que la tabla temporal global se quita al finalizar la última instrucción Transact-SQL que estuviera haciendo referencia activa a la tabla cuando finalizó la sesión que la creó.

Una tabla temporal local creada en un procedimiento almacenado o un desencadenador puede tener el mismo nombre que una tabla temporal creada antes de que se llame al procedimiento almacenado o al desencadenador. No obstante, si una consulta hace referencia a una tabla temporal y hay dos tablas temporales con el mismo nombre en ese momento, no está definido en cuál de las dos tablas debe resolverse la consulta. Los procedimientos almacenados anidados pueden crear también tablas temporales con el mismo nombre que la tabla temporal creada por el procedimiento almacenado que la llamó. Sin embargo, en el caso de las modificaciones que se van a resolver en la tabla creada en el procedimiento anidado, la tabla debe tener la misma estructura, con los mismos nombres de columna, que la tabla creada en el procedimiento que realiza la llamada. Esto se muestra en el ejemplo siguiente.

CREATE PROCEDURE dbo.Test2
AS
    CREATE TABLE #t (x INT PRIMARY KEY);
    INSERT INTO #t VALUES (2);
    SELECT Test2Col = x FROM #t;
GO

CREATE PROCEDURE dbo.Test1
AS
    CREATE TABLE #t (x INT PRIMARY KEY);
    INSERT INTO #t VALUES (1);
    SELECT Test1Col = x FROM #t;
    EXEC Test2;
GO

CREATE TABLE #t(x INT PRIMARY KEY);
INSERT INTO #t VALUES (99);
GO

EXEC Test1;
GO

Este es el conjunto de resultados.

(1 row(s) affected)
Test1Col
-----------
1

(1 row(s) affected)
 Test2Col
 -----------
 2

Cuando se crean tablas temporales globales o locales, la sintaxis de CREATE TABLE admite la definición de restricciones, excepto restricciones FOREIGN KEY. Si se especifica una restricción FOREIGN KEY en una tabla temporal, la instrucción devuelve un mensaje de advertencia que indica que la restricción se ha omitido. La tabla se sigue creando sin las restricciones FOREIGN KEY. En las restricciones FOREIGN KEY no se puede hacer referencia a tablas temporales.

Si una tabla temporal se crea con una restricción con nombre y la tabla temporal se crea dentro del ámbito de una transacción definida por el usuario, solo un usuario a la vez puede ejecutar la instrucción que crea la tabla temporal. Por ejemplo, si un procedimiento almacenado crea una tabla temporal con una restricción de clave principal con nombre, el procedimiento almacenado no puede ser ejecutado a la vez por varios usuarios.

Tablas temporales globales con ámbito de base de datos (Azure SQL Database)

Las tablas temporales globales para SQL Server (cuyo nombre de tabla empieza por ##) se almacenan en tempdb y se comparten entre las sesiones de todos los usuarios en toda la instancia de SQL Server. Para más información sobre los tipos de tablas SQL, vea la sección anterior sobre la creación de tablas.

Azure SQL Database admite tablas temporales globales que se almacenan en tempdb y que tienen como ámbito el nivel de base de datos. Esto significa que las tablas temporales globales se comparten entre las sesiones de todos los usuarios en la misma Azure SQL Database. Las sesiones de usuario de otras bases de datos no pueden acceder a tablas temporales globales.

Las tablas temporales globales para Azure SQL Database siguen la misma sintaxis y semántica que usa SQL Server para las tablas temporales. De manera similar, los procedimientos almacenados temporales globales también tienen el ámbito de nivel de base de datos en Azure SQL Database. Las tablas temporales locales (cuyo nombre de tabla empieza por #) también son compatibles con Azure SQL Database y siguen la misma sintaxis y semántica que usa SQL Server. Vea la sección anterior sobre tablas temporales.

Solución de problemas de tablas temporales globales para Azure SQL Database

Para solucionar problemas de tempdb, consulte Supervisión del uso de .

Permisos

Cualquier usuario puede crear objetos temporales globales. Los usuarios solo pueden acceder a sus propios objetos, a menos que reciban permisos adicionales.

Tablas con particiones

Antes de crear una tabla con particiones mediante CREATE TABLE, debe crear una función de partición para especificar cómo se van a crear las particiones en la tabla. Para crear una función de partición se usa CREATE PARTITION FUNCTION. A continuación, debe crear un esquema de partición para especificar los grupos de archivos que van a contener las particiones indicadas mediante la función de partición. Para crear un esquema de partición se usa CREATE PARTITION SCHEME. La colocación de restricciones PRIMARY KEY o UNIQUE para separar grupos de archivos no se puede especificar para las tablas con particiones. Para obtener más información, vea Partitioned Tables and Indexes.

PRIMARY KEY, restricciones

• Una tabla solo puede incluir una restricción PRIMARY KEY.

• El índice generado por una restricción PRIMARY KEY no puede hacer que el número de índices de la tabla supere 999 índices no clúster y 1 índice clúster.

• Si no se especifica CLUSTERED o NONCLUSTERED para una restricción PRIMARY KEY, se utiliza CLUSTERED si no hay índices clúster especificados para las restricciones UNIQUE.

• Todas las columnas definidas en una restricción PRIMARY KEY se deben definir como NOT NULL. Si no se especifica nulabilidad, la nulabilidad de todas las columnas que participan en una restricción PRIMARY KEY se establece en NOT NULL.

  Nota

  Para las tablas optimizadas para memoria, se permite la columna de clave que acepta valores NULL.

• Si la clave principal se define en una columna de tipo definido por el usuario CLR, la implementación del tipo debe admitir el orden binario. Para obtener más información, vea Tipos definidos por el usuario de CLR.

Restricciones UNIQUE

• Si no se especifica CLUSTERED o NONCLUSTERED para una restricción UNIQUE, de forma predeterminada se utiliza NONCLUSTERED.
• Cada restricción UNIQUE genera un índice. El número de restricciones UNIQUE no puede hacer que el número de índices de la tabla supere los 999 índices no clúster y 1 índice clúster.
• Si se define una restricción única en una columna de tipo definido por el usuario CLR, la implementación del tipo debe admitir el orden binario o el orden basado en el operador. Para obtener más información, vea Tipos definidos por el usuario de CLR.

FOREIGN KEY (restricciones)

• Si se especifica un valor distinto de NULL en la columna de una restricción FOREIGN KEY, el valor debe existir en la columna a que se hace referencia; de lo contrario, se devolverá un error de infracción de clave externa.

• Las restricciones FOREIGN KEY se aplican a la columna anterior, a menos que se especifiquen columnas de origen.

• Las restricciones FOREIGN KEY solo pueden hacer referencia a las tablas de la misma base de datos en el mismo servidor. La integridad referencial entre bases de datos debe implementarse a través de desencadenadores. Para obtener más información, vea CREATE TRIGGER.

• Las restricciones FOREIGN KEY pueden hacer referencia a otras columnas de la misma tabla. Esto recibe el nombre de autorreferencia.

• La cláusula REFERENCES de una restricción FOREIGN KEY de nivel de columna solo puede incluir una columna de referencia. Esta columna debe tener el mismo tipo de datos que la columna en la que se define la restricción.

• La cláusula REFERENCES de una restricción FOREIGN KEY de nivel de tabla debe tener el mismo número de columnas de referencia que la lista de columnas de la restricción. El tipo de datos de cada columna de referencia debe ser también el mismo que el de la columna correspondiente de la lista de columnas. Las columnas de referencia se deben especificar en el mismo orden que se ha usado al especificar las columnas de la restricción de clave principal o única en la tabla a la que se hace referencia.

• No se puede especificar CASCADE, SET NULL o SET DEFAULT si una columna de tipo timestamp forma parte de la clave externa o de la clave con referencia.

• CASCADE, SET NULL, SET DEFAULT y NO ACTION se pueden combinar en las tablas con relaciones referenciales entre sí. Si el Motor de base de datos detecta NO ACTION, detiene y revierte las acciones CASCADE, SET NULL y SET DEFAULT relacionadas. Cuando una instrucción DELETE hace que se combinen las acciones CASCADE, SET NULL, SET DEFAULT y NO ACTION, todas las acciones CASCADE, SET NULL y SET DEFAULT se aplican antes de que el Motor de base de datos compruebe la existencia de NO ACTION.

• El Motor de base de datos no tiene un límite predefinido para el número de restricciones FOREIGN KEY que una tabla que hace referencia a otras tablas puede contener, o para el número de restricciones FOREIGN KEY pertenecientes a otras tablas que hacen referencia a una tabla específica.

  No obstante, el número real de restricciones FOREIGN KEY que se puede utilizar está limitado por la configuración del hardware y por el diseño de la base de datos y de la aplicación. Se recomienda que la tabla no contenga más de 253 restricciones FOREIGN KEY y que no más de 253 restricciones FOREIGN KEY hagan referencia a ella. El límite real en cada caso puede variar en función de la aplicación y el hardware. Debe tener en cuenta el costo que supone la exigencia de restricciones FOREIGN KEY al diseñar la base de datos y las aplicaciones.

• Las restricciones FOREIGN KEY no se exigen en tablas temporales.

• Las restricciones FOREIGN KEY solo pueden hacer referencia a columnas de restricciones PRIMARY KEY o UNIQUE de la tabla a la que se hace referencia o a columnas en UNIQUE INDEX de dicha tabla.

• Si la clave externa se define en una columna de tipo definido por el usuario CLR, la implementación del tipo debe admitir el orden binario. Para obtener más información, vea Tipos definidos por el usuario de CLR.

• Las columnas que participan en una relación de claves externas deben estar definidas con la misma longitud y escala.

definiciones DEFAULT

• Una tabla solo puede incluir una definición DEFAULT.

• Una definición DEFAULT puede contener valores constantes, funciones, funciones niládicas estándar de SQL o NULL. En la siguiente tabla se muestran las funciones niládicas y los valores que devuelven para el valor predeterminado durante la ejecución de una instrucción INSERT.

  Función niládica SQL-92	Valor devuelto
  CURRENT_TIMESTAMP	Fecha y hora actuales.
  CURRENT_USER	Nombre del usuario que realiza la inserción.
  SESSION_USER	Nombre del usuario que realiza la inserción.
  SYSTEM_USER	Nombre del usuario que realiza la inserción.
  USER	Nombre del usuario que realiza la inserción.

• En una definición DEFAULT, constant_expression no puede hacer referencia a otra columna de la tabla ni a otras tablas, vistas o procedimientos almacenados.

• Las definiciones DEFAULT no se pueden crear en columnas con un tipo de datos timestamp o en columnas con la propiedad IDENTITY.

• Las definiciones DEFAULT no se pueden crear para columnas con tipos de datos de alias si estos están enlazados a un objeto predeterminado.

CHECK, restricciones

• Una columna puede tener cualquier número de restricciones CHECK y la condición puede incluir varias expresiones lógicas combinadas con AND y OR. Varias restricciones CHECK para una columna se validan en el orden en que se crean.

• La condición de búsqueda debe evaluarse como una expresión booleana y no puede hacer referencia a otra tabla.

• Una restricción CHECK en el nivel de columna solo puede hacer referencia a la columna restringida y una restricción CHECK en el nivel de tabla solo puede hacer referencia a columnas de la misma tabla.

  Las restricciones CHECK y las reglas sirven para la misma función de validación de los datos durante las instrucciones INSERT y UPDATE.

• Cuando hay una regla y una o más restricciones CHECK para una o varias columnas, se evalúan todas las restricciones.

• No se pueden definir restricciones CHECK en columnas text, ntext o image.

Información adicional de restricciones

• Un índice creado para una restricción no se puede quitar mediante con DROP INDEX; la restricción se debe quitar con ALTER TABLE. Un índice creado y utilizado por una restricción se puede volver a generar con ALTER INDEX ... REBUILD. Para obtener más información, vea Reorganizar y volver a generar índices.
• Los nombres de restricción deben seguir las reglas de los identificadores, excepto en que el nombre no puede empezar por un signo de número (#). Si no se proporciona el parámetro constraint_name, se asigna a la restricción un nombre generado por el sistema. El nombre de la restricción aparece en todos los mensajes de error relativos a infracciones de la restricción.
• Cuando se infringe una restricción en una instrucción INSERT, UPDATE o DELETE, la instrucción finaliza. Sin embargo, si SET XACT_ABORT se establece en OFF y la instrucción forma parte de una transacción explícita, continúa el procesamiento de la transacción. Si SET XACT_ABORT se establece en ON, se revierte toda la transacción. La instrucción ROLLBACK TRANSACTION también se puede usar con la definición de transacción al comprobar la función del sistema @@ERROR.
• Si ALLOW_ROW_LOCKS = ON y ALLOW_PAGE_LOCK = ON, se permiten los bloqueos de nivel de fila, página y tabla al obtener acceso al índice. Motor de base de datos elige el bloqueo apropiado y puede cambiar de escala el bloqueo: de un bloqueo de fila o página a un bloqueo de tabla. Si ALLOW_ROW_LOCKS = OFF y ALLOW_PAGE_LOCK = OFF, solo se permite un bloqueo de nivel de tabla al obtener acceso al índice.
• Si una tabla tiene restricciones FOREIGN KEY o CHECK, y desencadenadores, las condiciones de restricción se evalúan antes de que se ejecute el desencadenador.

Para ver un informe sobre una tabla y sus columnas, use sp_help o sp_helpconstraint. Para cambiar el nombre de una tabla, use sp_rename. Para obtener un informe de las vistas y los procedimientos almacenados que dependen de una tabla, use sys.dm_sql_referenced_entities y sys.dm_sql_referencing_entities.

Reglas de nulabilidad en una definición de tabla

La nulabilidad de una columna determina si esa columna puede permitir un valor nulo (NULL) para sus datos. NULL no es cero o en blanco: NULL significa que no se ha especificado ninguna entrada o que se ha proporcionado un valor NULL explícito, y suele implicar que se desconoce el valor o que no es aplicable.

Cuando se utiliza CREATE TABLE o ALTER TABLE para crear o alterar una tabla, la configuración de la base de datos y de la sesión afecta a la nulabilidad del tipo de datos que se utiliza en una definición de columna, e incluso puede anularla. Se recomienda que defina siempre explícitamente una columna como NULL o NOT NULL en el caso de columnas no calculadas o, si utiliza un tipo de datos definido por el usuario, que permita que la columna utilice la nulabilidad predeterminada del tipo de datos. Las columnas dispersas siempre deben permitir valores NULL.

Si la nulabilidad de la columna no se especifica explícitamente, seguirá las reglas que se muestran en la tabla siguiente.

Tipo de datos de columna	Regla
Tipo de datos de alias	Motor de base de datos utiliza la nulabilidad especificada al crear el tipo de datos. Para determinar la nulabilidad predeterminada del tipo de datos, use sp_help.
tipo definido por el usuario CLR	La nulabilidad se determina de acuerdo con la definición de columna.
Tipo de datos suministrado por el sistema	Si el tipo de datos suministrado por el sistema solo tiene una opción, esta tiene prioridad. Los tipos de datos timestamp deben ser NOT NULL. Si la configuración de sesión se establece en ON con SET: ANSI_NULL_DFLT_ON = ON, se asigna NULL. ANSI_NULL_DFLT_OFF = ON, se asigna NOT NULL. Si la base de datos se configura con ALTER DATABASE: ANSI_NULL_DEFAULT_ON = ON, se asigna NULL. ANSI_NULL_DEFAULT_OFF = ON, se asigna NOT NULL. Para ver la configuración de la base de datos para ANSI_NULL_DEFAULT, use la vista de catálogo sys.databases

Cuando ninguna de las opciones ANSI_NULL_DFLT está establecida para la sesión y la base de datos tiene la configuración predeterminada (ANSI_NULL_DEFAULT es OFF), se asigna el valor predeterminado NOT NULL.

En el caso de una columna calculada, el Motor de base de datos determinará automáticamente su nulabilidad. Para determinar la nulabilidad de este tipo de columna, use la función COLUMNPROPERTY con la propiedad AllowsNull.

Compresión de datos

En las tablas del sistema no se puede habilitar la compresión. Cuando se crea una tabla, la compresión de datos se establece en NONE, a menos que se especifique otra cosa. Si se especifica una lista de particiones o una partición que están fuera del intervalo, se generará un error. Para obtener más información sobre la compresión de datos, vea Compresión de datos.

Para evaluar cómo afecta el cambio del estado de compresión a una tabla, índice o partición, use el procedimiento almacenado sp_estimate_data_compression_savings .

Permisos

Se requiere el permiso CREATE TABLE en la base de datos y el permiso ALTER en el esquema en el que se va a crear la tabla.

Si las columnas de la instrucción CREATE TABLE se definen como un tipo definido por el usuario, se necesita el permiso REFERENCES en el tipo definido por el usuario.

Si las columnas de la instrucción CREATE TABLE se definen como un tipo definido por el usuario CLR, se necesita la propiedad del tipo o el permiso REFERENCES.

Si las columnas de la instrucción CREATE TABLE tienen asociada una colección de esquemas XML, se necesita la propiedad de la colección de esquemas XML o el permiso REFERENCES.

Cualquier usuario puede crear tablas temporales en tempdb.

Si la instrucción crea una tabla de libro de contabilidad, se requiere el permiso ENABLE LEDGER.

Ejemplos

A. Crear una restricción PRIMARY KEY en una columna

En el ejemplo siguiente se muestra la definición de columna para una restricción PRIMARY KEY con un índice clúster en la columna EmployeeID de la tabla Employee. Como no se especifica un nombre de restricción, el sistema proporciona el nombre de la restricción.

CREATE TABLE dbo.Employee (
    EmployeeID INT PRIMARY KEY CLUSTERED
);

B. Uso de restricciones FOREIGN KEY

Una restricción FOREIGN KEY se utiliza para hacer referencia a otra tabla. Las claves externas pueden ser claves de una sola columna o de varias columnas. En el siguiente ejemplo se muestra una restricción FOREIGN KEY de una única columna en la tabla SalesOrderHeader que hace referencia a la tabla SalesPerson. Solo se requiere la cláusula REFERENCES para una restricción FOREIGN KEY de una única columna.

SalesPersonID INT NULL REFERENCES SalesPerson(SalesPersonID)

También puede utilizar la cláusula FOREIGN KEY de forma explícita y volver a formular el atributo de columna. No es necesario que el nombre de la columna sea el mismo en ambas tablas.

FOREIGN KEY (SalesPersonID) REFERENCES SalesPerson(SalesPersonID)

Las restricciones de claves de varias columnas se crean como restricciones de tabla. En la base de datos AdventureWorks2022, la tabla SpecialOfferProduct incluye una restricción PRIMARY KEY de varias columnas. En el siguiente ejemplo se muestra cómo hacer referencia a esta clave desde otra tabla; el nombre explícito de restricción es opcional.

CONSTRAINT FK_SpecialOfferProduct_SalesOrderDetail
    FOREIGN KEY (ProductID, SpecialOfferID)
    REFERENCES SpecialOfferProduct (ProductID, SpecialOfferID)

C. Uso de restricciones UNIQUE

Las restricciones UNIQUE se utilizan para exigir la unicidad en las columnas de clave no principal. En el siguiente ejemplo se exige la restricción de que la columna Name de la tabla Product debe ser única.

Name NVARCHAR(100) NOT NULL
UNIQUE NONCLUSTERED

D. Uso de definiciones DEFAULT

Los valores predeterminados suministran un valor (con las instrucciones INSERT y UPDATE) cuando no se especifica ninguno. Por ejemplo, la base de datos AdventureWorks2022 puede incluir una tabla de búsqueda con los distintos trabajos que los empleados pueden realizar en la compañía. En la columna que describe cada trabajo, el valor predeterminado de cadena de caracteres puede suministrar una descripción si no se ha escrito una descripción de forma explícita.

DEFAULT 'New Position - title not formalized yet'

Además de constantes, las definiciones de DEFAULT pueden incluir funciones. Utilice el siguiente ejemplo para obtener la fecha actual de una entrada.

DEFAULT (GETDATE())

Un recorrido de las funciones niládicas puede mejorar también la integridad de los datos. Para realizar un seguimiento del usuario que ha insertado una fila, utilice la función niládica para USER. No escriba las funciones niládicas entre paréntesis.

DEFAULT USER

E. Uso de restricciones CHECK

En el siguiente ejemplo se muestra una restricción para los valores escritos en la columna CreditRating de la tabla Vendor. La restricción no tiene nombre.

CHECK (CreditRating >= 1 and CreditRating <= 5)

En este ejemplo se muestra una restricción con nombre con una restricción de patrón en los datos de caracteres escritos en la columna de la tabla.

CONSTRAINT CK_emp_id CHECK (
    emp_id LIKE '[A-Z][A-Z][A-Z][1-9][0-9][0-9][0-9][0-9][FM]'
    OR emp_id LIKE '[A-Z]-[A-Z][1-9][0-9][0-9][0-9][0-9][FM]'
)

En este ejemplo se especifica que los valores se deben incluir en una lista específica o seguir un patrón dado.

CHECK (
    emp_id IN ('1389', '0736', '0877', '1622', '1756')
    OR emp_id LIKE '99[0-9][0-9]'
)

F. Mostrar la definición de tabla completa

En el siguiente ejemplo se muestran las definiciones de tablas completas con todas las definiciones de restricciones para la tabla PurchaseOrderDetail creada en la base de datos AdventureWorks2022. Para ejecutar el ejemplo, el esquema de tabla se cambia a dbo.

CREATE TABLE dbo.PurchaseOrderDetail
(
    PurchaseOrderID int NOT NULL
        REFERENCES Purchasing.PurchaseOrderHeader(PurchaseOrderID),
    LineNumber smallint NOT NULL,
    ProductID int NULL
        REFERENCES Production.Product(ProductID),
    UnitPrice money NULL,
    OrderQty smallint NULL,
    ReceivedQty float NULL,
    RejectedQty float NULL,
    DueDate datetime NULL,
    rowguid uniqueidentifier ROWGUIDCOL NOT NULL
        CONSTRAINT DF_PurchaseOrderDetail_rowguid DEFAULT (NEWID()),
    ModifiedDate datetime NOT NULL
        CONSTRAINT DF_PurchaseOrderDetail_ModifiedDate DEFAULT (GETDATE()),
    LineTotal AS ((UnitPrice*OrderQty)),
    StockedQty AS ((ReceivedQty-RejectedQty)),
    CONSTRAINT PK_PurchaseOrderDetail_PurchaseOrderID_LineNumber
               PRIMARY KEY CLUSTERED (PurchaseOrderID, LineNumber)
               WITH (IGNORE_DUP_KEY = OFF)
)
ON [PRIMARY];

G. Crear una tabla con una columna xml con tipo en una colección de esquemas XML

En el siguiente ejemplo se crea una tabla con una columna xml con tipo de la colección de esquemas XML HRResumeSchemaCollection. La palabra clave DOCUMENT especifica que cada instancia del tipo de datos xml en column_name solo puede contener un elemento de nivel superior.

CREATE TABLE HumanResources.EmployeeResumes
(
    LName nvarchar(25),
    FName nvarchar(25),
    Resume xml(DOCUMENT HumanResources.HRResumeSchemaCollection)
);

H. Creación de una tabla con particiones

En el ejemplo siguiente se crea una función de partición para crear cuatro particiones en una tabla o en un índice. A continuación, se crea un esquema de partición en el que se especifican los grupos de archivos que van a contener cada una de las cuatro particiones. Finalmente, en el ejemplo se crea una tabla que utiliza el esquema de partición. En este ejemplo se asume que los grupos de archivos ya existen en la base de datos.

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

CREATE PARTITION SCHEME myRangePS1
    AS PARTITION myRangePF1
    TO (test1fg, test2fg, test3fg, test4fg);
GO

CREATE TABLE PartitionTable (col1 int, col2 char(10))
    ON myRangePS1 (col1);
GO

En función de los valores de la columna col1 de PartitionTable, las particiones se asignan de las maneras siguientes.

Grupo de archivos	test1fg	test2fg	test3fg	test4fg
Partición	1	2	3	4
Valores	col 1 <= 1	col1 > 1 AND col1 <= 100	col1 > 100 AND col1 <= 1,000	col1 > 1000

I. Usar el tipo de datos UNIQUEIDENTIFIER en una columna

En el siguiente ejemplo se crea una tabla con una columna uniqueidentifier. En el ejemplo se utiliza una restricción PRIMARY KEY para impedir que los usuarios inserten valores duplicados, y se utiliza la función NEWSEQUENTIALID() de la restricción DEFAULT para proporcionar valores a las nuevas filas. Se aplica la propiedad ROWGUIDCOL a la columna uniqueidentifier de modo que se pueda hacer referencia a la misma mediante la palabra clave $ROWGUID.

CREATE TABLE dbo.Globally_Unique_Data
(
    GUID UNIQUEIDENTIFIER
        CONSTRAINT Guid_Default DEFAULT
        NEWSEQUENTIALID() ROWGUIDCOL,
    Employee_Name VARCHAR(60)
    CONSTRAINT Guid_PK PRIMARY KEY (GUID)
);

J. Usar una expresión para una columna calculada

En el siguiente ejemplo se muestra el uso de una expresión ((low + high)/2) para calcular la columna calculada myavg.

CREATE TABLE dbo.mytable
(
    low INT,
    high INT,
    myavg AS (low + high)/2
);

K. Crear una columna calculada en función de una columna de tipo definido por el usuario

En el siguiente ejemplo se crea una tabla con una columna de tipo definido por el usuario utf8string dando por supuesto que el ensamblado del tipo y el propio tipo ya se han creado en la base de datos actual. Una segunda columna se define en utf8stringfunción de y usa el método ToString() de type(class) utf8string para calcular un valor para la columna.

CREATE TABLE UDTypeTable
(
    u UTF8STRING,
    ustr AS u.ToString() PERSISTED
);

L. Usar la función USER_NAME para una columna calculada

En el siguiente ejemplo se utiliza la función USER_NAME() en la columna myuser_name.

CREATE TABLE dbo.mylogintable
(
    date_in DATETIME,
    user_id INT,
    myuser_name AS USER_NAME()
);

M. Crear una tabla que tenga una columna FILESTREAM

En el ejemplo siguiente se crea una tabla que tiene una columna FILESTREAMPhoto. Si una tabla tiene una o varias columnas FILESTREAM, la tabla debe tener una columna ROWGUIDCOL.

CREATE TABLE dbo.EmployeePhoto
(
    EmployeeId INT NOT NULL PRIMARY KEY,
    Photo VARBINARY(MAX) FILESTREAM NULL,
    MyRowGuidColumn UNIQUEIDENTIFIER NOT NULL ROWGUIDCOL UNIQUE DEFAULT NEWID()
);

Hora Crear una tabla que use compresión de fila

En el ejemplo siguiente se crea una tabla que usa la compresión de fila.

CREATE TABLE dbo.T1
(
    c1 INT,
    c2 NVARCHAR(200)
)
WITH (DATA_COMPRESSION = ROW);

Para obtener más ejemplos de compresión de datos, vea Compresión de datos.

O. Crear una tabla que use compresión XML

Se aplica a SQL Server 2022 (16.x) y versiones posteriores, Azure SQL Database y Azure SQL Managed Instance.

En el ejemplo siguiente se crea una tabla que usa la compresión de XML.

CREATE TABLE dbo.T1
(
    c1 INT,
    c2 XML
)
WITH (XML_COMPRESSION = ON);

P. Crear una tabla que tenga columnas dispersas y un conjunto de columnas

En los ejemplos siguientes se muestra cómo crear una tabla que tenga una columna dispersa y una tabla que tenga dos columnas dispersas y un conjunto de columnas. En los ejemplos se utiliza la sintaxis básica. Para ejemplos más complejos, vea Usar columnas dispersas y Usar conjuntos de columnas.

En este ejemplo se crea una tabla que tiene una columna dispersa.

CREATE TABLE dbo.T1
(
    c1 INT PRIMARY KEY,
    c2 VARCHAR(50) SPARSE NULL
);

En este ejemplo se crea una tabla que tiene dos columnas dispersas y un conjunto de columnas denominado CSet.

CREATE TABLE T1
(
    c1 INT PRIMARY KEY,
    c2 VARCHAR(50) SPARSE NULL,
    c3 INT SPARSE NULL,
    CSet XML COLUMN_SET FOR ALL_SPARSE_COLUMNS
);

Q. Crear una tabla temporal basada en disco con control de versiones del sistema

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, y Azure SQL Database.

En estos ejemplos se muestra cómo crear una tabla temporal vinculada a una nueva tabla de historial y cómo crear una tabla temporal vinculada a una tabla de historial existente. La tabla temporal debe tener definida una clave principal para habilitarla para la tabla para el control de versiones del sistema. Para obtener ejemplos que muestren cómo agregar o quitar versiones del sistema en una tabla existente, vea Control de versiones del sistema en Ejemplos. Para casos de uso, vea Tablas temporales.

En este ejemplo se crea una nueva tabla temporal vinculada a una nueva tabla de historial.

CREATE TABLE Department
(
    DepartmentNumber CHAR(10) NOT NULL PRIMARY KEY CLUSTERED,
    DepartmentName VARCHAR(50) NOT NULL,
    ManagerID INT NULL,
    ParentDepartmentNumber CHAR(10) NULL,
    ValidFrom DATETIME2 GENERATED ALWAYS AS ROW START HIDDEN NOT NULL,
    ValidTo DATETIME2 GENERATED ALWAYS AS ROW END HIDDEN NOT NULL,
    PERIOD FOR SYSTEM_TIME (ValidFrom, ValidTo)
)
WITH (SYSTEM_VERSIONING = ON);

En este ejemplo se crea una nueva tabla temporal vinculada a una tabla de historial existente.

-- Existing table
CREATE TABLE Department_History
(
    DepartmentNumber CHAR(10) NOT NULL,
    DepartmentName VARCHAR(50) NOT NULL,
    ManagerID INT NULL,
    ParentDepartmentNumber CHAR(10) NULL,
    ValidFrom DATETIME2 NOT NULL,
    ValidTo DATETIME2 NOT NULL
);

-- Temporal table
CREATE TABLE Department
(
    DepartmentNumber CHAR(10) NOT NULL PRIMARY KEY CLUSTERED,
    DepartmentName VARCHAR(50) NOT NULL,
    ManagerID INT NULL,
    ParentDepartmentNumber CHAR(10) NULL,
    ValidFrom DATETIME2 GENERATED ALWAYS AS ROW START HIDDEN NOT NULL,
    ValidTo DATETIME2 GENERATED ALWAYS AS ROW END HIDDEN NOT NULL,
    PERIOD FOR SYSTEM_TIME (ValidFrom, ValidTo)
)
WITH (SYSTEM_VERSIONING = ON (HISTORY_TABLE = dbo.Department_History, DATA_CONSISTENCY_CHECK = ON));

R. Crear una tabla temporal optimizada para memoria con control de versiones del sistema

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores, y Azure SQL Database.

En este ejemplo se muestra cómo crear una tabla temporal optimizada para memoria con control de versiones del sistema que esté vinculada a una nueva tabla de historial basada en disco.

En este ejemplo se crea una nueva tabla temporal vinculada a una nueva tabla de historial.

CREATE SCHEMA History;
GO

CREATE TABLE dbo.Department
(
    DepartmentNumber CHAR(10) NOT NULL PRIMARY KEY NONCLUSTERED,
    DepartmentName VARCHAR(50) NOT NULL,
    ManagerID INT NULL,
    ParentDepartmentNumber CHAR(10) NULL,
    ValidFrom DATETIME2 GENERATED ALWAYS AS ROW START HIDDEN NOT NULL,
    ValidTo DATETIME2 GENERATED ALWAYS AS ROW END HIDDEN NOT NULL,
    PERIOD FOR SYSTEM_TIME (ValidFrom, ValidTo)
)
WITH
(
    MEMORY_OPTIMIZED = ON,
    DURABILITY = SCHEMA_AND_DATA,
    SYSTEM_VERSIONING = ON (HISTORY_TABLE = History.DepartmentHistory)
);

En este ejemplo se crea una nueva tabla temporal vinculada a una tabla de historial existente.

-- Existing table
CREATE TABLE Department_History
(
    DepartmentNumber CHAR(10) NOT NULL,
    DepartmentName VARCHAR(50) NOT NULL,
    ManagerID INT NULL,
    ParentDepartmentNumber CHAR(10) NULL,
    ValidFrom DATETIME2 NOT NULL,
    ValidTo DATETIME2 NOT NULL
);

-- Temporal table
CREATE TABLE Department
(
    DepartmentNumber CHAR(10) NOT NULL PRIMARY KEY CLUSTERED,
    DepartmentName VARCHAR(50) NOT NULL,
    ManagerID INT NULL,
    ParentDepartmentNumber CHAR(10) NULL,
    ValidFrom DATETIME2 GENERATED ALWAYS AS ROW START HIDDEN NOT NULL,
    ValidTo DATETIME2 GENERATED ALWAYS AS ROW END HIDDEN NOT NULL,
    PERIOD FOR SYSTEM_TIME (ValidFrom, ValidTo)
)
WITH
(
    SYSTEM_VERSIONING = ON (HISTORY_TABLE = dbo.Department_History, DATA_CONSISTENCY_CHECK = ON)
);

S. Crear una tabla con columnas cifradas

En este ejemplo se crea una tabla con dos columnas cifradas. Para obtener más información, vea Always Encrypted.

CREATE TABLE Customers (
    CustName NVARCHAR(60)
        ENCRYPTED WITH (
            COLUMN_ENCRYPTION_KEY = MyCEK,
            ENCRYPTION_TYPE = RANDOMIZED,
            ALGORITHM = 'AEAD_AES_256_CBC_HMAC_SHA_256'
        ),
    SSN VARCHAR(11) COLLATE Latin1_General_BIN2
        ENCRYPTED WITH (
            COLUMN_ENCRYPTION_KEY = MyCEK,
            ENCRYPTION_TYPE = DETERMINISTIC ,
            ALGORITHM = 'AEAD_AES_256_CBC_HMAC_SHA_256'
        ),
    Age INT NULL
);

T. Crear un índice filtrado en línea

Crea una tabla con un índice filtrado en línea.

CREATE TABLE t1
(
    c1 INT,
    index IX1 (c1) WHERE c1 > 0
);

U. Creación de un índice en línea

A continuación se muestra cómo utilizar NONCLUSTERED en línea para las tablas basadas en disco:

CREATE TABLE t1
(
    c1 INT,
    INDEX ix_1 NONCLUSTERED (c1)
);

CREATE TABLE t2
(
    c1 INT,
    c2 INT INDEX ix_1 NONCLUSTERED
);

CREATE TABLE t3
(
    c1 INT,
    c2 INT,
    INDEX ix_1 NONCLUSTERED (c1,c2)
);

V. Creación de una tabla temporal con una clave principal compuesta anónima

Crea una tabla con una clave principal compuesta anónima. Esto resulta útil para evitar conflictos de tiempo de ejecución en los que dos tablas temporales con ámbito de sesión, cada una en una sesión independiente, usan el mismo nombre para una restricción.

CREATE TABLE #tmp
(
    c1 INT,
    c2 INT,
    PRIMARY KEY CLUSTERED ([c1], [c2])
);
GO

Si asigna un nombre explícitamente a la restricción, la segunda sesión generará un error como el siguiente:

Msg 2714, Level 16, State 5, Line 1
There is already an object named 'PK_#tmp' in the database.
Msg 1750, Level 16, State 1, Line 1
Could not create constraint or index. See previous errors.

El problema surge del hecho de que, si bien el nombre de la tabla temporal es único, los nombres de las restricciones no.

Hora Uso de tablas temporales globales en Azure SQL Database

La sesión A crea una tabla temporal global ##test en testdb1 de Azure SQL Database y agrega una fila

CREATE TABLE ##test (
    a INT,
    b INT
);

INSERT INTO ##test
VALUES (1, 1);

-- Obtain object ID for temp table ##test
SELECT OBJECT_ID('tempdb.dbo.##test') AS 'Object ID';

Este es el conjunto de resultados.

1253579504

Obtención del nombre de la tabla temporal global para un identificador de objeto determinado 1253579504 en tempdb (2)

SELECT name FROM tempdb.sys.objects WHERE object_id = 1253579504;

Este es el conjunto de resultados.

##test

La sesión B se conecta a testdb1 de Azure SQL Database y puede acceder a la tabla ##test creada por la sesión A

SELECT * FROM ##test;

Este es el conjunto de resultados.

1, 1

La sesión C se conecta a otra base de datos testdb2 de Azure SQL Database y quiere acceder a ##test creada en testdb1. Esta selección genera un error debido al ámbito de la base de datos de las tablas temporales globales.

SELECT * FROM ##test

Esto genera el error siguiente:

Msg 208, Level 16, State 0, Line 1
Invalid object name '##test'

Direccionar el objeto de sistema en tempdb de Azure SQL Database desde testdb1 de la base de datos del usuario actual

SELECT * FROM tempdb.sys.objects;
SELECT * FROM tempdb.sys.columns;
SELECT * FROM tempdb.sys.database_files;

X. Habilitación de la directiva de retención de datos en una tabla

En el ejemplo siguiente se crea una tabla con retención de datos habilitada y un período de retención de una semana. Este ejemplo solo se aplica a Azure SQL Edge.

CREATE TABLE [dbo].[data_retention_table]
(
  [dbdatetime2] datetime2(7),
  [product_code] int,
  [value] char(10)
)
WITH (DATA_DELETION = ON ( FILTER_COLUMN = [dbdatetime2], RETENTION_PERIOD = 1 WEEKS ))

Y. Creación de una tabla actualizable del libro de contabilidad

En el ejemplo siguiente se crea una tabla de libro de contabilidad actualizable que no es una tabla temporal con una tabla de historial anónima (el sistema generará el nombre de la tabla de historial) y el nombre de la vista de libro de contabilidad generada. Como no se especifican los nombres de las columnas siempre generadas necesarias y las columnas adicionales de la vista de libro de contabilidad, las columnas tendrán los nombres predeterminados.

CREATE SCHEMA [HR];
GO
CREATE TABLE [HR].[Employees]
(
    EmployeeID INT NOT NULL,
    Salary Money NOT NULL
)
WITH (SYSTEM_VERSIONING = ON, LEDGER = ON);
GO

En el ejemplo siguiente se crea una tabla que es una tabla temporal y una tabla de libro de contabilidad actualizable, con una tabla de historial anónima (con un nombre generado por el sistema), el nombre de vista de libro de contabilidad generado y los nombres predeterminados de las columnas siempre generadas y las columnas de vista de libro de contabilidad adicionales.

CREATE SCHEMA [HR];
GO
CREATE TABLE [HR].[Employees]
(
    EmployeeID INT NOT NULL PRIMARY KEY,
    Salary Money NOT NULL,
    ValidFrom DATETIME2 GENERATED ALWAYS AS ROW START HIDDEN NOT NULL,
    ValidTo DATETIME2 GENERATED ALWAYS AS ROW END HIDDEN NOT NULL,
    PERIOD FOR SYSTEM_TIME (ValidFrom, ValidTo)
)
WITH (SYSTEM_VERSIONING = ON, LEDGER = ON);
GO

En el ejemplo siguiente se crea una tabla que es una tabla temporal y una tabla de libro de contabilidad actualizable con la tabla de historial con nombre explícito, el nombre especificado por el usuario de la vista de libro de contabilidad y los nombres especificados por el usuario de columnas siempre generadas y columnas adicionales en la vista de libro de contabilidad.

CREATE SCHEMA [HR];
GO
CREATE TABLE [HR].[Employees]
(
    EmployeeID INT NOT NULL PRIMARY KEY,
    Salary Money NOT NULL,
    StartTransactionId BIGINT GENERATED ALWAYS AS TRANSACTION_ID START HIDDEN NOT NULL,
    EndTransactionId BIGINT GENERATED ALWAYS AS TRANSACTION_ID END HIDDEN NULL,
    StartSequenceNumber BIGINT GENERATED ALWAYS AS SEQUENCE_NUMBER START HIDDEN NOT NULL,
    EndSequenceNumber BIGINT GENERATED ALWAYS AS SEQUENCE_NUMBER END HIDDEN NULL,
    ValidFrom DATETIME2 GENERATED ALWAYS AS ROW START HIDDEN NOT NULL,
    ValidTo DATETIME2 GENERATED ALWAYS AS ROW END HIDDEN NOT NULL,
    PERIOD FOR SYSTEM_TIME (ValidFrom, ValidTo)
)
WITH (
    SYSTEM_VERSIONING = ON (HISTORY_TABLE = [HR].[EmployeesHistory]),
    LEDGER = ON (
        LEDGER_VIEW = [HR].[EmployeesLedger] (
            TRANSACTION_ID_COLUMN_NAME = TransactionId,
            SEQUENCE_NUMBER_COLUMN_NAME = SequenceNumber,
            OPERATION_TYPE_COLUMN_NAME = OperationId,
            OPERATION_TYPE_DESC_COLUMN_NAME = OperationTypeDescription
        )
    )
);
GO

En el ejemplo siguiente se crea una tabla de libro de contabilidad de solo anexar con los nombres generados de la vista de libro de contabilidad y las columnas de la vista de libro de contabilidad.

CREATE SCHEMA [AccessControl];
GO
CREATE TABLE [AccessControl].[KeyCardEvents]
(
    EmployeeID INT NOT NULL,
    AccessOperationDescription NVARCHAR (MAX) NOT NULL,
    [Timestamp] Datetime2 NOT NULL,
    StartTransactionId BIGINT GENERATED ALWAYS AS TRANSACTION_ID START HIDDEN NOT NULL,
    StartSequenceNumber BIGINT GENERATED ALWAYS AS SEQUENCE_NUMBER START HIDDEN NOT NULL
)
WITH (
    LEDGER = ON (
        LEDGER_VIEW = [AccessControl].[KeyCardEventsLedger] (
            TRANSACTION_ID_COLUMN_NAME = TransactionId,
            SEQUENCE_NUMBER_COLUMN_NAME = SequenceNumber,
            OPERATION_TYPE_COLUMN_NAME = OperationId,
            OPERATION_TYPE_DESC_COLUMN_NAME = OperationTypeDescription
        ),
        APPEND_ONLY = ON
    )
);
GO

En el ejemplo siguiente se crea una base de datos de libro de contabilidad en Azure SQL Database y una tabla de libro de contabilidad actualizable con la configuración predeterminada. La creación de una tabla de libro de contabilidad actualizable en una base de datos de libro de contabilidad no requiere el uso de WITH (SYSTEM_VERSIONING = ON, LEDGER = ON);.

CREATE DATABASE MyLedgerDB ( EDITION = 'GeneralPurpose' ) WITH LEDGER = ON;
GO

CREATE SCHEMA [HR];
GO

CREATE TABLE [HR].[Employees]
(
    EmployeeID INT NOT NULL,
    Salary Money NOT NULL
)
GO

Contenido relacionado

• ALTER TABLE
• COLUMNPROPERTY
• CREATE INDEX
• CREATE VIEW
• Tipos de datos
• DROP INDEX
• sys.dm_sql_referenced_entities
• sys.dm_sql_referencing_entities
• DROP TABLE
• CREATE PARTITION FUNCTION
• CREATE PARTITION SCHEME
• CREATE TYPE
• EVENTDATA
• sp_help
• sp_helpconstraint
• sp_rename
• sp_spaceused