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

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

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

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

前提条件

• Linux バージョンは、必ず SQL Server によってサポートされますが、Docker エンジンは含まれていません。 サポートされているバージョンは次のとおりです。

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

• Transact-SQL (T-SQL) コマンドを実行するためのツールを用意しておく必要があります。 インストール後の構成および検証には、クエリ エディターが必要です。 Linux 上で実行される無料ダウンロードの Azure Data Studio をお勧めします。

• また、言語拡張は Linux コンテナー上でもサポートされます。 言語拡張には、ビルド済みのコンテナーは付属していませんが、GitHub 上で入手できるサンプル テンプレートを使用して、SQL Server コンテナーから作成できます。

• 言語拡張と Machine Learning Services は、SQL Server ビッグ データ クラスターには既定でインストールされます。 ビッグ データ クラスターを使用する場合、この記事の手順を行う必要はありません。 詳細は、「SQL Server 2019 のビッグ データ クラスターで Machine Learning Services を使用して Python と R のスクリプトを実行する」を参照してください。

パッケージ一覧

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

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 コマンドを実行します。 SQL Server を操作するときは、常にクラス ファイルを jar 内に配置することをお勧めします。 jar の作成でヘルプが必要な場合は、「クラス ファイルから Java jar ファイルを作成する」を参照してください。

   chmod ug+rx <MyJarFile.jar>
   

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

   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. Azure Data Studio または T-SQL を実行する SQL Server Management Studio (Windows のみ) などの別のツールを使用して、外部スクリプトの実行を有効にします。

   EXEC 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 機能の統合には、ライブラリは含まれませんが、grep -r JRE_HOME /etc を実行して JAVA_HOME 環境変数の作成を確認することができます。

インストールを確認するには、Java を起動するシステム ストアド プロシージャが実行される T-SQL スクリプトを実行します。 このタスクには、クエリ ツールが必要になります。 Azure Data Studio が適しています。 SQL Server Management Studio など、一般的に使用されるその他のツールは Windows 限定です。 これらのツールを利用する Windows コンピューターがある場合は、それを使用してデータベース エンジンの Linux インストールに接続します。

制限事項

現時点では、黙示的認証は Linux 上では使用できません。つまり、データやその他のリソースにアクセスするために、実行中の Java からサーバーへ接続することはできません。

リソース管理

外部リソース プールに対するリソースのガバナンスでは、Linux と Windows 間に一致がありますが、sys.dm_resource_governor_external_resource_pools の統計では、現在は Linux 上に異なるユニットがあります。

関連するコンテンツ

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