DATABASEPROPERTY (Transact-SQL)
Retorna o valor de propriedade do banco de dados nomeado para o nome de propriedade e banco de dados especificados.
![]() |
---|
Esse recurso será removido na próxima versão do Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e modifique, assim que possível, os aplicativos que atualmente o utilizam. Em vez disso, use DATABASEPROPERTYEX. |
Sintaxe
DATABASEPROPERTY ( database , property )
Argumentos
database
É uma expressão que contém o nome do banco de dados para o qual retornará as informações da propriedade nomeada. database é nvarchar(128).property
É uma expressão que contém o nome da propriedade de banco de dados a ser retornada.property é varchar(128) e pode ser um dos valores a seguir.Valor
Descrição
Valor retornado
IsAnsiNullDefault
O banco de dados segue regras ISO para permitir valores nulos.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsAnsiNullsEnabled
Todas as comparações com um nulo são avaliadas como desconhecidas.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsAnsiWarningsEnabled
Quando ocorrem condições de erro padrão, são emitidas mensagens de erro ou de aviso.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsAutoClose
Após a saída do último usuário, o banco de dados é desligado corretamente e libera recursos.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsAutoCreateStatistics
Quando se tornam desatualizadas com a mudança de dados nas tabelas, as estatísticas existentes são atualizadas automaticamente.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsAutoShrink
Os arquivos de banco de dados são candidatos à redução automática periódica.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsAutoUpdateStatistics
Opção de banco de dados de atualização automática de estatística está habilitada.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsBulkCopy
Banco de dados permite operações não registradas no log.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsCloseCursorsOnCommitEnabled
Os cursores que estão abertos quando uma transação é confirmada são fechados.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsDboOnly
Banco de dados está em modo de acesso somente DBO.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsDetached
Banco de dados foi desanexado por uma operação de remoção.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsEmergencyMode
Modo de emergência habilitado, para permitir que um banco de dados suspeito seja utilizável.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsFulltextEnabled
Banco de dados com texto completo habilitado.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsInLoad
Banco de dados está carregando.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsInRecovery
Banco de dados está recuperando.
1 = TRUE
0 = FALSE NULL1 = Entrada inválida
IsInStandBy
O banco de dados está on-line como somente leitura, com log de restauração permitido.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsLocalCursorsDefault
As declarações de cursor assumem LOCAL como padrão.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsNotRecovered
Recuperação do banco de dados falhou.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsNullConcat
Operando de concatenação nulo resulta em NULL.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsOffline
Banco de dados está offline.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsParameterizationForced
A opção SET do banco de dados PARAMETERIZATION é FORCED.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsQuotedIdentifiersEnabled
Pode-se usar aspas duplas em identificadores.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsReadOnly
Banco de dados está em modo de acesso somente leitura.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsRecursiveTriggersEnabled
O acionamento recursivo dos gatilhos está habilitado.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsShutDown
Banco de dados encontrou um problema na inicialização.
1 = TRUE
0 = FALSE
NULL1 = Entrada inválida.
IsSingleUser
Banco de dados está em modo de acesso de usuário único.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsSuspect
Banco de dados é suspeito.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
IsTruncLog
Banco de dados trunca seu log em pontos de verificação.
1 = TRUE
0 = FALSE
NULL = Entrada inválida
Version
Número de versão interno do código do Microsoft SQL Server com o qual o banco de dados foi criado. Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.
Número de versão = Banco de dados está aberto.
NULL = Banco de Dados está fechado.
1 Valor retornado também será NULL se o banco de dados nunca foi iniciado, nem fechado automaticamente.
Tipos de retorno
int
Exceções
Retorna NULL para erro ou caso um chamador não tenha 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. Isso significa que as funções internas emissoras de metadados, como OBJECT_ID, podem retornar NULL se o usuário não tiver permissão no objeto. Para obter mais informações, consulte Configuração de visibilidade de metadados e Solucionando problemas de visibilidade de metadados.
Exemplos
O exemplo a seguir retorna a configuração para a propriedade IsTruncLog para o banco de dados master.
USE master;
GO
SELECT DATABASEPROPERTY('master', 'IsTruncLog');
Aqui está o conjunto de resultados.
-------------------
1