Linux 上に SQL Server の Java 言語拡張をインストールする

適用対象: Linux 以降のバージョンの SQL Server 2019 (15.x)

SQL Server の Java 言語拡張機能コンポーネントを Linux にインストールする方法について説明します。 Java 言語拡張機能は、SQL Server 言語拡張機能の一部であり、データベース エンジンへのアドオンです。

データベース エンジンと言語拡張機能を同時にインストールすることは可能ですが、コンポーネントを追加する前に問題を解決できるように、まずは SQL Server データベースエンジンをインストールして構成することをお勧めします。

前提条件

• LinuxディストリビューションはSQL Serverでサポートされている必要があります。 容器は後の弾丸で別々にカバーされます。 サポートされているディストリビューションには以下が含まれます:

  • Red Hat Enterprise Linux (RHEL)
  • SUSE Linux Enterprise Server (SLES)
  • Ubuntu

• インストール後の設定や検証には、Transact-SQL(T-SQL)コマンドを実行するクエリエディタが必要です。 Visual Studio CodeにはMSSQL拡張機能を推奨します。 Linux上で動作する無料ダウンロードです。

• また、言語拡張は Linux コンテナー上でもサポートされます。 言語拡張付きの既成コンテナは利用できませんが、GitHubで入手可能なサンプルテンプレートを使ってSQL Serverコンテナから作成できます。

• 言語拡張と Machine Learning Services は、SQL Server ビッグ データ クラスターには既定でインストールされます。 ビッグ データ クラスターを使用する場合、この記事の手順を行う必要はありません。

パッケージ一覧

インターネットに接続されたデバイスでは、各オペレーティングシステムのパッケージインストーラーを使って、データベース エンジンとは独立してパッケージをダウンロード・インストールします。 次の表に、使用可能な全パッケージについて説明します。

Java 言語拡張機能をインストールする

# Install as root or sudo
sudo yum install mssql-server-extensibility-java

# Install as root or sudo
sudo apt-get install mssql-server-extensibility-java

# Install as root or sudo
sudo zypper install mssql-server-extensibility-java

インストール後の設定(必須)

1. Linux 上でのアクセス許可を付与します

   外部ライブラリを使用している場合は、この手順を実行する必要はありません。 外部ライブラリが推奨される方法です。 jarファイルから外部ライブラリを作成する際の助けは、CREATE EXTERNAL LIBRARYを参照してください。

   外部ライブラリを使用しない場合は、jar 内の Java クラスを実行するための権限を SQL Server に付与する必要があります。

   jarファイルへの読み取りおよび実行アクセスを許可するには、jarファイルに対して以下のchmodコマンドを実行します。 授業ファイルをjarに置くときは必ず使SQL Server。 jar の作成に関するヘルプについては、「クラス ファイルから Java .jar ファイルを作成する」を参照してください。

   chmod ug+rx <MyJarFile.jar>
   

   また、jarファイルの読み取りと実行権限をmssql_satellite付与する必要があります。

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   追加の構成には、主に mssql-conf ツールを利用します。

2. SQL Server サービスの実行に使用する mssql ユーザー アカウントを追加します。 このステップは、以前にセットアップを実行していない場合に必要です。

   sudo /opt/mssql/bin/mssql-conf setup
   

3. 送信ネットワーク アクセスを有効にします。 既定では、送信ネットワーク アクセスは無効になっています。 アウトバウンドリクエストを有効にするには、mssql-confツールでoutboundnetworkaccessブールプロパティを設定します。 詳しくは、「mssql-conf ツールを利用して SQL Server on Linux を構成する」をご覧ください。

   # Run as SUDO or root
   # Enable outbound requests over the network
   sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1
   

4. SQL Server Launchpad サービスとデータベース エンジン インスタンスを再起動して、INI ファイルから更新後の値を読み込みます。 拡張性関連の設定を変更するたびにリスタートメッセージが表示されます。

   systemctl restart mssql-launchpadd
   systemctl restart mssql-server.service
   

5. 外部スクリプトの実行を有効にします。 SQLcmd、SQL Server Management Studio (SSMS)、Visual Studio Code 用の MSSQL 拡張機能など、使い慣れた SQL Server クライアント ツールを使用して、SQL Server のインスタンスに接続できます。

   EXECUTE sp_configure 'external scripts enabled', 1;
   
   RECONFIGURE WITH OVERRIDE;
   

6. もう一度、mssql-launchpadd サービスを再起動します。

7. 言語拡張を使いたい各データベースで、外部言語を CREATE EXTERNAL LANGUAGEに登録してください。 次のセクションで手順をご参照ください。

外部言語を登録する

言語拡張を使いたい各データベースで、外部言語を CREATE EXTERNAL LANGUAGEに登録してください。

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

CREATE EXTERNAL LANGUAGE Java
FROM (
    CONTENT = N'/opt/mssql-extensibility/lib/java-lang-extension.tar.gz',
    FILE_NAME = 'javaextension.so',
    ENVIRONMENT_VARIABLES = N'{"JRE_HOME":"/opt/mssql/lib/zulu-jre-11"}'
);

Java拡張では、環境変数JRE_HOMEがJVMの探索と初期化のパスを決定します。

CREATE EXTERNAL LANGUAGE DDLは、拡張をホストするプロセスの環境変数を設定するためのENVIRONMENT_VARIABLESパラメータを提供します。 このパラメータを使って、外部言語拡張で必要とする環境変数を設定します。

詳細については、CREATE EXTERNAL LANGUAGEを参照してください。

インストールを検証する

機能統合Javaライブラリは含まれていませんが、JRE_HOME環境変数が存在することを確認するためにgrep -r JRE_HOME /etc実行できます。

インストールを確認するには、Java を起動するシステム ストアド プロシージャが実行される T-SQL スクリプトを実行します。 このタスクには、クエリ ツールが必要になります。 SQLcmd、SQL Server Management Studio (SSMS)、Visual Studio Code 用の MSSQL 拡張機能など、使い慣れた SQL Server クライアント ツールを使用して、SQL Server のインスタンスに接続できます。

制限事項

Linuxでは暗黙認証は利用できません。 外部プロセスで動作するJavaコードは、サーバーに接続してデータや他のリソースにアクセスできません。

リソース管理

LinuxとWindowsは外部リソースプールのリソースガバナンスに関して同等ですが、sys.dm_resource_governor_external_resource_poolsの統計では現在Linux上で異なるユニットが存在しています。

関連するコンテンツ

• チュートリアル:Java で正規表現 (regex) を使用して文字列を検索する