sql output

22/11/13

OUTPUT (cláusula de Transact-SQL)

Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo
para ver el texto original. Más información.

Traducción

Original

OUTPUT (cláusula de Transact-SQL)
SQL Server 2012

Personas que lo han encontrado útil: 1 de 1

Devuelve información de las filas afectadas por una instrucción INSERT, UPDATE,DELETE o MERGE, o expresiones basadas
en esas filas. Estos resultados se pueden devolver a la aplicación de procesamiento para que los utilice en mensajes de
confirmación, archivado y otros requisitos similares de una aplicación. Los resultados también se pueden insertar en una
tabla o variable de tabla. Además, puede capturar los resultados de una cláusula OUTPUT en una instrucción anidada
INSERT,UPDATE, DELETE o MERGE, e insertar los resultados en una tabla de destino o vista.
Nota
Una instrucción UPDATE, INSERT o DELETE que tenga una cláusula OUTPUT devolverá filas al cliente aunque la
instrucción encuentre errores y se revierta. El resultado no se debe usar si se produce algún error al ejecutar la
instrucción.
Se utiliza en:
DELETE
INSERT
UPDATE
MERGE
Convenciones de sintaxisde Transact-SQL

Sintaxis

::=
{
[ OUTPUT INTO { @table_variable | output_table } [ ( column_list ) ] ]
[ OUTPUT ]
}
::=
{ | scalar_expression } [ [AS] column_alias_identifier ]
[ ,...n ]
::=
{ DELETED | INSERTED | from_table_name } . { * | column_name }
| $action

Argumentos
@table_variable

msdn.microsoft.com/es-es/library/ms177564.aspx

1/14

22/11/13

OUTPUT(cláusula de Transact-SQL)

@table_variable
Especifica una variable table en la que se insertan las filas devueltas en lugar de devolverse al autor de la
llamada. Debe declararse @table_variable antes de la instrucción INSERT, UPDATE, DELETE o MERGE.
Si no se especifica column_list, la variable table debe tener el mismo número de columnas que el conjunto de
resultados OUTPUT. Las excepcionesson las columnas de identidad y calculadas, que deben omitirse. Si se
especifica column_list, las columnas omitidas deben aceptar valores NULL o tener valores predeterminados
asignados.
Para obtener más información acerca de las variables table, vea table (Transact-SQL).
output_table
Especifica una tabla en la que se insertan las filas devueltas en lugar de devolverse al autor de la llamada.output_table puede ser una tabla temporal.
Si no se especifica column_list, la tabla debe tener el mismo número de columnas que el conjunto de resultados
OUTPUT. Las excepciones son las columnas de identidad y calculadas. Éstas deben omitirse. Si se especifica
column_list, las columnas omitidas deben aceptar valores NULL o tener valores predeterminados asignados.
output_table no puede:
Tenerdefinidos desencadenadores habilitados.
Participar en alguna de las partes de una restricción FOREIGN KEY.
Tener restricciones CHECK o reglas habilitadas.
column_list
Es una lista opcional de nombres de columna de la tabla de destino de la cláusula INTO. Es equivalente a la lista
de columnas permitida en la instrucción INSERT.
scalar_expression
Es cualquier combinación de símbolos yoperadores que se evalúa como un solo valor. No se permiten funciones
de agregado en scalar_expression.
Cualquier referencia a las columnas de la tabla que se va a modificar debe calificarse con el prefijo INSERTED o
DELETED.
column_alias_identifier
Es un nombre alternativo que se utiliza para hacer referencia al nombre de columna.
DELETED
Es un prefijo de columna que especifica el valor eliminadoen la operación de actualización o eliminación. Las
columnas con prefijo DELETED reflejan el valor antes de que se complete la instrucción UPDATE, DELETE o
MERGE.
DELETED no se puede utilizar con la cláusula OUTPUT en la instrucción INSERT.
INSERTED
Es un prefijo de columna que especifica el valor agregado en la operación de inserción o actualización. Las
columnas con prefijo INSERTED...