CREATE EXTERNAL LANGUAGE (Transact-SQL)

[アーティクル]
06/02/2023

適用対象: SQL Server 2019 (15.x)

指定したファイルパスまたはバイトストリームから、データベースに外部言語拡張機能を登録します。このステートメントは、データベース管理者が SQL Server によってサポートされている任意の OS プラットフォームで新しい外部言語拡張機能を登録する汎用メカニズムとして機能します。詳細については、Language Extensions (言語拡張) に関する記事を参照してください。

Note

R と Python は予約済みの名前であり、それらの特定の名前で外部言語を作成することはできません。 R および Python を使う方法について詳しくは、「SQL Server Machine Learning Services (SQL Server Machine Learning Services)」をご覧ください。

構文

CREATE EXTERNAL LANGUAGE language_name  
[ AUTHORIZATION owner_name ]  
FROM <file_spec> [ ,...2 ]  
[ ; ]  

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

引数

language_name

言語は、データベーススコープのオブジェクトです。言語名は、データベース内で一意であることが必要です。

owner_name

外部言語を所有しているユーザーまたはロールの名前を指定します。このオプションを指定しない場合は、所有権は現在のユーザーに与えられます。アクセス許可によっては、特定の言語を使用するスクリプトを実行するために、他のユーザーに明示的なアクセス許可を付与することが必要な場合があります。

file_spec

言語拡張機能の内容を指定します。プラットフォームごとに、特定の言語に対して 1 つの filespec だけを指定できます。

external_lang_specifier

拡張機能のコードが含まれる .zip または tar.gz ファイルの完全なファイルパスです。この内容では、.zip ファイル (Windows の場合) または tar.gz (Linux の場合) へのパスを指定できます。

content_bits

アセンブリと同様に、言語の内容を 16 進数のリテラルとして指定します。

このオプションは、言語を作成するか、既存の言語を変更する必要があり (そして、それを行うために必要なアクセス許可を持っていて)、しかしサーバー上のファイルシステムが制限されていて、サーバーがアクセスできる場所にライブラリファイルをコピーできない場合に、役に立ちます。

external_lang_file_name

拡張機能の .dll または .so ファイルの名前です。これは、<external_lang_specifier> .zip または tar.gz に複数の .dll ファイルまたは .so ファイルが含まれる場合に、正しいファイルを示すために必要です。

external_lang_parameters

外部言語ランタイムにパラメーターのセットを提供できます。パラメーターの値は、外部プロセスが開始した後で、外部のランタイムに提供されます。ただし、外部プロセスの開始前でも、言語拡張機能は環境変数にアクセスできます。

external_lang_env_variables

これにより、外部プロセスの開始前に、外部言語ランタイムに環境変数のセットを提供できます。環境変数の例は、たとえば、ランタイム自体のホームディレクトリです。次に例を示します。JRE_HOME。

platform

このパラメーターは、ハイブリッド OS のシナリオに必要です。ハイブリッドアーキテクチャでは、プラットフォームごとに 1 回、言語を登録する必要があります。プラットフォームを指定しないと、現在の OS が想定されます。

アクセス許可

CREATE EXTERNAL LANGUAGE アクセス許可が必要です。既定では、db_owner ロールのメンバーである dbo を持つすべてのユーザーに、外部言語を作成するためのアクセス許可があります。他のすべてのユーザーについては、GRANT ステートメントを使用し、特権として CREATE EXTERNAL LANGUAGE を指定して、アクセス許可を明示的に付与する必要があります。

ライブラリを変更するには、別のアクセス許可 ALTER ANY EXTERNAL LANGUAGE が必要です。

EXECUTE EXTERNAL SCRIPT アクセス許可

EXECUTE EXTERNAL SCRIPT アクセス許可を使用すると、特定の言語で外部スクリプトの実行を許可できます。これは、特定の言語での実行アクセス許可の付与を許可しない EXECUTE ANY EXTERNAL SCRIPT データベース許可とは異なります。

これは、dbo 以外のユーザーは、特定の言語を実行するためのアクセス許可を付与してもらう必要があることを意味します。

GRANT EXECUTE EXTERNAL SCRIPT ON EXTERNAL LANGUAGE ::language_name 
TO database_principal_name;

外部ライブラリに対する参照アクセス許可

アセンブリと同様、外部ライブラリと外部言語の間にリンクが存在するように、外部言語に対する参照アクセス許可が必要です。たとえば、外部言語を削除する場合、ユーザーは最初に、その言語を参照しているすべての外部ライブラリを削除する必要があります。外部言語は、階層内で外部ライブラリより上位レベルのオブジェクトと見ることができます。

例

A. データベース内の外部言語を作成する

次の例では、Windows 上の SQL Server のデータベースに、Java という名前の外部言語を追加します。

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

B. Windows と Linux の両方に外部言語を作成する

最大 2 つの <file_spec> を指定できます。1 つは Windows 用、1 つは Linux 用です。

CREATE EXTERNAL LANGUAGE Java
FROM
(CONTENT = N'<path-to-zip>', FILE_NAME = 'javaextension.dll', PLATFORM = WINDOWS),
(CONTENT = N'<path-to-tar.gz>', FILE_NAME = 'javaextension.so', PLATFORM = LINUX);
GO

C. 外部スクリプトを実行するアクセス許可を付与する

次の例では、mylogin プリンシパルに、Java 外部言語を使用してスクリプトを実行するアクセス権を付与します。

GRANT EXECUTE EXTERNAL SCRIPT ON EXTERNAL LANGUAGE ::Java 
TO mylogin;