Artigo
04/01/2012

sp_unbindefault (Transact-SQL)

Desassocia, ou remove, um padrão de uma coluna ou de um tipo de dados de alias no banco de dados atual.

Importante
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, recomendamos criar definições padrão usando a palavra-chave DEFAULT nas instruções ALTER TABLE ou CREATE TABLE. Para obter mais informações, consulte Criando e modificando definições DEFAULT.

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, recomendamos criar definições padrão usando a palavra-chave DEFAULT nas instruções ALTER TABLE ou CREATE TABLE. Para obter mais informações, consulte Criando e modificando definições DEFAULT.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

sp_unbindefault [ @objname = ] 'object_name' 
     [ , [ @futureonly = ] 'futureonly_flag' ]

Argumentos

[ @objname= ] 'object_name'
É o nome da tabela e da coluna ou o tipo de dados do alias ao qual o padrão deve ser desassociado. object_name é nvarchar(776), sem nenhum padrão. SQL Server tenta resolver os identificadores de duas partes, primeiro, para os nomes de coluna e, depois, para tipos de dados de alias.

Ao desassociar um padrão de um tipo de dados de alias, as colunas desse tipo de dados que tiverem o mesmo padrão também serão desassociadas. As colunas desse tipo de dados com padrões associados diretamente não serão afetadas.

Observação
object_name pode conter colchetes [ ] como caracteres de identificador delimitados. Para obter mais informações, consulte Identificadores delimitados (Mecanismo de Banco de Dados).

[ @futureonly= ] 'futureonly_flag'
É usado apenas ao desassociar um padrão de um tipo de dados de alias futureonly_flag é varchar(15), com um padrão NULL. Quando futureonly_flag for futureonly, as colunas existentes do tipo de dados não perdem o padrão especificado.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

Para exibir o texto de um padrão, execute sp_helptext com o nome do padrão como o parâmetro.

Permissões

Para desassociar um padrão de uma coluna de tabela é necessário ter a permissão ALTER na tabela. Para desassociar um padrão de um tipo de dados de alias, é necessário ter a permissão CONTROL no tipo ou a permissão ALTER no esquema ao qual o tipo pertence.

Exemplos

A. Desassociando um padrão de uma coluna

O exemplo a seguir desassocia o padrão da coluna hiredate de uma tabela employees.

EXEC sp_unbindefault 'employees.hiredate'

B. Desassociando um padrão de um tipo de dados de alias

O exemplo a seguir desassocia o padrão do tipo de dados de alias ssn. Ele desassocia as colunas existentes e futuras desse tipo.

EXEC sp_unbindefault 'ssn'

C. Usando futureonly_flag

O exemplo a seguir desassocia usos futuros do tipo de dados de alias ssn sem afetar as colunas ssn existentes.

EXEC sp_unbindefault 'ssn', 'futureonly'

D. Usando identificadores delimitados

O exemplo a seguir mostra o uso de identificadores delimitados no parâmetro object_name .

CREATE TABLE [t.3] (c1 int) -- Notice the period as part of the table 
-- name.
CREATE DEFAULT default2 AS 0
GO
EXEC sp_bindefault 'default2', '[t.3].c1' 
-- The object contains two periods;
-- the first is part of the table name and the second 
-- distinguishes the table name from the column name.
EXEC sp_unbindefault '[t.3].c1'