SQLProcedureColumns

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform 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_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(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 사용자 정의 형식)를 참조하세요.

참고 항목

SQLProcedureColumns 함수
ODBC API 구현 정보