ALTER BIBLIOTECA EXTERNA (Transact-SQL)

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

Modifica o conteúdo de uma biblioteca de pacotes externa existente.

Observação

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

Sintaxe do SQL Server 2019

ALTER EXTERNAL LIBRARY library_name
[ AUTHORIZATION owner_name ]
SET <file_spec>
WITH ( LANGUAGE = <language> )
[ ; ]

<file_spec> ::=
{
    (CONTENT = { <client_library_specifier> | <library_bits> | NONE}
    [, PLATFORM = <platform> )
}

<client_library_specifier> :: =
{
      '[\\computer_name\]share_name\[path\]manifest_file_name'
    | '[local_path\]manifest_file_name'
    | '<relative_path_in_external_data_source>'
}

<library_bits> :: =
{ 
      varbinary_literal 
    | varbinary_expression 
}

<platform> :: = 
{
      WINDOWS
    | LINUX
}

<language> :: = 
{
      'R'
    | 'Python'
    | <external_language>
}

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.

O nome da biblioteca não pode ser atribuído arbitrariamente. Ou seja, você deve usar o nome que o tempo de execução de chamada espera quando carrega o pacote.

owner_name

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

file_spec

Especifica o conteúdo do pacote para uma plataforma específica. Apenas um artefato de arquivo por plataforma é suportado.

O arquivo pode ser especificado na forma de um caminho local ou caminho de rede. Se a opção de fonte de dados for especificada, o nome do arquivo poderá ser um caminho relativo em relação ao contêiner referenciado EXTERNAL DATA SOURCEno .

Opcionalmente, uma plataforma de sistema operacional para o arquivo pode ser especificada. Apenas um arquivo, artefato ou conteúdo é permitido para cada plataforma do sistema operacional para uma linguagem ou tempo de execução específico.

library_bits

Especifica o conteúdo do pacote como um literal hexadecimal, semelhante aos assemblies.

Essa opção é útil se você tiver a permissão necessária para alterar uma biblioteca, mas o acesso a arquivos no servidor é restrito e você não pode salvar o conteúdo em um caminho que o servidor possa acessar.

Em vez disso, você pode passar o conteúdo do pacote como uma variável em formato binário.

plataforma

Especifica a plataforma para o conteúdo da biblioteca. Esse valor é necessário ao modificar uma biblioteca existente para adicionar uma plataforma diferente. No SQL Server 2019, Windows e Linux são as plataformas suportadas.

Idioma

Especifica o idioma do pacote. O valor pode ser R, Python ou o nome de uma linguagem externa (consulte CREATE EXTERNAL LANGUAGE).

Observações

Para a linguagem R, ao usar um arquivo, os pacotes devem ser preparados na forma de arquivos compactados com a extensão .ZIP.

Para a linguagem Python, o pacote em um arquivo .whl ou .zip deve ser preparado na forma de um arquivo compactado. Se o pacote já for um arquivo .zip, ele deve ser incluído em um novo arquivo .zip. Atualmente, não há suporte para o upload de um pacote como arquivo .whl ou .zip diretamente.

A ALTER EXTERNAL LIBRARY instrução carrega apenas os bits da biblioteca para o banco de dados. A biblioteca modificada é instalada quando um usuário executa código em sp_execute_external_script (Transact-SQL) que chama a biblioteca.

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.

Permissions

Por padrão, o usuário dbo ou qualquer membro da função db_owner tem permissão para executar ALTER EXTERNAL LIBRARY. Além disso, o usuário que criou a biblioteca externa pode alterar essa biblioteca externa.

Examples

Os exemplos a seguir alteram uma biblioteca externa chamada customPackage.

Substituir o conteúdo de uma biblioteca usando um arquivo

O exemplo a seguir modifica uma biblioteca externa chamada customPackage, usando um arquivo compactado que contém os bits atualizados.

ALTER EXTERNAL LIBRARY customPackage 
SET 
  (CONTENT = 'C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\customPackage.zip')
WITH (LANGUAGE = 'R');

Para instalar a biblioteca atualizada, execute o procedimento sp_execute_external_scriptarmazenado .

EXEC sp_execute_external_script 
@language =N'R', 
@script=N'library(customPackage)'
;

Para a linguagem Python, o exemplo também funciona substituindo 'R' por 'Python'.

Alterar uma biblioteca existente usando um fluxo de bytes

O exemplo a seguir altera a biblioteca existente passando os novos bits como um literal hexadecimal.

ALTER EXTERNAL LIBRARY customLibrary 
SET (CONTENT = 0xABC123...) WITH (LANGUAGE = 'R');

Para a linguagem Python, o exemplo também funciona substituindo 'R' por 'Python'.

Observação

Este exemplo de código demonstra apenas a sintaxe; O valor binário em CONTENT = foi truncado para legibilidade e não cria uma biblioteca de trabalho. O conteúdo real da variável binária seria muito mais longo.

Consulte também

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