sp_unbindefault (Transact-SQL)
Aplica-se: SQL Server
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 em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Recomendamos que você crie definições padrão usando a palavra-chave DEFAULT nas instruções ALTER TABLE ou CREATE TABLE .
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_unbindefault
[ @objname = ] N'objname'
[ , [ @futureonly = ] 'futureonly' ]
[ ; ]
Argumentos
@objname [ = ] n'objname'
O nome da tabela e da coluna ou o tipo de dados de alias do qual o padrão deve ser desvinculado. @objname é nvarchar(776), sem padrão. O SQL Server tenta resolver identificadores de duas partes para nomes de coluna primeiro e, em seguida, para tipos de dados de 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
@objname podem conter colchetes []
como caracteres identificadores delimitados. Para obter mais informações, consulte Identificadores de banco de dados.
@futureonly [ = ] 'somente futuro'
Usado somente ao desvincular um padrão de um tipo de dados de alias. @futureonly é varchar(15), com um padrão de NULL
. Quando @futureonly é futureonly
, as colunas existentes do tipo de dados não perdem o padrão especificado.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Comentários
Para exibir o texto de um padrão, execute sp_helptext
com o nome do padrão como 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
R. Desvincular 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. Desvincular 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. Use o 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. Usar identificadores delimitados
O exemplo a seguir mostra o uso de identificadores delimitados em @objname parâmetro. Observe o ponto como parte do nome da tabela. sp_unbindefault
Na parte, o objeto contém dois pontos; o primeiro faz parte do nome da tabela e o segundo distingue o nome da tabela do nome da coluna.
--
CREATE TABLE [t.3] (c1 INT);
CREATE DEFAULT default2 AS 0;
GO
EXEC sp_bindefault 'default2', '[t.3].c1';
EXEC sp_unbindefault '[t.3].c1';