SQLProcedureColumns
적용 대상: 
SQL ServerAzure SQL 데이터베이스Azure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System(PDW)
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 데이터 형식을 처리하도록 확장된 방법을 나열합니다.
| 열 이름 | 설명 |
|---|---|
| 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_DATETIME_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(10.0.x) 이상 버전에서 테이블 반환 매개 변수에 대해 카탈로그와 스키마를 각각 반환할 수 있습니다. 이러한 열은 테이블 반환 매개 변수 및 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 사용자 정의 형식)를 참조하세요.