DATABASEPROPERTYEX(Transact-SQL)

업데이트: 2006년 7월 17일

지정한 데이터베이스에 대해 지정한 데이터베이스 옵션이나 속성의 현재 설정을 반환합니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

DATABASEPROPERTYEX ( database , property )

인수

  • database
    명명된 속성 정보를 반환할 데이터베이스의 이름을 나타내는 식입니다. database는 **nvarchar(128)**입니다.
  • property
    반환할 데이터베이스 속성의 이름을 나타내는 식입니다. property는 **varchar(128)**이며 다음 값 중 하나일 수 있습니다. 반환 유형은 sql_variant입니다. 다음 표에서는 각 속성 값에 대한 기본 데이터 형식을 보여 줍니다.

    [!참고] 데이터베이스가 시작되지 않은 경우 Microsoft SQL Server 2005 데이터베이스 엔진이 메타데이터에서 값을 검색하지 않고 데이터베이스에 직접 액세스하여 검색하는 속성은 NULL을 반환합니다. 즉, 데이터베이스에 대해 AUTO_CLOSE가 ON으로 설정된 경우 또는 데이터베이스가 오프라인인 경우입니다.

    속성

반환 유형

sql_variant

예외

오류가 발생하거나 호출자가 개체를 볼 수 있는 권한을 갖고 있지 않으면 NULL을 반환합니다.

SQL Server 2005에서 사용자는 소유하고 있거나 사용 권한을 부여 받은 보안 개체의 메타데이터만 볼 수 있습니다. 즉, 사용자가 개체에 대한 사용 권한이 없으면 OBJECT_ID와 같은 메타데이터 내보내기 기본 제공 함수가 NULL을 반환합니다. 자세한 내용은 메타데이터 표시 유형 구성메타데이터 표시 유형 문제 해결을 참조하십시오.

주의

DATABASEPROPERTYEX는 한 번에 하나의 속성 설정만 반환합니다. 여러 속성 설정을 표시하려면 sys.databases 카탈로그 뷰를 사용하십시오.

1. AUTO_SHRINK 데이터베이스 옵션의 상태 검색

다음 예에서는 AdventureWorks 데이터베이스에 대한 AUTO_SHRINK 데이터베이스 옵션의 상태를 반환합니다.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'IsAutoShrink');

결과 집합은 다음과 같습니다. 이것은 AUTO_SHRINK가 해제되었음을 의미합니다.

------------------
0

2. 데이터베이스의 기본 데이터 정렬 검색

다음 예에서는 AdventureWorks 데이터베이스에 대한 기본 데이터 정렬의 이름을 반환합니다.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'Collation');

결과 집합은 다음과 같습니다.

------------------------------
SQL_Latin1_General_CP1_CI_AI

참고 항목

참조

ALTER DATABASE(Transact-SQL)
sys.databases(Transact-SQL)
sys.database_files(Transact-SQL)

관련 자료

데이터베이스 상태
데이터베이스 옵션 설정
sql_variant 데이터 사용

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스 내역

2006년 7월 17일

새로운 내용
  • "예외" 섹션을 추가했습니다.

2006년 4월 14일

변경된 내용
  • ComparisonStyleLCID에 대한 설명을 수정하고 추가했습니다.