다음을 통해 공유


SQLProcedureColumns

SQLProcedureColumns는 모든 SQL Server 저장 프로시저의 반환 값 특성을 보고하는 하나의 행을 반환합니다.

SQLProcedureColumnsCatalogName, SchemaName, ProcName 또는 ColumnName 매개 변수에 값이 있는지 여부에 관계없이 SQL_SUCCESS를 반환합니다. 이 매개 변수에 잘못된 값이 사용되면 SQLFetch는 SQL_NO_DATA를 반환합니다.

SQLProcedureColumns는 정적 서버 커서에 대해 실행할 수 있습니다. 업데이트할 수 있는(동적 또는 키 집합) 커서에 대해 SQLProcedureColumns를 실행하려고 하면 커서 유형이 변경되었음을 나타내는 SQL_SUCCESS_WITH_INFO가 반환됩니다.

다음 표에서는 결과 집합에 반환되는 열과 SQL Server Native Client ODBC 드라이버를 통해 이러한 열이 udtxml 데이터 형식을 처리하도록 확장된 방법을 표시합니다.

열 이름

설명

SS_UDT_CATALOG_NAME

UDT(사용자 정의 형식)를 포함하는 카탈로그의 이름을 반환합니다.

SS_UDT_SCHEMA_NAME

UDT가 포함된 스키마의 이름을 반환합니다.

SS_UDT_ASSEMBLY_TYPE_NAME

UDT의 정규화된 어셈블리 이름을 반환합니다.

SS_XML_SCHEMACOLLECTION_CATALOG_NAME

XML 스키마 컬렉션 이름이 정의된 카탈로그의 이름을 반환합니다. 카탈로그 이름을 찾을 수 없는 경우 이 변수에는 빈 문자열이 포함됩니다.

SS_XML_SCHEMACOLLECTION_SCHEMA_NAME

XML 스키마 컬렉션 이름이 정의된 스키마의 이름을 반환합니다. 스키마 이름을 찾을 수 없는 경우 이 변수에는 빈 문자열이 포함됩니다.

SS_XML_SCHEMACOLLECTION_NAME

XML 스키마 컬렉션의 이름을 반환합니다. 이름을 찾을 수 없는 경우 이 변수에는 빈 문자열이 포함됩니다.

SQLProcedureColumns와 테이블 반환 매개 변수

SQLProcedureColumns는 CLR 사용자 정의 형식과 유사한 방식으로 테이블 반환 매개 변수를 처리합니다. 테이블 반환 매개 변수에 대해 반환되는 행의 열은 다음과 같은 값을 갖습니다.

열 이름

설명/값

DATA_TYPE

SQL_SS_TABLE

TYPE_NAME

테이블 반환 매개 변수에 대한 테이블 유형의 이름입니다.

COLUMN_SIZE

NULL

BUFFER_LENGTH

0

DECIMAL_DIGITS

테이블 반환 매개 변수의 열 수입니다.

NUM_PREC_RADIX

NULL

NULLABLE

SQL_NULLABLE

REMARKS

NULL

COLUMN_DEF

NULL입니다. 테이블 유형에 기본값이 없을 수도 있습니다.

SQL_DATA_TYPE

SQL_SS_TABLE

SQL_DATEIME_SUB

NULL

CHAR_OCTET_LENGTH

NULL

IS_NULLABLE

"YES"

SS_TYPE_CATALOG_NAME

테이블 또는 CLR 사용자 정의 형식을 포함하는 카탈로그의 이름을 반환합니다.

SS_TYPE_SCHEMA_NAME

테이블 또는 CLR 사용자 정의 형식을 포함하는 스키마의 이름을 반환합니다.

SS_TYPE_CATALOG_NAME 및 SS_TYPE_SCHEMA_NAME 열은 각각 테이블 반환 매개 변수의 카탈로그와 스키마를 반환하기 위해 SQL Server 2008 이상 버전에서 사용 가능합니다. 두 열은 테이블 반환 매개 변수뿐만 아니라 CLR 사용자 정의 형식 매개 변수에 대해서도 채워집니다. CLR 사용자 정의 형식 매개 변수의 기존 스키마 및 카탈로그 열은 이 추가 기능의 영향을 받지 않습니다. 또한 두 열은 이전 버전과의 호환성을 유지하기 위해 채워집니다.

ODBC 사양에 따라 SS_TYPE_CATALOG_NAME 및 SS_TYPE_SCHEMA_NAME은 이전 버전의 SQL Server에 추가된 모든 드라이버별 열 앞에, 그리고 ODBC 자체에서 지정한 모든 열 뒤에 표시됩니다.

테이블 반환 매개 변수에 대한 자세한 내용은 테이블 반환 매개 변수(ODBC)를 참조하십시오.

향상된 날짜 및 시간 기능에 대한 SQLProcedureColumns 지원

날짜/시간 형식에 대해 반환되는 값에 대한 자세한 내용은 카탈로그 메타데이터를 참조하십시오.

자세한 내용은 날짜/시간 기능 향상(ODBC)을 참조하십시오.

큰 CLR UDT에 대한 SQLProcedureColumns 지원

SQLProcedureColumns는 큰 CLR UDT(사용자 정의 형식)를 지원합니다. 자세한 내용은 큰 CLR 사용자 정의 형식(ODBC)을 참조하십시오.

참고 항목

개념

ODBC API 구현 정보

관련 자료

SQLProcedureColumns 함수(SQLProcedureColumns Function)