DATABASEPROPERTYEX (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Para um banco de dados especificado em SQL Server, essa função retorna a configuração atual da opção ou propriedade de banco de dados especificada.

Convenções de sintaxe de Transact-SQL

Sintaxe

DATABASEPROPERTYEX ( database , property )  

Argumentos

database
É uma expressão que especifica o nome do banco de dados para o qual DATABASEPROPERTYEX retorna as informações da propriedade nomeada. database tem um tipo de dados nvarchar (128) .

Para Banco de Dados SQL, DATABASEPROPERTYEX requer o nome do banco de dados atual. Retornará NULL para todas as propriedades se for fornecido um nome de banco de dados diferente.

property
É uma expressão que especifica o nome da propriedade do banco de dados a ser retornada. property tem um tipo de dados varchar (128) e dá suporte a um dos valores nesta tabela:

Observação

Se o banco de dados ainda não foi iniciado, as chamadas para DATABASEPROPERTYEX retornarão NULL se DATABASEPROPERTYEX recuperar esses valores por acesso direto do banco de dados, em vez da recuperação dos metadados. Um banco de dados com AUTO_CLOSE definida como ON ou, caso contrário, offline, é definido como "não iniciado".

Propriedade	Descrição	Valor retornado
Collation	O nome da ordenação padrão para o banco de dados.	Nome da ordenação NULL: o banco de dados não foi iniciado. Tipo de dados base: nvarchar(128)
ComparisonStyle	O estilo de comparação da ordenação do Windows. Use os seguintes valores de estilo para criar um bitmap para o valor ComparisonStyle concluído: Ignore case: 1 Ignore accent: 2 Ignorar kana: 65536 Ignore width: 131072 Por exemplo, o padrão de 196609 é o resultado de combinar as opções ignorar maiúsculas e minúsculas, ignorar kana e ignorar largura.	Retorna o estilo de comparação. Retorna 0 para todas as ordenações primárias. Tipo de dados base: int
Edition	A camada de edição ou de serviço do banco de dados.	Aplica-se a: Banco de Dados SQL do Azure, Azure Synapse Analytics. Uso Geral Comercialmente Crítico Basic Standard Premium Sistema (para o banco de dados mestre) NULL: o banco de dados não foi iniciado. Tipo de dados base: nvarchar(64)
IsAnsiNullDefault	O banco de dados segue regras de ISO por permitir valores nulos.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsAnsiNullsEnabled	Todas as comparações com um nulo são avaliadas como desconhecido.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsAnsiPaddingEnabled	As cadeias de caracteres são convertidas na mesma largura antes da comparação ou inserção.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsAnsiWarningsEnabled	Mensagens de erro ou de aviso do SQL Server quando ocorrem condições de erro padrão.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsArithmeticAbortEnabled	Consultas são encerradas quando um erro de estouro ou divisão por zero ocorre durante a execução da consulta.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsAutoClose	O banco de dados é desligado corretamente e libera recursos depois da saída do último usuário.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsAutoCreateStatistics	O otimizador de consulta cria estatísticas de coluna única, conforme necessário, para melhorar o desempenho de consulta.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsAutoCreateStatisticsIncremental	As estatísticas e coluna única criadas automaticamente são incrementais quando possível.	Aplica-se a: SQL Server 2014 (12.x) e posterior. 1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsAutoShrink	Os arquivos de banco de dados são candidatos à redução automática periódica.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsAutoUpdateStatistics	Quando uma consulta usa estatísticas existentes potencialmente desatualizadas, o otimizador de consulta atualiza as estatísticas.	1: TRUE 0: FALSE NULL: Entrada não válida Tipo de dados base: int
IsClone	O banco de dados é uma cópia somente de esquema e estatísticas de um banco de dados de usuário criado com DBCC CLONEDATABASE. Confira o artigo do Suporte da Microsoft para obter mais informações.	Aplica-se ao: SQL Server 2014 (12.x) SP2 e posterior. 1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsCloseCursorsOnCommitEnabled	Quando uma transação é confirmada, todos os cursores abertos serão fechados.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsDatabaseSuspendedForSnapshotBackup	O banco de dados está suspenso.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsFulltextEnabled	O banco de dados está habilitado para indexação de texto completo e semântica.	Aplica-se a: SQL Server 2008 (10.0.x) e posterior. 1: TRUE 0: FALSE NULL: Entrada não válida Tipo de dados base: int Observação: O valor dessa propriedade agora não tem nenhum efeito. Os bancos de dados de usuário são sempre habilitados para pesquisa de texto completo. Uma versão futura do SQL Server removerá essa propriedade. Não use essa propriedade em desenvolvimentos novos e modifique, assim que possível, os aplicativos que atualmente a usam.
IsInStandBy	O banco de dados está online como somente leitura, com o log de restauração permitido.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsLocalCursorsDefault	As declarações de cursor assumem LOCAL como padrão.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsMemoryOptimizedElevateToSnapshotEnabled	As tabelas com otimização de memória são acessadas usando o isolamento SNAPSHOT quando a configuração de sessão TRANSACTION ISOLATION LEVEL é definida como READ COMMITTED, READ UNCOMMITTED ou um nível de isolamento inferior.	Aplica-se a: SQL Server 2014 (12.x) e posterior. 1: TRUE 0: FALSE Tipo de dados base: int
IsMergePublished	SQL Server dá suporte à publicação da tabela de um banco de dados para replicação de mesclagem, caso a replicação tenha sido instalada.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsNullConcat	O operando de concatenação nulo resulta em NULL.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsNumericRoundAbortEnabled	Erros são gerados quando a perda de precisão ocorre em expressões.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsParameterizationForced	A opção SET de banco de dados PARAMETERIZATION é FORCED.	1: TRUE 0: FALSE NULL: Entrada inválida
IsQuotedIdentifiersEnabled	São permitidas aspas duplas em identificadores.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsPublished	Se a replicação tiver sido instalada, haverá suporte de SQL Server à publicação de tabelas do banco de dados por instantâneo ou replicação transacional.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsRecursiveTriggersEnabled	O acionamento recursivo dos disparadores está habilitado.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsSubscribed	O banco de dados é assinado para uma publicação.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsSyncWithBackup	Este é um banco de dados publicado ou um banco de dados de distribuição e dá suporte à restauração sem romper a replicação transacional.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsTornPageDetectionEnabled	O Mecanismo de Banco de Dados do SQL Server detecta operações de E/S incompletas causadas por falhas de energia ou outros problemas no sistema.	1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsVerifiedClone	O banco de dados é uma cópia somente de esquema e estatísticas de um banco de dados de usuário criado usando a opção WITH VERIFY_CLONEDB de DBCC CLONEDATABASE. Confira este artigo do Suporte da Microsoft para obter mais informações.	Aplica-se ao: Começando com SQL Server 2016 (13.x) SP2. 1: TRUE 0: FALSE NULL: Entrada inválida Tipo de dados base: int
IsXTPSupported	Indica se o banco de dados dá suporte ao OLTP In-Memory. Por exemplo, a criação e uso de tabelas com otimização de memória e módulos compilados nativamente. Específico ao SQL Server: IsXTPSupported não depende da existência de um grupo de arquivos MEMORY_OPTIMIZED_DATA, que é necessário para a criação de objetos OLTP in-memory.	Aplica-se a: SQL Server (SQL Server 2016 (13.x) e posterior) e Banco de Dados SQL do Azure. 1: TRUE 0: FALSE NULL: Entrada inválida, um erro ou não aplicável Tipo de dados base: int
LastGoodCheckDbTime	A data e hora do último DBCC CHECKDB bem-sucedido executado no banco de dados especificado.1 Se DBCC CHECKDB não tiver sido executado em um banco de dados, 1900-01-01 00:00:00.000 será retornado.	Aplica-se a: SQL Server 2016 (13.x) a partir do SP2. SQL Server 2017 (14.x) a partir do CU9. SQL Server 2019 (15.x) ou posterior. Banco de Dados SQL do Azure. Um valor datetime NULL: Entrada inválida Tipo de dados base: datetime
LCID	O LCID (identificador de localidade) do Windows da ordenação.	Valor LCID (em formato decimal). Tipo de dados base: int
MaxSizeInBytes	Tamanho máximo do banco de dados, em bytes.	Aplica-se a: Banco de Dados SQL do Azure, Azure Synapse Analytics. Banco de Dados SQL do Azure e Azure Synapse Analytics – o valor é baseado no SLO, a menos que armazenamento adicional tenha sido comprado. vCore – o valor está em incrementos de 1 GB até o tamanho máximo. NULL: o banco de dados não foi iniciado Tipo de dados base: bigint
Recuperação	Modelo de recuperação de banco de dados	FULL: Modelo de recuperação completa BULK_LOGGED: Modelo registrado em log em massa SIMPLE: Modelo de recuperação simples Tipo de dados base: nvarchar(128)
ServiceObjective	Descreve o nível de desempenho do banco de dados no Banco de Dados SQL ou Azure Synapse Analytics.	Um dos seguintes valores: Nulo: banco de dados não iniciado Compartilhado (para edições Web/Business) Basic S0 S1 S2 S3 P1 P2 P3 ElasticPool Sistema (para o banco de dados mestre) Tipo de dados base: nvarchar(32)
ServiceObjectiveId	O ID do objetivo de serviço em Banco de Dados SQL.	uniqueidentifier que identifica o objetivo de serviço.
SQLSortOrder	Identificação de ordem de classificação SQL Server com suporte em versões anteriores do SQL Server.	0: o banco de dados usa ordenação do Windows >0: ID da ordem de classificação do SQL Server ID NULL: entrada inválida ou banco de dados não foi iniciado Tipo de dados base: tinyint
Status	Status do banco de dados.	ONLINE: o banco de dados está disponível para consulta. Observação: A função pode retornar um status ONLINE enquanto o banco de dados for aberto e ainda não tiver sido recuperado. Para identificar se um banco de dados ONLINE pode aceitar conexões, consulte a propriedade Ordenação de DATABASEPROPERTYEX. O banco de dados ONLINE pode aceitar conexões quando a ordenação de banco de dados retorna um valor não nulo. Para bancos de dados Always On, consulte as colunas database_state ou database_state_desc de sys.dm_hadr_database_replica_states. OFFLINE: o banco de dados foi colocado em offline explicitamente. RESTORING: a restauração de banco de dados foi iniciada. RECOVERING: a recuperação do banco de dados foi iniciada e o banco de dados ainda não está pronto para consultas. SUSPECT: o banco de dados não foi recuperado. EMERGENCY: o banco de dados está em uma emergência, em estado somente leitura. O acesso está restrito a membros sysadmin Tipo de dados base: nvarchar(128)
Updateability	Indica se os dados podem ser modificados.	READ_ONLY: o banco de dados dá suporte a leituras de dados, mas não a modificações de dados. READ_WRITE: o banco de dados dá suporte a leituras e a modificações de dados. Tipo de dados base: nvarchar(128)
UserAccess	Indica quais usuários podem acessar o banco de dados.	SINGLE_USER: apenas um usuário db_owner, dbcreator ou sysadmin por vez RESTRICTED_USER: apenas membros das funções db_owner, dbcreator ou sysadmin MULTI_USER: todos os usuários Tipo de dados base: nvarchar(128)
Versão	Número de versão interno do código SQL Server com que o banco de dados foi criado. Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.	Número de versão: o banco de dados está aberto. NULL: o banco de dados não foi iniciado. Tipo de dados base: int
ReplicaID	A ID de réplica de uma réplica/banco de dados de hiperescala conectado.	Aplica-se a: Banco de Dados SQL do Azure. Retornará somente a ID de réplica de uma réplica/banco de dados de hiperescala conectado. Para saber mais sobre tipos de réplica, confira Réplicas secundárias de hiperescala. NULL: não é um banco de dados de hiperescala ou o banco de dados não foi iniciado. Tipo de dados base: nvarchar(128)

Observação

¹ Para bancos de dados que fazem parte de um grupo de disponibilidade, LastGoodCheckDbTime retornará a data e hora do último DBCC CHECKDB bem-sucedido executado na réplica primária, independentemente da réplica da qual você está executando o comando.

Tipos de retorno

sql_variant

Exceções

Retornará NULL em caso de erro ou se um chamador não tiver permissão para exibir o objeto.

No SQL Server, um usuário só pode exibir os metadados de itens protegíveis de sua propriedade ou para os quais ele tenha permissão concedida. Essa regra significa que as funções internas que emitem metadados, como OBJECT_ID, poderão retornar NULL se o usuário não tiver permissões para o objeto. Veja Configuração de Visibilidade de Metadados para obter mais informações.

Comentários

DATABASEPROPERTYEX retorna somente uma configuração de propriedade por vez. Para exibir várias configurações de propriedade, use a exibição do catálogo sys.databases.

Exemplos

a. Recuperando o estado da opção de banco de dados AUTO_SHRINK

Este exemplo retorna o status da opção de banco de dados AUTO_SHRINK para o banco de dados AdventureWorks.

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

Veja a seguir o conjunto de resultados. Isso indica que AUTO_SHRINK está desativada.

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

B. Recuperando a ordenação padrão de um banco de dados

Este exemplo retorna vários atributos do banco de dados AdventureWorks.

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

Veja a seguir o conjunto de resultados.

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

C. Usar DATABASEPROPERTYEX para verificar a conexão com a réplica

Ao usar o Banco de Dados SQL do Azure para ler o recurso de expansão, você pode verificar se está conectado a uma réplica somente leitura ou não executando a consulta a seguir no contexto do banco de dados. Ela retornará READ_ONLY quando você estiver conectado a uma réplica somente leitura. Dessa forma, você também pode identificar quando uma consulta está em execução em uma réplica somente leitura.

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

Confira também

ALTER DATABASE (Transact-SQL)
Estados de banco de dados
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
SERVERPROPERTY (Transact-SQL)