추가 테이블 반환 매개 변수 메타데이터

응용 프로그램은 테이블 반환 매개 변수에 대한 메타데이터를 검색하기 위해 SQLProcedureColumns를 호출합니다. SQLProcedureColumns는 테이블 반환 매개 변수에 대해 단일 행을 반환합니다. 두 개의 추가 SQL Server 특정 열인 SS_TYPE_CATALOG_NAME 및 SS_TYPE_SCHEMA_NAME은 테이블 반환 매개 변수와 연결된 테이블 형식의 스키마 및 카탈로그 정보를 제공하기 위해 추가되었습니다. ODBC 사양에 따라 SS_TYPE_CATALOG_NAME 및 SS_TYPE_SCHEMA_NAME은 이전 버전의 SQL Server에 추가된 모든 드라이버별 열 앞에, 그리고 ODBC 자체에서 지정한 모든 열 뒤에 표시됩니다.

다음 표에서는 테이블 반환 매개 변수에서 중요한 열을 나열합니다.

열 이름	데이터 형식	값/설명
DATA_TYPE	NULL이 아닌 Smallint	SQL_SS_TABLE
TYPE_NAME	NULL이 아닌 WVarchar(128)	테이블 반환 매개 변수의 형식 이름입니다.
COLUMN_SIZE	Integer	NULL
BUFFER_LENGTH	Integer	0
DECIMAL_DIGITS	Smallint	NULL
NUM_PREC_RADIX	Smallint	NULL
NULLABLE	NULL이 아닌 Smallint	SQL_NULLABLE
REMARKS	Varchar	NULL
COLUMN_DEF	WVarchar(4000)	NULL
SQL_DATA_TYPE	NULL이 아닌 Smallint	SQL_SS_TABLE
SQL_DATETIME_SUB	Smallint	NULL
CHAR_OCTET_LENGTH	Integer	NULL
ORDINAL_POSITION	NULL이 아닌 Integer	매개 변수의 서수 위치입니다.
IS_NULLABLE	Varchar	"YES"
SS_TYPE_CATALOG_NAME	NULL이 아닌 WVarchar(128)	테이블 반환 매개 변수의 테이블 형식에 대한 형식 정의를 포함하는 카탈로그입니다.
SS_TYPE_SCHEMA_NAME	NULL이 아닌 WVarchar(128)	테이블 반환 매개 변수의 테이블 형식에 대한 형식 정의를 포함하는 스키마입니다.

WVarchar 열은 ODBC 사양에 Varchar로 정의되어 있지만 실제로는 최근의 모든 SQL Server ODBC 드라이버에서 WVarchar로 반환됩니다. 이러한 변경 내용은 ODBC 3.5 사양에 유니코드 지원이 추가될 때 적용되었지만 명시적으로 발표되지는 않았습니다.

응용 프로그램은 테이블 반환 매개 변수에 대한 추가 메타데이터를 얻기 위해 카탈로그 함수 SQLColumns 및 SQLPrimaryKeys를 사용합니다. 이러한 함수를 호출하여 테이블 반환 매개 변수를 얻으려면 응용 프로그램에서 문 특성 SQL_SOPT_SS_NAME_SCOPE를 SQL_SS_NAME_SCOPE_TABLE_TYPE으로 설정해야 합니다. 이 값은 응용 프로그램에서 실제 테이블이 아니라 테이블 형식의 메타데이터를 요구한다는 것을 나타냅니다. 그러면 응용 프로그램이 테이블 반환 매개 변수의 TYPE_NAME을 TableName 매개 변수로 전달합니다. SS_TYPE_CATALOG_NAME 및 SS_TYPE_SCHEMA_NAME은 각각 CatalogName 및 SchemaName 매개 변수와 함께 사용되어 테이블 반환 매개 변수의 카탈로그와 스키마를 확인합니다. 응용 프로그램이 테이블 반환 매개 변수의 메타데이터 검색을 마치면 SQL_SOPT_SS_NAME_SCOPE가 기본값인 SQL_SS_NAME_SCOPE_TABLE로 다시 설정됩니다.

SQL_SOPT_SS_NAME_SCOPE가 SQL_SS_NAME_SCOPE_TABLE로 설정되면 연결된 서버에 대한 쿼리가 실패합니다. 서버 구성 요소를 포함하는 카탈로그에 대해 SQLColumns 또는 SQLPrimaryKeys를 호출하면 실패합니다.

참고 항목

개념

테이블 반환 매개 변수(ODBC)