Instalowanie rozszerzenia języka Java programu SQL Server w systemie Linux

Dotyczy: SQL Server 2019 (15.x) — Linux i nowsze wersje

Dowiedz się, jak zainstalować składnik rozszerzenia języka Java dla programu SQL Server w systemie Linux. Rozszerzenie języka Java jest częścią SQL Server Language Extensions i dodatkiem do silnika bazy danych.

Mimo że aparat bazy danych i rozszerzenia języka można zainstalować jednocześnie, najlepiej jest najpierw zainstalować i skonfigurować aparat bazy danych programu SQL Server, aby móc rozwiązać wszelkie problemy przed dodaniem kolejnych składników.

Wymagania wstępne

• Wersja systemu Linux musi być obsługiwana przez serwer SQL Server, ale nie zawiera silnika Docker. Obsługiwane wersje obejmują:

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

• Powinno być narzędzie do uruchamiania poleceń Transact-SQL (T-SQL). Edytor zapytań jest niezbędny do konfiguracji i weryfikacji po instalacji. Zalecamy korzystanie z usługi Azure Data Studio — bezpłatnego pobierania działającego w systemie Linux.

• Rozszerzenia językowe są również obsługiwane w kontenerach systemu Linux. Nie udostępniamy wstępnie utworzonych kontenerów z rozszerzeniami języka, ale można je utworzyć na podstawie kontenerów programu SQL Server przy użyciu przykładowego szablonu dostępnego w usłudze GitHub.

• Rozszerzenia języka i usługi Machine Learning Services są instalowane domyślnie w klastrach danych big data programu SQL Server. Jeśli używasz klastrów danych big data, nie musisz wykonywać kroków opisanych w tym artykule. Aby uzyskać więcej informacji, zobacz Run Python and R scripts with Machine Learning Services on SQL Server 2019 Big Data Clusters (Uruchamianie skryptów języka Python i R za pomocą usług Machine Learning Services w klastrach danych big data programu SQL Server 2019).

Lista pakietów

Na urządzeniu połączonym z Internetem pakiety są pobierane i instalowane niezależnie od aparatu bazy danych przy użyciu instalatora pakietów dla każdego systemu operacyjnego. W poniższej tabeli opisano wszystkie dostępne pakiety.

Instalowanie rozszerzenia języka 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

Konfiguracja po instalacji (wymagana)

1. Udzielanie uprawnień w systemie Linux

   Nie musisz wykonywać tego kroku, jeśli używasz bibliotek zewnętrznych. Zalecanym sposobem pracy jest używanie bibliotek zewnętrznych. Aby uzyskać pomoc dotyczącą tworzenia biblioteki zewnętrznej z plikujar, zobacz CREATE EXTERNAL LIBRARY (TWORZENIE ZEWNĘTRZNEJ BIBLIOTEKI)

   Jeśli nie używasz bibliotek zewnętrznych, musisz zapewnić programowi SQL Server uprawnienia do wykonywania klas Języka Java w usłudze jar.

   Aby udzielić dostępu do odczytu i wykonania na pliku jar, uruchom następujące polecenie chmod na pliku jar. Zalecamy zawsze umieszczanie plików klas w jar podczas pracy z SQL Server. Aby uzyskać pomoc dotyczącą tworzenia obiektu jar, zobacz Create a Java .jar file from class files (Tworzenie pliku java .jar z plików klas).

   chmod ug+rx <MyJarFile.jar>
   

   Musisz również przyznać plikowi mssql_satellite uprawnienia jar do odczytu i wykonywania.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   Dodatkową konfigurację wykonuje się przede wszystkim za pomocą narzędzia mssql-conf.

2. Dodaj konto użytkownika mssql używane do uruchamiania usługi SQL Server. Jest to wymagane, jeśli wcześniej nie uruchomiono instalacji.

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

3. Włącz wychodzący dostęp sieciowy. Dostęp sieciowy wychodzący jest domyślnie wyłączony. Aby umożliwić żądania wychodzące, ustaw wartość logiczną outboundnetworkaccess za pomocą narzędzia mssql-conf. Aby uzyskać więcej informacji, zobacz Configure SQL Server on Linux with mssql-conf(Konfigurowanie programu SQL Server w systemie Linux przy użyciumssql-conf).

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

4. Uruchom ponownie usługę SQL Server Launchpad oraz instancję silnika bazy danych, aby odczytać zaktualizowane wartości z pliku INI. Komunikat ponownego uruchomienia przypomina o każdej modyfikacji ustawienia związanego z rozszerzalnością.

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

5. Włącz wykonywanie skryptów zewnętrznych przy użyciu narzędzia Azure Data Studio lub innego narzędzia, takiego jak SQL Server Management Studio (tylko system Windows), z uruchomionym językiem T-SQL.

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

6. Ponownie uruchom usługę mssql-launchpadd .

7. Dla każdej bazy danych, w której chcesz używać rozszerzeń językowych, należy zarejestrować język zewnętrzny za pomocą polecenia CREATE EXTERNAL LANGUAGE. Zobacz kroki w następnej sekcji.

Rejestrowanie języka zewnętrznego

Dla każdej bazy danych, w której chcesz używać rozszerzeń językowych, należy zarejestrować język zewnętrzny za pomocą polecenia CREATE EXTERNAL LANGUAGE.

Poniższy przykład dodaje język zewnętrzny o nazwie Java do bazy danych w programie SQL Server w systemie Linux.

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"}'
);

W przypadku rozszerzenia Java zmienna środowiskowa JRE_HOME służy do określania ścieżki do znajdowania i inicjowania maszyny wirtualnej JVM.

DDL CREATE EXTERNAL LANGUAGE udostępnia parametr (ENVIRONMENT_VARIABLES) do ustawiania zmiennych środowiskowych specjalnie dla procesu hostowania rozszerzenia. Ten proces jest zalecanym i najbardziej efektywnym sposobem ustawiania zmiennych środowiskowych wymaganych przez rozszerzenia języka zewnętrznego.

Aby uzyskać więcej informacji, zobacz CREATE EXTERNAL LANGUAGE (TWORZENIE JĘZYKA ZEWNĘTRZNEgo).

Weryfikowanie instalacji

Integracja funkcji Języka Java nie obejmuje bibliotek, ale można uruchomić polecenie grep -r JRE_HOME /etc w celu potwierdzenia utworzenia zmiennej środowiskowej JAVA_HOME .

Aby zweryfikować instalację, uruchom skrypt języka T-SQL, który wykonuje systemową procedurę składowaną wywołującą język Java. Do tego zadania potrzebne jest narzędzie do wykonywania zapytań. Usługa Azure Data Studio jest dobrym wyborem. Inne powszechnie używane narzędzia, takie jak SQL Server Management Studio, to tylko system Windows. Jeśli masz komputer z systemem Windows z tymi narzędziami, użyj go do nawiązania połączenia z instalacją systemu Linux aparatu bazy danych.

Ograniczenia

W tej chwili uwierzytelnianie implikowane nie jest obecnie dostępne w systemie Linux, co oznacza, że nie można nawiązać połączenia z serwerem z poziomu języka Java w toku w celu uzyskania dostępu do danych lub innych zasobów.

Nadzór nad zasobami

Istnieje równorzędność między systemami Linux i Windows w zarządzaniu zasobami w przypadku zewnętrznych pul zasobów, ale statystyki dotyczące sys.dm_resource_governor_external_resource_pools mają obecnie różne jednostki w systemie Linux.

Powiązana zawartość

• Samouczek: wyszukiwanie ciągu przy użyciu wyrażeń regularnych (regex) w języku Java