sp_columns_ex(Transact-SQL)

아티클
12/15/2008

업데이트: 2006년 7월 17일

지정된 연결된 서버 테이블에 대해 각 열마다 한 행씩 열 정보를 반환합니다. sp_columns_ex는 column이 지정된 경우에 지정된 열에 대해서만 열 정보를 반환합니다.

구문

sp_columns_ex [ @table_server = ] 'table_server' 
     [ , [ @table_name = ] 'table_name' ] 
     [ , [ @table_schema = ] 'table_schema' ] 
     [ , [ @table_catalog = ] 'table_catalog' ] 
     [ , [ @column_name = ] 'column' ] 
     [ , [ @ODBCVer = ] 'ODBCVer' ]

인수

[ @table_server = ] 'table_server'
열 정보가 반환될 연결된 서버의 이름입니다. table_server는 sysname이며 기본값은 없습니다.

[ @table_name = ] 'table_name'
열 정보를 반환할 대상이 되는 테이블의 이름입니다. table_name은 sysname이며 기본값은 NULL입니다.

[ @table_schema = ] 'table_schema'
열 정보를 반환할 대상이 되는 테이블의 스키마 이름입니다. table_schema는 sysname이며 기본값은 NULL입니다.

[ @table_catalog = ] 'table_catalog'
열 정보를 반환할 대상이 되는 테이블의 카탈로그 이름입니다. table_catalog는 sysname이며 기본값은 NULL입니다.

[ @column_name = ] 'column'
정보를 제공할 대상이 되는 데이터베이스 열의 이름입니다. column은 sysname이며 기본값은 NULL입니다.

[ @ODBCVer =] 'ODBCVer'
사용 중인 ODBC의 버전입니다. ODBCVer은 int이며 기본값은 2입니다. 이 값은 ODBC 버전 2를 나타내며 유효한 값은 2 또는 3입니다. 버전 2 및 3 간의 동작 차이에 대한 자세한 내용은 ODBC SQLColumns 사양을 참조하십시오.

반환 코드 값

없음

결과 집합

열 이름	데이터 형식	설명
TABLE_CAT	sysname	테이블 또는 뷰 한정자 이름입니다. 다양한 DBMS 제품에서 테이블에 대해 3부분으로 구성된 이름(qualifier.owner.name)을 지원합니다. SQL Server 2005에서 이 열은 데이터베이스 이름을 나타냅니다. 일부 제품에서는 테이블 데이터베이스 환경의 서버 이름을 나타냅니다. 이 필드는 NULL이 될 수 있습니다.
TABLE_SCHEM	sysname	테이블 또는 뷰 소유자 이름입니다. SQL Server에서 이 열은 테이블을 만든 데이터베이스 사용자의 이름을 나타냅니다. 이 필드는 항상 값을 반환합니다.
TABLE_NAME	sysname	테이블 또는 뷰 이름입니다. 이 필드는 항상 값을 반환합니다.
COLUMN_NAME	sysname	반환된 TABLE_NAME의 각 열에 대한 열 이름입니다. 이 필드는 항상 값을 반환합니다.
DATA_TYPE	smallint	ODBC 형식 식별자에 해당하는 정수 값입니다. ODBC 형식에 매핑될 수 없는 데이터 형식인 경우에 이 값은 NULL이 됩니다. 네이티브 데이터 형식 이름이 TYPE_NAME 열에 반환됩니다.
TYPE_NAME	varchar(13)	데이터 형식을 나타내는 문자열입니다. 기본 DBMS는 이 데이터 형식 이름을 표시합니다.
COLUMN_SIZE	int	유효 자리 수입니다. PRECISION 열의 반환 값은 10을 기준으로 합니다.
BUFFER_LENGTH	int	데이터의 전송 크기입니다.1
DECIMAL_DIGITS	smallint	소수점의 오른쪽 자리 수입니다.
NUM_PREC_RADIX	smallint	숫자 데이터 형식의 기준입니다.
NULLABLE	smallint	NULL 허용 여부를 지정합니다. 1 = NULL을 사용할 수 있습니다. 0 = NULL을 사용할 수 없습니다.
REMARKS	varchar(254)	이 필드는 항상 NULL을 반환합니다.
COLUMN_DEF	varchar(254)	열의 기본값입니다. SQL Server 2005는 카탈로그 메타데이터에 SQL 식을 디코딩하고 저장하는 방식에서 SQL Server 2000과 다릅니다. 디코딩된 식의 의미 체계는 원본 텍스트와 동일하지만 구문은 일치하지 않을 수 있습니다. 예를 들어 공백은 디코딩된 식에서 제거됩니다. 자세한 내용은 SQL Server 2005 데이터베이스 엔진 기능의 동작 변경을 참조하십시오.
SQL_DATA_TYPE	smallint	설명자의 TYPE 필드에 표시된 SQL 데이터 형식의 값입니다. 이 열은 datetime 및 SQL-92 interval 데이터 형식을 제외하고 DATA_TYPE 열과 동일합니다. 이 열은 항상 값을 반환합니다.
SQL_DATETIME_SUB	smallint	datetime 및 SQL-92 interval 데이터 형식에 대한 하위 유형 코드입니다. 이 열은 다른 데이터 형식에 대해서는 NULL을 반환합니다.
CHAR_OCTET_LENGTH	int	문자 또는 정수 데이터 형식 열의 최대 길이를 바이트로 표시한 것입니다 이 열은 다른 모든 데이터 형식에 대해서는 NULL을 반환합니다.
ORDINAL_POSITION	int	테이블에 있는 열의 순서 위치입니다. 테이블의 첫 번째 열은 1입니다. 이 열은 항상 값을 반환합니다.
IS_NULLABLE	varchar(254)	테이블에 있는 열의 Null 허용 여부입니다. ISO 규칙을 따라서 Null 허용 여부를 결정합니다. ISO SQL-호환 DBMS에서는 빈 문자열을 반환할 수 없습니다. YES = Column이 NULL을 포함할 수 있습니다. NO = Column이 NULL을 포함할 수 없습니다. Null 허용을 알 수 없으면 이 열에서는 길이가 0인 문자열을 반환합니다. 이 열에 대해 반환되는 값은 NULLABLE 열에 대해 반환되는 값과 다릅니다.
SS_DATA_TYPE	tinyint	확장 저장 프로시저에 사용되는 SQL Server 데이터 형식입니다. 자세한 내용은 데이터 형식(데이터베이스 엔진)을 참조하십시오.

자세한 내용은 Microsoft ODBC 설명서를 참조하십시오.

주의

sp_columns_ex는 table_server에 해당되는 OLE DB 공급자의 IDBSchemaRowset 인터페이스에 있는 COLUMNS 행 집합을 쿼리하여 실행됩니다. 반환되는 행 수를 제한하기 위해 table_name, table_schema, table_catalog 및 column 매개 변수가 이 인터페이스로 전달됩니다.

sp_columns_ex는 지정된 연결된 서버의 OLE DB 공급자가 IDBSchemaRowset 인터페이스의 COLUMNS 행 집합을 지원하지 않는 경우 빈 결과 집합을 반환합니다.

사용 권한

스키마에 대한 SELECT 권한이 필요합니다.

예

다음 예에서는 연결된 서버 Seattle1에 있는 AdventureWorks 데이터베이스의 HumanResources.Employee 테이블에 있는 Title 열에 대한 데이터 형식을 반환합니다.

EXEC sp_columns_ex 'Seattle1', 
   'Employee', 
   'HumanResources', 
   'AdventureWorks', 
   'Title';

참고 항목

참조

sp_catalogs(Transact-SQL)
sp_foreignkeys(Transact-SQL)
sp_indexes(Transact-SQL)
sp_linkedservers(Transact-SQL)
sp_primarykeys(Transact-SQL)
sp_tables_ex(Transact-SQL)
sp_table_privileges(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스	내역
2006년 7월 17일	새로운 내용 COLUMN_DEF 열에 SQL 식이 SQL Server 2005에 저장되는 방법에 대한 내용을 추가했습니다.

다음을 통해 공유