SQLProcedureColumns
SQLProcedureColumns는 모든 SQL Server 저장 프로시저의 반환 값 특성을 보고하는 한 행을 반환합니다.
SQLProcedureColumns는 CatalogName, SchemaName, ProcName 또는 ColumnName 매개 변수에 대한 값이 있는지 여부를 SQL_SUCCESS 반환합니다. SQLFetch 는 이러한 매개 변수에 잘못된 값이 사용되는 경우 SQL_NO_DATA 반환합니다.
SQLProcedureColumns는 정적 서버 커서에 대해 실행할 수 있습니다. 업데이트할 수 있는(동적 또는 키 집합) 커서에 대해 SQLProcedureColumns를 실행하려고 하면 커서 유형이 변경되었음을 나타내는 SQL_SUCCESS_WITH_INFO가 반환됩니다.
다음 표에서는 결과 집합에서 반환된 열과 SQL Server Native Client ODBC 드라이버를 통해 udt 및 xml 데이터 형식을 처리하도록 확장된 방법을 나열합니다.
| 열 이름 | Description |
|---|---|
| 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(사용자 정의 형식)를 지원합니다. 자세한 내용은 ODBC(대규모 CLR User-Defined 형식)를 참조하세요.
참고 항목
SQLProcedureColumns 함수(SQLProcedureColumns Function)
ODBC API 구현 정보