SET 문(Transact-SQL)

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW) Microsoft Fabric의 SQL 분석 엔드포인트 Microsoft Fabric의 웨어하우스

Transact-SQL 프로그래밍 언어는 특정 정보를 처리하는 현재 세션을 변경할 수 있는 몇 가지 SET 문을 제공합니다. SET 문은 다음 표에 표시된 범주별로 그룹화됩니다.

SET 문을 사용하여 지역 변수를 설정하는 방법은 SET @local_variable (Transact-SQL)을 참조하세요.

범주	문
날짜 및 시간 문	SET DATEFIRST SET DATEFORMAT
잠금 문	SET DEADLOCK_PRIORITY SET LOCK_TIMEOUT
기타 문	SET CONCAT_NULL_YIELDS_NULL SET CURSOR_CLOSE_ON_COMMIT SET FIPS_FLAGGER SET IDENTITY_INSERT SET LANGUAGE SET OFFSETS SET QUOTED_IDENTIFIER
쿼리 실행 문	SET ARITHABORT SET ARITHIGNORE SET FMTONLY 참고: 이 기능은 이후 버전의 SQL Server에서 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. SET NOCOUNT SET NOEXEC SET NUMERIC_ROUNDABORT SET PARSEONLY SET QUERY_GOVERNOR_COST_LIMIT 결과 집합 캐싱 설정(미리 보기) 참고: 이 기능은 Azure Synapse Analytics에만 적용됩니다. SET ROWCOUNT SET TEXTSIZE
ISO 설정 문	SET ANSI_DEFAULTS SET ANSI_NULL_DFLT_OFF SET ANSI_NULL_DFLT_ON SET ANSI_NULLS SET ANSI_PADDING SET ANSI_WARNINGS
통계 문	SET FORCEPLAN SET SHOWPLAN_ALL SET SHOWPLAN_TEXT SET SHOWPLAN_XML SET STATISTICS IO SET STATISTICS XML SET STATISTICS PROFILE SET STATISTICS TIME
트랜잭션 문	SET IMPLICIT_TRANSACTIONS SET REMOTE_PROC_TRANSACTIONS SET TRANSACTION ISOLATION LEVEL SET XACT_ABORT

SET 문 사용 시 고려 사항

• 구문 분석 시간에 실행되는 다음 문을 제외하고 모든 SET 문은 실행 시간 또는 런타임에 실행됩니다.

  • SET FIPS_FLAGGER
  • SET OFFSETS
  • SET PARSEONLY
  • 및 SET QUOTED_IDENTIFIER

• 저장 프로시저에 또는 트리거에서 SET 문이 실행되면 저장 프로시저 또는 트리거에서 컨트롤이 반환된 후 SET 옵션 값이 복원됩니다. 또한 sp_executesql 또는 EXECUTE를 사용하여 실행되는 동적 SQL 문자열에서 SET 문을 지정하면 동적 SQL 문자열에 지정된 일괄 처리에서 컨트롤이 반환된 후 SET 옵션 값이 복원됩니다.

• 저장 프로시저는 SET ANSI_NULLS와 SET QUOTED_IDENTIFIER를 제외한 실행 시간에 지정된 SET 설정으로 실행됩니다. SET ANSI_NULLS나 SET QUOTED_IDENTIFIER를 지정하는 저장 프로시저는 저장 프로시저를 만든 시간에 지정된 설정을 사용합니다. SET 설정을 저장 프로시저 내에서 사용하면 모두 무시됩니다.

• sp_configure의 user options 설정은 서버 측 설정을 허용하고 여러 데이터베이스에 걸쳐 작동합니다. 또한 이 설정은 로그인 시간에 발생할 경우를 제외하고 명시적 SET 문과 같이 작동합니다.

• ALTER DATABASE를 사용하여 지정한 데이터베이스 설정은 데이터베이스 수준에서만 유효하며 명시적으로 설정된 경우에만 적용됩니다. 데이터베이스 설정은 sp_configure를 사용하여 지정한 인스턴스 옵션 설정보다 우선 적용됩니다.

• SET 문에서 ON이나 OFF를 사용하면 여러 SET 옵션을 ON 또는 OFF로 지정할 수 있습니다.

  참고

  통계 관련 SET 옵션에는 적용되지 않습니다.

  예를 들어 SET QUOTED_IDENTIFIER, ANSI_NULLS ON은 QUOTED_IDENTIFIER 및 ANSI_NULLS를 ON으로 설정합니다.

• SET 문 설정은 ALTER DATABASE를 사용하여 설정한 동일한 데이터베이스 옵션 설정을 재정의합니다. 예를 들어 SET ANSI_NULLS 문에서 지정한 값은 ANSI_NULL에 대한 데이터베이스 설정보다 우선 적용됩니다. 뿐만 아니라 데이터베이스에 연결할 때 사용자가 이전에 sp_configure user options 설정을 사용할 때 적용된 값 또는 모든 ODBC 및 OLE/DB 연결에 적용되는 값에 따라 일부 연결 설정은 자동으로 ON으로 설정됩니다.

• ALTER, CREATE 및 DROP DATABASE 문은 SET LOCK_TIMEOUT 설정을 인식하지 못합니다.

• 전역 또는 바로 가기 SET 문은 여러 개의 설정을 설정해 바로 가기 SET 문은 영향을 미치는 모든 옵션에 대한 이전 설정을 다시 설정합니다. 바로 가기 SET 문이 실행된 후 바로 가기 SET 문에 의해 영향을 받은 SET 옵션이 설정되면 개별 SET 문은 비교 가능한 바로 가기 설정을 재정의합니다. 바로 가기 SET 문의 예로는 SET ANSI_DEFAULTS가 있습니다.

• 일괄 처리를 사용하면 USE 문을 사용해 설정된 일괄 처리에 의해 데이터베이스 컨텍스트가 결정됩니다. 계획되지 않은 쿼리 및 저장 프로시저 외부에서 실행되고 일괄 처리되는 다른 모든 문은 USE 문을 통해 설정된 연결 및 데이터베이스의 옵션 설정을 상속합니다.

• MARS(Multiple Active Result Set) 요청은 최신 세션 SET 옵션 설정이 포함된 전역 상태를 공유합니다. 각 요청이 실행될 때 SET 옵션을 수정할 수 있습니다. 변경 내용은 이 옵션이 설정된 요청 컨텍스트에만 적용되며 다른 동시 MARS 요청에는 영향을 주지 않습니다. 그러나 요청 실행을 완료한 후 새 SET 옵션이 전역 세션 상태로 복사됩니다. 이 변경 작업 후 같은 세션에서 실행되는 새 요청은 이러한 새 SET 옵션 설정을 사용합니다.

• 저장 프로시저가 일괄 처리 또는 다른 저장 프로시저에서 실행되면 해당 프로시저는 저장 프로시저가 포함된 데이터베이스에 설정된 옵션 값에 따라 실행됩니다. 예를 들어 저장 프로시저 db1.dbo.sp1이 저장 프로시저 db2.dbo.sp2를 호출할 경우 저장 프로시저 sp1은 데이터베이스 db1의 현재 호환성 수준 설정에서 실행되고 저장 프로시저 sp2는 데이터베이스 db2의 현재 호환성 수준 설정에서 실행됩니다.

• Transact-SQL 문이 여러 데이터베이스에 있는 개체와 관련된 경우 현재 데이터베이스 컨텍스트 및 현재 연결 컨텍스트가 이 문에 적용됩니다. 이러한 경우 Transact-SQL 문이 일괄 처리에 있을 경우 현재 연결 컨텍스트는 USE 문으로 정의된 데이터베이스입니다. Transact-SQL 문이 저장 프로시저에 있을 경우 연결 컨텍스트는 이 저장 프로시저가 포함된 데이터베이스입니다.

• 계산 열이나 인덱싱된 뷰에서 인덱스를 만들거나 조작할 때는 다음 SET 옵션을 ON으로 설정해야 합니다. ARITHABORT, CONCAT_NULL_YIELDS_NULL, QUOTED_IDENTIFIER, ANSI_NULLS, ANSI_PADDING 및 ANSI_WARNINGS. NUMERIC_ROUNDABORT 옵션을 OFF로 설정합니다.

  이 옵션 중 하나라도 필요한 값으로 설정하지 않으면 인덱싱된 뷰나 계산 열에 인덱스가 있는 테이블에서의 INSERT, UPDATE, DELETE, DBCC CHECKDB 및 DBCC CHECKTABLE 동작이 실패합니다. SQL Server는 잘못 설정된 모든 옵션을 나열하는 오류 메시지를 표시합니다. 또한 SQL Server에서는 옵션이 잘못 설정된 테이블이나 인덱싱된 뷰에 대해 계산 열이나 뷰에 이러한 인덱스가 존재하지 않는 것처럼 SELECT 문을 처리합니다.

• SET RESULT_SET_CACHING이 ON이면 현재 클라이언트 세션의 결과 캐싱 기능을 사용하도록 설정합니다. 데이터베이스 수준에서 Result_set_caching이 OFF인 경우 세션에서 ON으로 설정할 수 없습니다. SET RESULT_SET_CACHING이 OFF이면 현재 클라이언트 세션의 결과 집합 캐싱 기능을 사용하지 않도록 설정합니다. 이 설정을 변경하려면 public 역할의 멤버 자격이 필요합니다. 적용 대상: Azure Synapse Analytics Gen2