UPDATE(Transact-SQL)

적용 대상: Microsoft Fabric의 SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW) 웨어하우스

SQL Server에서 테이블 또는 뷰의 기존 데이터를 변경합니다. 예제를 보려면 예제를 참조하세요.

Transact-SQL 구문 표기 규칙

구문

-- Syntax for SQL Server and Azure SQL Database  

[ WITH <common_table_expression> [...n] ]  
UPDATE   
    [ TOP ( expression ) [ PERCENT ] ]   
    { { table_alias | <object> | rowset_function_limited   
         [ WITH ( <Table_Hint_Limited> [ ...n ] ) ]  
      }  
      | @table_variable      
    }  
    SET  
        { column_name = { expression | DEFAULT | NULL }  
          | { udt_column_name.{ { property_name = expression  
                                | field_name = expression }  
                                | method_name ( argument [ ,...n ] )  
                              }  
          }  
          | column_name { .WRITE ( expression , @Offset , @Length ) }  
          | @variable = expression  
          | @variable = column = expression  
          | column_name { += | -= | *= | /= | %= | &= | ^= | |= } expression  
          | @variable { += | -= | *= | /= | %= | &= | ^= | |= } expression  
          | @variable = column { += | -= | *= | /= | %= | &= | ^= | |= } expression  
        } [ ,...n ]   
  
    [ <OUTPUT Clause> ]  
    [ FROM{ <table_source> } [ ,...n ] ]   
    [ WHERE { <search_condition>   
            | { [ CURRENT OF   
                  { { [ GLOBAL ] cursor_name }   
                      | cursor_variable_name   
                  }   
                ]  
              }  
            }   
    ]   
    [ OPTION ( <query_hint> [ ,...n ] ) ]  
[ ; ]  
  
<object> ::=  
{   
    [ server_name . database_name . schema_name .   
    | database_name .[ schema_name ] .   
    | schema_name .  
    ]  
    table_or_view_name}  

-- Syntax for Azure Synapse Analytics and Microsoft Fabric

[ WITH <common_table_expression> [ ,...n ] ]
UPDATE [ database_name . [ schema_name ] . | schema_name . ] table_name
SET { column_name = { expression | NULL } } [ ,...n ]  
FROM [ database_name . [ schema_name ] . | schema_name . ] table_name   
JOIN {<join_table_source>}[ ,...n ] 
ON <join_condition>
[ WHERE <search_condition> ]   
[ OPTION ( LABEL = label_name ) ]  
[;]  

<join_table_source> ::=   
{  
    [ database_name . [ schema_name ] . | schema_name . ] table_or_view_name [ AS ] table_or_view_alias 
    [ <tablesample_clause>]  
    | derived_table [ AS ] table_alias [ ( column_alias [ ,...n ] ) ]  
}  

-- Syntax for Parallel Data Warehouse

UPDATE [ database_name . [ schema_name ] . | schema_name . ] table_name   
SET { column_name = { expression | NULL } } [ ,...n ]  
[ FROM from_clause ]  
[ WHERE <search_condition> ]   
[ OPTION ( LABEL = label_name ) ]  
[;]  

인수

WITH <common_table_expression>
UPDATE 문의 범위 내에서 정의된 임시 명명된 결과 집합 또는 뷰를 지정합니다. 이를 CTE(공통 테이블 식)라고 합니다. CTE 결과 집합은 단순 쿼리에서 파생되며 UPDATE 문에서 참조됩니다.

공통 테이블 식은 SELECT, INSERT, DELETE 및 CREATE VIEW 문에서도 사용됩니다. 자세한 내용은 WITH common_table_expression (Transact-SQL)을 참조하세요.

TOP ( expression) [ PERCENT ]
업데이트할 행의 수 또는 비율을 지정합니다. expression 은 행의 수 또는 비율일 수 있습니다.

INSERT, UPDATE 또는 DELETE와 함께 사용된 TOP 식에서 참조된 행은 어떠한 순서로도 정렬되지 않습니다.

INSERT, UPDATE 및 DELETE 문에는 TOP에서 expression을 구분하는 괄호가 필요합니다. 자세한 내용은 TOP(Transact-SQL)을 참조하세요.

table_alias
행을 업데이트할 테이블 또는 뷰를 나타내는 UPDATE 절에 지정되는 별칭입니다.

server_name
테이블이나 뷰가 위치한 서버의 이름입니다. 연결된 서버 이름 또는 OPENDATASOURCE 함수를 서버 이름으로 사용합니다. server_name이 지정되면 database_name과 schema_name이 필요합니다.

database_name
데이터베이스의 이름입니다.

schema_name
테이블이나 뷰가 속한 스키마의 이름입니다.

table_or_view_name
행을 업데이트할 테이블 또는 뷰의 이름입니다. table_or_view_name에서 참조되는 뷰는 업데이트가 가능해야 하며 해당 뷰의 FROM 절에서 정확히 하나의 기본 테이블을 참조해야 합니다. 업데이트할 수 있는 뷰에 대한 자세한 내용은 CREATE VIEW(Transact-SQL)를 참조하세요.

rowset_function_limited
공급자 기능에 관련된 OPENQUERY 또는 OPENROWSET 함수입니다.

WITH (<Table_Hint_Limited>)
대상 테이블에 허용되는 하나 이상의 테이블 힌트를 지정합니다. WITH 키워드와 괄호가 필요합니다. NOLOCK, READUNCOMMITTED, NOEXPAND 및 기타 여러 가지는 허용되지 않습니다. 테이블 힌트에 대한 자세한 내용은 테이블 힌트(Transact-SQL)를 참조하세요.

@table_variable
테이블 원본으로 table 변수를 지정합니다.

SET
업데이트할 열이나 변수 이름의 목록을 지정합니다.

column_name
변경할 데이터가 포함된 열입니다. column_name은 table_or view_name에 있어야 합니다. ID 열은 업데이트할 수 없습니다.

expression
단일 값을 반환하는 변수, 리터럴 값, 식 또는 괄호로 묶인 하위 SELECT 문입니다. expression에서 반환된 값이 column_name 또는@variable의 기존 값을 대체합니다.

참고

nchar, nvarchar 및 ntext 유니코드 문자 데이터 형식을 참조할 때는 'expression' 앞에 대문자 'N'이 접두사로 와야 합니다. 'N'을 지정하지 않으면 SQL Server에서 데이터베이스 또는 열의 기본 데이터 정렬에 해당하는 코드 페이지로 문자열을 변환합니다. 이 코드 페이지에 없는 문자는 모두 손실됩니다.

DEFAULT
열에 정의한 기본값이 열의 기존 값을 대체하도록 지정합니다. 열에 기본값이 없고 NULL 값을 허용하도록 정의한 경우, 열을 NULL로 변경하는 데 사용할 수도 있습니다.

{ +=*=-= | | | /=%= | | &= } | ^= | |=
복합 할당 연산자:
+= 더하기 및 할당
-= 빼기 및 할당
*= 곱하기 및 할당
/= 나누기 및 할당
%= 나머지 및 할당
&= 비트 AND 및 할당
^= 비트 XOR 및 할당
|= 비트 OR 및 할당

udt_column_name
사용자 정의 형식의 열입니다.

property_name | field_name
사용자 정의 형식의 공용 속성 또는 공용 데이터 멤버입니다.

method_name ( 인수 [ ,... n] )
하나 이상의 인수를 사용하는 udt_column_name의 비정적 공용 변경자(mutator) 메서드입니다.

.WRITE (expression,@Offset,@Length)
column_name 값의 섹션이 수정되도록 지정합니다. expression이 column_name의 @Offset부터 @Length 단위를 대체합니다. varchar(max) , nvarchar(max) 또는 varbinary(max) 의 열만 이 절을 사용하여 지정될 수 있습니다. column_name은 NULL일 수 없으며 테이블 이름 또는 테이블 별칭으로 정규화될 수 없습니다.

expression은 column_name에 복사된 값입니다. expression은 column_name 형식으로 평가되거나 암시적으로 이러한 데이터 형식으로 변환될 수 있어야 합니다. expression을 NULL로 설정하면 @Length가 무시되고 column_name의 값이 지정된 @Offset에서 잘립니다.

@Offset은 expression이 쓰일 column_name에 저장되는 값의 시작점입니다. @Offset은 0부터 시작하는 서수 바이트 위치이고 bigint이며 음수가 될 수 없습니다. @Offset이 NULL이면 업데이트 작업 시 기존 column_name 값 끝에 expression이 추가되고 @Length는 무시됩니다. @Offset이 column_name 값의 바이트 길이보다 크면 데이터베이스 엔진에서 오류를 반환합니다. @Offset에 @Length를 더한 값이 열의 기본 값 길이를 초과하면 값의 마지막 문자까지 삭제됩니다.

@Length는 @Offset부터 expression으로 대체될 열 섹션의 길이입니다. @Length는 bigint이며 음수일 수 없습니다. @Length가 NULL이면 업데이트 작업 시 @Offset부터 column_name 값의 끝까지 모든 데이터를 제거합니다.

자세한 내용은 뒷부분의 큰 값 데이터 형식 업데이트를 참조하세요.

@ variable
expression에서 반환된 값으로 설정한 선언된 변수입니다.

SET @variable = column = expression은 열과 동일한 값으로 변수를 설정합니다. 이것은 변수를 이미 업데이트한 열 값으로 설정하는 SET @variable = column, column = expression과는 다릅니다.

<OUTPUT_Clause>
UPDATE 작업의 일부로서 업데이트된 데이터 또는 이를 바탕으로 한 식을 반환합니다. OUTPUT 절은 원격 테이블 또는 뷰를 대상으로 하는 어떤 DML 문에서도 지원되지 않습니다. 이 절의 인수 및 동작에 대한 자세한 내용은 OUTPUT 절(Transact-SQL)을 참조하세요.

FROM <table_source>
업데이트 작업의 기준이 될 테이블, 뷰 또는 파생된 테이블 원본을 지정합니다. 자세한 내용은 FROM(Transact-SQL)을 참조하세요.

업데이트되는 개체가 FROM 절의 개체와 같고 개체에 대한 참조가 FROM 절에 하나만 있는 경우, 개체 별칭은 지정될 수도 있고 지정되지 않을 수도 있습니다. 업데이트되는 개체가 FROM 절에서 두 번 이상 나타날 경우 개체에 대한 단 한 번의 참조로 테이블 별칭을 지정할 수는 없습니다. FROM 절의 개체에 대한 다른 모든 참조에는 개체 별칭이 포함되어야 합니다.

INSTEAD OF UPDATE 트리거가 있는 뷰는 FROM 절이 있는 UPDATE의 대상이 될 수 없습니다.

참고

FROM 절에서 OPENDATASOURCE, OPENQUERY 또는 OPENROWSET에 대한 모든 호출은 두 호출에 동일한 인수가 제공되는 경우에도 업데이트의 대상으로 사용되는 함수에 대한 호출과는 개별적이고 독립적으로 평가됩니다. 특히 이러한 호출 중 하나의 결과에 적용되는 필터 또는 조인 조건은 다른 호출의 결과에 영향을 미치지 않습니다.

WHERE
업데이트되는 열을 제한하는 조건을 지정합니다. 어떤 형식의 WHERE 절을 사용하는가에 따라 다음 두 가지 업데이트 형식이 있습니다.

• 검색 결과 업데이트 - 삭제할 행을 제한하는 검색 조건을 지정합니다.

• 현재 위치 업데이트 - 커서를 지정하는 CURRENT OF 절을 사용합니다. 이 경우 커서의 현재 위치에서 업데이트 작업이 이루어집니다.

<search_condition>
업데이트할 행을 결정하는 조건을 지정합니다. 조인을 기반으로 하는 조건도 검색 조건으로 사용할 수 있습니다. 검색 조건에 포함시킬 수 있는 조건자의 개수에는 제한이 없습니다. 조건자 및 검색 조건에 대한 자세한 내용은 검색 조건(Transact-SQL)을 참조하세요.

CURRENT OF
지정한 커서의 현재 위치에서 업데이트가 수행되도록 지정합니다.

WHERE CURRENT OF 절을 사용하여 현재 위치 업데이트를 수행하면 커서의 현재 위치에서 단일 행을 업데이트합니다. 이것은 WHERE <search_condition> 절을 사용하여 업데이트될 행을 제한하는 검색 결과 업데이트보다 정확한 방법입니다. 검색 결과 업데이트는 검색 조건이 단일 행을 고유하게 식별하지 못할 경우 여러 행을 변경할 수 있습니다.

GLOBAL
cursor_name이 전역 커서를 참조하도록 지정합니다.

cursor_name
인출이 수행되는 열린 커서의 이름입니다. 이름이 cursor_name인 전역 커서와 로컬 커서가 모두 있는 경우 이 인수는 GLOBAL이 지정되면 전역 커서를 참조하고, 그렇지 않으면 로컬 커서를 참조합니다. 커서는 업데이트될 수 있어야 합니다.

cursor_variable_name
커서 변수의 이름입니다. cursor_variable_name은 업데이트를 허용하는 커서를 참조해야 합니다.

OPTION (<query_hint> [ ,... n ] )
데이터베이스 엔진이 문을 처리하는 방식을 사용자 지정하기 위한 최적화 프로그램 힌트를 지정합니다. 자세한 내용은 쿼리 힌트(Transact-SQL)를 참조하세요.

모범 사례

@@ROWCOUNT 함수를 사용하여 클라이언트 애플리케이션에 삽입된 행의 수를 반환할 수 있습니다. 자세한 내용은 (Transact-SQL)를 참조하세요.

UPDATE 문에서 변수 이름을 사용하면 영향을 받는 이전 값과 새로운 값을 표시할 수 있지만 이는 UPDATE 문이 단일 레코드에 영향을 줄 경우에만 사용할 수 있는 방법입니다. UPDATE 문이 여러 개의 레코드에 영향을 주는 경우 각각의 레코드에 대한 이전 값 및 새로운 값을 반환하려면 OUTPUT 절을 사용합니다.

업데이트 작업의 기준을 제공하는 FROM 절을 지정할 때는 주의해야 합니다. 업데이트되는 각 열에 대해 하나의 값만 가능하도록 지정되지 않은 FROM 절이 문에 포함된 경우(즉, UPDATE 문이 비결정적인 경우) UPDATE 문의 결과가 정의되지 않습니다. 예를 들어 다음 스크립트의 UPDATE 문에서 Table1에 있는 두 행이 UPDATE 문의 FROM 절 조건을 충족하지만 Table1의 행을 업데이트하기 위해 Table2.의 어떤 행을 사용할 것인지는 정의되지 않았습니다.

USE AdventureWorks2022;  
GO  
IF OBJECT_ID ('dbo.Table1', 'U') IS NOT NULL  
    DROP TABLE dbo.Table1;  
GO  
IF OBJECT_ID ('dbo.Table2', 'U') IS NOT NULL  
    DROP TABLE dbo.Table2;  
GO  
CREATE TABLE dbo.Table1   
    (ColA INT NOT NULL, ColB DECIMAL(10,3) NOT NULL);  
GO  
CREATE TABLE dbo.Table2   
    (ColA INT PRIMARY KEY NOT NULL, ColB DECIMAL(10,3) NOT NULL);  
GO  
INSERT INTO dbo.Table1 VALUES(1, 10.0), (1, 20.0);  
INSERT INTO dbo.Table2 VALUES(1, 0.0);  
GO  
UPDATE dbo.Table2   
SET dbo.Table2.ColB = dbo.Table2.ColB + dbo.Table1.ColB  
FROM dbo.Table2   
    INNER JOIN dbo.Table1   
    ON (dbo.Table2.ColA = dbo.Table1.ColA);  
GO  
SELECT ColA, ColB   
FROM dbo.Table2;  

FROM 및 WHERE CURRENT OF 절을 함께 사용할 때도 같은 문제가 발생합니다. 다음 예에서 Table2 테이블의 두 행은 FROM 문에 있는 UPDATE 절의 조건을 충족시킵니다. 하지만 Table2의 행을 업데이트하기 위해 Table1의 어떤 행을 사용할 것인지는 정의되지 않았습니다.

USE AdventureWorks2022;  
GO  
IF OBJECT_ID ('dbo.Table1', 'U') IS NOT NULL  
    DROP TABLE dbo.Table1;  
GO  
IF OBJECT_ID ('dbo.Table2', 'U') IS NOT NULL  
    DROP TABLE dbo.Table2;  
GO  
CREATE TABLE dbo.Table1  
    (c1 INT PRIMARY KEY NOT NULL, c2 INT NOT NULL);  
GO  
CREATE TABLE dbo.Table2  
    (d1 INT PRIMARY KEY NOT NULL, d2 INT NOT NULL);  
GO  
INSERT INTO dbo.Table1 VALUES (1, 10);  
INSERT INTO dbo.Table2 VALUES (1, 20), (2, 30);  
GO  
DECLARE abc CURSOR LOCAL FOR  
    SELECT c1, c2   
    FROM dbo.Table1;  
OPEN abc;  
FETCH abc;  
UPDATE dbo.Table1   
SET c2 = c2 + d2   
FROM dbo.Table2   
WHERE CURRENT OF abc;  
GO  
SELECT c1, c2 FROM dbo.Table1;  
GO  

호환성 지원

UPDATE 또는 DELETE 문의 대상 테이블에 적용되는 FROM 절의 READUNCOMMITTED 및 NOLOCK 힌트 사용 지원은 SQL Server의 이후 버전에서 제거될 예정입니다. 새 개발 작업에서는 이 컨텍스트에서 이러한 힌트를 사용하지 않도록 하고 현재 이 힌트를 사용하는 애플리케이션은 수정하세요.

데이터 형식

모든 char 및 nchar 열은 정의된 길이에 맞도록 오른쪽이 채워집니다.

ANSI_PADDING이 OFF로 설정되면 varchar 및 nvarchar 열에 삽입되는 데이터에서 후행 공백을 제거합니다(공백만 있는 문자열은 예외). 공백만 있는 문자열은 빈 문자열로 잘립니다. ANSI_PADDING이 ON으로 설정되면 후행 공백이 삽입됩니다. Microsoft SQL Server ODBC 드라이버와 SQL Server용 OLE DB 공급자는 각 연결에 대해 ANSI_PADDING ON을 자동 설정합니다. 이 설정은 ODBC 데이터 원본이나 연결 특성 또는 속성을 통해 구성할 수 있습니다. 자세한 내용은 SET ANSI_PADDING(Transact-SQL)을 참조하세요.

text, ntext 및 image 열 업데이트

열을 NULL로 업데이트하는 경우를 제외하고, UPDATE로 text, ntext 또는 image 열을 변경하면 열이 초기화되고 유효한 텍스트 포인터가 할당됩니다.

text, ntext 또는 image 데이터를 대체 또는 수정하려면 UPDATE 문 대신에 WRITETEXT 또는 UPDATETEXT를 사용합니다.

UPDATE 문이 클러스터링 키와 한 개 이상의 text, ntext 또는 image 열을 함께 업데이트하는 경우, 이러한 열의 부분 업데이트는 값을 모두 대체하게 됩니다.

중요

ntext, text및 image 데이터 형식은 Microsoft SQL Server이후 버전에서 제거됩니다. 향후 개발 작업에서는 이 데이터 형식을 사용하지 않도록 하고 현재 이 데이터 형식을 사용하는 애플리케이션은 수정하세요. 대신 nvarchar(max), varchar(max)및 varbinary(max) 를 사용합니다.

큰 값 데이터 형식 업데이트

.WRITE (expression,@Offset,@Length) 절을 사용하여 varchar(max), nvarchar(max) 및 varbinary(max) 데이터 형식의 부분 또는 전체 업데이트를 수행합니다.

예를 들어 varchar(max) 열의 부분 업데이트를 통해 열의 처음 200바이트(ASCII 문자를 사용하는 경우 200자)만 삭제 또는 변경할 수 있으며, 전체 업데이트를 통해서는 열의 모든 데이터를 삭제하거나 수정할 수 있습니다. .WRITE는 데이터베이스 복구 모델이 대량 로그 또는 단순으로 설정되면 새 데이터의 삽입 또는 추가를 최소 로깅하도록 업데이트합니다. 기존 값이 업데이트되면 최소 로깅이 사용되지 않습니다. 자세한 내용은 트랜잭션 로그(SQL Server)를 참조하세요.

데이터베이스 엔진은 UPDATE 문이 다음 중 한 가지 동작을 유발할 때 부분 업데이트를 전체 업데이트로 변환합니다.

• 분할된 뷰 또는 테이블의 키 열을 변경합니다.
• 하나 이상의 행을 변경하고 고유하지 않은 클러스터형 인덱스의 키를 상수가 아닌 값으로 업데이트합니다.

.WRITE 절을 사용하여 NULL 열을 업데이트하거나 column_name의 값을 NULL로 설정할 수 없습니다.

@Offset 및 @Length는 varbinary 및 varchar 데이터 형식의 경우 바이트 단위로 지정되고, nvarchar 데이터 형식의 경우 바이트 쌍 단위로 지정됩니다. 문자열 데이터 형식 길이에 대한 자세한 내용은 char 및 varchar(Transact-SQL) 및 nchar 및 nvarchar(Transact-SQL)를 참조하세요.

최상의 성능을 위해 8,040바이트의 배수인 청크 크기로 데이터를 삽입 또는 업데이트하는 것이 좋습니다.

.WRITE 절로 수정된 열을 OUTPUT 절에서 참조하면 열의 전체 값, 즉 deleted.column_name의 이전 이미지 또는 inserted.column_name의 이후 이미지가 테이블 변수에 지정된 열로 반환됩니다. 뒷부분의 예제 R을 참조하세요.

다른 문자 또는 binary 데이터 형식에 대해 .WRITE의 기능과 동일한 결과를 얻으려면 STUFF(Transact-SQL)를 사용합니다.

사용자 정의 형식 열 업데이트

다음 중 한 가지 방법으로 사용자 정의 형식 열의 값을 업데이트할 수 있습니다.

• 사용자 정의 형식에서 SQL Server 시스템 데이터 형식의 암시적 또는 명시적 변환이 지원되는 경우 해당 형식의 값을 제공합니다. 다음 예에서는 문자열에서 명시적 변환을 통해 사용자 정의 형식인 Point 열의 값을 업데이트하는 방법을 보여 줍니다.

  UPDATE Cities  
  SET Location = CONVERT(Point, '12.3:46.2')  
  WHERE Name = 'Anchorage';  
  

• 변경자(mutator)로 표시된 사용자 정의 형식의 메서드를 호출하여 업데이트를 수행합니다. 다음 예에서는 Point라는 SetXY 유형의 변경자 메서드를 호출합니다. 해당 유형의 인스턴스 상태가 업데이트됩니다.

  UPDATE Cities  
  SET Location.SetXY(23.5, 23.5)  
  WHERE Name = 'Anchorage';  
  

  참고

  SQL Server Null 값에서 변경자(mutator) 메서드를 호출하거나 변경자(mutator) 메서드에 의해 생성된 새 값이 Null이면 Transact-SQL에서 오류가 반환됩니다.

• 등록된 속성 또는 사용자 정의 형식의 공용 데이터 멤버 값을 변경합니다. 값을 제공하는 식은 암시적으로 해당 속성 유형으로 변환할 수 있어야 합니다. 다음 예에서는 사용자 정의 형식 X의 Point 속성 값을 수정합니다.

  UPDATE Cities  
  SET Location.X = 23.5  
  WHERE Name = 'Anchorage';  
  

  동일한 사용자 정의 형식 열의 다른 속성을 수정하려면 UPDATE 문을 실행하거나 해당 유형의 변경자(mutator) 메서드를 호출합니다.

FILESTREAM 데이터 업데이트

UPDATE 문을 통해 FILESTREAM 필드를 Null 값, 비어 있는 값 또는 상대적으로 짧은 인라인 데이터로 업데이트할 수 있습니다. 그러나 크기가 큰 데이터는 Win32 인터페이스를 사용하여 파일로 좀 더 효율적으로 스트리밍됩니다. FILESTREAM 필드를 업데이트할 때 파일 시스템의 기본 BLOB 데이터를 수정합니다. FILESTREAM 필드를 NULL로 설정하면 이 필드와 연결된 BLOB 데이터가 삭제됩니다. FILESTREAM 데이터의 부분 업데이트를 수행하기 위해 .WRITE()를 사용할 수 없습니다. 자세한 내용은 FILESTREAM(SQL Server)을 참조하세요.

오류 처리

행에 대한 업데이트가 제약 조건이나 규칙을 위반할 경우, 열에 대한 NULL 설정을 위반할 경우 또는 새 값이 호환되지 않는 데이터 형식인 경우에는 문이 취소되고 오류가 반환되며 레코드가 업데이트되지 않습니다.

식을 평가할 때 UPDATE 문에 산술 오류(오버플로, 0으로 나누기 또는 도메인 오류)가 발생하면 업데이트가 실행되지 않으며 나머지 일괄 처리가 실행되지 않고 오류 메시지가 반환됩니다.

클러스터형 인덱스에 참여하는 열을 업데이트하여 클러스터형 인덱스와 행의 크기가 8,060바이트를 넘어서면 업데이트가 실패하고 오류 메시지가 반환됩니다.

상호 운용성

수정되고 있는 테이블이 테이블 변수인 경우에만 UPDATE 문이 사용자 정의 함수의 본문에 허용됩니다.

테이블에 대한 UPDATE 동작에 INSTEAD OF 트리거가 정의되면 UPDATE 문 대신 트리거가 실행됩니다. 이전 버전의 SQL Server에서는 UPDATE 및 기타 데이터 수정 문에서 정의된 AFTER 트리거만 지원되었습니다. INSTEAD OF 트리거가 정의된 뷰를 직접 또는 간접적으로 참조하는 UPDATE 문에는 FROM 절을 지정할 수 없습니다. INSTEAD OF 트리거에 대한 자세한 내용은 CREATE TRIGGER(Transact-SQL)를 참조하세요.

현재 FROM 절은 Microsoft Fabric의 Warehouse에 대한 UPDATE 문에 지정할 수 없습니다. 단일 테이블 UPDATE 문이 지원됩니다.

제한 사항

INSTEAD OF 트리거가 정의된 뷰를 직접 또는 간접적으로 참조하는 UPDATE 문에는 FROM 절을 지정할 수 없습니다. INSTEAD OF 트리거에 대한 자세한 내용은 CREATE TRIGGER(Transact-SQL)를 참조하세요.

CTE(공통 테이블 식)가 UPDATE 문의 대상인 경우 문에서 CTE에 대한 모든 참조가 일치해야 합니다. 예를 들어 FROM 절에서 CTE에 별칭이 지정된 경우 CTE에 대한 다른 모든 참조에서 이 별칭을 사용해야 합니다. SQL Server에서는 개체 ID를 사용하여 개체와 해당 별칭 간의 암시적 관계를 인식하는데, CTE는 개체 ID가 없기 때문에 CTE 참조가 분명해야 합니다. 이 관계가 없으면 쿼리 계획에서 예기치 않은 조인 동작과 의도하지 않은 쿼리 결과가 발생할 수 있습니다. 다음 예에서는 CTE가 업데이트 작업의 대상 개체일 때 CTE를 지정하는 올바른 방법과 잘못된 방법을 보여 줍니다.

USE tempdb;  
GO  
-- UPDATE statement with CTE references that are correctly matched.  
DECLARE @x TABLE (ID INT, Value INT);  
DECLARE @y TABLE (ID INT, Value INT);  
INSERT @x VALUES (1, 10), (2, 20);  
INSERT @y VALUES (1, 100),(2, 200);  
  
WITH cte AS (SELECT * FROM @x)  
UPDATE x -- cte is referenced by the alias.  
SET Value = y.Value  
FROM cte AS x  -- cte is assigned an alias.  
INNER JOIN @y AS y ON y.ID = x.ID;  
SELECT * FROM @x;  
GO  

결과 집합은 다음과 같습니다.

ID     Value  
------ -----  
1      100  
2      200  
(2 row(s) affected)  

올바르지 않게 일치된 CTE 참조가 있는 UPDATE 문입니다.

USE tempdb;  
GO  
DECLARE @x TABLE (ID INT, Value INT);  
DECLARE @y TABLE (ID INT, Value INT);  
INSERT @x VALUES (1, 10), (2, 20);  
INSERT @y VALUES (1, 100),(2, 200);  
  
WITH cte AS (SELECT * FROM @x)  
UPDATE cte   -- cte is not referenced by the alias.  
SET Value = y.Value  
FROM cte AS x  -- cte is assigned an alias.  
INNER JOIN @y AS y ON y.ID = x.ID;   
SELECT * FROM @x;   
GO  

결과 집합은 다음과 같습니다.

ID     Value  
------ -----  
1      100  
2      100  
(2 row(s) affected)  

잠금 동작

UPDATE 문은 수정하는 모든 행에 대해 배타적(X) 잠금을 획득하고 해당 트랜잭션이 완료될 때까지 이 잠금을 보유합니다. UPDATE 문의 쿼리 계획, 수정되는 행 수 및 트랜잭션의 격리 수준에 따라 ROW 수준이 아닌 PAGE 수준 또는 TABLE 수준에서 잠금이 가능할 수 있습니다. 이러한 더 높은 수준의 잠금을 피하려면 수천 개의 행에 영향을 주는 update 문을 일괄 처리로 나누고 인덱스에서 조인 및 필터 조건이 지원되는지 확인하세요. SQL Server의 잠금 메커니즘에 대한 자세한 내용은 데이터베이스 엔진의 잠금에 대한 문서를 참조하세요.

로깅 동작

UPDATE 문은 로그되지만 .WRITE 절을 사용하는 큰 값 데이터 형식의 부분 업데이트는 최소로 로그됩니다. 자세한 내용은 이전 섹션 “데이터 형식”에서 "큰 값 데이터 형식 업데이트"를 참조하세요.

보안

사용 권한

대상 테이블에 대한 UPDATE 권한이 필요합니다. 또한 UPDATE 문에 WHERE 절이 포함되거나, SET 절의 expression에서 테이블의 열을 사용할 경우 업데이트하는 중인 테이블에 대해 SELECT 권한이 요구됩니다.

UPDATE 권한은 sysadmin 고정 서버 역할, db_owner 및 db_datawriter 고정 데이터베이스 역할, 테이블 소유자의 멤버에게 기본적으로 부여됩니다. sysadmin, db_owner 및 db_securityadmin 역할의 멤버와 테이블 소유자는 다른 사용자에게 권한을 위임할 수 있습니다.

예제

범주	중요한 구문 요소
기본 구문	UPDATE
업데이트할 행 제한	WHERE * TOP * WITH 공통 테이블 식 * WHERE CURRENT OF
열 값 설정	계산 값 * 복합 연산자 * 기본값 * 하위 쿼리
표준 테이블 이외의 대상 개체 지정	views * table variables * table aliases
다른 테이블의 데이터를 기반으로 데이터 업데이트	FROM
원격 테이블의 행 업데이트	연결된 서버 * OPENQUERY * OPENDATASOURCE
LOB(Large Object) 데이터 형식 업데이트	. WRITE * OPENROWSET
사용자 정의 형식 업데이트	사용자 정의 형식
힌트를 사용하여 쿼리 최적화 프로그램의 기본 동작 재정의	테이블 힌트 * 쿼리 힌트
UPDATE 문의 결과 캡처	OUTPUT 절
다른 문에서 UPDATE 사용	저장 프로시저 * TRY... 잡기

기본 구문

이 섹션의 예에서는 최소 필수 구문을 사용하여 UPDATE 문의 기본 기능을 보여 줍니다.

A. 단순 UPDATE 문 사용

다음 예에서는 Person.Address 테이블의 모든 행에 대해 단일 열을 업데이트합니다.

USE AdventureWorks2022;  
GO  
UPDATE Person.Address  
SET ModifiedDate = GETDATE();  

B. 여러 열 업데이트

다음 예에서는 Bonus 테이블의 모든 행에 대해 CommissionPct, SalesQuota 및 SalesPerson 열의 값을 업데이트합니다.

USE AdventureWorks2022;  
GO  
UPDATE Sales.SalesPerson  
SET Bonus = 6000, CommissionPct = .10, SalesQuota = NULL;  
GO  

업데이트할 행 제한

이 섹션의 예에서는 UPDATE 문의 영향을 받는 행 수를 제한하는 데 사용할 수 있는 방법을 보여 줍니다.

C. WHERE 절 사용

다음 예에서는 WHERE 절을 사용하여 업데이트할 행을 지정합니다. 이 문은 Color 테이블에서 Production.Product 열의 기존 값이 'Red'이고 Color 열의 값이 'Road-250'으로 시작하는 모든 행에 대해 Name 열의 값을 업데이트합니다.

USE AdventureWorks2022;  
GO  
UPDATE Production.Product  
SET Color = N'Metallic Red'  
WHERE Name LIKE N'Road-250%' AND Color = N'Red';  
GO  

D. TOP 절 사용

다음 예에서는 UPDATE 문에 TOP 절을 사용하여 수정되는 행 수를 제한합니다. UPDATE 문에 TOP(n) 절을 사용하면 임의로 선택된 'n'개의 행에 대해 업데이트 작업이 수행됩니다. 다음 예에서는 VacationHours 테이블에 있는 임의의 10개 행의 Employee 열을 25% 업데이트합니다.

USE AdventureWorks2022;
GO
UPDATE TOP (10) HumanResources.Employee
SET VacationHours = VacationHours * 1.25 ;
GO  

TOP를 사용하여 의미 있는 연대순으로 업데이트를 적용해야 할 경우 하위 SELECT 문에서 TOP를 ORDER BY와 함께 사용해야 합니다. 다음 예에서는 채용일이 가장 빠른 직원 10명의 휴가 기간을 업데이트합니다.

UPDATE HumanResources.Employee  
SET VacationHours = VacationHours + 8  
FROM (SELECT TOP 10 BusinessEntityID FROM HumanResources.Employee  
     ORDER BY HireDate ASC) AS th  
WHERE HumanResources.Employee.BusinessEntityID = th.BusinessEntityID;  
GO  

E. WITH common_table_expression 절 사용

다음 예에서는 PerAssemblyQty을 만드는 데 직접 또는 간접적으로 사용되는 모든 부분과 구성 요소의 ProductAssemblyID 800 값을 업데이트합니다. 공통 테이블 식은 ProductAssemblyID 800를 만드는 데 직접 사용되는 부분 및 해당 구성 요소를 만드는 데 사용되는 부분과 같은 식으로 이어지는 계층적 목록을 반환합니다. 이렇게 공통 테이블 식이 반환한 행만 수정됩니다.

USE AdventureWorks2022;  
GO  
WITH Parts(AssemblyID, ComponentID, PerAssemblyQty, EndDate, ComponentLevel) AS  
(  
    SELECT b.ProductAssemblyID, b.ComponentID, b.PerAssemblyQty,  
        b.EndDate, 0 AS ComponentLevel  
    FROM Production.BillOfMaterials AS b  
    WHERE b.ProductAssemblyID = 800  
          AND b.EndDate IS NULL  
    UNION ALL  
    SELECT bom.ProductAssemblyID, bom.ComponentID, p.PerAssemblyQty,  
        bom.EndDate, ComponentLevel + 1  
    FROM Production.BillOfMaterials AS bom   
        INNER JOIN Parts AS p  
        ON bom.ProductAssemblyID = p.ComponentID  
        AND bom.EndDate IS NULL  
)  
UPDATE Production.BillOfMaterials  
SET PerAssemblyQty = c.PerAssemblyQty * 2  
FROM Production.BillOfMaterials AS c  
JOIN Parts AS d ON c.ProductAssemblyID = d.AssemblyID  
WHERE d.ComponentLevel = 0;  

F. WHERE CURRENT OF 절 사용

다음 예에서는 WHERE CURRENT OF 절을 사용하여 커서가 있는 행만 업데이트합니다. 커서가 조인을 기반으로 할 경우 UPDATE 문에 지정된 table_name만 수정되고 커서에 사용한 다른 테이블은 영향을 받지 않습니다.

USE AdventureWorks2022;  
GO  
DECLARE complex_cursor CURSOR FOR  
    SELECT a.BusinessEntityID  
    FROM HumanResources.EmployeePayHistory AS a  
    WHERE RateChangeDate <>   
         (SELECT MAX(RateChangeDate)  
          FROM HumanResources.EmployeePayHistory AS b  
          WHERE a.BusinessEntityID = b.BusinessEntityID) ;  
OPEN complex_cursor;  
FETCH FROM complex_cursor;  
UPDATE HumanResources.EmployeePayHistory  
SET PayFrequency = 2   
WHERE CURRENT OF complex_cursor;  
CLOSE complex_cursor;  
DEALLOCATE complex_cursor;  
GO  

열 값 설정

이 섹션의 예에서는 계산 값, 하위 쿼리 및 DEFAULT 값을 사용하여 열을 업데이트하는 방법을 보여 줍니다.

G. 계산 값 지정

다음 예에서는 UPDATE 문에 계산 값을 사용합니다. 이 예에서는 ListPrice 테이블의 모든 행에 대해 Product 열의 값을 두 배로 만듭니다.

USE AdventureWorks2022;  
GO  
UPDATE Production.Product  
SET ListPrice = ListPrice * 2;  
GO  

H. 복합 연산자 지정

다음 예에서는 @NewPrice 변수를 사용하여 현재 가격을 가져오고 여기에 10을 더하여 모든 빨간색 자전거의 가격을 올립니다.

USE AdventureWorks2022;  
GO  
DECLARE @NewPrice INT = 10;  
UPDATE Production.Product  
SET ListPrice += @NewPrice  
WHERE Color = N'Red';  
GO  

다음 예에서는 += 복합 연산자를 사용하여 ' - tool malfunction'가 10에서 12 사이인 행에 대해 Name 열의 기존 값에 ScrapReasonID을 추가합니다.

USE AdventureWorks2022;  
GO  
UPDATE Production.ScrapReason   
SET Name += ' - tool malfunction'  
WHERE ScrapReasonID BETWEEN 10 and 12;  

9\. SET 절에 하위 쿼리 지정

다음 예에서는 SET 절에 하위 쿼리를 사용하여 열을 업데이트하는 데 사용되는 값을 확인합니다. 이 하위 쿼리는 스칼라 값, 즉 각 행에 대해 단일 값을 반환해야 합니다. 이 예에서는 SalesYTD 테이블의 SalesPerson 열을 변경하여 SalesOrderHeader 테이블의 가장 최근 판매 기록을 반영합니다. 하위 쿼리는 UPDATE 문에서 각 영업 사원의 판매를 집계합니다.

USE AdventureWorks2022;  
GO  
UPDATE Sales.SalesPerson  
SET SalesYTD = SalesYTD +   
    (SELECT SUM(so.SubTotal)   
     FROM Sales.SalesOrderHeader AS so  
     WHERE so.OrderDate = (SELECT MAX(OrderDate)  
                           FROM Sales.SalesOrderHeader AS so2  
                           WHERE so2.SalesPersonID = so.SalesPersonID)  
     AND Sales.SalesPerson.BusinessEntityID = so.SalesPersonID  
     GROUP BY so.SalesPersonID);  
GO  

J. DEFAULT 값을 사용하여 행 업데이트

다음 예에서는 CostRate 값이 CostRate보다 큰 모든 행에 대해 20.00 열을 기본값(0.00)으로 설정합니다.

USE AdventureWorks2022;  
GO  
UPDATE Production.Location  
SET CostRate = DEFAULT  
WHERE CostRate > 20.00;  

표준 테이블 이외의 대상 개체 지정

이 섹션의 예에서는 뷰, 테이블 별칭 또는 테이블 변수를 지정하여 행을 업데이트하는 방법을 보여 줍니다.

11. 뷰를 대상 개체로 지정

다음 예에서는 뷰를 대상 개체로 지정하여 테이블의 행을 업데이트합니다. 뷰 정의에서는 여러 테이블을 참조하지만 UPDATE 문은 기본 테이블 중 하나의 열만 참조하므로 성공적으로 실행됩니다. 모든 테이블의 열을 지정하면 UPDATE 문이 실패합니다. 자세한 내용은 뷰를 통해 데이터 수정을 참조하세요.

USE AdventureWorks2022;  
GO  
UPDATE Person.vStateProvinceCountryRegion  
SET CountryRegionName = 'United States of America'  
WHERE CountryRegionName = 'United States';  

12. 테이블 별칭을 대상 개체로 지정

다음 예에서는 Production.ScrapReason 테이블의 행을 업데이트합니다. FROM 절에서 ScrapReason에 할당된 테이블 별칭은 UPDATE 절에서 대상 개체로 지정됩니다.

USE AdventureWorks2022;  
GO  
UPDATE sr  
SET sr.Name += ' - tool malfunction'  
FROM Production.ScrapReason AS sr  
JOIN Production.WorkOrder AS wo   
     ON sr.ScrapReasonID = wo.ScrapReasonID  
     AND wo.ScrappedQty > 300;  

13. 테이블 변수를 대상 개체로 지정

다음 예에서는 테이블 변수의 행을 업데이트합니다.

USE AdventureWorks2022;  
GO  
-- Create the table variable.  
DECLARE @MyTableVar TABLE (  
    EmpID INT NOT NULL,  
    NewVacationHours INT,  
    ModifiedDate DATETIME);  
  
-- Populate the table variable with employee ID values from HumanResources.Employee.  
INSERT INTO @MyTableVar (EmpID)  
    SELECT BusinessEntityID FROM HumanResources.Employee;  
  
-- Update columns in the table variable.  
UPDATE @MyTableVar  
SET NewVacationHours = e.VacationHours + 20,  
    ModifiedDate = GETDATE()  
FROM HumanResources.Employee AS e   
WHERE e.BusinessEntityID = EmpID;  
  
-- Display the results of the UPDATE statement.  
SELECT EmpID, NewVacationHours, ModifiedDate FROM @MyTableVar  
ORDER BY EmpID;  
GO  

다른 테이블의 데이터를 기반으로 데이터 업데이트

이 섹션의 예에서는 한 테이블의 행을 다른 테이블의 정보에 따라 업데이트하는 방법을 보여 줍니다.

14. 다른 테이블의 정보와 함께 UPDATE 문 사용

다음 예에서는 SalesYTD 테이블의 SalesPerson 열을 변경하여 SalesOrderHeader 테이블의 가장 최근 판매 기록을 반영합니다.

USE AdventureWorks2022;  
GO  
UPDATE Sales.SalesPerson  
SET SalesYTD = SalesYTD + SubTotal  
FROM Sales.SalesPerson AS sp  
JOIN Sales.SalesOrderHeader AS so  
    ON sp.BusinessEntityID = so.SalesPersonID  
    AND so.OrderDate = (SELECT MAX(OrderDate)  
                        FROM Sales.SalesOrderHeader  
                        WHERE SalesPersonID = sp.BusinessEntityID);  
GO  

앞의 예에서는 특정 날짜에 지정된 판매 직원에 대해 하나의 판매 정보만 기록되고 테이블이 최신 상태로 업데이트된 상태라고 가정합니다. 지정된 판매 직원에 대해 두 건 이상의 판매 정보를 같은 날 기록할 수 있는 경우 이 예는 제대로 실행되지 않습니다. 해당 날짜의 실제 판매 실적에 관계없이 이 예는 오류 없이 실행되지만 각 SalesYTD 값은 한 건의 판매 정보로만 업데이트됩니다. 이는 하나의 UPDATE 문이 같은 행을 두 번 업데이트하지 않기 때문입니다.

지정된 판매 직원에 대해 하루에 두 번 이상의 판매가 발생할 수 있는 상황에서 각 판매 직원에 대한 모든 판매 정보는 다음 예와 같이 UPDATE 문 내에서 함께 집계되어야 합니다.

USE AdventureWorks2022;  
GO  
UPDATE Sales.SalesPerson  
SET SalesYTD = SalesYTD +   
    (SELECT SUM(so.SubTotal)   
     FROM Sales.SalesOrderHeader AS so  
     WHERE so.OrderDate = (SELECT MAX(OrderDate)  
                           FROM Sales.SalesOrderHeader AS so2  
                           WHERE so2.SalesPersonID = so.SalesPersonID)  
     AND Sales.SalesPerson.BusinessEntityID = so.SalesPersonID  
     GROUP BY so.SalesPersonID);  
GO  

원격 테이블의 행 업데이트

이 섹션의 예에서는 원격 테이블을 참조하는 연결된 서버 또는 행 집합 함수를 사용하여 원격 대상 테이블의 행을 업데이트하는 방법을 보여 줍니다.

15. 연결된 서버를 사용하여 원격 테이블의 데이터 업데이트

다음 예에서는 원격 서버의 테이블을 업데이트합니다. 먼저 sp_addlinkedserver를 사용하여 원격 데이터 원본에 대한 링크를 만듭니다. 그런 다음 연결된 서버 이름 MyLinkedServer가 server.catalog.schema.object와 같이 네 부분으로 구성된 개체 이름의 일부로 지정됩니다. @datasrc에는 유효한 서버 이름을 지정해야 합니다.

USE master;  
GO  
-- Create a link to the remote data source.   
-- Specify a valid server name for @datasrc as 'server_name' or 'server_nameinstance_name'.  
  
EXEC sp_addlinkedserver @server = N'MyLinkedServer',  
    @srvproduct = N' ',  
    @provider = N'SQLNCLI10',   
    @datasrc = N'<server name>',  
    @catalog = N'AdventureWorks2022';  
GO  
USE AdventureWorks2022;  
GO  
-- Specify the remote data source using a four-part name   
-- in the form linked_server.catalog.schema.object.  
  
UPDATE MyLinkedServer.AdventureWorks2022.HumanResources.Department  
SET GroupName = N'Public Relations'  
WHERE DepartmentID = 4;  

16. OPENQUERY 함수를 사용하여 원격 테이블의 데이터 업데이트

다음 예에서는 OPENQUERY 행 집합 함수를 지정하여 원격 테이블의 행을 업데이트합니다. 이 예에서는 이전 예에서 만든 연결된 서버 이름이 사용됩니다.

UPDATE OPENQUERY (MyLinkedServer, 'SELECT GroupName FROM HumanResources.Department WHERE DepartmentID = 4')   
SET GroupName = 'Sales and Marketing';  

17. OPENDATASOURCE 함수를 사용하여 원격 테이블의 데이터 업데이트

다음 예에서는 OPENDATASOURCE 행 집합 함수를 지정하여 원격 테이블의 행을 업데이트합니다. server_name 또는 server_name\instance_name 형식을 사용하여 데이터 원본에 대해 유효한 서버 이름을 지정해야 합니다. 임시 분산 쿼리에 맞게 SQL Server 인스턴스를 구성해야 할 수 있습니다. 자세한 내용은 임시 분산 쿼리 서버 구성 옵션을 참조하세요.

UPDATE OPENDATASOURCE('SQLNCLI', 'Data Source=<server name>;Integrated Security=SSPI').AdventureWorks2022.HumanResources.Department
SET GroupName = 'Sales and Marketing' WHERE DepartmentID = 4;  

LOB(Large Object) 데이터 형식 업데이트

이 섹션의 예에서는 LOB(Large Object) 데이터 형식을 사용하여 정의된 열의 값을 업데이트하는 방법을 보여 줍니다.

18. UPDATE를 .WRITE와 함께 사용하여 nvarchar(max) 열의 데이터 수정

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

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  

S.는 UPDATE를 .WRITE와 함께 사용하여 nvarchar(max) 열의 데이터 추가 및 제거

다음 예에서는 현재 NULL로 설정된 nvarchar(max) 열에 데이터를 추가하거나 제거합니다. .WRITE 절은 NULL 열을 수정하는 데 사용할 수 없기 때문에 열을 먼저 임시 데이터로 채웁니다. 그런 다음 .WRITE 절을 사용하여 이 데이터를 올바른 데이터로 대체합니다. 다음 추가 예에서는 열 값의 끝에 데이터를 추가하고 열에서 데이터를 제거(잘라내기)하고 마지막으로 열에서 일부 데이터를 제거합니다. SELECT 문은 각각의 UPDATE 문에 의한 데이터 수정 내용을 표시합니다.

USE AdventureWorks2022;  
GO  
-- Replacing NULL value with temporary data.  
UPDATE Production.Document  
SET DocumentSummary = N'Replacing NULL value'  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
SELECT DocumentSummary   
FROM Production.Document  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
-- Replacing temporary data with the correct data. Setting @Length to NULL   
-- truncates all existing data from the @Offset position.  
UPDATE Production.Document  
SET DocumentSummary .WRITE(N'Carefully inspect and maintain the tires and crank arms.',0,NULL)  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
SELECT DocumentSummary   
FROM Production.Document  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
-- Appending additional data to the end of the column by setting   
-- @Offset to NULL.  
UPDATE Production.Document  
SET DocumentSummary .WRITE (N' Appending data to the end of the column.', NULL, 0)  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
SELECT DocumentSummary   
FROM Production.Document  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
-- Removing all data from @Offset to the end of the existing value by   
-- setting expression to NULL.   
UPDATE Production.Document  
SET DocumentSummary .WRITE (NULL, 56, 0)  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
SELECT DocumentSummary   
FROM Production.Document  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
-- Removing partial data beginning at position 9 and ending at   
-- position 21.  
UPDATE Production.Document  
SET DocumentSummary .WRITE ('',9, 12)  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  
SELECT DocumentSummary   
FROM Production.Document  
WHERE Title = N'Crank Arm and Tire Maintenance';  
GO  

20. UPDATE를 OPENROWSET와 함께 사용하여 varbinary(max) 열 수정

다음 예에서는 varbinary(max) 열에 저장된 기존 이미지를 새 이미지로 대체합니다. OPENROWSET 함수에 BULK 옵션을 사용하여 이미지를 열에 로드합니다. 이 예에서는 지정된 파일 경로에 Tires.jpg라는 이름의 파일이 존재하는 것으로 가정합니다.

USE AdventureWorks2022;  
GO  
UPDATE Production.ProductPhoto  
SET ThumbNailPhoto = (  
    SELECT *  
    FROM OPENROWSET(BULK 'c:Tires.jpg', SINGLE_BLOB) AS x )  
WHERE ProductPhotoID = 1;  
GO  

21. UPDATE를 사용하여 FILESTREAM 데이터 수정

다음 예에서는 UPDATE 문을 사용하여 파일 시스템 파일의 데이터를 수정합니다. 많은 양의 데이터를 파일로 스트리밍하는 데는 이 방법을 사용하지 않는 것이 좋습니다. 적절한 Win32 인터페이스를 사용해야 합니다. 다음 예에서는 파일 레코드에 있는 임의의 텍스트를 Xray 1로 바꿉니다. 자세한 내용은 FILESTREAM(SQL Server)을 참조하세요.

UPDATE Archive.dbo.Records  
SET [Chart] = CAST('Xray 1' as VARBINARY(max))  
WHERE [SerialNumber] = 2;  

사용자 정의 형식 업데이트

다음 예에서는 CLR UDT(사용자 정의 형식) 열의 값을 수정하는 세 가지 방법을 보여 줍니다. 사용자 정의 형식 열에 대한 자세한 내용은 CLR 사용자 정의 형식을 참조하세요.

V. 시스템 데이터 형식 사용

사용자 정의 형식에서 SQL Server 시스템 데이터 형식의 암시적 또는 명시적 변환이 지원되는 경우 해당 형식의 값을 제공하여 UDT를 업데이트할 수 있습니다. 다음 예에서는 문자열에서 명시적 변환을 통해 사용자 정의 형식인 Point 열의 값을 업데이트하는 방법을 보여 줍니다.

UPDATE dbo.Cities  
SET Location = CONVERT(Point, '12.3:46.2')  
WHERE Name = 'Anchorage';  

W. 메서드 호출

변경자(mutator)로 표시된 사용자 정의 형식의 메서드를 호출하여 업데이트를 수행하는 방법으로 UDT를 업데이트할 수 있습니다. 다음 예에서는 Point라는 SetXY 유형의 변경자 메서드를 호출합니다. 해당 유형의 인스턴스 상태가 업데이트됩니다.

UPDATE dbo.Cities  
SET Location.SetXY(23.5, 23.5)  
WHERE Name = 'Anchorage';  

X. 속성 또는 데이터 멤버의 값 수정

등록된 속성 또는 사용자 정의 형식의 공용 데이터 멤버 값을 수정하여 UDT를 업데이트할 수 있습니다. 값을 제공하는 식은 암시적으로 해당 속성 유형으로 변환할 수 있어야 합니다. 다음 예에서는 사용자 정의 형식 X의 Point 속성 값을 수정합니다.

UPDATE dbo.Cities  
SET Location.X = 23.5  
WHERE Name = 'Anchorage';  

힌트를 사용하여 쿼리 최적화 프로그램의 기본 동작 재정의

이 섹션의 예에서는 UPDATE 문을 처리할 때 쿼리 최적화 프로그램의 기본 동작을 임시로 재정의하기 위해 테이블 및 쿼리 힌트를 사용하는 방법을 보여 줍니다.

주의

일반적으로 SQL Server 쿼리 최적화 프로그램은 쿼리에 대해 최상의 실행 계획을 선택하므로 숙련된 개발자 및 데이터베이스 관리자가 마지막 방법으로만 힌트를 사용하는 것이 좋습니다.

Y. 테이블 힌트 지정

다음 예에서는 테이블 힌트 TABLOCK을 지정합니다. 이 힌트는 Production.Product 테이블에 공유 잠금을 사용하고 UPDATE 문이 끝날 때까지 이 잠금을 유지하도록 지정합니다.

USE AdventureWorks2022;  
GO  
UPDATE Production.Product  
WITH (TABLOCK)  
SET ListPrice = ListPrice * 1.10  
WHERE ProductNumber LIKE 'BK-%';  
GO  

Z를 대신하여 테넌트 관리자에게 권한 부여 요청을 보내세요. 쿼리 힌트 지정

다음 예에서는 UPDATE 문에 쿼리 힌트OPTIMIZE FOR (@variable)를 지정합니다. 이 힌트는 쿼리가 컴파일되고 최적화될 때 쿼리 최적화 프로그램이 지역 변수에 대해 특정 값을 사용하도록 지시합니다. 해당 값은 쿼리 최적화 중에만 사용되고 쿼리 실행 중에는 사용되지 않습니다.

USE AdventureWorks2022;  
GO  
CREATE PROCEDURE Production.uspProductUpdate  
@Product NVARCHAR(25)  
AS  
SET NOCOUNT ON;  
UPDATE Production.Product  
SET ListPrice = ListPrice * 1.10  
WHERE ProductNumber LIKE @Product  
OPTION (OPTIMIZE FOR (@Product = 'BK-%') );  
GO  
-- Execute the stored procedure   
EXEC Production.uspProductUpdate 'BK-%';  

UPDATE 문의 결과 캡처

이 섹션의 예에서는 OUTPUT 절을 사용하여 UPDATE 문의 영향을 받는 각 행의 정보 또는 각 행을 기반으로 하는 식을 반환하는 방법을 보여 줍니다. 이러한 결과를 처리 애플리케이션에 반환하여 확인 메시지, 보관 및 기타 애플리케이션 요구 사항을 충족시키는 데 사용할 수 있습니다.

AA. OUTPUT 절과 함께 UPDATE 사용

다음 예제에서는 Employee 테이블에서 VacationHours가 10시간 미만인 직원의 VacationHours 열을 25% 업데이트하고 ModifiedDate 열의 값을 현재 날짜로 설정합니다. OUTPUT 절은 deleted.VacationHours 열에서 UPDATE 문을 적용하기 전에 존재했던 VacationHours의 값, 그리고 inserted.VacationHours 열에서 업데이트된 값을 @MyTableVar 테이블 변수에 반환합니다.

각각 SELECT의 값과 @MyTableVar 테이블의 업데이트 작업 결과를 반환하는 두 개의 Employee 문이 이어집니다. OUTPUT 절을 사용하는 더 많은 예제는 OUTPUT 절(Transact-SQL)을 참조하세요.

USE AdventureWorks2022;  
GO  

--Display the initial data of the table to be updated.  
SELECT BusinessEntityID, VacationHours, ModifiedDate, HireDate  
FROM HumanResources.Employee
WHERE VacationHours < 10  
GO  

DECLARE @MyTableVar TABLE (  
    EmpID int NOT NULL,  
    OldVacationHours smallint,  
    NewVacationHours smallint,  
    ModifiedDate datetime);  
UPDATE HumanResources.Employee  
SET VacationHours =  VacationHours * 1.25,  
    ModifiedDate = GETDATE()   
OUTPUT inserted.BusinessEntityID,  
      deleted.VacationHours,  
      inserted.VacationHours,  
      inserted.ModifiedDate  
INTO @MyTableVar
    WHERE VacationHours < 10  
--Display the result set of the table variable.  
SELECT EmpID, OldVacationHours
, NewVacationHours, ModifiedDate  
FROM @MyTableVar;  

GO  
--Display the result set of the table.  
SELECT BusinessEntityID, VacationHours, ModifiedDate, HireDate  
FROM HumanResources.Employee
    WHERE VacationHours < 10  
GO  

다른 문에서 UPDATE 사용

이 섹션의 예에서는 다른 문에 UPDATE를 사용하는 방법을 보여 줍니다.

AB. 저장 프로시저에 UPDATE 사용

다음 예에서는 저장 프로시저에 UPDATE 문을 사용합니다. 이 프로시저에서는 @NewHours라는 입력 매개 변수 하나와 @RowCount라는 출력 매개 변수 하나를 사용합니다. UPDATE 문에 사용된 @NewHours 매개 변수 값은 HumanResources.Employee 테이블의 VacationHours 열을 업데이트합니다. @RowCount 출력 매개 변수는 영향을 받는 행 수를 지역 변수에 반환하는 데 사용됩니다. SET 절에 사용된 CASE 식은 VacationHours에 대해 설정되는 값을 조건에 따라 결정합니다. 시간당 급여를 받는 직원(SalariedFlag = 0)의 경우 현재 시간 수에 VacationHours에 지정된 값을 더한 값으로 @NewHours가 설정되고, 그 외의 경우에는 VacationHours에 지정된 값으로 @NewHours가 설정됩니다.

USE AdventureWorks2022;  
GO  
CREATE PROCEDURE HumanResources.Update_VacationHours  
@NewHours SMALLINT  
AS   
SET NOCOUNT ON;  
UPDATE HumanResources.Employee  
SET VacationHours =   
    ( CASE  
         WHEN SalariedFlag = 0 THEN VacationHours + @NewHours  
         ELSE @NewHours  
       END  
    )  
WHERE CurrentFlag = 1;  
GO  
  
EXEC HumanResources.Update_VacationHours 40;  

AC. TRY…CATCH 블록에 UPDATE 사용

다음 예제에서는 TRY…CATCH 블록에 UPDATE 문을 사용하여 업데이트 작업 도중 발생할 수 있는 실행 오류를 처리합니다.

USE AdventureWorks2022;  
GO  
BEGIN TRANSACTION;  
  
BEGIN TRY  
    -- Intentionally generate a constraint violation error.  
    UPDATE HumanResources.Department  
    SET Name = N'MyNewName'  
    WHERE DepartmentID BETWEEN 1 AND 2;  
END TRY  
BEGIN CATCH  
    SELECT   
         ERROR_NUMBER() AS ErrorNumber  
        ,ERROR_SEVERITY() AS ErrorSeverity  
        ,ERROR_STATE() AS ErrorState  
        ,ERROR_PROCEDURE() AS ErrorProcedure  
        ,ERROR_LINE() AS ErrorLine  
        ,ERROR_MESSAGE() AS ErrorMessage;  
  
    IF @@TRANCOUNT > 0  
        ROLLBACK TRANSACTION;  
END CATCH;  
  
IF @@TRANCOUNT > 0  
    COMMIT TRANSACTION;  
GO  

예: Azure Synapse Analytics 및 분석 플랫폼 시스템(PDW)

AD. 단순 UPDATE 문 사용

다음 예에서는 업데이트할 행을 지정하기 위해 WHERE 절을 사용하지 않았을 때 모든 행이 영향을 받는 방식을 보여 줍니다.

이 예에서는 DimEmployee 테이블의 모든 행에 대해 EndDate 및 CurrentFlag 열의 값을 업데이트합니다.

-- Uses AdventureWorks  
  
UPDATE DimEmployee  
SET EndDate = '2010-12-31', CurrentFlag='False';  

UPDATE 문에서 계산된 값을 사용할 수도 있습니다. 다음 예에서는 ListPrice 테이블의 모든 행에 대해 Product 열의 값을 두 배로 만듭니다.

-- Uses AdventureWorks  
  
UPDATE DimEmployee  
SET BaseRate = BaseRate * 2;  

AE. WHERE 절과 함께 UPDATE 문 사용

다음 예에서는 WHERE 절을 사용하여 업데이트할 행을 지정합니다.

-- Uses AdventureWorks  
  
UPDATE DimEmployee  
SET FirstName = 'Gail'  
WHERE EmployeeKey = 500;  

AF. 레이블과 함께 UPDATE 문 사용

다음 예에서는 UPDATE 문에 LABEL을 사용하는 방법을 보여줍니다.

-- Uses AdventureWorks  
  
UPDATE DimProduct  
SET ProductSubcategoryKey = 2   
WHERE ProductKey = 313  
OPTION (LABEL = N'label1');  

AG. 다른 테이블의 정보와 함께 UPDATE 문 사용

이 예에서는 연도별 총 판매액을 저장하는 테이블을 만듭니다. FactInternetSales 테이블에 대해 SELECT 문을 실행하여 2004년에 대한 총 판매액을 업데이트합니다.

-- Uses AdventureWorks  
  
CREATE TABLE YearlyTotalSales (  
    YearlySalesAmount MONEY NOT NULL,  
    Year SMALLINT NOT NULL )  
WITH ( DISTRIBUTION = REPLICATE );  
  
INSERT INTO YearlyTotalSales VALUES (0, 2004);  
INSERT INTO YearlyTotalSales VALUES (0, 2005);  
INSERT INTO YearlyTotalSales VALUES (0, 2006);  
  
UPDATE YearlyTotalSales  
SET YearlySalesAmount=  
(SELECT SUM(SalesAmount) FROM FactInternetSales WHERE OrderDateKey >=20040000 AND OrderDateKey < 20050000)  
WHERE Year=2004;  
  
SELECT * FROM YearlyTotalSales;   

AH. Update 문에 대한 ANSI 조인

이 예제에서는 다른 테이블의 조인 결과에 따라 데이터를 업데이트하는 방법을 보여 줍니다.

CREATE TABLE dbo.Table1   
    (ColA INT NOT NULL, ColB DECIMAL(10,3) NOT NULL);  
GO  
CREATE TABLE dbo.Table2   
    (ColA INT NOT NULL, ColB DECIMAL(10,3) NOT NULL);  
GO  
INSERT INTO dbo.Table1 VALUES(1, 10.0);  
INSERT INTO dbo.Table2 VALUES(1, 0.0);  
GO  
UPDATE dbo.Table2   
SET dbo.Table2.ColB = dbo.Table2.ColB + dbo.Table1.ColB  
FROM dbo.Table2   
    INNER JOIN dbo.Table1   
    ON (dbo.Table2.ColA = dbo.Table1.ColA);  
GO  
SELECT ColA, ColB   
FROM dbo.Table2;
GO

참고 항목

CREATE TABLE(Transact-SQL)
CREATE TRIGGER(Transact-SQL)
커서(Transact-SQL)
DELETE (Transact-SQL)
INSERT(Transact-SQL)
텍스트 및 이미지 함수(Transact-SQL)
WITH common_table_expression(Transact-SQL)
FILESTREAM [SQL Server]
데이터 정렬 및 유니코드 지원
싱글바이트 및 멀티바이트 문자 집합