DROP EXTERNAL LIBRARY (Transact-SQL)

適用対象: SQL Server 2017 (14.x) 以降 Azure SQL Managed Instance

既存のパッケージ ライブラリを削除します。 パッケージ ライブラリは、R、Python、Java などのサポートされる外部ランタイムで使用されます。

注意

SQL Server 2017 では、R 言語と Windows プラットフォームがサポートされています。 Windows および Linux プラットフォームの R、Python、Java は SQL Server 2019 以降でサポートされています。

構文

DROP EXTERNAL LIBRARY library_name
[ AUTHORIZATION owner_name ];

引数

library_name

既存のパッケージ ライブラリの名前を指定します。

ライブラリは、ユーザーに範囲指定されます。 ライブラリ名は、特定のユーザーまたは所有者のコンテキスト内で一意と見なされる必要があります。

owner_name

外部ライブラリを所有しているユーザーまたはロールの名前を指定します。

データベース所有者は、他のユーザーによって作成されたライブラリを削除できます。

アクセス許可

ライブラリを削除するには、ALTER ANY EXTERNAL LIBRARY の特権が必要です。 既定では、すべてのデータベース所有者、またはオブジェクトの所有者も外部ライブラリを削除することができます。

戻り値

ステートメントが成功した場合は、情報メッセージが返されます。

解説

SQL Server の他の DROP とは異なり、このステートメントは、省略可能な承認句の指定をサポートします。 これにより、dbo または db_owner ロールのユーザーが、データベース内の正規のユーザーによってアップロードされたパッケージ ライブラリを削除することができます。

SQL インスタンスには、"システム パッケージ" という多数のパッケージが事前にインストールされています。 ユーザーがシステム パッケージを追加、更新、または削除することはできません。

例

カスタムの R パッケージ customPackage をデータベースに追加します。

CREATE EXTERNAL LIBRARY customPackage 
FROM (CONTENT = 'C:\temp\customPackage_v1.1.zip')
WITH (LANGUAGE = 'R');
GO

customPackage ライブラリを削除します。

DROP EXTERNAL LIBRARY customPackage;

関連項目

CREATE EXTERNAL LIBRARY (Transact-SQL)
ALTER EXTERNAL LIBRARY (Transact-SQL)
sys.external_library_files
sys.external_libraries