sp_unbindefault (Transact-SQL)

  • Artigo

Aplica-se a: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 coluna ou o tipo de dados de alias do qual o padrão deve ser desacoplado. @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 pode conter colchetes como caracteres identificadores delimitados[]. Para obter mais informações, consulte Database Identifiers.

@futureonly [ = ] 'somente no 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 período como parte do nome da tabela. Na parte, o sp_unbindefault 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';

Conteúdo relacionado