DROP EXTERNAL LIBRARY (Transact-SQL)

  • Artigo

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.

Observação

No SQL Server 2017, há compatibilidade apenas com a linguagem R e a plataforma Windows. Há suporte para R, Python e Java nas plataformas Windows e Linux no SQL Server 2019 e posteriores.

Observação

Na Instância Gerenciada de SQL do Azure, as linguagens R e Python são compatíveis.

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.

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

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

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

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