sp_refreshsqlmodule(Transact-SQL)
적용 대상: 
SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics(전용 SQL 풀만)
현재 데이터베이스에서 지정된 스키마 바인딩되지 않은 저장 프로시저, 사용자 정의 함수, 뷰, DML 트리거, 데이터베이스 수준 DDL 트리거 또는 서버 수준 DDL 트리거에 대한 메타데이터를 업데이트합니다. 기본 개체가 변경되면 매개 변수의 데이터 형식과 같은 이러한 개체의 영구 메타데이터가 최신 상태를 유지하지 못할 수 있습니다. 예를 들어 다음과 같은 The definition for user-defined data type 'typename' has changed오류가 표시될 수 있습니다. 오류에 지정된 형식을 사용하는 모듈에 대한 메타데이터를 새로 고쳐 문제를 해결할 수 있습니다.
sp_refreshsqlmodule
[ @name = ] N'name'
[ , [ @namespace = ] { OBJECT | DATABASE_DDL_TRIGGER | SERVER_DDL_TRIGGER } ]
[ ; ]
인수
[ @name = ] N'name'
저장 프로시저, 사용자 정의 함수, 뷰, DML 트리거, 데이터베이스 수준 DDL 트리거 또는 서버 수준 DDL 트리거의 이름입니다. @name은 기본값이 없는 nvarchar(776)입니다. @name은 공용 언어 런타임(CLR) 저장 프로시저 또는 CLR 함수가 될 수 없습니다. @name은 스키마 바인딩이 불가능합니다. @name은 여러 부분으로 구성된 식별자가 될 수 있지만 현재 데이터베이스의 객체만 참조할 수 있습니다.
[ @namespace = ] N'namespace'
지정된 모듈의 클래스입니다. @namespace은 nvarchar(20) 형식이며, 기본값은 OBJECT입니다. @name이 DDL 트리거인 경우 @namespace은 필수입니다. 잘못된 입력은 DATABASE_DDL_TRIGGER 및 SERVER_DDL_TRIGGER입니다.
반환 코드 값
0(성공) 또는 0이 아닌 숫자(실패).
설명
sp_refreshsqlmodule 는 해당 정의에 영향을 주는 모듈의 기본 개체를 변경할 때 실행해야 합니다. 그렇지 않으면 모듈이 쿼리하거나 호출할 때 예기치 않은 결과를 생성할 수 있습니다. 보기를 새로 고치려면 동일한 결과를 사용하거나 sp_refreshview 사용할 sp_refreshsqlmodule 수 있습니다.
sp_refreshsqlmodule은(는) 개체와 연결된 권한, 확장 속성 또는 SET 옵션에는 영향을 주지 않습니다.
서버 수준 DDL 트리거를 새로 고치려면 데이터베이스의 컨텍스트에서 이 저장 프로시저를 실행합니다.
참고 항목
sp_refreshsqlmodule을 실행하면 개체와 연결된 모든 서명이 삭제됩니다.
사용 권한
모듈에 대한 ALTER 권한 및 개체가 참조하는 CLR 사용자 정의 형식과 XML 스키마 컬렉션에 대한 REFERENCES 권한이 필요합니다. ALTER ANY DATABASE DDL TRIGGER 지정된 모듈이 데이터베이스 수준 DDL 트리거인 경우 현재 데이터베이스에 대한 권한이 필요합니다. 지정된 모듈이 CONTROL SERVER 서버 수준 DDL 트리거인 경우 사용 권한이 필요합니다.
또한 절 IMPERSONATE 로 정의된 모듈의 EXECUTE AS 경우 지정된 보안 주체에 대한 권한이 필요합니다. 일반적으로 모듈을 사용하여 정의하고 보안 주체의 사용자 이름이 모듈을 만들 때 사용자와 다른 사용자로 EXECUTE AS USER 확인되지 않는 한 개체를 새로 고치는 것은 보안 주체를 변경하지 EXECUTE AS 않습니다.
예제
이 문서의 Transact-SQL 코드 샘플은 AdventureWorks2022 또는 AdventureWorksDW2022 샘플 데이터베이스를 사용하며, 이는 Microsoft SQL Server 예시 및 커뮤니티 프로젝트(Microsoft SQL Server Samples and Community Projects) 홈 페이지에서 다운로드할 수 있습니다.
A. 사용자 정의 함수 새로 고침
다음 예제에서는 사용자 정의 함수를 새로 고칩니다. 이 예에서는 별칭 데이터 형식인 mytype과 to_upper을 사용하는 사용자 정의 함수 mytype를 만듭니다. 그런 다음 이름이 mytype 바뀝 myoldtype니다. 그러면 다른 정의인 새 mytype 항목이 만들어집니다. dbo.to_upper 함수는 이전 구현 대신 새 구현mytype을 참조할 수 있도록 새로 고쳐집니다.
첫 번째 단계에서 별칭 형식을 만듭니다.
USE AdventureWorks2022;
GO
IF EXISTS (SELECT 'mytype' FROM sys.types WHERE name = 'mytype')
DROP TYPE mytype;
GO
CREATE TYPE mytype FROM NVARCHAR(5);
GO
IF OBJECT_ID('dbo.to_upper', 'FN') IS NOT NULL
DROP FUNCTION dbo.to_upper;
GO
CREATE FUNCTION dbo.to_upper (@a mytype)
RETURNS mytype
WITH ENCRYPTION
AS
BEGIN
RETURN UPPER(@a);
END;
GO
SELECT dbo.to_upper('abcde');
GO
다음으로 별칭 형식의 길이를 늘입니다.
sp_rename 'mytype', 'myoldtype', 'userdatatype';
GO
CREATE TYPE mytype FROM NVARCHAR(10);
GO
함수 매개 변수는 여전히 이전 형식을 사용하며 잘림으로 인해 실패합니다.
SELECT name, TYPE_NAME(user_type_id)
FROM sys.parameters
WHERE object_id = OBJECT_ID('dbo.to_upper');
GO
SELECT dbo.to_upper('abcdefgh'); -- Fails because of truncation
GO
함수를 새로 고쳐 이름이 바뀐 형식에 바인딩합니다.
EXEC sys.sp_refreshsqlmodule 'dbo.to_upper';
이제 함수 매개 변수가 올바른 형식에 바인딩되고 문이 올바르게 작동합니다.
SELECT name, TYPE_NAME(user_type_id)
FROM sys.parameters
WHERE object_id = OBJECT_ID('dbo.to_upper');
GO
SELECT dbo.to_upper('abcdefgh');
GO
B. 데이터베이스 수준 DDL 트리거 새로 고침
다음 예제에서는 데이터베이스 수준 DDL 트리거를 새로 고칩니다.
USE AdventureWorks2022;
GO
EXEC sys.sp_refreshsqlmodule
@name = 'ddlDatabaseTriggerLog',
@namespace = 'DATABASE_DDL_TRIGGER';
GO
C. 서버 수준 DDL 트리거 새로 고침
다음 예에서는 서버 수준 DDL 트리거를 새로 고칩니다.
USE master;
GO
EXEC sys.sp_refreshsqlmodule
@name = 'ddl_trig_database',
@namespace = 'SERVER_DDL_TRIGGER';
GO