sp_batch_params(Transact-SQL)

Transact-SQL 일괄 처리에 포함된 매개 변수에 대한 정보가 있는 행 집합을 반환합니다. sp_batch_params는 지정한 일괄 처리를 구문 분석하여 포함된 매개 변수 값에 대한 정보를 반환하는 작업만 수행합니다. 일괄 처리를 실행하거나 실행 환경을 수정하지는 않습니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

sp_batch_params [ [ @tsqlbatch = ] 'tsqlbatch'] 

인수

  • [ @tsqlbatch =] 'tsqlbatch'
    원하는 매개 변수 정보가 포함된 Transact-SQL 문 또는 일괄 처리를 포함하는 유니코드 문자열입니다. tsqlbatch는 **nvarchar(max)**이거나 암시적으로 **nvarchar(max)**로 변환할 수 있습니다.

반환 코드 값

없음

결과 집합

열 이름 데이터 형식 설명

PARAMETER_NAME

sysname

SQL Server가 일괄 처리에서 찾은 매개 변수의 이름입니다.

COLUMN_TYPE

smallint

이 필드는 항상 다음 값 중 하나를 반환합니다.

0 = SQL_PARAM_TYPE_UNKNOWN

1 = SQL_PARAM_TYPE_INPUT

2 = SQL_PARAM_TYPE_OUTPUT

3 = SQL_RESULT_COL

4 = SQL_PARAM_OUTPUT

5 = SQL_RETURN_VALUE

SQL Server 2005에서 이 열은 항상 0입니다.

DATA_TYPE

smallint

매개 변수의 데이터 형식(ODBC 데이터 형식에 대한 정수 코드)입니다. 데이터 형식을 SQL-92 유형에 매핑할 수 없는 경우의 값은 NULL입니다. 네이티브 데이터 형식 이름이 TYPE_NAME 열에 반환됩니다. SQL Server 2005에서 이 값은 NULL입니다.

TYPE_NAME

sysname

원본으로 사용하는 DBMS에 의해 제시된 데이터 형식의 문자열 표시입니다. SQL Server 2005에서 이 값은 NULL입니다.

PRECISION

int

유효 자릿수입니다. PRECISION 열의 반환 값은 10을 기준으로 합니다.

LENGTH

int

데이터의 전송 크기입니다. SQL Server 2005에서 이 값은 NULL입니다.

SCALE

smallint

소수점 이하 자릿수입니다. SQL Server 2005에서 이 값은 NULL입니다.

RADIX

smallint

숫자 유형에 대한 기준입니다. SQL Server 2005에서 이 값은 NULL입니다.

NULLABLE

smallint

NULL 허용 여부를 지정합니다.

1 = Null 값을 허용하는 매개 변수 데이터 형식을 만들 수 있습니다.

0 = Null 값이 허용되지 않습니다.

SQL Server 2005에서 이 값은 NULL입니다.

SQL_DATA_TYPE

smallint

설명자의 TYPE 필드에 표시된 SQL Server 시스템 데이터 형식의 값입니다. 이 열은 datetime 및 SQL-92 interval 데이터 형식을 제외하고 DATA_TYPE 열과 동일합니다. 이 열은 항상 값을 반환합니다. SQL Server 2005에서 이 값은 NULL입니다.

SQL_DATETIME_SUB

smallint

SQL_DATA_TYPE의 값이 SQL_DATETIME 또는 SQL_INTERVAL인 경우 datetime 또는 SQL-92 interval 하위 코드입니다. datetime 및 SQL-92 interval이 아닌 데이터 형식에 대해서는 이 열이 NULL입니다. SQL Server 2005에서 이 값은 NULL입니다.

CHAR_OCTET_LENGTH

int

character 또는 binary 데이터 형식 매개 변수의 최대 길이(바이트)입니다. 다른 모든 데이터 형식의 경우에는 이 열이 NULL을 반환합니다. SQL Server 2005에서 이 값은 항상 NULL입니다.

ORDINAL_POSITION

int

일괄 처리에 있는 매개 변수의 서수 위치입니다. 매개 변수 이름이 여러 번 반복되는 경우 이 열에는 처음 나타나는 위치의 서수가 포함됩니다. 첫 번째 매개 변수의 서수 위치는 1입니다. 이 열은 항상 값을 반환합니다.

사용 권한

sp_batch_params를 실행할 수 있는 권한은 public에 부여됩니다.

다음 예에서는 sp_batch_params로 전달되는 쿼리를 보여 줍니다. 결과 집합에는 포함된 매개 변수 값의 목록이 나열됩니다.

DECLARE @SQLString nvarchar(500);
/* Build the SQL string */
SET @SQLString =
     N'SELECT * FROM AdventureWorks.HumanResources.Employee 
     WHERE ManagerID = @ManagerID';
EXECUTE sp_batch_params @SQLString

참고 항목

참조

데이터 형식(Transact-SQL)

관련 자료

일괄 처리
Running Stored Procedures
Running Stored Procedures (OLE DB)

도움말 및 정보

SQL Server 2005 지원 받기