아마존 넵튠 커넥티비티 JDBC - Amazon Neptune
시작하기Tableau 사용문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

아마존 넵튠 커넥티비티 JDBC

Amazon Neptune은 Gremlin, SQL -Gremlin 및 쿼리를 openCypher 지원하는 JDBC오픈 소스 드라이버를 출시했습니다. SPARQL JDBC연결성을 통해 Tableau와 같은 비즈니스 인텔리전스 (BI) 도구를 사용하여 Neptune에 쉽게 연결할 수 있습니다. Neptune에서 JDBC 드라이버를 사용하는 데 드는 추가 비용은 없습니다. 사용한 Neptune 리소스에 대해서만 비용을 지불하면 됩니다.

드라이버는 JDBC 4.2와 호환되며 Java 8 이상이 필요합니다. JDBC드라이버 사용 방법에 대한 자세한 내용은 JDBCAPI설명서를 참조하십시오.

문제를 제출하고 기능 요청을 열 수 있는 GitHub 프로젝트에는 드라이버에 대한 자세한 설명서가 포함되어 있습니다.

JDBC아마존 Neptune용 드라이버

Neptune 드라이버 JDBC 시작하기

JDBCNeptune 드라이버를 사용하여 Neptune 인스턴스에 연결하려면 JDBC 드라이버를 Neptune DB 클러스터와 VPC 동일한 Amazon EC2 인스턴스에 배포하거나 터널 또는 로드 밸런서를 통해 인스턴스를 사용할 수 있어야 합니다. SSH SSH터널은 드라이버 내부적으로 설정하거나 외부에서 설정할 수 있습니다.

여기에서 드라이버를 다운로드할 수 있습니다. 드라이버는 이름이 같은 단일 JAR 파일로 패키지되어 제공됩니다. neptune-jdbc-1.0.0-all.jar 이 파일을 사용하려면 응용 프로그램에 JAR 파일을 넣으십시오. classpath 또는 애플리케이션에서 Maven 또는 Gradle을 사용하는 경우 적절한 Maven 또는 Gradle 명령을 사용하여 에서 드라이버를 설치할 수 있습니다. JAR

드라이버를 URL Neptune에 JDBC 연결하려면 다음과 같은 형식으로 연결해야 합니다.

jdbc:neptune:(connection type)://(host);property=value;property=value;...;property=value

GitHub 프로젝트의 각 쿼리 언어 섹션에는 해당 쿼리 언어에 URL 대한 JDBC 연결에서 설정할 수 있는 속성이 설명되어 있습니다.

JAR파일이 애플리케이션에 있는 classpath 경우 다른 구성은 필요하지 않습니다. JDBCDriverManager인터페이스와 Neptune 연결 문자열을 사용하여 드라이버를 연결할 수 있습니다. 예를 들어, 포트 8182의 neptune-example.com 엔드포인트를 통해 Neptune DB 클러스터에 액세스할 수 있는 경우 다음과 같이 연결할 수 있습니다. openCypher 

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.Statement;

void example() {
    String url = "jdbc:neptune:opencypher://bolt://neptune-example:8182";

    Connection connection = DriverManager.getConnection(url);
    Statement statement = connection.createStatement();

    connection.close();
}

각 쿼리 언어에 대한 GitHub 프로젝트의 설명서 섹션에서는 해당 쿼리 언어를 사용할 때 연결 문자열을 구성하는 방법을 설명합니다.

Neptune JDBC 드라이버와 함께 Tableau를 사용하기

Tableau를 JDBC Neptune 드라이버와 함께 사용하려면 먼저 최신 버전의 Tableau Desktop을 다운로드하고 설치하십시오. Neptune 드라이버용 JAR 파일과 JDBC Neptune Tableau 커넥터 파일 (파일) 을 다운로드하십시오. .taco

Mac에서 Neptune용 Tableau에 연결하려면

  1. JDBCNeptune JAR 드라이버 파일을 폴더에 넣습니다. /Users/(your user name)/Library/Tableau/Drivers

  2. Neptune Tableau 커넥터 .taco 파일을 /Users/(your user name)/Documents/My Tableau Repository/Connectors 폴더에 배치합니다.

  3. IAM인증을 활성화한 경우 인증을 위한 환경을 설정하십시오. .zprofile/, .zshenv/, .bash_profile 등에 설정된 환경 변수는 작동하지 않는다는 점에 유의하세요. GUI애플리케이션이 환경 변수를 로드할 수 있도록 설정해야 합니다.

    보안 인증 정보를 설정하는 한 방법은 액세스 키와 비밀 키를 /Users/(your user name)/.aws/credentials 파일에 저장하는 것입니다.

    서비스 리전은 터미널을 열고 애플리케이션의 리전(예: us-east-1)을 사용하여 다음 명령을 입력하면 쉽게 설정할 수 있습니다.

    launchctl setenv SERVICE_REGION region name

    재시작 후에도 유지되는 환경 변수를 설정하는 다른 방법도 있지만 어떤 방법을 사용하든 GUI 응용 프로그램에서 액세스할 수 있는 변수를 설정해야 합니다.

  4. Mac의 GUI a에 로드할 환경 변수를 가져오려면 터미널에 다음 명령을 입력합니다.

    /Applications/Tableau/Desktop/2021.1.app/Contents/MacOS/Tableau
Windows 컴퓨터에서 Neptune용 Tableau에 연결하려면

  1. JDBCNeptune JAR 드라이버 파일을 폴더에 넣습니다. C:\Program Files\Tableau\Drivers

  2. Neptune Tableau 커넥터 .taco 파일을 C:\Users\(your user name)\Documents\My Tableau Repository\Connectors 폴더에 배치합니다.

  3. IAM인증을 활성화한 경우 인증을 위한 환경을 설정하십시오.

    사용자 ACCESS_KEY, SECRET_KEY, SERVICE_REGION 환경 변수를 설정하는 것만큼 간단할 수 있습니다.

Tableau를 열고 창 왼쪽에서 기타를 선택합니다. Tableau 커넥터 파일이 제대로 위치한 경우 나타나는 목록에서 AWS에서 제공하는 Amazon Neptune을 선택할 수 있습니다.

SQLTableau에서 선택하기

포트를 편집하거나 연결 옵션을 추가할 필요가 없습니다. Neptune 엔드포인트를 입력하고 AND 구성을 설정합니다 IAM (사용 중인 경우 SSL 활성화해야 함). SSL IAM

로그인을 선택하면 그래프가 큰 경우 연결하는 데 30초 이상 걸릴 수 있습니다. Tableau는 버텍스 및 엣지 표를 수집하고 엣지의 버텍스를 조인하는 동시에 시각화도 생성합니다.

드라이버 연결 문제 해결 JDBC

드라이버가 서버에 연결되지 않는 경우 JDBC Connection 개체의 isValid 기능을 사용하여 연결이 유효한지 확인하십시오. 함수가 반환되면 (즉false, 연결이 유효하지 않음), 연결 중인 엔드포인트가 올바른지, 현재 Neptune DB 클러스터에 속해 있는지 또는 클러스터에 VPC 대한 SSH 유효한 터널이 있는지 확인하십시오.

DriverManager.getConnection 호출에서 No suitable driver found for (connection string) 응답을 받으면 연결 문자열의 시작 부분에 문제가 있을 수 있습니다. 연결 문자열이 다음과 같이 시작되는지 확인하세요.

jdbc:neptune:opencypher://...

연결에 대한 추가 정보를 수집하려면 다음과 같이 연결 문자열에 LogLevel을 추가하면 됩니다.

jdbc:neptune:opencypher://(JDBC URL):(port);logLevel=trace

또는 입력 속성에 properties.put("logLevel", "trace")을 추가하여 추적 정보를 로깅할 수 있습니다.