JDBC를 Eclipse와 함께 사용하여 Oracle Autonomous AI Database에 연결

Eclipse IDE를 사용하여 Oracle Autonomous AI Database에 대한 연결을 설정할 수 있습니다. 다음 섹션에서는 Maven 프로젝트 또는 Gradle 프로젝트를 사용하여 Oracle Autonomous AI Database에 처음 접속하는 방법에 대한 정보를 제공합니다. Oracle Autonomous AI Database에 연결하기 전에 필요 조건에 설명된 단계를 완료했는지 확인하십시오.

필수 조건

다음 섹션에서는 Oracle JDBC 드라이버 및 범용 접속 풀을 사용하여 Oracle Autonomous AI Database에 Java 애플리케이션을 접속하기 전에 수행해야 하는 작업에 대한 정보를 제공합니다. 자율운영 Exadata VM 클러스터(AVMC) 프로비전 중에 선택된 인증 유형에 따라 적절한 필요 조건을 참조하십시오. 기본적으로 단방향 TLS 연결은 AVMC를 프로비전할 때 사용으로 설정됩니다. 자세한 내용은 자율운영 Exadata VM 클러스터 생성을 참조하십시오.

인증 유형은 AVMC의 세부 정보 페이지에서 찾을 수 있습니다. 지침은 자율운영 Exadata VM 클러스터의 세부정보 보기를 참조하십시오.

Oracle Autonomous AI Database 인스턴스 프로비전

Oracle Autonomous AI Database에 대한 액세스 권한이 필요합니다. 아직 프로비저닝되지 않은 경우 전용 Exadata 인프라의 자율운영 AI 데이터베이스로 시작하기 전에를 참조하십시오.

ADMIN 사용자에 대해 사용한 비밀번호를 기억하십시오. 데모를 위해 ADMIN 사용자를 사용하지만 Oracle SQL Developer 또는 Database Actions를 사용하여 다른 데이터베이스 사용자를 생성하는 것이 좋습니다.

JDK 8 설치

최신 JDK 8 또는 더 높은 JDK 버전을 다운로드하세요.

주: JDK8u162 또는 이후 버전을 사용해야 합니다. java -version를 사용하여 설치한 JDK 버전을 확인합니다. JDBC 드라이버 버전을 확인하려면 java -jar ojdbc8.jar를 입력합니다.

Github에서 샘플 프로그램 다운로드

Github에서 ADBQuickStart.java 파일을 다운로드합니다. 이 샘플 애플리케이션은 SH(판매 내역) 샘플 스키마를 사용하고 SH.CUSTOMERS 테이블의 20개 레코드를 표시합니다.
Oracle Autonomous AI Database 연결 정보를 포함하도록 ADBQuickStart.java 파일을 수정합니다.
- DB_USER: Oracle Autonomous AI Database가 생성될 때 기본적으로 생성된 사용자인 ADMIN를 사용할 수 있습니다(다른 OracleAutonomous AI 데이터베이스 사용자를 생성하는 경우 해당 사용자를 대신 사용할 수 있음).
- DB_PASSWORD: 데이터베이스 사용자의 비밀번호를 사용합니다. ADMIN 사용자로 접속하는 경우 Oracle Autonomous AI Database를 프로비전하는 동안 자율운영 AI 데이터베이스 생성 단계에서 선택한 비밀번호로 설정합니다. 보안상의 이유로 샘플을 실행할 때 콘솔을 통해 암호를 입력해야 합니다.
- DB_URL: 자율운영 AI 데이터베이스에 대한 접속 문자열 보기의 지침에 따라 자율운영 AI 데이터베이스에 대한 접속 문자열을 얻습니다. Java 프로그램에서 직접 사용하는 경우 연결 문자열에서
  
  샘플 빠른 시작 Java 파일은 다음과 같습니다.
```
DB_URL = "jdbc:oracle:thin:@jdbc:oracle:thin:@(description=
      (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-sanjose-1.oraclecloud.com))(connect_data=(service_name=g13ec47eade81f7_demodb_low.adb.oraclecloud.com))(security=(ssl_server_cert_dn="CN=adb.us-sanjose-1.oraclecloud.com,
      OU=Oracle ADB SANJOSE, O=Oracle Corporation, L=Redwood City, ST=California,
      C=US")))"
DB_USER="ADMIN" and DB_PASSWORD="your_password"
```
ADBQuickStart.java 파일에 대한 변경 사항을 저장합니다.

문제 해결 및 디버깅:

오류가 발생하면 문제 해결 팁 페이지에서 유용한 힌트를 참조하십시오.

Oracle Autonomous AI Database 인스턴스 프로비전

클라이언트 인증서 얻기

자율운영 AI 데이터베이스 인스턴스에서 전자 지갑 파일을 다운로드하여 자율운영 AI 데이터베이스 인스턴스 액세스에 필요한 클라이언트 보안 인증서 및 네트워크 구성 설정이 포함된 zip 파일을 가져옵니다.

클라이언트 보안 인증서(wallet.zip 파일)를 얻습니다.
- ADMIN 사용자: Oracle Cloud Infrastructure 콘솔에서 데이터베이스 연결을 누릅니다. 클라이언트 인증서 다운로드를 참조하십시오.
- 기타 사용자(비관리자): 자율운영 AI 데이터베이스 인스턴스에 대한 관리자로부터 Oracle Wallet을 얻습니다.
  
  주: 무단 데이터베이스 액세스를 방지하기 위해 wallet.zip 파일 및 해당 콘텐츠를 보호합니다.
클라이언트 인증서 파일(wallet.zip)의 압축을 풉니다.

JDK 8 설치

최신 JDK 8 또는 더 높은 JDK 버전을 다운로드하세요.

Github에서 샘플 프로그램 다운로드

Github에서 ADBQuickStart.java 파일을 다운로드합니다. 이 샘플 애플리케이션은 SH(판매 내역) 샘플 스키마를 사용하고 SH.CUSTOMERS 테이블의 20개 레코드를 표시합니다.
Oracle Autonomous AI Database 연결 정보를 포함하도록 ADBQuickStart.java 파일을 수정합니다.
- DB_USER: Oracle Autonomous AI Database가 생성될 때 기본적으로 생성된 사용자인 ADMIN를 사용할 수 있습니다(다른 OracleAutonomous AI 데이터베이스 사용자를 생성하는 경우 해당 사용자를 대신 사용할 수 있음).
- DB_PASSWORD: 데이터베이스 사용자의 비밀번호를 사용합니다. ADMIN 사용자로 접속하는 경우 Oracle Autonomous AI Database를 프로비전하는 동안 자율운영 AI 데이터베이스 생성 단계에서 선택한 비밀번호로 설정합니다. 보안상의 이유로 샘플을 실행할 때 콘솔을 통해 암호를 입력해야 합니다.
- DB_URL: 네트 서비스 이름(TNS 별칭) DBName_medium을 입력합니다. 여기서 DBName은 Oracle Autonomous AI Database를 프로비전하는 동안 자율운영 AI 데이터베이스 생성 단계 중에 입력된 Oracle Autonomous AI Database 이름입니다. 사용 가능한 네트 서비스 이름은 클라이언트 인증서 zip 파일의 일부인 tnsnames.ora 파일에서 볼 수 있습니다.
  
  TNS_ADMIN은 Oracle Autonomous AI Database의 클라이언트 인증서 압축을 해제한 위치를 가리켜야 합니다.
  
  샘플 빠른 시작 Java 파일은 다음과 같습니다.
```
DB_URL = "jdbc:oracle:thin:@DBName_medium?TNS_ADMIN=/Users/test/wallet_DBName" DB_USER="ADMIN" and DB_PASSWORD="enter_it_from_console"
```
ADBQuickStart.java 파일에 대한 변경 사항을 저장합니다.

절차

Eclipse와 Maven 또는 Gradle을 사용하여 자율운영 AI 데이터베이스에 연결할 수 있습니다.

Maven 프로젝트를 생성합니다.
1. 파일 메뉴에서 새로 만들기를 선택한 다음 새 Maven 프로젝트를 선택합니다. Maven Archetype을 사용하거나 단순 프로젝트 생성(Archetype 선택 건너뛰기)을 선택할 수 있습니다.
2. Maven 프로젝트에 대해 GAV를 선택합니다. 이러한 파일은 프로젝트에 대한 pom.xml 파일에 나타납니다.
  - 그룹 ID: com.oracle
  - 아티팩트 ID: ADBquickstart
  - 버전: 0.0.1-SNAPSHOT로 둡니다.
ADBQuickStart.java 파일을 만듭니다.
1. src/main/java을 마우스 오른쪽 단추로 누르고 새로 만들기를 선택한 다음 클래스를 선택합니다.
2. 다음 값을 입력한 후 완료를 누릅니다.
  - 패키지: com.oracle.jdbctest
  - 이름: ADBQuickStart
    
    주: ADBQuickStart.java 파일의 내용을 생성된 새 파일로 복사해야 합니다.
pom.xml 파일을 다음 변경 사항으로 수정합니다. Oracle JDBC Driver를 종속성으로 추가합니다.

ojdbc8-production는 ucp.jar(클라이언트측 접속 풀로 UCP를 사용하는 데 필요), oraclepki.jar, osdt_core.jar, osdt_cert.jar와 함께 Oracle JDBC 드라이버(ojdbc8.jar)를 다운로드합니다. 이러한 JAR은 Oracle Autonomous AI Database에 연결하는 동안 Oracle Wallets를 사용하는 데 필요합니다.
```
 <properties>
     <maven.compiler.source>11</maven.compiler.source>
     <maven.compiler.target>11</maven.compiler.target>
 </properties>
 <dependencies>
   <dependency>
     <groupId>com.oracle.database.jdbc</groupId>
     <artifactId>ojdbc8-production</artifactId>
     <version>19.18.0.0</version>
     <type>pom</type>
   </dependency>
 </dependencies>
```
샘플 Java 프로그램을 빌드하고 실행합니다. Java 코드에 컴파일 오류가 없고 최신 JDK 버전을 사용 중인지 확인하십시오. ADBQuickStart.java를 마우스 오른쪽 버튼으로 누릅니다. 다른 이름으로 실행을 누른 다음 Java 응용 프로그램을 눌러 샘플 Java 프로그램을 실행합니다. 데이터베이스 암호를 입력하라는 메시지가 표시됩니다.

암호를 입력하면 결과가 표시됩니다.

샘플 출력:

다음 화면에 표시된 것처럼 질의된 행과 성공 메시지가 표시됩니다.

그림 eclipse_build_and_run.png에 대한 설명

참고: 방화벽 뒤에서 Oracle Autonomous AI Database에 접속할 경우 접속 시간 초과 오류가 발생할 수 있습니다. 이 샘플을 실행하는 동안 방화벽 외부에 있어야 합니다. 또는 HTTPS 프록시를 사용하도록 tnsnames.ora 파일을 업데이트하십시오.

Gradle 다운로드 및 빌드 지침은 Gradle Guide의 지침에 따라 Gradle 명령을 사용하기 전에 PATH 변수를 설정합니다. 첫 번째 단계로 다음 명령을 사용하여 Gradle 프로젝트를 만듭니다. 생성할 프로젝트 유형 선택에 대해 2:application을 선택해야 합니다. 또한 소스 패키지(기본값:temp)의 경우 com.oracle.jdbctest를 사용합니다.
```
 gradle init
```
ADBQuickStart.java 파일을 src/main/java/com/oracle/jdbctest 디렉토리에 복사합니다.
다음 변경 사항으로 build.gradle 파일을 수정합니다.
- mavenCentral()를 저장소로 추가합니다.
- Oracle JDBC 드라이버를 종속성으로 추가합니다.
주: ojdbc8-production는 ucp.jar(클라이언트측 접속 풀로 UCP를 사용하는 데 필요), oraclepki.jar, osdt_core.jar, osdt_cert.jar와 함께 Oracle JDBC 드라이버(ojdbc8.jar)를 다운로드합니다. 이러한 JAR은 Oracle Autonomous AI Database에 연결하는 동안 Oracle Wallets를 사용하는 데 필요합니다.

자세한 내용은 Maven Central Guide를 참조하십시오.
- mainClassName를 ADBQuickStart로 업데이트합니다.
- 콘솔에서 암호를 읽을 수 있는 run 블록을 추가합니다.
```
 repositories {
   // Maven Central
    mavenCentral()
  }
 dependencies {
   // Get the 19.18.0.0 Oracle JDBC driver along with other companion jars
   implementation("com.oracle.database.jdbc:ojdbc8-production:19.18.0.0")
  }
 application {
   // Define the main class for the application
   mainClassName ='{your_project_directory}.ADBQuickStart'
 }
 // To pause to read the password from console
 run {
   standardInput = System.in
 }
```
Gradle Application 만들기 build.gradle 파일이 있는 디렉토리에 있는지 확인합니다. 다음 명령을 사용하여 Java 코드를 컴파일합니다.
```
 ./gradlew build
```
샘플 Java 프로그램을 실행합니다.
```
 ./gradlew run
```
샘플 출력:

다음 화면에 표시된 것처럼 질의된 행과 성공 메시지가 표시됩니다.

그림 gradle_build_and_run.png에 대한 설명

참고: 방화벽 뒤에서 Oracle Autonomous AI Database에 접속할 경우 접속 시간 초과 오류가 발생할 수 있습니다. 이 샘플을 실행하는 동안 방화벽 외부에 있어야 합니다. 또는 HTTPS 프록시를 사용하도록 tnsnames.ora 파일을 업데이트하십시오.