OUTPUT 절(Transact-SQL)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

INSERT, UPDATE, DELETE 또는 MERGE 문의 영향을 받는 각 행의 정보 또는 각 행을 기반으로 하는 식을 반환합니다. 이러한 결과를 처리 애플리케이션에 반환하여 확인 메시지, 보관 및 기타 애플리케이션 요구 사항을 충족시키는 데 사용할 수 있습니다. 결과를 테이블 또는 테이블 변수에 삽입할 수도 있습니다. 또한 중첩된 INSERT, UPDATE, DELETE 또는 MERGE 문에서 절의 OUTPUT 결과를 캡처하고 해당 결과를 대상 테이블 또는 뷰에 삽입할 수 있습니다.

참고 항목

절이 있는 UPDATE, INSERT 또는 DELETE 문은 OUTPUT 문이 오류가 발생하고 롤백되더라도 클라이언트에 행을 반환합니다. 문을 실행할 때 오류가 발생하는 경우 결과를 사용하면 안 됩니다.

사용 대상:

Transact-SQL 구문 표기 규칙

Syntax

<OUTPUT_CLAUSE> ::=
{
    [ OUTPUT <dml_select_list> INTO { @table_variable | output_table } [ ( column_list ) ] ]
    [ OUTPUT <dml_select_list> ]
}
<dml_select_list> ::=
{ <column_name> | scalar_expression } [ [ AS ] column_alias_identifier ]
    [ , ...n ]

<column_name> ::=
{ DELETED | INSERTED | from_table_name } . { * | column_name }
    | $action

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

@table_variable

반환된 행이 호출자에게 반환되는 대신 삽입되는 table 변수를 지정합니다. @table_variable INSERT, UPDATE, DELETE 또는 MERGE 문 앞에 선언해야 합니다.

column_list 지정하지 않으면 테이블 변수의 열 수가 결과 집합과 OUTPUT 같아야 합니다. 단, ID 및 계산 열은 건너뛰므로 예외입니다. column_list가 지정되면 생략된 모든 열에 Null 값을 허용하거나 기본값을 할당해야 합니다.

table 변수에 대한 자세한 내용은 table(Transact-SQL)을 참조하세요.

output_table

반환된 행을 호출자에 반환하는 대신 삽입할 테이블을 지정합니다. output_table은 임시 테이블일 수 있습니다.

column_list 지정하지 않으면 테이블의 열 수가 결과 집합과 OUTPUT 같아야 합니다. 단, ID 및 계산 열은 예외이며 이 열은 건너뛰어야 합니다. column_list가 지정되면 생략된 모든 열에 Null 값을 허용하거나 기본값을 할당해야 합니다.

output_table 다음을 수행할 수 없습니다.

  • 활성화된 트리거를 정의할 수 없습니다.
  • FOREIGN KEY 제약 조건의 어느 쪽에도 참여할 수 없습니다.
  • CHECK 제약 조건 또는 활성화된 규칙을 가질 수 없습니다.

column_list

INTO 절의 대상 테이블에 있는 열 이름의 선택적 목록입니다. INSERT 문에서 허용되는 열 목록과 비슷합니다.

scalar_expression

단일 값으로 계산되는 기호와 연산자의 조합입니다. 집계 함수는 scalar_expression 허용되지 않습니다.

수정되는 테이블의 열에 대한 모든 참조는 INSERTED 또는 DELETED 접두사를 사용해 정규화되어야 합니다.

column_alias_identifier

열 이름을 참조하는 데 사용되는 대체 이름입니다.

DELETED

업데이트 또는 삭제 작업으로 삭제된 값을 지정하는 열 접두사입니다. DELETED가 접두사로 사용된 열은 UPDATE, DELETE 또는 MERGE 문이 완료되기 이전의 값을 반영합니다.

DELETED는 INSERT 문의 절과 함께 OUTPUT 사용할 수 없습니다.

INSERTED

삽입 또는 업데이트 작업에서 추가한 값을 지정하는 열 접두사입니다. INSERTED가 접두사로 사용된 열은 UPDATE, INSERT 또는 MERGE 문이 완료되었으나 트리거가 실행되기 이전의 값을 반영합니다.

INSERTED는 DELETE 문의 절과 함께 OUTPUT 사용할 수 없습니다.

from_table_name

업데이트하거나 삭제할 행을 지정하는 데 사용되는 DELETE, UPDATE 또는 MERGE 문의 FROM 절에 포함된 테이블을 지정하는 열 접두사입니다.

변경되는 테이블을 FROM 절에도 지정할 경우 해당 테이블의 열에 대한 모든 참조는 INSERTED 또는 DELETED 접두사를 사용해 정규화해야 합니다.

*

삭제 * , 삽입 또는 업데이트 작업의 영향을 받는 모든 열이 테이블에 있는 순서대로 반환되도록 지정합니다.

예를 들어 다음 DELETE 문에서 OUTPUT DELETED.*ShoppingCartItem 테이블에서 삭제된 모든 열을 반환합니다.

DELETE Sales.ShoppingCartItem
    OUTPUT DELETED.*;

column_name

명시적 열 참조입니다. 수정되는 테이블에 대한 모든 참조는 INSERTED 또는 DELETED 접두사로 적절히 한정되어야 합니다(예: INSERTED.column_name).

$action

MERGE 문에만 사용할 수 있습니다. 해당 행에서 OUTPUT 수행된 작업에 따라 각 행에 대해 'INSERT', 'UPDATE' 또는 'DELETE'의 세 값 중 하나를 반환하는 MERGE 문의 절에 nvarchar(10) 형식의 열을 지정합니다.

설명

절과 절은 OUTPUT <dml_select_list>OUTPUT <dml_select_list> INTO { @table_variable | output_table } 단일 INSERT, UPDATE, DELETE 또는 MERGE 문으로 정의할 수 있습니다.

참고 항목

달리 지정하지 않는 한 절에 대한 참조는 OUTPUT 절과 절을 모두 OUTPUT 참조합니다 OUTPUT INTO .

이 절은 OUTPUT INSERT 또는 UPDATE 작업 후 ID 또는 계산 열의 값을 검색하는 데 유용할 수 있습니다.

계산 열이 포함된 <dml_select_list>경우 출력 테이블 또는 테이블 변수의 해당 열은 계산 열이 아닙니다. 새 열의 값은 문이 실행된 시점에 계산된 값입니다.

변경 내용이 테이블에 적용되는 순서와 행이 출력 테이블 또는 테이블 변수에 삽입되는 순서가 해당한다는 보장은 없습니다.

매개 변수 또는 변수가 UPDATE 문의 OUTPUT 일부로 수정된 경우 절은 수정된 값 대신 문이 실행되기 전과 마찬가지로 항상 매개 변수 또는 변수의 값을 반환합니다.

WHERE CURRENT OF 구문을 사용하는 커서에 배치된 UPDATE 또는 DELETE 문과 함께 사용할 OUTPUT 수 있습니다.

절은 OUTPUT 다음 문에서 지원되지 않습니다.

  • 분할된 로컬 뷰, 배포된 분할된 뷰 또는 원격 테이블을 참조하는 DML 문

  • EXECUTE 문이 포함된 INSERT 문

  • 데이터베이스 호환성 수준이 100으로 설정된 경우 절에는 OUTPUT 전체 텍스트 조건자가 허용되지 않습니다.

  • 이 절은 OUTPUT INTO 뷰 또는 행 집합 함수에 삽입하는 데 사용할 수 없습니다.

  • 테이블이 대상으로 있는 INTO 절이 포함된 OUTPUT 경우 사용자 정의 함수를 만들 수 없습니다.

비결정적 동작을 방지하기 위해 절에는 OUTPUT 다음 참조가 포함될 수 없습니다.

  • 사용자 또는 시스템 데이터 액세스를 수행하거나 이러한 액세스를 수행하는 것으로 간주되는 하위 쿼리 또는 사용자 정의 함수입니다. 사용자 정의 함수는 스키마에 바인딩되지 않은 경우 데이터 액세스를 수행하는 것으로 간주됩니다.

  • 해당 열이 다음 중 한 가지 방법으로 정의된 경우 뷰 또는 인라인 테이블 반환 함수의 열입니다.

    • 하위 쿼리

    • 사용자 또는 시스템 데이터 액세스를 수행하거나 이러한 액세스를 수행하는 것으로 간주되는 사용자 정의 함수

    • 해당 정의에서 사용자 또는 시스템 데이터 액세스를 수행하는 사용자 정의 함수가 포함된 계산 열

    SQL Server가 절에서 OUTPUT 이러한 열을 검색하면 오류 4186이 발생합니다.

OUTPUT 절에서 반환된 데이터를 테이블에 삽입합니다.

중첩된 INSERT, UPDATE, DELETE 또는 MERGE 문에서 절의 OUTPUT 결과를 캡처하고 해당 결과를 대상 테이블에 삽입하는 경우 다음 정보를 염두에 두어야 합니다.

  • 전체 작업은 원자성을 갖습니다. INSERT 문과 절이 포함된 OUTPUT 중첩된 DML 문이 모두 실행되거나 전체 문이 실패합니다.

  • 다음과 같은 제한 사항이 외부 INSERT 문의 대상에 적용됩니다.

    • 대상은 원격 테이블, 뷰 또는 공통 테이블 식일 수 없습니다.

    • 대상에는 FOREIGN KEY 제약 조건이 있거나 FOREIGN KEY 제약 조건에 의해 참조될 수 없습니다.

    • 트리거는 대상에 정의할 수 없습니다.

    • 대상은 트랜잭션 복제본(replica) 대한 병합 복제본(replica)tion 또는 updatable 구독에 참여할 수 없습니다.

  • 다음과 같은 제한 사항이 중첩된 DML 문에 적용됩니다.

    • 대상은 원격 테이블 또는 분할된 뷰일 수 없습니다.

    • 원본 자체에 절을 <dml_table_source> 포함할 수 없습니다.

  • 절이 OUTPUT INTO 포함된 <dml_table_source> INSERT 문에서는 이 절이 지원되지 않습니다.

  • @@ROWCOUNT 는 외부 INSERT 문에 의해서만 삽입된 행을 반환합니다.

  • @@IDENTITY, SCOPE_IDENTITYIDENT_CURRENT 중첩된 DML 문에 의해서만 생성되고 외부 INSERT 문에 의해 생성된 값이 아닌 ID 값을 반환합니다.

  • 외부 INSERT 문 자체에서 크게 변경된 경우에도 쿼리 알림은 문을 단일 엔터티로 취급하며 작성되는 메시지의 유형은 중첩된 DML의 유형이 됩니다.

  • <dml_table_source> 절에서 SELECT 및 WHERE 절에는 하위 쿼리, 집계 함수, 순위 함수, 전체 텍스트 조건자, 데이터 액세스를 수행하는 사용자 정의 함수 또는 TEXTPTR() 함수를 포함할 수 없습니다.

병렬 처리

OUTPUT 클라이언트 또는 테이블 변수에 결과를 반환하는 절은 항상 직렬 계획을 사용합니다.

호환성 수준 130 이상으로 설정된 데이터베이스의 컨텍스트에서 작업에서 SELECT 문에 대한 힌트를 사용하고 WITH (TABLOCK) 임시 또는 사용자 테이블에 삽입하는 데 사용하는 OUTPUT...INTO 경우 INSERT...SELECT 하위 트리 비용에 따라 대상 테이블 INSERT...SELECT 이 병렬 처리에 적합합니다. 절에서 OUTPUT INTO 참조되는 대상 테이블은 병렬 처리에 적합하지 않습니다.

트리거

INSERT, UPDATE 또는 DELETE 문이 완료된 후 트리거가 실행되기 전의 데이터에서 반환 OUTPUT 된 열은 데이터를 반영합니다.

INSTEAD OF 트리거의 경우 트리거 작업의 결과로 아무런 수정 사항이 없음에도 불구하고 INSERT, UPDATE 또는 DELETE가 실제로 발생한 것처럼 반환 결과가 생성됩니다. 절을 포함하는 OUTPUT 문이 트리거 본문 내에 사용되는 경우 삽입 및 삭제된 트리거 테이블을 참조하는 데 테이블 별칭을 사용하여 INSERTED 및 DELETED 테이블과 연결된 열 참조가 중복되지 OUTPUT않도록 해야 합니다.

INTO 키워드(keyword) OUTPUT 지정하지 않고 절을 지정하는 경우 DML 작업의 대상에는 지정된 DML 작업에 대해 정의된 활성화된 트리거가 있을 수 없습니다. 예를 들어 절이 OUTPUT UPDATE 문에 정의된 경우 대상 테이블에 활성화된 UPDATE 트리거가 있을 수 없습니다.

sp_configure 트리거의 결과를 허용하지 않는 옵션이 설정 OUTPUT 되면 INTO 절이 없는 절은 트리거 내에서 호출될 때 문이 실패합니다.

데이터 유형

이 절은 OUTPUT nvarchar(max), varchar(max), varbinary(max), text, ntext, image 및 xml같은 큰 개체 데이터 형식을 지원합니다. UPDATE 문의 절을 .WRITE 사용하여 nvarchar(max), varchar(max) 또는 varbinary(max) 열을 수정하는 경우 값의 전체 전후 이미지가 참조되는 경우 반환됩니다. 함수는 TEXTPTR() 절의 텍스트, ntext 또는 이미지 열에 대한 식의 OUTPUT 일부로 표시할 수 없습니다.

테이블을 큐로 사용하는 애플리케이션에서 사용 OUTPUT 하거나 중간 결과 집합을 저장할 수 있습니다. 이 경우 애플리케이션은 지속적으로 테이블에 행을 추가하거나 제거합니다. 다음 예제에서는 DELETE 문의 절을 사용하여 OUTPUT 삭제된 행을 호출 애플리케이션에 반환합니다.

USE AdventureWorks2022;
GO

DELETE TOP(1) dbo.DatabaseLog WITH (READPAST)
OUTPUT DELETED.*
WHERE DatabaseLogID = 7;
GO

이 예에서는 큐로 사용되는 테이블에서 행을 삭제하고 삭제된 값을 처리하는 애플리케이션에 반환하는 과정을 한 번의 작동으로 수행합니다. 이 밖에도 스택 구현을 위해 테이블을 사용하는 등 다른 응용도 가능합니다. 그러나 SQL Server는 절을 사용하여 OUTPUT DML 문에서 행을 처리하고 반환하는 순서를 보장하지 않습니다. 원하는 용도에 맞게 적절한 WHERE 절을 포함하거나 DML 작업에 여러 행을 사용하기 위해 적절히 정규화할 책임은 애플리케이션의 몫입니다. 다음 예에서는 하위 쿼리를 사용하며 필요한 정렬 구현을 위해 각 DatabaseLogID 열이 고유한 특성을 가짐을 가정합니다.

USE tempdb;
GO

CREATE TABLE dbo.table1
(
    id INT,
    employee VARCHAR(32)
);
GO
  
INSERT INTO dbo.table1
VALUES (1, 'Fred'),
    (2, 'Tom'),
    (3, 'Sally'),
    (4, 'Alice');
GO
  
DECLARE @MyTableVar TABLE (
    id INT,
    employee VARCHAR(32)
);

PRINT 'table1, before delete';

SELECT *
FROM dbo.table1;

DELETE
FROM dbo.table1
OUTPUT DELETED.*
INTO @MyTableVar
WHERE id = 4
    OR id = 2;

PRINT 'table1, after delete';

SELECT *
FROM dbo.table1;

PRINT '@MyTableVar, after delete';

SELECT *
FROM @MyTableVar;

DROP TABLE dbo.table1;

결과는 다음과 같습니다.

table1, before delete
id          employee
----------- ------------------------------
1           Fred
2           Tom
3           Sally
4           Alice

table1, after delete
id          employee
----------- ------------------------------
1           Fred
3           Sally

@MyTableVar, after delete
id          employee
----------- ------------------------------
2           Tom
4           Alice

참고 항목

여러 개의 애플리케이션에서 한 테이블에 대해 파괴 읽기를 허용하는 경우 UPDATE 및 DELETE 문에서 READPAST 테이블 힌트를 사용하세요. 이렇게 하면 다른 애플리케이션이 이미 테이블의 첫 번째 정규화 레코드를 읽고 있는 경우 발생할 수 있는 잠금 문제를 방지합니다.

사용 권한

SELECT 권한은 <dml_select_list>를 통해 검색되거나 <scalar_expression>에서 사용되는 모든 열에 필요합니다.

INSERT 권한은 <output_table>에 지정된 모든 테이블에 필요합니다.

예제

A. INSERT 문과 함께 OUTPUT INTO 사용

다음 예에서는 ScrapReason 테이블에 행을 삽입하고 OUTPUT 절을 사용하여 문의 결과를 @MyTableVar 테이블 변수에 반환합니다. 열이 ScrapReasonID IDENTITY 속성으로 정의되므로 해당 열에 대한 문에 값이 INSERT 지정되지 않습니다. 그러나 해당 열에 대한 데이터베이스 엔진 생성된 값은 열의 OUTPUT 절에 INSERTED.ScrapReasonID반환됩니다.

USE AdventureWorks2022;
GO

DECLARE @MyTableVar TABLE (
    NewScrapReasonID SMALLINT,
    Name VARCHAR(50),
    ModifiedDate DATETIME);
    
INSERT Production.ScrapReason
    OUTPUT INSERTED.ScrapReasonID, INSERTED.Name, INSERTED.ModifiedDate
        INTO @MyTableVar
VALUES (N'Operator error', GETDATE());
  
--Display the result set of the table variable.
SELECT NewScrapReasonID, Name, ModifiedDate FROM @MyTableVar;
--Display the result set of the table.
SELECT ScrapReasonID, Name, ModifiedDate
FROM Production.ScrapReason;
GO

B. DELETE 문과 함께 OUTPUT 사용

다음 예에서는 ShoppingCartItem 테이블의 모든 행을 삭제합니다. 이 절 OUTPUT DELETED.* 은 삭제된 행의 DELETE 모든 열인 문의 결과가 호출 애플리케이션에 반환되도록 지정합니다. 이어지는 SELECT 문은 ShoppingCartItem 테이블의 삭제 작업 결과를 확인합니다.

USE AdventureWorks2022;
GO

DELETE Sales.ShoppingCartItem
OUTPUT DELETED.*
WHERE ShoppingCartID = 20621;
  
--Verify the rows in the table matching the WHERE clause have been deleted.
SELECT COUNT(*) AS [Rows in Table] FROM Sales.ShoppingCartItem WHERE ShoppingCartID = 20621;
GO

C. UPDATE 문과 함께 OUTPUT INTO 사용

다음 예에서는 VacationHours 테이블에 있는 처음 10개 행의 Employee 열을 25% 업데이트합니다. OUTPUT 절은 DELETED.VacationHours 열에서 UPDATE 문을 적용하기 전에 존재했던 VacationHours의 값과 INSERTED.VacationHours 열에서 업데이트된 값을 @MyTableVar 테이블 변수에 반환합니다.

다음 두 SELECT 문은 테이블의 업데이트 작업 Employee 결과와 값을 @MyTableVar 반환합니다.

USE AdventureWorks2022;
GO
  
DECLARE @MyTableVar TABLE (
    EmpID INT NOT NULL,
    OldVacationHours INT,
    NewVacationHours INT,
    ModifiedDate DATETIME);
  
UPDATE TOP (10) HumanResources.Employee
SET VacationHours = VacationHours * 1.25,
    ModifiedDate = GETDATE()
OUTPUT INSERTED.BusinessEntityID,
       DELETED.VacationHours,
       INSERTED.VacationHours,
       INSERTED.ModifiedDate
INTO @MyTableVar;
  
--Display the result set of the table variable.
SELECT EmpID, OldVacationHours, NewVacationHours, ModifiedDate
FROM @MyTableVar;
GO
--Display the result set of the table.
SELECT TOP (10) BusinessEntityID, VacationHours, ModifiedDate
FROM HumanResources.Employee;
GO

D. OUTPUT INTO를 사용하여 식 반환

예 3을 기반으로 만들어진 다음 예에서는 업데이트된 OUTPUT 값과 업데이트가 적용되기 이전의 VacationHours 값 간의 차이를 나타내는 식을 VacationHours 절에 정의합니다. 이 식의 값은 VacationHoursDifference 열의 @MyTableVar 테이블 변수에 반환됩니다.

USE AdventureWorks2022;
GO

DECLARE @MyTableVar TABLE (
    EmpID INT NOT NULL,
    OldVacationHours INT,
    NewVacationHours INT,
    VacationHoursDifference INT,
    ModifiedDate DATETIME);
  
UPDATE TOP (10) HumanResources.Employee
SET VacationHours = VacationHours * 1.25,
    ModifiedDate = GETDATE()
OUTPUT INSERTED.BusinessEntityID,
       DELETED.VacationHours,
       INSERTED.VacationHours,
       INSERTED.VacationHours - DELETED.VacationHours,
       INSERTED.ModifiedDate
INTO @MyTableVar;
  
--Display the result set of the table variable.
SELECT EmpID, OldVacationHours, NewVacationHours,
    VacationHoursDifference, ModifiedDate
FROM @MyTableVar;
GO
SELECT TOP (10) BusinessEntityID, VacationHours, ModifiedDate
FROM HumanResources.Employee;
GO

E. UPDATE 문에서 from_table_name OUTPUT INTO 사용

다음 예제에서는 지정된 ProductIDScrapReasonID가 있는 모든 작업 순서에 대해 WorkOrder 테이블의 ScrapReasonID 열을 업데이트합니다. OUTPUT INTO 절은 업데이트되는 테이블인 WorkOrder의 값과 더불어 Product 테이블의 값을 반환합니다. 업데이트할 행을 지정하기 위해 Product 테이블이 FROM 절에 사용됩니다. WorkOrder 테이블에는 AFTER UPDATE 트리거가 정의되어 있으므로 INTO 키워드가 필요합니다.

USE AdventureWorks2022;
GO

DECLARE @MyTestVar TABLE (
    OldScrapReasonID INT NOT NULL,
    NewScrapReasonID INT NOT NULL,
    WorkOrderID INT NOT NULL,
    ProductID INT NOT NULL,
    ProductName NVARCHAR(50)NOT NULL);
  
UPDATE Production.WorkOrder
SET ScrapReasonID = 4
OUTPUT DELETED.ScrapReasonID,
       INSERTED.ScrapReasonID,
       INSERTED.WorkOrderID,
       INSERTED.ProductID,
       p.Name
    INTO @MyTestVar
FROM Production.WorkOrder AS wo
    INNER JOIN Production.Product AS p
    ON wo.ProductID = p.ProductID
    AND wo.ScrapReasonID= 16
    AND p.ProductID = 733;
  
SELECT OldScrapReasonID, NewScrapReasonID, WorkOrderID,
    ProductID, ProductName
FROM @MyTestVar;
GO

F. DELETE 문에서 from_table_name OUTPUT INTO 사용

다음 예에서는 ProductProductPhoto 문의 FROM 절에 정의된 검색 조건에 따라 DELETE 테이블의 행을 삭제합니다. OUTPUT 절은 삭제되는 테이블인 DELETED.ProductIDDELETED.ProductPhotoID의 열과 더불어 Product 테이블의 열을 반환합니다. 이 테이블은 FROM 절에서 삭제할 행을 지정하기 위해 사용됩니다.

USE AdventureWorks2022;
GO

DECLARE @MyTableVar TABLE (
    ProductID INT NOT NULL,
    ProductName NVARCHAR(50)NOT NULL,
    ProductModelID INT NOT NULL,
    PhotoID INT NOT NULL);
  
DELETE Production.ProductProductPhoto
OUTPUT DELETED.ProductID,
       p.Name,
       p.ProductModelID,
       DELETED.ProductPhotoID
    INTO @MyTableVar
FROM Production.ProductProductPhoto AS ph
JOIN Production.Product as p
    ON ph.ProductID = p.ProductID
    WHERE p.ProductModelID BETWEEN 120 and 130;
  
--Display the results of the table variable.
SELECT ProductID, ProductName, ProductModelID, PhotoID
FROM @MyTableVar
ORDER BY ProductModelID;
GO

G. 큰 개체 데이터 형식으로 OUTPUT INTO 사용

다음 예에서는 DocumentSummary 절을 사용해 nvarchar(max) 테이블의 Production.Document 열인 .WRITE의 부분 값을 업데이트합니다. 대체 단어, 기존 데이터에서 대체할 단어의 시작 위치(오프셋), 그리고 대체할 문자 수(길이)를 지정함으로써 componentsfeatures로 대체됩니다. 이 예제에서는 OUTPUT 절을 사용해 DocumentSummary 열의 이전 및 이후 이미지를 @MyTableVar 테이블 변수에 반환합니다. 열의 DocumentSummary 전체 전후 이미지가 반환됩니다.

USE AdventureWorks2022;
GO

DECLARE @MyTableVar TABLE (
    SummaryBefore NVARCHAR(max),
    SummaryAfter NVARCHAR(max));
  
UPDATE Production.Document
SET DocumentSummary .WRITE (N'features',28,10)
OUTPUT DELETED.DocumentSummary,
       INSERTED.DocumentSummary
    INTO @MyTableVar
WHERE Title = N'Front Reflector Bracket Installation';
  
SELECT SummaryBefore, SummaryAfter
FROM @MyTableVar;
GO

H. INSTEAD OF 트리거에서 OUTPUT 사용

다음 예에서는 트리거에 OUTPUT 절을 사용하여 트리거 작업 결과를 반환합니다. 먼저 ScrapReason 테이블에서 뷰를 만들고 해당 뷰에서 사용자가 기본 테이블의 INSTEAD OF INSERT 열만 수정할 수 있게 하는 Name 트리거를 정의합니다. ScrapReasonID 열은 기본 테이블의 IDENTITY 열이기 때문에 트리거는 사용자가 제공한 값을 무시합니다. 대신 데이터베이스 엔진이 자동으로 올바른 값을 생성합니다. 또한 사용자가 제공한 ModifiedDate 값 역시 무시되고 현재 날짜로 설정됩니다. OUTPUT 절은 ScrapReason 테이블에 실제로 삽입된 값을 반환합니다.

USE AdventureWorks2022;
GO

IF OBJECT_ID('dbo.vw_ScrapReason', 'V') IS NOT NULL
    DROP VIEW dbo.vw_ScrapReason;
GO

CREATE VIEW dbo.vw_ScrapReason
AS
SELECT ScrapReasonID,
    Name,
    ModifiedDate
FROM Production.ScrapReason;
GO

CREATE TRIGGER dbo.io_ScrapReason ON dbo.vw_ScrapReason
INSTEAD OF INSERT
AS
BEGIN
    --ScrapReasonID is not specified in the list of columns to be inserted
    --because it is an IDENTITY column.
    INSERT INTO Production.ScrapReason (
        Name,
        ModifiedDate
    )
    OUTPUT INSERTED.ScrapReasonID,
        INSERTED.Name,
        INSERTED.ModifiedDate
    SELECT Name, GETDATE()
    FROM INSERTED;
END
GO

INSERT vw_ScrapReason (
    ScrapReasonID,
    Name,
    ModifiedDate
)
VALUES (
    99,
    N'My scrap reason',
    '20030404'
);
GO

다음은 2004년 4월 12일('2004-04-12')에 생성된 결과 집합입니다. ScrapReasonIDActualModifiedDate 열은 INSERT 문에서 제공된 값 대신 트리거 작업에 의해 생성된 값을 반영합니다.

ScrapReasonID  Name             ModifiedDate
-------------  ---------------- -----------------------
17             My scrap reason  2004-04-12 16:23:33.050

9\. ID 및 계산 열에 OUTPUT INTO 사용

다음 예에서는 EmployeeSales 테이블을 만들고 INSERT 문에 SELECT 문을 사용하여 이 테이블에 여러 개의 행을 삽입한 후 원본 테이블에서 데이터를 검색합니다. EmployeeSales 테이블에는 ID 열(EmployeeID)과 계산 열(ProjectedSales)이 포함되어 있습니다.

USE AdventureWorks2022;
GO

IF OBJECT_ID('dbo.EmployeeSales', 'U') IS NOT NULL
    DROP TABLE dbo.EmployeeSales;
GO

CREATE TABLE dbo.EmployeeSales (
    EmployeeID INT IDENTITY(1, 5) NOT NULL,
    LastName NVARCHAR(20) NOT NULL,
    FirstName NVARCHAR(20) NOT NULL,
    CurrentSales MONEY NOT NULL,
    ProjectedSales AS CurrentSales * 1.10
);
GO

DECLARE @MyTableVar TABLE (
    EmployeeID INT NOT NULL,
    LastName NVARCHAR(20) NOT NULL,
    FirstName NVARCHAR(20) NOT NULL,
    CurrentSales MONEY NOT NULL,
    ProjectedSales MONEY NOT NULL
);

INSERT INTO dbo.EmployeeSales (
    LastName,
    FirstName,
    CurrentSales
)
OUTPUT INSERTED.EmployeeID,
    INSERTED.LastName,
    INSERTED.FirstName,
    INSERTED.CurrentSales,
    INSERTED.ProjectedSales
INTO @MyTableVar
SELECT c.LastName,
    c.FirstName,
    sp.SalesYTD
FROM Sales.SalesPerson AS sp
INNER JOIN Person.Person AS c
    ON sp.BusinessEntityID = c.BusinessEntityID
WHERE sp.BusinessEntityID LIKE '2%'
ORDER BY c.LastName,
    c.FirstName;

SELECT EmployeeID,
    LastName,
    FirstName,
    CurrentSales,
    ProjectedSales
FROM @MyTableVar;
GO

SELECT EmployeeID,
    LastName,
    FirstName,
    CurrentSales,
    ProjectedSales
FROM dbo.EmployeeSales;
GO

J. 단일 문에서 OUTPUT 및 OUTPUT INTO 사용

다음 예에서는 ProductProductPhoto 문의 FROM 절에 정의된 검색 조건에 따라 DELETE 테이블의 행을 삭제합니다. OUTPUT INTO 절은 삭제되는 테이블(DELETED.ProductIDDELETED.ProductPhotoID)의 열과 Product 테이블의 열을 @MyTableVar 테이블 변수에 반환합니다. Product 테이블은 FROM 절에서 삭제할 행을 지정하기 위해 사용됩니다. OUTPUT 절은 DELETED.ProductIDDELETED.ProductPhotoID 열, 그리고 ProductProductPhoto 테이블에서 행을 삭제한 날짜 및 시간을 호출하는 애플리케이션에 반환합니다.

USE AdventureWorks2022;
GO

DECLARE @MyTableVar TABLE (
    ProductID INT NOT NULL,
    ProductName NVARCHAR(50) NOT NULL,
    ProductModelID INT NOT NULL,
    PhotoID INT NOT NULL
);

DELETE Production.ProductProductPhoto
OUTPUT DELETED.ProductID,
    p.Name,
    p.ProductModelID,
    DELETED.ProductPhotoID
INTO @MyTableVar
OUTPUT DELETED.ProductID,
    DELETED.ProductPhotoID,
    GETDATE() AS DeletedDate
FROM Production.ProductProductPhoto AS ph
INNER JOIN Production.Product AS p
    ON ph.ProductID = p.ProductID
WHERE p.ProductID BETWEEN 800
        AND 810;

--Display the results of the table variable.
SELECT ProductID,
    ProductName,
    PhotoID,
    ProductModelID
FROM @MyTableVar;
GO

11. OUTPUT 절에서 반환된 데이터 삽입

다음 예에서는 OUTPUT 문의 MERGE 절에서 반환되는 데이터를 캡처하고 이 데이터를 다른 테이블에 삽입합니다. MERGE 문은 Quantity 테이블에서 처리하는 순서대로 ProductInventory 테이블의 SalesOrderDetail 열을 매일 업데이트합니다. 또한 재고가 감소 0 하는 제품의 행도 삭제합니다. 이 예에서는 삭제된 행을 캡처한 후 다른 ZeroInventory 테이블에 삽입하여 재고가 없는 제품을 추적합니다.

USE AdventureWorks2022;
GO

IF OBJECT_ID(N'Production.ZeroInventory', N'U') IS NOT NULL
    DROP TABLE Production.ZeroInventory;
GO

--Create ZeroInventory table.
CREATE TABLE Production.ZeroInventory (
    DeletedProductID INT,
    RemovedOnDate DATETIME
    );
GO

INSERT INTO Production.ZeroInventory (
    DeletedProductID,
    RemovedOnDate
)
SELECT ProductID,
    GETDATE()
FROM (
    MERGE Production.ProductInventory AS pi
    USING (
        SELECT ProductID,
            SUM(OrderQty)
        FROM Sales.SalesOrderDetail AS sod
        INNER JOIN Sales.SalesOrderHeader AS soh
            ON sod.SalesOrderID = soh.SalesOrderID
                AND soh.OrderDate = '20070401'
        GROUP BY ProductID
        ) AS src(ProductID, OrderQty)
        ON (pi.ProductID = src.ProductID)
    WHEN MATCHED
        AND pi.Quantity - src.OrderQty <= 0
        THEN
            DELETE
    WHEN MATCHED
        THEN
            UPDATE
            SET pi.Quantity = pi.Quantity - src.OrderQty
    OUTPUT $ACTION,
        DELETED.ProductID
    ) AS Changes(Action, ProductID)
WHERE Action = 'DELETE';

IF @@ROWCOUNT = 0
    PRINT 'Warning: No rows were inserted';
GO

SELECT DeletedProductID,
    RemovedOnDate
FROM Production.ZeroInventory;
GO

다음 단계