DROP EXTERNAL LIBRARY (Transact-SQL)

Aplica-se a: SQL Server 2017 (14.x) e versões posteriores Instância Gerenciada de SQL do Azure

Exclui uma biblioteca de pacote existente. As bibliotecas de pacotes são usadas por runtimes externos com suporte, tais como do R, Python ou Java.

Sintaxe

DROP EXTERNAL LIBRARY library_name
[ AUTHORIZATION owner_name ];

Argumentos

library_name

Especifica o nome de uma biblioteca de pacotes existente.

As bibliotecas estão no escopo do usuário. Os nomes de bibliotecas devem ser exclusivos no contexto de um usuário ou proprietário específico.

owner_name

Especifica o nome do usuário ou da função que é a proprietária da biblioteca externa.

Os proprietários de banco de dados podem excluir bibliotecas criadas por outros usuários.

Permissões

Para excluir uma biblioteca, é necessário ter o privilégio ALTER ANY EXTERNAL LIBRARY. Por padrão, todos os proprietários de bancos de dados ou do objeto também podem excluir uma biblioteca externa.

Valores retornados

Uma mensagem informativa é retornada se a instrução foi bem-sucedida.

Comentários

Ao contrário de outras instruções DROP no SQL Server, essa instrução dá suporte à especificação de uma cláusula de autorização opcional. Isso permite que o dbo ou os usuários na função db_owner removam uma biblioteca de pacote carregada por um usuário normal no banco de dados.

Vários pacotes, chamados de pacotes do sistema, são pré-instalados em uma instância SQL. Os pacotes do sistema não podem ser adicionados, atualizados nem removidos pelo usuário.

Exemplos

CREATE EXTERNAL LIBRARY customPackage 
FROM (CONTENT = 'C:\temp\customPackage_v1.1.zip')
WITH (LANGUAGE = 'R');
GO

Exclua a biblioteca customPackage.

DROP EXTERNAL LIBRARY customPackage;

Confira também

CREATE EXTERNAL LIBRARY (Transact-SQL)
ALTER EXTERNAL LIBRARY (Transact-SQL)
sys.external_library_files
sys.external_libraries