sp_unbindefault (Transact-SQL)

Artigo
06/18/2013

Desvincula, 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.

Ícone de vínculo de tópico Convenções da 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 do qual o padrão deve ser desassociado. object_name é nvarchar(776), sem padrão. O SQL Server tenta resolver identificadores de duas partes primeiro para nomes das colunas e, em seguida, para tipos de dados do alias.

Ao desvincular 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 desvinculadas. As colunas desse tipo de dados com padrões vinculados 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 de banco de dados.
[ @futureonly= ] 'futureonly_flag'
É usado apenas ao desvincular um padrão de um tipo de dados de alias. futureonly_flag é varchar(15), com um padrão de NULL. Quando futureonly_flag for futureonly, as colunas existentes do tipo de dados não perdem o padrão especificado.

Observação
object_name pode conter colchetes [ ] como caracteres de identificador delimitados. Para obter mais informações, consulte Identificadores de banco de dados.

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 desvincular um padrão de uma coluna de tabela é necessário ter a permissão ALTER na tabela. Para desvincular 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.Desvinculando um padrão de uma coluna

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

EXEC sp_unbindefault 'employees.hiredate'

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

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

EXEC sp_unbindefault 'ssn'

C.Usando futureonly_flag

O exemplo a seguir desvincula 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'