Windows에 SQL Server Java 언어 확장 설치

적용 대상: SQL Server 2019(15.x) 이상 버전

Windows에 SQL Server용 Java 언어 확장 구성 요소를 설치하는 방법을 알아봅니다. Java 언어 확장은 SQL Server 언어 확장의 일부입니다.

참고 항목

이 문서는 Windows에서의 SQL Server용 Java 언어 확장을 설치하는 데 사용합니다. Linux의 경우, Linux에 SQL Server Java 언어 확장 설치를 참조하세요. Windows의 C# 언어 확장은 Windows에 SQL Server .NET 언어 확장 설치를 참조하세요.

필수 조건

참고 항목

기능 및 설치 옵션은 SQL Server 버전에 따라 다릅니다. 버전 선택기 드롭다운 목록을 사용하여 적절한 버전의 SQL Server를 선택합니다.

• Java 언어 확장 지원을 설치하려면 SQL Server 설치가 필요합니다.

• 최신 Microsoft Build of OpenJDK 또는 공식적으로 라이선스가 부여된 Java 런타임을 포함하여 원하는 대로 Java 런타임을 다운로드하고 설치할 수 있습니다. SQL Server 2022(16.x) 이상 버전에서는 SQL Server 설치 프로그램에서 Java 런타임을 설치하지 않습니다.

• 데이터베이스 엔진 인스턴스가 필요합니다. 기존 인스턴스에 증분식으로 추가할 수 있지만 Java 언어 확장 기능만 설치할 수는 없습니다.

• 비즈니스 연속성을 위해 Always On 가용성 그룹이 언어 확장에 대해 지원됩니다. 언어 확장을 설치하고 각 노드에서 패키지를 구성해야 합니다. Java 언어 확장 설치는 SQL Server의 장애 조치(failover) 클러스터 인스턴스에서도 지원됩니다.

• 도메인 컨트롤러에 SQL Server 언어 확장 또는 Java 언어 확장을 설치하지 마세요. 설치 프로그램의 언어 확장 부분이 실패합니다.

• 언어 확장 및 Machine Learning Services는 SQL Server 빅 데이터 클러스터에 기본적으로 설치됩니다. 빅 데이터 클러스터를 사용하는 경우에는 이 문서의 단계를 수행하지 않아도 됩니다. 자세한 내용은 SQL Server 2019 빅 데이터 클러스터에서 Machine Learning Services를 사용하여 Python 및 R 스크립트 실행을 참조하세요.

Important

설치가 완료되면 이 문서에 설명된 구성 후 단계를 완료해야 합니다. 이러한 단계에는 SQL Server에서 외부 코드를 사용하도록 설정하고 SQL Server가 사용자를 대신하여 Java 코드를 실행하는 데 필요한 계정을 추가하는 것이 포함됩니다. 일반적으로 구성 변경 시 인스턴스를 다시 시작하거나 실행 패드 서비스를 다시 시작해야 합니다.

Java JRE 또는 JDK

참고

기능 및 설치 옵션은 SQL Server 버전에 따라 다릅니다. 버전 선택기 드롭다운 목록을 사용하여 적절한 버전의 SQL Server를 선택합니다.

SQL Server 2022(16.x)에서는 최신 Microsoft Build of OpenJDK 또는 공식적으로 라이선스가 부여된 Java 런타임을 포함하여 Java 런타임을 다운로드하고 설치할 수 있습니다.

Java 11이 현재 Windows에서 지원되는 버전입니다. JRE(Java Runtime Environment)가 최소 요구 사항이지만, Java 컴파일러 및 개발 패키지를 필요로 하는 경우 JDK(Java Development Kit)가 유용합니다. JDK는 모두 포함하므로 JDK를 설치하는 경우 JRE가 필요하지 않습니다. Windows에서는 가능한 경우 기본 /Program Files/ 폴더 아래에 JDK를 설치하는 것이 좋습니다. 그렇지 않으면 실행 파일에 대한 사용 권한을 부여하기 위한 추가 구성이 필요합니다. 자세한 내용은 이 문서의 권한 부여(Windows) 섹션을 참조하세요.

설치 미디어 다운로드

SQL Server 다운로드 위치는 버전에 따라 다릅니다.

• SQL Server Enterprise, Standard 및 Express Edition 이러한 버전은 프로덕션 용도로 사용이 허가됩니다. Enterprise 및 Standard Edition의 경우 설치 미디어를 얻으려면 소프트웨어 공급업체에 문의하세요. 구매 정보 및 Microsoft 파트너 디렉터리는 Microsoft 구매 웹 사이트에서 확인할 수 있습니다.

• 최신 무료 버전

설치 프로그램 실행

로컬 설치의 경우 관리자로 설치 프로그램을 실행해야 합니다. 원격 공유로 SQL Server를 설치하는 경우 원격 공유에 대한 읽기 및 실행 권한이 있는 도메인 계정을 사용해야 합니다.

1. SQL Server에 대한 설치 마법사를 시작합니다.

2. 설치 탭에서 새 SQL Server 독립 실행형 설치 또는 기존 설치에 기능 추가를 선택합니다.

3. 기능 선택 페이지에서 다음 옵션을 선택합니다.

   데이터베이스 엔진 서비스: SQL Server에서 언어 확장을 사용하려면 데이터베이스 엔진의 인스턴스를 설치해야 합니다. 기본 인스턴스나 명명된 인스턴스를 사용할 수 있습니다.

   Machine Learning 서비스 및 언어 확장: 이 옵션은 Java 코드 실행을 지원하는 언어 확장 구성 요소를 설치합니다.

   

4. 설치 준비 완료 페이지에서 이러한 선택 사항이 포함되어 있는지 확인하고 설치를 선택합니다.

   • 데이터베이스 엔진 서비스
   • Machine Learning Services 및 언어 확장

   구성 파일이 저장된 ..\Setup Bootstrap\Log 경로 아래에 있는 폴더의 위치를 확인합니다. 설치가 완료되면 요약 파일에 설치된 구성 요소를 검토할 수 있습니다.

5. 설치가 완료된 후 컴퓨터를 다시 시작하라는 메시지가 나타나면 다시 시작합니다. 설치가 끝나면 설치 마법사에 표시되는 메시지를 읽어야 합니다. 자세한 내용은 View and Read SQL Server Setup Log Files을 참조하세요.

JRE_HOME 변수 추가

JRE_HOME은 Java 인터프리터의 위치를 지정하는 시스템 환경 변수입니다. 이 단계에서는 Windows에서 이에 대한 시스템 환경 변수를 만듭니다.

1. JRE 홈 경로를 찾아 복사합니다.

   이 경로는 런타임 및 설치 옵션에 따라 달라집니다.

   Java 확장 프로그램은 경로 %JRE_HOME%\bin\server에서 jvm.dll을 로드하려고 시도합니다.

1. 제어판에서 시스템 및 보안, 시스템을 차례로 연 다음 고급 시스템 속성을 선택합니다.

2. 환경 변수를 선택합니다.

3. JDK/JRE 경로(1단계에 찾음)의 값을 사용하여 JRE_HOME에 대한 새 시스템 변수를 만듭니다.

1. 언어 확장 등록 Java 사용자 지정 런타임에 사용되는 Java 언어 확장을 다운로드하고 등록하려면 다음 단계를 수행합니다.

   1. SQL Server GitHub 리포지토리용 Java 언어 확장에서 java-lang-extension-windows-release.zip 파일을 다운로드합니다. 최신 Window sjava-lang-extension-windows.zip 파일을 다운로드합니다. SQL Server 설치 프로그램에서 기본 Java를 설치하지 않은 경우 JRE 버전이 GitHub에서 다운로드한 버전과 일치하는지 확인합니다. 자체 설치된 JRE 버전을 사용하려는 경우 GitHub 소스 코드에서 java-lang-extension을(를) 컴파일해야 할 수 있습니다.

   2. Azure Data Studio를 사용하여 SQL Server 인스턴스에 연결하고, 다음 T-SQL 명령을 실행하여 Java 언어 확장을 CREATE EXTERNAL LANGUAGE에 등록합니다.

   3. 다운로드한 언어 확장 zip 파일(java-lang-extension-windows-release.zip)의 위치와 사용자 지정 Java 설치 위치(%ProgramFiles%\Python)를 반영하도록 이 명령문의 경로를 수정합니다.

   CREATE EXTERNAL LANGUAGE [Java]
   FROM (CONTENT = N'C:\path\to\java-lang-extension-windows-release.zip',
       FILE_NAME = 'javaextension.dll',
       ENVIRONMENT_VARIABLES = N'{"JAVAHOME": "C:\\Program Files\\Java"}');
   GO
   

2. 실행 패드를 다시 시작합니다.

   1. SQL Server 구성 관리자를 엽니다.

   2. SQL Server 서비스에서 SQL Server 실행 패드를 마우스 오른쪽 단추로 클릭한 다음 다시 시작을 선택합니다.

기본 JRE 폴더가 아닌 폴더에 대한 액세스 권한 부여

프로그램 파일 아래에 Java를 설치하지 않은 경우 다음 단계를 수행해야 합니다.

관리자 권한 명령줄에서 icacls 명령을 실행하여 JRE에 액세스하기 위한 SQLRUsergroup 및 SQL Server 서비스 계정(ALL_APPLICATION_PACKAGES)에 대한 액세스 권한을 부여합니다. 이 명령은 지정된 디렉터리 경로 아래의 모든 파일 및 폴더에 대한 액세스 권한을 재귀적으로 부여합니다.

1. SQLRUserGroup 권한 부여

   명명된 인스턴스의 경우 인스턴스 이름을 SQLRUsergroup에 추가합니다(예: SQLRUsergroupINSTANCENAME).

   icacls "<PATH to JRE>" /grant "SQLRUsergroup":(OI)(CI)RX /T
   

   Windows의 Program Files 아래에 있는 기본 폴더에 JDK/JRE를 설치한 경우 이 단계를 건너뛸 수 있습니다.

2. AppContainer 권한 부여 이 명령은 컴퓨터 SID S-1-15-2-1에 권한을 부여하며 이는 영어 버전 Windows에서의 ALL APPLICATION PACKAGES과(와) 같습니다. 또는 영어 버전 Windows에서 icacls "<PATH to JRE>" /grant "ALL APPLICATION PACKAGES":(OI)(CI)RX /T를 사용할 수도 있습니다.

   icacls "<PATH to JRE>" /grant *S-1-15-2-1:(OI)(CI)RX /T
   

서비스를 다시 시작합니다.

설치가 완료되면 다음 단계를 계속하기 전에 데이터베이스 엔진을 다시 시작하여 스크립트 실행을 사용하도록 설정합니다.

서비스를 다시 시작하면 관련 SQL Server 실행 패드 서비스가 자동으로 다시 시작됩니다.

SSMS의 인스턴스에 대해 Restart 명령을 마우스 오른쪽 단추로 클릭하거나 제어판의 서비스 패널을 사용하거나 SQL Server 구성 관리자를 사용하여 서비스를 다시 시작할 수 있습니다.

스크립트 실행 사용

1. SQL Server Management Studio를 엽니다. 언어 확장을 설치한 인스턴스에 연결하고 새 쿼리를 선택하여 쿼리 창을 열고 다음 명령을 실행합니다.

   EXEC sp_configure;
   

   이 기능은 기본적으로 꺼져(value은(는) 0임) 있으며, Java 코드를 실행하기 전에 관리자가 명시적으로 사용하도록 설정해야 합니다.

2. 외부 스크립팅 기능을 사용하도록 설정하려면 다음 문을 실행합니다.

   EXEC sp_configure 'external scripts enabled', 1
   GO
   RECONFIGURE WITH OVERRIDE
   

   이미 Machine Learning Services 기능을 사용하도록 설정한 경우 언어 확장에 대해 다시 구성을 실행하지 마세요. 기본 확장성 플랫폼은 둘 모두 지원합니다.

외부 언어 등록

언어 확장을 사용하려는 각 데이터베이스에 대해 외부 언어 만들기를 사용하여 외부 언어를 등록해야 합니다.

다음 예제는 Windows에서 SQL Server의 데이터베이스에 외부 언어가 호출한 Java를 추가합니다.

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

자세한 내용은 외부 언어 만들기를 참조하세요.

설치 확인

설치 로그에서 인스턴스의 설치 상태를 확인합니다.

외부 스크립트를 시작하는 데 사용되는 모든 구성 요소가 실행 중인지 확인하려면 다음 단계를 사용합니다.

1. SQL Server Management Studio 또는 Azure Data Studio에서 새 쿼리 창을 열고 다음 문을 실행합니다.

   EXEC sp_configure 'external scripts enabled';
   

   run_value은(는) 이제 1로 설정됩니다.

2. 서비스 패널 또는 SQL Server 구성 관리자를 열고 SQL Server 실행 패드 서비스가 실행 중인지 확인합니다. 언어 확장이 설치된 모든 데이터베이스 엔진 인스턴스에 대해 하나의 서비스가 있어야 합니다. 서비스에 대한 자세한 내용은 SQL Server 언어 확장의 확장성 아키텍처를 참조하세요.

추가 구성

확인 단계가 성공하면 SQL Server Management Studio, Azure Data Studio 또는 Visual Studio Code에서 또는 T-SQL 문을 서버로 보낼 수 있는 기타 클라이언트에서 Java 코드를 실행할 수 있습니다.

명령을 실행할 때 오류가 발생하는 경우 이 섹션의 추가 구성 단계를 검토하세요. 서비스 또는 데이터베이스에 적절한 구성을 추가해야 할 수도 있습니다.

인스턴스 수준에서 추가 구성은 다음을 포함할 수 있습니다.

• SQL Server Machine Learning Services에 대한 방화벽 구성
• 서버 네트워크 프로토콜 설정 또는 해제
• 원격 액세스(서버 구성 옵션) 구성
• SQLRUserGroup에 대한 로그인 만들기

데이터베이스에서는 다음 구성 업데이트가 필요할 수 있습니다.

• 데이터베이스 사용자에게 SQL Server Machine Learning Services를 사용하여 Python 및 R 스크립트를 실행할 수 있는 권한 부여
• 사용자에게 특정 언어를 실행할 수 있는 권한 부여

참고

추가 구성이 필요한지 여부는 보안 스키마, SQL Server를 설치한 위치, 사용자가 데이터베이스에 연결하여 외부 스크립트를 실행하는 방법에 따라 결정됩니다.

권장 최적화

이제 모두 제대로 작동하므로 Java 언어 확장을 지원하도록 서버를 최적화할 수도 있습니다.

Java 언어 확장을 위한 서버 최적화

SQL Server 설치 프로그램에 대한 기본 설정은 데이터베이스 엔진에서 지원하는 다양한 서비스에 맞게 서버의 균형을 최적화하기 위한 것입니다. 이러한 서비스에는 ETL(추출, 변환 및 로드) 프로세스, 보고, 감사 및 SQL Server 데이터를 사용하는 애플리케이션이 포함될 수 있습니다. 따라서 기본 설정을 사용할 경우, 특히 메모리를 많이 사용하는 작업에서는 언어 확장을 위한 리소스가 제한될 수도 있습니다.

언어 확장 작업에 적절한 우선 순위와 리소스가 지정되도록 SQL Server Resource Governor를 사용하여 외부 리소스 풀을 구성하는 것이 좋습니다. 또한 데이터베이스 엔진에 할당된 메모리 크기를 변경하거나 SQL Server 실행 패드 서비스에서 실행되는 계정 수를 늘릴 수도 있습니다.

• 외부 리소스 관리를 위해 리소스 풀을 구성하려면 CREATE EXTERNAL RESOURCE POOL(Transact-SQL)을 참조하세요.

• 데이터베이스에 예약된 메모리 양을 변경하려면 서버 메모리 구성 옵션을 참조하세요.

Standard Edition을 사용 중인 경우 Resource Governor가 없으면 DMV(동적 관리 뷰) 및 확장 이벤트뿐만 아니라 Windows 이벤트 모니터링을 사용하여 서버 리소스를 쉽게 관리할 수 있습니다.

다음 단계

Java 개발자는 몇 가지 간단한 예제를 시작하고 Java가 SQL Server에서 작동하는 방식의 기초를 알아볼 수 있습니다. 다음 단계는 아래 링크를 참조하세요.

자습서: Java를 사용하는 정규식