sp_sproc_columns(Transact-SQL)

현재 환경 내의 저장 프로시저 또는 사용자 정의 함수에 대한 열 정보를 반환합니다.

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

구문

sp_sproc_columns [[@procedure_name = ] 'name'] 
    [ , [@procedure_owner = ] 'owner'] 
    [ , [@procedure_qualifier = ] 'qualifier'] 
    [ , [@column_name = ] 'column_name']
    [ , [@ODBCVer = ] 'ODBCVer']
    [ , [@fUsePattern = ] 'fUsePattern']

인수

  • [ @procedure_name = ] 'name'
    카탈로그 정보를 반환하는 데 사용되는 프로시저의 이름입니다. name은 nvarchar(390)이며 기본값은 현재 데이터베이스의 모든 테이블을 의미하는 %입니다. 와일드카드 패턴 일치가 지원됩니다.

  • [ @procedure_owner =] 'owner'
    프로시저의 소유자 이름입니다. owner는 nvarchar(384)이며 기본값은 NULL입니다. 와일드카드 패턴 일치가 지원됩니다. owner를 지정하지 않은 경우 기본 DBMS의 기본 프로시저 표시 규칙이 적용됩니다.

    지정한 이름의 프로시저를 현재 사용자가 갖고 있을 경우 해당 프로시저에 대한 정보가 반환됩니다. owner를 지정하지 않았으며 지정한 이름의 프로시저를 현재 사용자가 갖고 있지 않은 경우 sp_sproc_columns는 데이터베이스 소유자가 소유한 지정한 이름의 프로시저를 찾습니다. 프로시저가 있으면 해당 열에 대한 정보가 반환됩니다.

  • [ @procedure_qualifier =] 'qualifier'
    프로시저 한정자의 이름입니다. qualifier는 sysname이며 기본값은 NULL입니다. 다양한 DBMS 제품에서 테이블에 대해 세 부분으로 이루어진 이름(qualifier.owner.name)을 지원합니다. SQL Server에서 이 매개 변수는 데이터베이스 이름을 나타냅니다. 일부 제품에서는 테이블 데이터베이스 환경의 서버 이름을 나타냅니다.

  • [ @column_name =] 'column_name'
    카탈로그 정보 중 한 열만을 사용하고자 할 때 지정하는 단일 열입니다. column_name은 nvarchar(384)이며 기본값은 NULL입니다. column_name을 생략하면 모든 열이 반환됩니다. 와일드카드 패턴 일치가 지원됩니다. 상호 운용성을 극대화하려면 게이트웨이 클라이언트에서 ISO 표준 패턴 일치(% 및 _ 와일드카드 문자)만 사용해야 합니다.

  • [ @ODBCVer =] 'ODBCVer'
    사용하고 있는 ODBC의 버전입니다. ODBCVer는 int이며 기본값은 ODBC 버전 2.0을 의미하는 2입니다. ODBC 버전 2.0과 ODBC 버전 3.0의 차이점에 대한 자세한 내용은 ODBC 버전 3.0에 관한 ODBC SQLProcedureColumns 사양을 참조하십시오.

  • [ @fUsePattern =] 'fUsePattern'
    밑줄(_), 백분율(%) 및 대괄호([ ]) 문자를 와일드카드 문자로 해석할지 여부를 결정합니다. 유효한 값은 0(패턴 일치 해제)과 1(패턴 일치 설정)입니다. fUsePattern은 bit이며 기본값은 1입니다.

반환 코드 값

없음

결과 집합

열 이름

데이터 형식

설명

PROCEDURE_QUALIFIER

sysname

프로시저 한정자 이름입니다. 이 열은 NULL이 될 수 있습니다.

PROCEDURE_OWNER

sysname

프로시저 소유자 이름입니다. 이 열은 항상 값을 반환합니다.

PROCEDURE_NAME

nvarchar(134)

프로시저 이름입니다. 이 열은 항상 값을 반환합니다.

COLUMN_NAME

sysname

반환된 TABLE_NAME의 각 열에 대한 열 이름입니다. 이 열은 항상 값을 반환합니다.

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

DATA_TYPE

smallint

ODBC 데이터 형식에 대한 정수 코드입니다. 데이터 형식을 ISO 형식에 매핑할 수 없는 경우 값은 NULL입니다. 네이티브 데이터 형식 이름이 TYPE_NAME 열에 반환됩니다.

TYPE_NAME

sysname

데이터 형식의 문자열 표시입니다. 이것은 원본으로 사용되는 DBMS에 의해 제시된 데이터 형식 이름입니다.

PRECISION

int

유효 자릿수입니다. PRECISION 열의 값은 10진수로 반환됩니다.

LENGTH

int

데이터의 전송 크기입니다.

SCALE

smallint

소수점 이하 자릿수입니다.

RADIX

smallint

숫자 유형에 대한 기준입니다.

NULLABLE

smallint

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

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

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

REMARKS

varchar(254)

프로시저 열에 대한 설명입니다. SQL Server는 이 열의 값을 반환하지 않습니다.

COLUMN_DEF

nvarchar(4000)

열의 기본값입니다.

SQL_DATA_TYPE

smallint

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

SQL_DATETIME_SUB

smallint

SQL_DATA_TYPE 값이 SQL_DATETIME 또는 SQL_INTERVAL인 경우 datetime ISO interval 하위 코드입니다. datetime 및 ISO interval이 아닌 데이터 형식의 경우 이 필드는 NULL입니다.

CHAR_OCTET_LENGTH

int

character 또는 binary 데이터 형식 열의 최대 길이(바이트)입니다. 다른 모든 데이터 형식의 경우에는 이 열이 NULL을 반환합니다.

ORDINAL_POSITION

int

테이블에 있는 열의 서수 위치입니다. 테이블의 첫 번째 열은 1입니다. 이 열은 항상 값을 반환합니다.

IS_NULLABLE

varchar(254)

테이블에 있는 열의 Null 허용 여부입니다. ISO 규칙에 따라 Null 허용 여부를 결정합니다. ISO 호환 DBMS에서는 빈 문자열을 반환할 수 없습니다.

열이 NULL을 포함할 수 있으면 YES를 표시하고 NULL을 포함할 수 없으면 NO를 표시합니다.

Null 허용 여부를 알 수 없으면 길이가 0인 문자열을 반환합니다.

이 열에 반환되는 값은 NULLABLE 열에 반환되는 값과 다릅니다.

SS_DATA_TYPE

tinyint

확장 저장 프로시저에 사용되는 SQL Server 데이터 형식입니다. 자세한 내용은 데이터 형식(Transact-SQL)을 참조하십시오.

주의

sp_sproc_columns는 ODBC의 SQLProcedureColumns와 같습니다. 반환된 결과는 PROCEDURE_QUALIFIER, PROCEDURE_OWNER, PROCEDURE_NAME 및 매개 변수가 프로시저 정의에 표시되는 순서대로 정렬됩니다.

사용 권한

스키마에 대한 SELECT 권한이 필요합니다.

참고 항목

참조

카탈로그 저장 프로시저(Transact-SQL)

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