AWS Data Pipeline 不再提供給新客戶。的現有客戶 AWS Data Pipeline 可以繼續正常使用服務。[進一步了解](https://aws.amazon.com/blogs/big-data/migrate-workloads-from-aws-data-pipeline/)

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

# 資料庫
<a name="dp-object-databases"></a>

以下是 AWS Data Pipeline 資料庫物件：

**Topics**
+ [JdbcDatabase](dp-object-jdbcdatabase.md)
+ [RdsDatabase](dp-object-rdsdatabase.md)
+ [RedshiftDatabase](dp-object-redshiftdatabase.md)

# JdbcDatabase
<a name="dp-object-jdbcdatabase"></a>

定義 JDBC 資料庫。

## 範例
<a name="jdbcdatabase-example"></a>

以下為此物件類型的範例。

```
{
  "id" : "MyJdbcDatabase",
  "type" : "JdbcDatabase",
  "connectionString" : "jdbc:redshift://hostname:portnumber/dbname",
  "jdbcDriverClass" : "com.amazon.redshift.jdbc41.Driver",
  "jdbcDriverJarUri" : "s3://redshift-downloads/drivers/RedshiftJDBC41-1.1.6.1006.jar",
  "username" : "user_name",
  "*password" : "my_password"
}
```

## 語法
<a name="jdbcdatabase-syntax"></a>


****  

| 必要欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| connectionString | 存取資料庫的 JDBC 連線字串。 | String | 
| jdbcDriverClass | 在建立 JDBC 連線之前要載入的驅動程式類別。 | String | 
| \$1password | 要提供的密碼。 | String | 
| 使用者名稱 | 連線至資料庫時要提供的使用者名稱。 | String | 

 


****  

| 選用欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| databaseName | 要連接的邏輯資料庫的名稱 | String | 
| jdbcDriverJarUri | 用來連線到資料庫之 JDBC 驅動程式 JAR 檔案在 Amazon S3 中的位置。AWS Data Pipeline 必須具有讀取此 JAR 檔案的許可。 | String | 
| jdbcProperties | 會在此資料庫 JDBC 連線上設為屬性的 A=B 形式對。 | String | 
| parent | 目前物件的父系，其插槽會被繼承。 | 參考物件，例如 "parent":\$1"ref":"myBaseObjectId"\$1 | 

 


****  

| 執行時間欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| @version | 建立物件時使用的管道版本。 | String | 

 


****  

| 系統欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| @error | 描述格式錯誤物件的錯誤。 | String | 
| @pipelineId | 此物件所屬管道的 ID。 | String | 
| @sphere | 物件範圍代表其在生命週期中的位置：Component 物件會引發執行 Attempt 物件的 Instance 物件。 | String | 

# RdsDatabase
<a name="dp-object-rdsdatabase"></a>

定義 Amazon RDS 資料庫。

**注意**  
RdsDatabase 不支援 Aurora。改為使用[JdbcDatabase](dp-object-jdbcdatabase.md)適用於 Aurora 的 。

## 範例
<a name="rdsdatabase-example"></a>

以下為此物件類型的範例。

```
{
  "id" : "MyRdsDatabase",
  "type" : "RdsDatabase",
  "region" : "us-east-1",
  "username" : "user_name",
  "*password" : "my_password",
  "rdsInstanceId" : "my_db_instance_identifier"
}
```

針對 Oracle 引擎，`jdbcDriverJarUri` 欄位是必要欄位，並且您可以指定以下驅動程式：`http://www.oracle.com/technetwork/database/features/jdbc/jdbc-drivers-12c-download-1958347.html`。針對 SQL Server 引擎，`jdbcDriverJarUri` 欄位是必要欄位，並且您可以指定以下驅動程式：`https://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=11774`。針對 MySQL 和 PostgreSQL 引擎，`jdbcDriverJarUri` 欄位是選擇性的。

## 語法
<a name="rdsdatabase-syntax"></a>


****  

| 必要欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| \$1password | 要提供的密碼。 | String | 
| rdsInstanceId | 資料庫執行個體的 DBInstanceIdentifier 屬性。 | String | 
| 使用者名稱 | 連線至資料庫時要提供的使用者名稱。 | String | 

 


****  

| 選用欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| databaseName | 要連接的邏輯資料庫的名稱 | String | 
| jdbcDriverJarUri | 用來連線到資料庫之 JDBC 驅動程式 JAR 檔案在 Amazon S3 中的位置。AWS Data Pipeline 必須具有讀取此 JAR 檔案的許可。針對 MySQL 和 PostgreSQL 引擎，若未指定此欄位，則會使用預設驅動程式，但您可以使用這個欄位來覆寫預設值。若是 Oracle 和 SQL Server 引擎，則此為必要欄位。 | String | 
| jdbcProperties | 會在此資料庫 JDBC 連線上設為屬性的 A=B 形式對。 | String | 
| parent | 目前物件的父系，其插槽會被繼承。 | 參考物件，例如 "parent":\$1"ref":"myBaseObjectId"\$1 | 
| region | 資料庫所在的區域代碼。例如 us-east-1。 | String | 

 


****  

| 執行時間欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| @version | 建立物件時使用的管道版本。 | String | 

 


****  

| 系統欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| @error | 描述格式錯誤物件的錯誤。 | String | 
| @pipelineId | 此物件所屬管道的 ID。 | String | 
| @sphere | 物件範圍代表其在生命週期中的位置：Component 物件會引發執行 Attempt 物件的 Instance 物件。 | String | 

# RedshiftDatabase
<a name="dp-object-redshiftdatabase"></a>

定義 Amazon Redshift 資料庫。 `RedshiftDatabase`代表管道所使用的資料庫屬性。

## 範例
<a name="redshiftdatabase-example"></a>

以下為此物件類型的範例。

```
{
  "id" : "MyRedshiftDatabase",
  "type" : "RedshiftDatabase",
  "clusterId" : "myRedshiftClusterId",
  "username" : "user_name",
  "*password" : "my_password",
  "databaseName" : "database_name"
}
```

根據預設，物件會使用 Postgres 驅動程式，而該驅動程式需要 `clusterId` 欄位。若要使用 Amazon Redshift 驅動程式，請在 `connectionString` 欄位中從 Amazon Redshift 主控台指定 Amazon Redshift 資料庫連線字串 （開頭為 "jdbc：redshift：")。

## 語法
<a name="redshiftdatabase-syntax"></a>


****  

| 必要欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| \$1password | 要提供的密碼。 | String | 
| 使用者名稱 | 連線至資料庫時要提供的使用者名稱。 | String | 

 


****  

| 必要的群組 (下列其中之一為必要) | Description | 槽類型 | 
| --- | --- | --- | 
| clusterId | 建立 Amazon Redshift 叢集時，使用者提供的識別符。例如，如果 Amazon Redshift 叢集的端點是 mydb.example.us-east-1.redshift.amazonaws.com，則正確的識別符是 mydb。在 Amazon Redshift 主控台中，您可以從叢集識別符或叢集名稱取得此值。 | String | 
| connectionString | 用於連線至與管道不同的 帳戶所擁有之 Amazon Redshift 執行個體的 JDBC 端點。您不能同時指定 connectionString 和 clusterId。 | String | 

 


****  

| 選用欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| databaseName | 要連接的邏輯資料庫的名稱。 | String | 
| jdbcProperties | 要在此資料庫 JDBC 連線上設為屬性的 A=B 形式對。 | String | 
| parent | 目前物件的父系，其插槽已被繼承。 | 參考物件，例如 "parent":\$1"ref":"myBaseObjectId"\$1 | 
| region | 資料庫所在的區域代碼。例如 us-east-1。 | 列舉 | 

 


****  

| 執行時間欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| @version | 建立物件時使用的管道版本。 | String | 

 


****  

| 系統欄位 | Description | 槽類型 | 
| --- | --- | --- | 
| @error | 描述格式錯誤物件的錯誤。 | String | 
| @pipelineId | 此物件所屬管道的 ID。 | String | 
| @sphere | 物件範圍代表其在生命週期中的位置：Component 物件會引發執行 Attempt 物件的 Instance 物件。 | String |