

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Neptune JDBC 驅動程式入門
<a name="neptune-jdbc-getting-started"></a>

若要使用 Neptune JDBC 驅動程式連線至 Neptune 執行個體，JDBC 驅動程式必須部署在與 Neptune 資料庫叢集相同的 VPC 中，或者執行個體必須透過 SSH 通道或負載平衡器使用。SSH 通道可以在驅動程式內部設定，也可以在外部設定。

您可以在[這裡](https://github.com/aws/amazon-neptune-jdbc-driver/releases)下載驅動程式。驅動程式會包裝成單一 JAR 檔案，其名稱類似 `neptune-jdbc-1.0.0-all.jar`。若要使用它，請將 JAR 檔案放在應用程式的 `classpath` 中。或者，如果您的應用程式使用 Maven 或 Gradle，則您可以使用適當的 Maven 或 Gradle 命令，從 JAR 安裝驅動程式。

驅動程式需要一個 JDBC 連線 URL 與 Neptune 連線，形式如下：

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

GitHub 專案中每個查詢語言的章節都會描述您可以在 JDBC 連線 URL 中為該查詢語言設定的屬性。

如果 JAR 檔案位於應用程式的 `classpath` 中，則不需要任何其他組態。您可以使用 JDBC `DriverManager` 介面和 Neptune 連線字串來連線驅動程式。例如，如果可以透過連接埠 8182 上的端點 `neptune-example.com` 存取您的 Neptune 資料庫叢集，您將能夠像這樣與 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 專案中每種查詢語言的文件章節描述如何在使用該查詢語言時建構連線字串。