Partilhar via


DROP BIBLIOTECA EXTERNA (Transact-SQL)

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

Exclui uma biblioteca de pacotes existente. As bibliotecas de pacotes são usadas por runtimes externos suportados, como R, Python ou Java.

Observação

No SQL Server 2017, há suporte para a linguagem R e a plataforma Windows. R, Python e Java nas plataformas Windows e Linux são suportados no SQL Server 2019 e posterior.

Observação

Na Instância Gerenciada SQL do Azure, as linguagens R e Python são suportadas.

Sintaxe

DROP EXTERNAL LIBRARY library_name
[ AUTHORIZATION owner_name ];

Arguments

library_name

Especifica o nome de uma biblioteca de pacotes existente.

As bibliotecas têm o escopo definido para o usuário. Os nomes das bibliotecas devem ser exclusivos dentro do contexto de um usuário ou proprietário específico.

owner_name

Especifica o nome do usuário ou função que possui a biblioteca externa.

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

Permissions

Para excluir uma biblioteca requer o privilégio ALTER ANY EXTERNAL LIBRARY. Por padrão, qualquer proprietário de banco de dados, ou o proprietário do objeto, também pode excluir uma biblioteca externa.

Valores de retorno

Uma mensagem informativa será retornada se a instrução tiver sido bem-sucedida.

Observações

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

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

Examples

Adicione o pacote R personalizado, customPackage, a um banco de dados:

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

Exclua a customPackage biblioteca.

DROP EXTERNAL LIBRARY customPackage;

Consulte também

CRIAR BIBLIOTECA EXTERNA (Transact-SQL)
ALTER BIBLIOTECA EXTERNA (Transact-SQL)
sys.external_library_files
sys.external_libraries