CREATE EXTERNAL LIBRARY (Transact-SQL)

Uploadt R-, Python- of Java-pakketbestanden naar een database vanuit de opgegeven bytestroom of het bestandspad. Deze instructie fungeert als een algemeen mechanisme voor de databasebeheerder om artefacten te uploaden die nodig zijn voor nieuwe runtimes voor externe talen en besturingssysteemplatforms die worden ondersteund door SQL Server.

Uploadt R- of Python-pakketbestanden naar een database vanuit de opgegeven bytestroom of bestandspad. Deze instructie fungeert als een algemeen mechanisme voor de databasebeheerder om artefacten te uploaden die nodig zijn.

Syntaxis voor SQL Server 2019

CREATE EXTERNAL LIBRARY library_name  
[ AUTHORIZATION owner_name ]  
FROM <file_spec> [ ,...2 ]  
WITH ( LANGUAGE = <language> )  
[ ; ]  

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

<client_library_specifier> :: = 
{
    '[file_path\]manifest_file_name'  
} 

<library_bits> :: =  
{ 
      varbinary_literal 
    | varbinary_expression 
}

<platform> :: = 
{
      WINDOWS
    | LINUX
}

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

Syntaxis voor SQL Server 2017

CREATE EXTERNAL LIBRARY library_name  
[ AUTHORIZATION owner_name ]  
FROM <file_spec> [ ,...2 ]  
WITH ( LANGUAGE = 'R' )  
[ ; ]  

<file_spec> ::=  
{  
    (CONTENT = { <client_library_specifier> | <library_bits> })  
}  

<client_library_specifier> :: = 
{
    '[file_path\]manifest_file_name'
} 

<library_bits> :: =  
{ 
      varbinary_literal 
    | varbinary_expression 
}

Syntaxis voor Azure SQL Managed Instance

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'
}

file_spec

Hiermee geeft u de inhoud van het pakket voor een specifiek platform. Er wordt slechts één bestandsartefact per platform ondersteund.

Het bestand kan worden opgegeven in de vorm van een lokaal pad of netwerkpad.

Wanneer u probeert toegang te krijgen tot het bestand dat is opgegeven in <client_library_specifier>, imiteert SQL Server de beveiligingscontext van de huidige Windows-aanmelding. Als <client_library_specifier> een netwerklocatie (UNC-pad) opgeeft, wordt de imitatie van de huidige aanmelding niet overgedragen naar de netwerklocatie vanwege delegeringsbeperkingen. In dit geval wordt toegang gemaakt met behulp van de beveiligingscontext van het SQL Server-serviceaccount. Zie Referenties (Database Engine) voor meer informatie.

U kunt eventueel een besturingssysteemplatform voor het bestand opgeven. Er is slechts één bestandsartefact of -inhoud toegestaan voor elk besturingssysteemplatform voor een specifieke taal of runtime.

PERRON

Hiermee geeft u het platform voor de inhoud van de bibliotheek. De waarde wordt standaard ingesteld op het hostplatform waarop SQL Server wordt uitgevoerd. Daarom hoeft de gebruiker de waarde niet op te geven. Dit is vereist in het geval dat meerdere platforms worden ondersteund of dat de gebruiker een ander platform moet opgeven. In SQL Server 2019 zijn Windows en Linux de ondersteunde platforms.

LANGUAGE = 'R'

Hiermee geeft u de taal van het pakket. R wordt ondersteund in SQL Server 2017.

Taal

Hiermee geeft u de taal van het pakket. De waarde kan of Python in Azure SQL Managed Instance zijnR.

Taal

Hiermee geeft u de taal van het pakket. De waarde kan R, Pythonof de naam van een externe taal zijn (zie CREATE EXTERNAL LANGUAGE).

Voor de R-taal moeten pakketten worden voorbereid in de vorm van gezipte archiefbestanden met de extensie .ZIP voor Windows. In SQL Server 2017 wordt alleen het Windows-platform ondersteund.

Voor de R-taal moeten pakketten worden voorbereid in de vorm van gezipte archiefbestanden met de extensie .ZIP.

Voor de Python-taal moet het pakket in een .whl- of .zip-bestand worden voorbereid in de vorm van een zip-archiefbestand. Als het pakket al een .zip bestand is, moet het worden opgenomen in een nieuw .zip bestand. Het rechtstreeks uploaden van een pakket als .whl- of .zip-bestand wordt momenteel niet ondersteund.

In SQL Server 2019 heeft de gebruiker naast de machtiging CREATE EXTERNAL LIBRARY ook verwijzingen nodig voor een externe taal om externe bibliotheken voor die externe taal te kunnen maken.

GRANT REFERENCES ON EXTERNAL LANGUAGE::Java to user
GRANT CREATE EXTERNAL LIBRARY to user

Een externe bibliotheek toevoegen aan een database

In het volgende voorbeeld wordt een externe bibliotheek aangeroepen customPackage aan een database toegevoegd.

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

Nadat de bibliotheek is geüpload naar het exemplaar, voert een gebruiker de sp_execute_external_script procedure uit om de bibliotheek te installeren.

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

Voor de Python-taal in SQL Server 2019 werkt het voorbeeld ook door te 'R' vervangen door 'Python'.

• Upload het doelpakket en de bijbehorende afhankelijkheden. Alle bestanden moeten zich in een map bevinden die toegankelijk is voor de server.

  CREATE EXTERNAL LIBRARY packageA 
  FROM (CONTENT = 'C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\packageA.zip') 
  WITH (LANGUAGE = 'R'); 
  GO
  
  CREATE EXTERNAL LIBRARY packageB FROM (CONTENT = 'C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\packageB.zip') 
  WITH (LANGUAGE = 'R');
  GO
  
  CREATE EXTERNAL LIBRARY packageC FROM (CONTENT = 'C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\packageC.zip') 
  WITH (LANGUAGE = 'R');
  GO
  

• Installeer eerst de vereiste pakketten.

  Als er al een vereist pakket is geüpload naar het exemplaar, hoeft u het niet opnieuw toe te voegen. Zorg ervoor dat u controleert of het bestaande pakket de juiste versie is.

  De vereiste pakketten packageC en packageB worden geïnstalleerd, in de juiste volgorde, wanneer het pakket voor sp_execute_external_script het eerst wordt uitgevoerd om het pakket packageAte installeren.

  Als er echter geen vereist pakket beschikbaar is, mislukt de installatie van het doelpakket packageA .

  EXEC sp_execute_external_script 
  @language =N'R', 
  @script=N'
  # load the desired package packageA
  library(packageA)
  '
  

Voor de Python-taal in SQL Server 2019 werkt het voorbeeld ook door te 'R' vervangen door 'Python'.

Voor de Python-taal in SQL Server 2019 werkt het voorbeeld ook door R te vervangen door Python.

Een Java .jar-bestand toevoegen aan een database

In het volgende voorbeeld wordt een extern JAR-bestand aangeroepen customJar aan een database toegevoegd.

CREATE EXTERNAL LIBRARY customJar
FROM (CONTENT = 'C:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\customJar.jar') 
WITH (LANGUAGE = 'Java');

Nadat de bibliotheek is geüpload naar het exemplaar, voert een gebruiker de sp_execute_external_script procedure uit om de bibliotheek te installeren.

EXEC sp_execute_external_script
    @language = N'Java'
    , @script = N'customJar.MyCLass.myMethod'
    , @input_data_1 = N'SELECT * FROM dbo.MyTable'
WITH RESULT SETS ((column1 int))

Een extern pakket toevoegen voor Zowel Windows als Linux

U kunt maximaal twee <file_spec>opgeven, één voor Windows en één voor Linux.

CREATE EXTERNAL LIBRARY lazyeval 
FROM (CONTENT = 'C:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\packageA.zip', PLATFORM = WINDOWS),
(CONTENT = 'C:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\packageA.tar.gz', PLATFORM = LINUX)
WITH (LANGUAGE = 'R')

Wanneer u sp_execute_external_script het pakket installeert, afhankelijk van het platform waarop het SQL Server-exemplaar wordt uitgevoerd, wordt de bibliotheekinhoud voor dat platform gebruikt.

EXECUTE sp_execute_external_script 
    @LANGUAGE = N'R',
    @SCRIPT = N'
library(packageA)'