SQLProcedureColumns

적용 대상: SQL Server(지원되는 모든 버전) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics 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 드라이버를 통해 udtxml 데이터 형식을 처리하기 위해 확장된 방법이 나열되어 있습니다.

열 이름 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(Table-Valued Parameters)를 참조하세요.

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

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

자세한 내용은 날짜 및 시간 개선 사항(ODBC)을 참조하세요.

큰 CLR UDT에 대한 SQLProcedureColumns 지원

SQLProcedureColumns 는 큰 CLR UT(사용자 정의 형식)를 지원합니다. 자세한 내용은 큰 CLR User-Defined 형식(ODBC)을 참조하세요.

참고 항목

SQLProcedureColumns 함수(SQLProcedureColumns Function)
ODBC API 구현 정보