ALTER EXTERNAL LANGUAGE (Transact-SQL)

platí pro: SQL Server 2019 (15.x)

Upravuje obsah v existujícím externím jazykovém rozšíření databáze.

Syntax

ALTER EXTERNAL LANGUAGE language_name  
[ AUTHORIZATION owner_name ]
{
    SET <file_spec>
    | ADD <file_spec>
    | REMOVE PLATFORM <platform> 
}
[ ; ]  

<file_spec> ::=  
{
    ( CONTENT = {<external_lang_specifier> | <content_bits>,
    FILE_NAME = <external_lang_file_name>
    [, PLATFORM = <platform> ]
    [, PARAMETERS = <external_lang_parameters> ]
    [, ENVIRONMENT_VARIABLES = <external_lang_env_variables> ] )
}

<external_lang_specifier> :: =  
{
    '[file_path\]os_file_name'  
}

<content_bits> :: =  
{
    varbinary_literal
   | varbinary_expression
}

<external_lang_file_name> :: =  
'extension_file_name'

<platform> :: =
{
   WINDOWS
  | LINUX
}

< external_lang_parameters > :: =  
'extension_specific_parameters'

Arguments

language_name

Jazyky jsou objekty zaměřené na databázi. Názvy jazyků musí být v databázi jedinečné.

owner_name

Specifikuje jméno uživatele nebo role, která vlastní externí jazyk. Pokud není zadáno, je vlastnictví uděleno aktuálnímu uživateli. V závislosti na oprávněních mohou ostatní uživatelé potřebovat explicitní povolení ke spuštění skriptů v konkrétním jazyce.

file_spec

Specifikuje obsah jazykového rozšíření. Pro konkrétní jazyk na platformu je povolena pouze jedna specifikace souboru.

external_lang_specifier

Celá cesta k souboru .zip nebo tar.gz obsahujícímu kód příponek. Tento obsah může být cestou k .zip souboru (na Windows) nebo tar.gz (na Linuxu).

content_bits

Specifikuje obsah jazyka jako hex literál, podobně jako assemblies. Tato možnost je užitečná, pokud potřebujete vytvořit jazyk nebo změnit existující jazyk (a máte k tomu potřebná oprávnění), ale souborový systém na serveru je omezený a nemůžete zkopírovat knihovní soubory na místo, ke kterému má server přístup.

external_lang_file_name

Název přípony .dll nebo .so souboru. To je nutné k identifikaci správného souboru v případech, kdy je v external_lang_specifier> .zip nebo tar.gz několik .dll nebo .so souborů<.

external_lang_parameters

To umožňuje přiřadit sadu parametrů do runtime externího jazyka. Hodnoty parametrů jsou poskytovány externímu runtime po spuštění externího procesu. Proměnné prostředí jsou však přístupné rozšíření jazyka před spuštěním externího procesu.

external_lang_env_variables

To umožňuje přiřadit sadu proměnných prostředí pro runtime externího jazyka před spuštěním externího procesu. Příkladem proměnné prostředí je například domovský adresář samotného runtime. Například: JRE_HOME.

nástupiště

Tento parametr je potřeba pro hybridní operační systémy. V hybridní architektuře je potřeba jazyk registrovat jednou na platformu. Název platformy a jazyka bude unikátním klíčem pro každý externí jazyk. Pokud není specifikována žádná platforma, předpokládá se aktuální operační systém.

Remarks

V současnosti nejsou podporovány PARAMETERS a ENVIRONMENT_VARIABLES .

Permissions

Vyžaduje oprávnění ALTER ANY EXTERNAL LANGUAGE. Ve výchozím nastavení má každý uživatel s dbo a je členem role db_owner oprávnění měnit externí jazyk. Pro všechny ostatní uživatele musíte výslovně udělit oprávnění pomocí příkazu GRANT , který specifikuje ALTER ANY EXTERNAL LANGUAGE jako toto oprávnění.

Examples

Změna externího jazyka v databázi

Následující příklad přidá externí jazyk s názvem Java do databáze na SQL Serveru ve Windows.

ALTER EXTERNAL LANGUAGE Java 
SET (CONTENT = N'<path-to-zip>', FILE_NAME = 'javaextension.dll');
GO

Viz také

CREATE EXTERNAL LANGUAGE (Transact-SQL)
DROP EXTERNAL LANGUAGE (Transact-SQL)
sys.external_languages
sys.external_language_files