컴퓨팅에 연결

연결

AI Data Platform Workbench를 Oracle Analytics Cloud 또는 기타 비즈니스 인텔리전스 도구와 연결할 수 있습니다.

AI 데이터 플랫폼 워크벤치에서 제공하는 커스텀 JDBC 또는 ODBC를 사용하여 다양한 비즈니스 인텔리전스 도구에서 Oracle AI Data Platform Workbench에 연결할 수 있습니다. 또한 AI Data Platform Workbench는 타사 상용 BI 도구(Tableau, Power BI) 또는 DBeaver와 같은 오픈 소스 BI 도구의 연결을 지원합니다. 이러한 툴에서 접속하려면 AI 데이터 플랫폼 워크벤치에서 컴퓨트 클러스터의 접속 세부정보가 필요합니다. 이 세부정보는 접속 세부정보 탭에서 확인할 수 있습니다. 필요한 정보는 연결 중인 제품에 따라 다릅니다.

Oracle Analytics를 AI 데이터 플랫폼 워크벤치에 연결

Oracle Analytics Cloud 인스턴스에서 AI Data Platform Workbench 인스턴스가 관리하는 카탈로그 또는 테이블에 연결할 수 있습니다.

Oracle Analytics에서 Oracle AI Data Platform Workbench로의 연결을 생성하려면 다음을 수행해야 합니다.

OCI에서 API 키 가져오기.
Oracle Analytics 접속 구성 파일 가져오기.
API 키와 구성 파일을 결합하여 연결을 생성합니다. Oracle Analytics 접속 파일 생성을 참조하십시오.
Oracle Analytics Cloud에서 접속을 사용합니다. Oracle AI Data Platform Workbench를 Oracle Analytics에 연결하기를 참고하세요.

어떤 순서로든 1단계와 2단계를 수행할 수 있지만 계속하기 전에 둘 다 수행해야 합니다.

Oracle은 OCI에서 Oracle Analytics 사용 사례 전용 사용자를 생성할 것을 권장합니다. 해당 사용자는 Oracle Analytics에서 액세스하려는 AI 데이터 플랫폼 워크벤치의 테이블에 대해 적절한 권한이 있어야 합니다. OCI에서 필요한 API 키를 생성하고 이 용도로 생성된 사용자에 대한 PEM 파일을 다운로드합니다.

주:

Oracle Analytics에서 AI 데이터 플랫폼 워크벤치에 연결하려면 연결 설정 중 카탈로그 이름을 제공해야 합니다.
현재 시스템에서 AI 데이터 플랫폼 클러스터 내에서 올바른 스키마 및 데이터 객체를 찾는 데 카탈로그가 필요합니다.
이 요구 사항은 이후 릴리스에서 완화될 예정입니다.

OCI에서 API 키 가져오기

Oracle Analytics에 대한 연결을 생성할 때 Oracle AI Data Platform Workbench에 액세스할 수 있는 사용자의 경우 OCI의 API 키가 필요합니다.

API 키를 생성하는 사용자는 AI 데이터 플랫폼 워크벤치 인스턴스의 생성자이거나 인스턴스에 대한 관리자 권한이 있어야 합니다. 또한 인스턴스에 적합한 AI 데이터 플랫폼 워크벤치 클러스터가 있어야 합니다.

OCI에서 사용자 아이콘을 누른 다음 사용자 설정을 누릅니다.
내 프로파일에서 토큰 및 키를 누른 다음 API 키 추가를 누릅니다.
API 키 쌍 생성을 선택한 다음 개인 키 다운로드를 누릅니다.
추가를 누릅니다.

수신한 개인 키(.pem 파일)를 안전하고 영구적인 위치에 저장합니다. 연결에 필요하며 한 번만 다운로드할 수 있습니다. 이 파일은 Oracle Analytics를 AI Data Platform Workbench에 연결할 때 지문으로 사용됩니다.

Oracle Analytics 접속 구성 파일 가져오기

Oracle Analytics에 접속하려면 Oracle AI Data Platform Workbench 인스턴스에서 config.json 파일을 다운로드해야 합니다.

OCPU가 2개 이상이고, 드라이버 및 작업자 노드 모두에 32GB 메모리가 있고, 작업자가 2명 이상인 컴퓨트 클러스터가 필요합니다.

작업영역으로 이동하고 컴퓨트를 누릅니다.
Oracle Analytics에 접속할 클러스터를 누릅니다.
접속 세부정보 탭에서 Oracle Analytics Cloud 로고 아래의 다운로드 아이콘을 누릅니다. config.json 파일이 시스템에 다운로드됩니다.

다운로드한 config.json 파일에 지문 키 값 쌍이 누락되었습니다. AI 데이터 플랫폼 워크벤치를 생성한 OCI 사용자 또는 관리자 권한이 있는 사용자에 속하는 API 키의 지문 키 값과 결합되어야 합니다.

사용자 이름, 테넌시, 영역 및 dsn을 포함한 config.json 파일 내용

Oracle Analytics 접속 파일 생성

Oracle Analytics에 연결하는 데 파일을 사용할 수 있도록 Oracle AI Data Platform Workbench에서 다운로드한 config.json 파일에 지문 키 값 쌍을 수동으로 추가해야 합니다.

AI 데이터 플랫폼 워크벤치 인스턴스를 생성했거나 인스턴스에 대한 관리자 권한이 있는 OCI 사용자에 대한 API 키를 생성했어야 합니다. 또한 Oracle Analytics에 접속할 클러스터에서 config.json를 다운로드해야 합니다.

config.json 파일과 API 키의 구성 파일을 엽니다.
config.json를 편집하여 API 키 구성 파일에서 지문 값을 추가합니다.
config.json 파일에 대한 변경 사항을 저장합니다.

이후 릴리스에서 config.json는 API 키의 공개 키 지문을 포함하며 더 이상 수동으로 추가할 필요가 없습니다. 이 릴리스에서는 사용자가 사용할 수 있는 최신 API 키가 config.json에서 사용됩니다.

Oracle Analytics에 Oracle AI Data Platform Workbench 연결

Oracle Analytics 인스턴스에서 AI Data Platform Workbench 인스턴스가 관리하는 카탈로그 또는 테이블에 연결할 수 있습니다.

AI 데이터 플랫폼 워크벤치 인스턴스에 대한 Oracle Analytics 연결은 연결당 하나의 카탈로그만 지원합니다. 두 개 이상의 카탈로그를 사용하려면 추가 연결을 생성해야 합니다.

Oracle Analytics 홈 페이지에서 생성, 접속을 차례로 누릅니다.
Oracle AI Data Platform을 누릅니다.
연결에 대한 이름 및 설명을 입력합니다.
접속 세부정보의 경우 선택을 누르고 config.json 파일로 이동한 다음 열기를 누릅니다. 자세한 내용은 Oracle Analytics 접속 파일 생성을 참조하십시오.
인증 유형으로 API 키를 선택합니다.
데이터세트에 사용할 카탈로그 이름을 입력하십시오.
개인 API 키의 경우 선택을 누르고 개인 API 키()로 이동합니다. PEM 파일)을 누르고 열기를 누릅니다. 자세한 내용은 OCI에서 API 키 가져오기를 참조하십시오.
저장을 누릅니다.
새 데이터 집합을 생성하여 새 접속을 테스트합니다. 자세한 내용은 연결에서 데이터 집합 생성을 참조하십시오.

지침에 따라 연결을 저장하거나 스키마를 나열하는 데 문제가 있는 경우 클러스터를 다시 시작해야 할 수 있습니다.

JDBC 드라이버 다운로드

[접속 세부정보] 탭에서 JDBC 드라이버를 다운로드하고 다른 BI 툴에 맞게 구성할 수 있습니다.

작업영역으로 이동하고 컴퓨트를 누릅니다.
JDBC 호환 BI 툴에 접속할 클러스터를 누르고 접속을 누릅니다.
JDBC 드라이버 다운로드를 누릅니다.

DBeaver 구성

Oracle AI Data Platform Workbench에서 다운로드한 파일을 AI Data Platform Workbench의 컴퓨트 클러스터에 연결하기 전에 DBeaver를 설치하고 준비해야 합니다.

다운로드하고 DBeaver 클라이언트를 설치합니다. 커뮤니티 또는 엔터프라이즈 버전을 사용할 수 있지만 Windows, Mac OS X, Eclipse 플러그인 및 Linux에서만 22.x 이상이어야 합니다.
JDBC 드라이버 다운로드에서 파일의 압축을 풉니다.
압축을 푼 파일에서 simbaSpark.zip 드라이버 파일의 압축을 풉니다.

Spark Simba JDBC 드라이버로 DBeaver 구성

Oracle AI Data Platform Workbench의 컴퓨트 클러스터에 접속하도록 DBeaver를 구성할 수 있습니다.

DBeaver를 설치하고 AI 데이터 플랫폼 워크벤치에서 다운로드한 simbaSpark.zip 파일을 추출해야 합니다.

DBeaver를 엽니다.
데이터베이스 네비게이터를 누릅니다.
드라이버 관리자를 누릅니다.
새로 만들기를 누릅니다.
드라이버 이름으로 AI 데이터 플랫폼을 입력합니다.
라이브러리를 누릅니다.
폴더 추가를 누릅니다.
sparkSimba.zip 추출의 위치를 찾습니다.
클래스 찾기를 누릅니다.
확인을 선택합니다.
드라이버 클래스를 com.simba.spark.jdbc.Driver로 설정합니다.
설정을 누릅니다.
Class Name을 com.simba.spark.jdbc.Driver로 설정합니다.
확인을 누릅니다.

DBeaver에서 데이터베이스 접속 생성

Oracle AI Data Platform Workbench에서 DBeaver를 컴퓨트 클러스터에 연결하려면 먼저 DBeaver에서 데이터베이스 연결을 생성해야 합니다.

AI 데이터 플랫폼 워크벤치에서 다운로드한 Spark Simba JDBC 드라이버로 DBeaver를 구성해야 합니다. 자세한 내용은 Spark Simba JDBC 드라이버로 DBeaver 구성을 참조하십시오.

DBeaver를 엽니다.
Database를 누릅니다.
새 데이터베이스 접속을 누릅니다.
모두를 누릅니다.
AI 데이터 플랫폼을 선택합니다.
다음을 누릅니다.
JDBC 드라이버의 URL을 입력합니다. AI 데이터 플랫폼 워크벤치에서 컴퓨트 클러스터의 접속 세부정보 탭에서 JDBC URL을 찾을 수 있습니다.
완료를 누릅니다.

JDBC를 사용하여 DBeaver를 Oracle AI Data Platform Workbench에 연결

DBeaver가 구성되고 AI 데이터 플랫폼 워크벤치에 데이터베이스가 연결되어 있으면 DBeaver와 AI 데이터 플랫폼 워크벤치 간의 연결을 완료할 수 있습니다.

DBeaver를 엽니다.
연결을 누릅니다.
권한 부여 토큰 또는 API 키로 접속하도록 선택합니다.
- 권한 부여 토큰을 사용하여 접속
  - DEFAULT 프로파일이 없는 경우 URL에 프로파일을 지정하지 않고 토큰을 사용합니다. 예: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5
    URL이 브라우저 창을 엽니다.
    
    AI 데이터 플랫폼 워크벤치 인스턴스가 생성된 테넌시에 사인인합니다.
    
    자세한 내용은 CLI에 대한 토큰 기반 인증을 참조하십시오.
- 연결 URL에 ociProfile=<profile_name>를 사용하여 OCI 프로파일을 지정하여 API 키를 사용하여 연결합니다.
  - API 키 인증을 사용하여 AI 데이터 플랫폼 워크벤치 인스턴스에 접속합니다.
    연결 URL에 ociProfile=<profile_name>를 사용하여 OCI 프로파일을 지정하여 API 키를 사용합니다. 예를 들어, OCI 프로파일 이름 데모를 사용하려면 다음과 같이 하십시오. jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5 ;ociProfile=Demo
    
    자세한 내용은 필수 키 및 OCID를 참조하십시오.
DBeaver는 메타데이터를 읽기 위한 연결과 다른 모든 작업에 대한 연결을 생성합니다. 연결이 제한된 경우 DBeaver가 모든 작업에 대해 하나의 연결을 사용하도록 두번째 연결을 사용 안함으로 설정할 수 있습니다.
1. 환경설정을 누릅니다.
2. 공통을 누릅니다.
3. 메타데이터를 누릅니다.
4. 메타데이터 읽기에 대한 별도의 연결 열기를 선택 해제합니다.

JDBC를 사용하여 Tableau를 AI 데이터 플랫폼에 연결

AI 데이터 플랫폼의 데이터를 Tableau에 연결하여 분석 및 시각화와 함께 사용할 수 있습니다.

작업영역으로 이동하고 컴퓨트를 누릅니다.
Tableau에 접속할 클러스터를 누르고 접속 세부정보 탭을 누릅니다.
JDBC 드라이버 다운로드를 누릅니다.
다운로드한 .zip 파일에서 파일을 추출합니다.
추출된 파일에서 기본 폴더를 열고 OS 유형에 따라 Simba JAR 파일을 다음 폴더로 추출합니다.
- Linux: /opt/tableau/tableau_driver/jdbc
- MacOS: ~/Library/Tableau/Drivers/
- 윈도우: C:\Program Files\Tableau\Driver
예를 들어, MacOS에서 JAR 파일 위치는 ~/Library/Tableau/Drivers/SparkJDBC42.jar입니다.
Tableau 클라이언트를 엽니다.
서버에 접속 목록에서 JDBC 데이터베이스를 검색합니다.
JDBC URL을 복사합니다.
방언에 대해 SQL92를 선택합니다.

다음 방법 중 하나로 연결을 인증합니다.

API 키로 인증

기본 OCI 구성 파일과 기본 프로파일을 사용합니다. 예:

jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0

또는 기본 위치를 사용하지 않는 경우 접속 JDBC URL에 OCI 구성 파일 위치를 추가합니다. 예:

jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0;OCIConfigFile=<config_file_absolute_path>

또는 기본 프로파일을 사용하지 않는 경우 연결 JDBC URL에 OCI 프로파일을 추가합니다. 예:

jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0;OCIConfigFile=<config_file_absolute_path>OCIProfile=<profile_name>

권한 부여 토큰을 사용하여 인증:
- 권한 부여 토큰을 사용하려면 기본 경로(예: /Users/xyz/.oci/config)에 구성 파일이 없으며 URL에 프로파일을 지정하지 마십시오. 예:
```
jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0
```
자세한 내용은 CLI에 대한 토큰 기반 인증을 참조하십시오.

사인인을 누릅니다.
선택 사항: 토큰 기반 인증을 사용하는 경우 나타나는 브라우저 창에서 AI 데이터 플랫폼이 생성된 테넌시에 사인인합니다.

ODBC 드라이버 다운로드

연결 세부정보 탭에서 ODBC 드라이버를 다운로드하여 다른 BI 도구에 맞게 구성할 수 있습니다.

작업영역으로 이동하고 컴퓨트를 누릅니다.
ODBC 호환 BI 툴에 접속할 클러스터를 누르고 접속을 누릅니다.
ODBC 드라이버 다운로드를 누릅니다.
목록에서 해당 OS를 선택합니다.