ALTER EXTERNAL LIBRARY (Transact-SQL)
Si applica a:
SQL Server 2017 (14.x) e versioni successive Istanza gestita di SQL di Azure
Modifica il contenuto di una libreria di pacchetti esterna esistente.
Nota
In SQL Server 2017 sono supportati il linguaggio R e la piattaforma Windows. In SQL Server 2019 e versioni successive sono supportati R, Python e linguaggi esterni nelle piattaforme Windows e Linux.
Nota
In Istanza gestita di SQL di Azure è possibile modificare una libreria rimuovendola e quindi usando sqlmlutils per installare la versione modificata. Per altre informazioni su sqlmlutils, vedere Installare pacchetti Python con sqlmlutils e installare nuovi pacchetti R con sqlmlutils.
Sintassi per 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>
}
Sintassi per SQL Server 2017
ALTER EXTERNAL LIBRARY library_name
[ AUTHORIZATION owner_name ]
SET <file_spec>
WITH ( LANGUAGE = 'R' )
[ ; ]
<file_spec> ::=
{
(CONTENT = { <client_library_specifier> | <library_bits> | NONE}
[, PLATFORM = WINDOWS )
}
<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
}
Sintassi per Istanza gestita di SQL di Azure
CREATE EXTERNAL LIBRARY library_name
[ AUTHORIZATION owner_name ]
FROM <file_spec> [ ,...2 ]
WITH ( LANGUAGE = <language> )
[ ; ]
<file_spec> ::=
{
(CONTENT = <library_bits>)
}
<library_bits> :: =
{
varbinary_literal
| varbinary_expression
}
<language> :: =
{
'R'
| 'Python'
}
Argomenti
library_name
Specifica il nome di una libreria di pacchetti esistente. Le librerie hanno un ambito di tipo utente. I nomi delle librerie devono essere univoci nel contesto di un utente o proprietario specifico.
Il nome della libreria non può essere assegnato in modo arbitrario. È quindi necessario usare il nome previsto dal runtime di chiamata quando viene caricato il pacchetto.
owner_name
Specifica il nome dell'utente o del ruolo che è proprietario della libreria esterna.
file_spec
Specifica il contenuto del pacchetto per una piattaforma specifica. È supportato soltanto un elemento di tipo file per piattaforma.
Il file può essere specificato usando il percorso locale o il percorso di rete. Se l'opzione dell'origine dati è specificata, il nome del file può essere un percorso relativo che riguarda il contenitore a cui si fa riferimento in EXTERNAL DATA SOURCE.
Facoltativamente, è possibile specificare una piattaforma del sistema operativo per il file. È consentito un solo elemento di tipo file o un contenuto per piattaforma del sistema operativo per un linguaggio o un runtime specifico.
library_bits
Specifica il contenuto del pacchetto come valore letterale esadecimale, analogamente agli assembly.
Questa opzione è utile quando si ha l'autorizzazione necessaria a modificare una libreria, ma l'accesso ai file nel server è limitato e non è possibile salvare il contenuto in un percorso accessibile al server.
In alternativa, è possibile passare il contenuto dei pacchetti come variabile in un formato binario.
platform = WINDOWS
Specifica la piattaforma per il contenuto della libreria. Si tratta di un valore obbligatorio quando si modifica una libreria esistente per poter aggiungere una piattaforma diversa. In SQL Server 2017 Windows è l'unica piattaforma supportata.
platform
Specifica la piattaforma per il contenuto della libreria. Si tratta di un valore obbligatorio quando si modifica una libreria esistente per poter aggiungere una piattaforma diversa. In SQL Server 2019 Windows e Linux sono le piattaforme supportate.
LANGUAGE = 'R'
Specifica il linguaggio del pacchetto. Il linguaggio R è supportato in SQL Server 2017.
language
Specifica il linguaggio del pacchetto. Il valore può essere R o Python in Istanza gestita di SQL di Azure.
language
Specifica il linguaggio del pacchetto. Il valore può essere R, Pythono il nome di un linguaggio esterno (vedere CREATE EXTERNAL LANGUAGE).
Nota
Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.
Osservazioni:
Per il linguaggio R, è necessario preparare i pacchetti sotto forma di file di archivio compressi usando l'estensione zip di Windows. In SQL Server 2017 Windows è l'unica piattaforma supportata.
Per il linguaggio R, quando si usa un file è necessario preparare i pacchetti sotto forma di file di archivio compressi usando l'estensione zip.
Per il linguaggio Python, è necessario preparare il pacchetto in un file WHL o ZIP sotto forma di file di archivio compresso. Se il pacchetto è già un file ZIP, deve essere incluso in un nuovo file ZIP. Il caricamento di un pacchetto direttamente come file WHL o ZIP attualmente non è supportato.
L'istruzione ALTER EXTERNAL LIBRARY carica solo i bit della libreria nel database. La libreria modificata viene installata quando un utente esegue il codice nella stored procedure sp_execute_external_script (Transact-SQL) che chiama la libreria.
Una serie di pacchetti, detti pacchetti di sistema, sono preinstallati in un'istanza di SQL. L'utente non può aggiungere, aggiornare o rimuovere i pacchetti di sistema.
Autorizzazioni
Per impostazione predefinita, l'utente dbo o qualsiasi membro del ruolo db_owner ha l'autorizzazione per eseguire ALTER EXTERNAL LIBRARY. Inoltre, una libreria esterna può essere modificata dall'utente che ha creato la libreria.
Esempi
L'esempio seguente modifica una libreria esterna denominata customPackage.
Sostituire il contenuto di una libreria usando un file
Nell'esempio seguente viene modificata una libreria esterna denominata customPackage, usando un file compresso che contiene i bit aggiornati.
ALTER EXTERNAL LIBRARY customPackage
SET
(CONTENT = 'C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\customPackage.zip')
WITH (LANGUAGE = 'R');
Per installare la libreria aggiornata, eseguire la stored procedure sp_execute_external_script.
EXEC sp_execute_external_script
@language =N'R',
@script=N'library(customPackage)'
;
Per il linguaggio Python, l'esempio funziona anche sostituendo 'R' con 'Python'.
Modificare una libreria esistente usando un flusso di byte
L'esempio seguente modifica la libreria esistente passando i nuovi bit come valore letterale esadecimale.
ALTER EXTERNAL LIBRARY customLibrary
SET (CONTENT = 0xABC123...) WITH (LANGUAGE = 'R');
Per il linguaggio Python, l'esempio funziona anche sostituendo 'R' con 'Python'.
Nota
Questo esempio di codice illustra solo la sintassi. Il valore binario in CONTENT = è stato troncato per migliorare la leggibilità e non crea una libreria di lavoro. Il contenuto effettivo della variabile binaria sarebbe molto più lungo.
Vedi anche
CREATE EXTERNAL LIBRARY (Transact-SQL)
DROP EXTERNAL LIBRARY (Transact-SQL)
sys.external_library_files
sys.external_libraries
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per