DATABASEPROPERTYEX(Transact-SQL)

적용 대상:SQL 서버Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics분석 플랫폼 시스템(PDW)Microsoft Fabric의 SQL 데이터베이스

SQL Server의 지정된 데이터베이스에 대해 이 함수는 DATABASEPROPERTYEX 지정된 데이터베이스 옵션 또는 속성의 현재 설정을 반환합니다.

Transact-SQL 구문 표기 규칙

구문

DATABASEPROPERTYEX ( database , property )

인수

데이터베이스

명명된 속성 정보를 반환하는 데이터베이스의 이름을 지정하는 DATABASEPROPERTYEX 식입니다. database에는 nvarchar(128) 데이터 형식이 있습니다.

SQL Database에서는 DATABASEPROPERTYEX에 현재 데이터베이스의 이름을 반환합니다. 다른 데이터베이스 이름이 지정된 경우 모든 속성에 대해 반환 NULL 됩니다.

속성

반환할 데이터베이스 속성의 이름을 나타내는 식입니다. property에는 varchar(128) 데이터 형식이 있고, 이 표의 값 중 하나가 지원됩니다.

반환 형식

sql_variant

예외

오류가 발생하거나 호출자에게 개체를 볼 수 있는 권한이 없는 경우 반환 NULL 합니다.

SQL Server에서 사용자는 소유하고 있거나 사용 권한을 부여받은 보안 개체의 메타데이터만 볼 수 있습니다. 이 규칙은 사용자에게 개체에 대한 권한이 없는 경우 반환 OBJECT_ID 할 수 있는 NULL 메타데이터 내보내기 기본 제공 함수를 의미합니다. 자세한 내용은 메타데이터 표시 유형 구성을 참조하세요.

설명

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

예제

이 문서의 코드 샘플은 AdventureWorks2025 또는 AdventureWorksDW2025 샘플 데이터베이스를 사용합니다. 이 데이터베이스는 Microsoft SQL Server 샘플 및 커뮤니티 프로젝트 홈페이지에서 다운로드할 수 있습니다.

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

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

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

결과 집합은 다음과 같습니다. 이는 꺼져 있음을 AUTO_SHRINK 나타냅니다.

0

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

이 예에서는 AdventureWorks 데이터베이스의 여러 속성을 반환합니다.

SELECT DATABASEPROPERTYEX('AdventureWorks2022', 'Collation') AS Collation,
       DATABASEPROPERTYEX('AdventureWorks2022', 'Edition') AS Edition,
       DATABASEPROPERTYEX('AdventureWorks2022', 'ServiceObjective') AS ServiceObjective,
       DATABASEPROPERTYEX('AdventureWorks2022', 'MaxSizeInBytes') AS MaxSizeInBytes;

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

Collation                     Edition        ServiceObjective  MaxSizeInBytes
----------------------------  -------------  ----------------  --------------
SQL_Latin1_General_CP1_CI_AS  DataWarehouse  DW1000            5368709120

C. DATABASEPROPERTYEX를 사용하여 복제본에 대한 연결 확인

Azure SQL Database 스케일 아웃 기능을 사용하는 경우 데이터베이스 컨텍스트에서 다음 쿼리를 실행하여 읽기 전용 복제본에 연결되어 있는지 여부를 확인할 수 있습니다. 읽기 전용 복제본에 연결되면 반환 READ_ONLY 됩니다. 이 방식으로, 읽기 전용 복제본에서 쿼리가 실행되는 경우를 식별할 수도 있습니다.

SELECT DATABASEPROPERTYEX(DB_NAME(), 'Updateability');

관련 콘텐츠

• ALTER DATABASE(Transact-SQL)
• 데이터베이스 상태
• sys.databases(Transact-SQL)
• sys.database_files(Transact-SQL)
• SERVERPROPERTY(Transact-SQL)