Partilhar via


sp_unbindefault (Transact-SQL)

Aplica-se a: SQL Server

Desvincula, ou remove, um padrão de uma coluna ou de um tipo de dado alias na base de dados atual.

Importante

Esta funcionalidade será removida numa versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Crie definições padrão usando a DEFAULT palavra-chave nas instruções ALTER TABLE ou CREATE TABLE.

Convenções sintáticas Transact-SQL

Sintaxe

sp_unbindefault
    [ @objname = ] N'objname'
    [ , [ @futureonly = ] 'futureonly' ]
[ ; ]

Argumentos

[ @objname = ] N'objname'

O nome da tabela e coluna, ou o tipo de dado do alias, para desligar o predefinido. @objname é nvarchar(776), sem padrão. O SQL Server tenta resolver identificadores de duas partes primeiro para nomes de colunas e depois para tipos de dados de alias.

Ao desvincular um padrão de um tipo de dado alias, quaisquer colunas desse tipo de dado que tenham o mesmo padrão também ficam desvinculadas. Colunas desse tipo de dado com os valores definidos diretamente atribuídos não são afetadas.

Observação

@objname podem conter parênteses [] como caracteres identificadores delimitados. Para obter mais informações, consulte Identificadores de banco de dados.

[ @futureonly = ] 'Futuros-Only'

Usado apenas quando se desvincula um padrão de um tipo de dado de alias. @futureonly é varchar(15), com um padrão de NULL. Quando @futureonly é futureonly, as colunas existentes do tipo de dado não perdem o padrão especificado.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

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

Permissões

Para desassociar um padrão de uma coluna de tabela é necessária ALTER permissão na tabela. Para desvincular um padrão de um tipo de dado de alias, é necessário CONTROL permissão sobre o tipo ou ALTER permissão sobre o esquema a que o tipo pertence.

Exemplos

A. Desvincular um padrão de uma coluna

O exemplo seguinte desliga o padrão da hiredate coluna de uma employees tabela.

EXECUTE sp_unbindefault 'employees.hiredate';

B. Desvincular um padrão de um tipo de dado de alias

O exemplo seguinte desliga o padrão do tipo ssnde dados de alias . Desvincula colunas existentes e futuras desse tipo.

EXECUTE sp_unbindefault 'ssn';

C. Usa o futureonly_flag

O exemplo seguinte desvincula os usos futuros do tipo ssn de dado alias sem afetar as colunas existentes ssn .

EXECUTE sp_unbindefault 'ssn', 'futureonly';

D. Usar identificadores delimitados

O exemplo seguinte mostra a utilização de identificadores delimitados no parâmetro @objname . O nome t.3 da tabela contém um ponto, pelo que são necessários delimitadores de parênteses. Na sp_unbindefault chamada, o primeiro ponto faz parte do nome da tabela e o segundo separa o nome da tabela do nome da coluna.

CREATE TABLE [t.3] (c1 INT);
CREATE DEFAULT default2 AS 0;
GO

EXECUTE sp_bindefault 'default2', '[t.3].c1';
EXECUTE sp_unbindefault '[t.3].c1';