sp_columns_ex(Transact-SQL)
적용 대상:SQL Server
지정한 연결된 서버 테이블에 대해 각 열마다 한 행씩 열 정보를 반환합니다. sp_columns_ex 열이 지정된 경우 특정 열에 대해서만 열 정보를 반환합니다.
구문
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'
정보를 제공할 데이터베이스 열의 이름입니다. 열은 sysname이며 기본값은 NULL입니다.
[ @ODBCVer = ] 'ODBCVer'
사용 중인 ODBC 버전입니다. ODBCVer는 기본값이 2인 int입니다. 이는 ODBC 버전 2를 나타냅니다. 유효한 값은 2 또는 3입니다. 버전 2와 버전 3의 동작 차이에 대한 자세한 내용은 ODBC SQLColumns 사양을 참조하십시오.
반환 코드 값
아니요
결과 집합
열 이름 | 데이터 형식 | 설명 |
---|---|---|
TABLE_CAT | sysname | 테이블 또는 뷰 한정자 이름입니다. 다양한 DBMS 제품은 테이블(한정자)에 대해 세 부분으로 구성된 명명을 지원합니다.소유자입니다.name). SQL Server에서 이 열은 데이터베이스 이름을 나타냅니다. 일부 제품에서는 테이블 데이터베이스 환경의 서버 이름을 나타냅니다. 이 필드는 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 열의 반환 값은 base 10입니다. |
BUFFER_LENGTH | int | 데이터의 전송 크기입니다.1 |
DECIMAL_DIGITS | smallint | 소수점 오른쪽에 있는 자릿수입니다. |
NUM_PREC_RADIX | smallint | 숫자 데이터 형식의 기준입니다. |
Nullable | smallint | NULL 허용 여부를 지정합니다. 1 = NULL이 가능합니다. 0 = NULL이 아닙니다. |
발언 | varchar(254) | 이 필드는 항상 NULL을 반환합니다. |
COLUMN_DEF | varchar(254) | 열의 기본값입니다. |
SQL_DATA_TYPE | smallint | 설명자의 TYPE 필드에 표시되는 SQL 데이터 형식의 값입니다. 이 열은 datetime 및 SQL-92 간격 데이터 형식을 제외하고 DATA_TYPE 열과 동일합니다. 이 열은 항상 값을 반환합니다. |
SQL_DATETIME_SUB | smallint | datetime 및 SQL-92 간격 데이터 형식에 대한 하위 형식 코드입니다. 이 열은 다른 데이터 형식에 대해서는 NULL을 반환합니다. |
CHAR_OCTET_LENGTH | int | 문자 또는 정수 데이터 형식 열의 최대 길이(바이트)입니다. 이 열은 다른 모든 데이터 형식에 대해서는 NULL을 반환합니다. |
ORDINAL_POSITION | int | 표에 있는 열의 서수 위치입니다. 테이블의 첫 번째 열은 1입니다. 이 열은 항상 값을 반환합니다. |
IS_NULLABLE | varchar(254) | 테이블 열의 Null 허용 여부입니다. ISO 규칙을 따라 Null 허용 여부를 확인합니다. ISO SQL 규격 DBMS는 빈 문자열을 반환할 수 없습니다. 예 = 열에 NULLS가 포함될 수 있습니다. NO = 열에 NULLS를 포함할 수 없습니다. 이 열은 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 및 열 매개 변수가 이 인터페이스에 전달됩니다.
sp_columns_ex 지정된 연결된 서버의 OLE DB 공급자가 IDBSchemaRowset 인터페이스의 COLUMNS 행 집합을 지원하지 않는 경우 빈 결과 집합을 반환합니다.
sp_columns_ex 구분된 식별자에 대한 요구 사항을 따릅니다. 자세한 내용은 Database Identifiers을 참조하세요.
사용 권한
스키마에 대한 SELECT 권한이 필요합니다.
예
다음 예제에서는 연결된 서버의 JobTitle
데이터베이스에 있는 AdventureWorks2022
테이블 열의 HumanResources.Employee
데이터 형식을 반환Seattle1
합니다.
EXEC sp_columns_ex 'Seattle1',
'Employee',
'HumanResources',
'AdventureWorks2022',
'JobTitle';
참고 항목
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)
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기