DROP SEQUENCE (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Remove um objeto de sequência do banco de dados atual.

Convenções de sintaxe de Transact-SQL

Sintaxe

DROP SEQUENCE [ IF EXISTS ] { database_name.schema_name.sequence_name | schema_name.sequence_name | sequence_name } [ ,...n ]  
 [ ; ]

Argumentos

IF EXISTS
Aplica-se a: SQL Server (SQL Server 2016 (13.x) até a versão atual).

Remove condicionalmente a sequência somente se ela já existe.

database_name
É o nome do banco de dados no qual o objeto de sequência foi criado.

schema_name
É o nome do esquema ao qual o objeto de sequência pertence.

sequence_name
É o nome da sequência a ser removida. O tipo é sysname.

Comentários

Depois de gerar um número, um objeto de sequência não tem nenhuma relação contínua com o número que gerou; portanto, o objeto de sequência pode ser removido, embora o número gerado ainda esteja em uso.

Um objeto de sequência pode ser removido enquanto é referenciado por um procedimento armazenado, ou pode ser disparado, pois não é associado ao esquema. Um objeto de sequência não poderá ser removido se for referenciado como um valor padrão em uma tabela. A mensagem de erro listará o objeto que referencia a sequência.

Para listar todos os objetos de sequência no banco de dados, execute a instrução a seguir.

SELECT sch.name + '.' + seq.name AS [Sequence schema and name]   
    FROM sys.sequences AS seq  
    JOIN sys.schemas AS sch  
        ON seq.schema_id = sch.schema_id ;  
GO

Segurança

Permissões

Requer a permissão ALTER ou CONTROL no esquema.

Audit

Para auditar DROP SEQUENCE, monitore SCHEMA_OBJECT_CHANGE_GROUP.

Exemplos

O exemplo a seguir remove do banco de dados atual um objeto de sequência denominado CountBy1.

DROP SEQUENCE CountBy1 ;  
GO

Consulte Também

ALTER SEQUENCE (Transact-SQL)
CREATE SEQUENCE (Transact-SQL)
NEXT VALUE FOR (Transact-SQL)
Números de sequência