SKAPA EXTERNT BIBLIOTEK (Transact-SQL)

Laddar upp R-, Python- eller Java-paketfiler till en databas från den angivna byteströmmen eller filsökvägen. Den här instruktionen fungerar som en allmän mekanism för databasadministratören att ladda upp artefakter som behövs för nya externa språkkörningar och os-plattformar som stöds av SQL Server.

Laddar upp R- eller Python-paketfiler till en databas från den angivna byteströmmen eller filsökvägen. Den här instruktionen fungerar som en allmän mekanism för databasadministratören att ladda upp artefakter som behövs.

Syntax för 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>
}

Syntax för 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 
}

Syntax för 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

Anger innehållet i paketet för en specifik plattform. Endast en filartefakt per plattform stöds.

Filen kan anges i form av en lokal sökväg eller nätverkssökväg.

När du försöker komma åt filen som anges i <client_library_specifier> personifierar SQL Server säkerhetskontexten för den aktuella Windows-inloggningen. Om <client_library_specifier> anger en nätverksplats (UNC-sökväg) överförs inte personifieringen av den aktuella inloggningen till nätverksplatsen på grund av delegeringsbegränsningar. I det här fallet görs åtkomst med hjälp av säkerhetskontexten för SQL Server-tjänstkontot. Mer information finns i Autentiseringsuppgifter (databasmotor).

Du kan också ange en OS-plattform för filen. Endast en filartefakt eller innehåll tillåts för varje OS-plattform för ett visst språk eller en viss körning.

PLATTFORM

Anger plattformen för bibliotekets innehåll. Värdet är som standard värdplattformen där SQL Server körs. Därför behöver användaren inte ange värdet. Det krävs om flera plattformar stöds, eller om användaren behöver ange en annan plattform. I SQL Server 2019 är Windows och Linux de plattformar som stöds.

LANGUAGE = 'R'

Anger paketets språk. R stöds i SQL Server 2017.

Språk

Anger paketets språk. Värdet kan vara R eller Python i Azure SQL Managed Instance.

Språk

Anger paketets språk. Värdet kan vara R, Pythoneller namnet på ett externt språk (se SKAPA EXTERNT SPRÅK).

När du använder en fil för R-språket måste paket förberedas i form av zippade arkivfiler med .ZIP-tillägget för Windows. I SQL Server 2017 stöds endast Windows-plattformen.

När du använder en fil för R-språket måste paket förberedas i form av zippade arkivfiler med .ZIP-tillägget.

För Python-språket måste paketet i en .whl- eller .zip-fil förberedas i form av en zippad arkivfil. Om paketet redan är en .zip fil måste det ingå i en ny .zip fil. Det går för närvarande inte att ladda upp ett paket som .whl eller .zip fil direkt.

I SQL Server 2019 behöver användaren förutom behörigheten SKAPA EXTERNT BIBLIOTEK även referensbehörighet på ett externt språk för att kunna skapa externa bibliotek för det externa språket.

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

Lägga till ett externt bibliotek i en databas

I följande exempel läggs ett externt bibliotek som heter customPackage till en databas.

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

När biblioteket har laddats upp till instansen kör en användare proceduren sp_execute_external_script för att installera biblioteket.

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

För Python-språket i SQL Server 2019 fungerar exemplet också genom att 'R' ersätta med 'Python'.

• Ladda upp målpaketet och dess beroenden. Alla filer måste finnas i en mapp som är tillgänglig för servern.

  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
  

• Installera de nödvändiga paketen först.

  Om ett obligatoriskt paket redan har laddats upp till instansen behöver du inte lägga till det igen. Se bara till att kontrollera om det befintliga paketet är rätt version.

  De nödvändiga paketen packageC och packageB installeras i rätt ordning när sp_execute_external_script först körs för att installera paketet packageA.

  Om ett obligatoriskt paket inte är tillgängligt misslyckas dock installationen av målpaketet packageA .

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

För Python-språket i SQL Server 2019 fungerar exemplet också genom att 'R' ersätta med 'Python'.

För Python-språket i SQL Server 2019 fungerar exemplet också genom att ersätta R med Python.

Lägga till en Java .jar-fil i en databas

I följande exempel läggs en extern jar-fil som anropas customJar till en databas.

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

När biblioteket har laddats upp till instansen kör en användare proceduren sp_execute_external_script för att installera biblioteket.

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))

Lägga till ett externt paket för både Windows och Linux

Du kan ange upp till två <file_spec>, en för Windows och en för 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')

När du använder sp_execute_external_script för att installera paketet används biblioteksinnehållet för den plattformen beroende på vilken plattform SQL Server-instansen körs på.

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