sp_prepare(Transact SQL)

매개 변수가 있는 Transact-SQL 문을 준비하고 실행을 위해 문 핸들을 반환합니다. sp_prepare는 TDS(Tabular Data Stream) 패킷에서 ID = 11을 지정하여 호출합니다.

Transact-SQL 구문 표기 규칙

구문

sp_prepare handle OUTPUT, params, stmt, options

인수

• handle
  SQL Server에서 생성하는 준비된 핸들 식별자입니다. handle은 int 반환 값을 포함하는 필수 매개 변수입니다.

• params
  매개 변수가 있는 문을 식별합니다. 문에서 매개 변수 표식은 변수의 params 정의로 바뀝니다. params는 ntext, nchar 또는 nvarchar 입력 값을 필요로 하는 필수 매개 변수입니다. 문에 매개 변수가 없으면 NULL 값을 입력합니다.

• stmt
  커서 결과 집합을 정의합니다. stmt 매개 변수는 필수 항목이며 ntext, nchar 또는 nvarchar 입력 값을 필요로 합니다.

• options
  커서 결과 집합 열의 설명을 반환하는 선택적 매개 변수입니다. options는 다음 int 입력 값을 필요로 합니다.

  값	설명
  0x0001	RETURN_METADATA

예

다음 예에서는 간단한 문을 준비 및 실행합니다.

Declare @P1 int;
Exec sp_prepare @P1 output, 
    N'@P1 nvarchar(128), @P2 nvarchar(100)',
    N'SELECT database_id, name FROM sys.databases WHERE name=@P1 AND state_desc = @P2';
Exec sp_execute @P1, N'tempdb', N'ONLINE';
EXEC sp_unprepare @P1;

참고 항목

참조

시스템 저장 프로시저(Transact-SQL)