本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 AWS Glue Studio 中連線至 SAP HANA
AWS Glue 會提供 SAP HANA 的內建支援。AWS Glue Studio 會提供視覺化介面以連線至 SAP HANA、撰寫資料整合任務，以及在 AWS Glue Studio 無伺服器 Spark 執行期上執行此類任務。
AWS Glue Studio 會為 SAP HANA 建立統一連線。如需詳細資訊，請參閱[考量事項](using-connectors-unified-connections.md#using-connectors-unified-connections-considerations)。
**Topics**
+ [建立 SAP HANA 連線](creating-saphana-connection.md)
+ [建立 SAP HANA 來源節點](creating-saphana-source-node.md)
+ [建立 SAP HANA 目標節點](creating-saphana-target-node.md)
+ [進階選項](#creating-saphana-connection-advanced-options)
# 建立 SAP HANA 連線
若要從 連線至 SAP HANA AWS Glue，您需要在 AWS Secrets Manager 秘密中建立和存放 SAP HANA 登入資料，然後將該秘密與 SAP HANA AWS Glue 連線建立關聯。您將需要設定 SAP HANA 服務與 AWS Glue之間的網路連線。
**先決條件：**
+ 如果您的 SAP HANA 服務位於 Amazon VPC 中，請設定 Amazon VPC 以允許您的 AWS Glue 任務與 SAP HANA 服務通訊，而不會讓流量周遊公有網際網路。
在 Amazon VPC 中，識別或建立 AWS Glue 將在執行任務時使用的 **VPC**、**子網路**和**安全群組**。此外，您也需要確保 Amazon VPC 已完成設定，以允許 SAP HANA 端點與此位置之間的網路流量。您的任務將需要與 SAP HANA JDBC 連接埠建立 TCP 連線。如需有關 SAP HANA 連接埠的詳細資訊，請參閱 [SAP HANA 文件](https://help.sap.com/docs/HANA_SMART_DATA_INTEGRATION/7952ef28a6914997abc01745fef1b607/88e2e8bded9e4041ad3ad87dc46c7b55.html?locale=en-US)。根據您的網路配置，這可能需要變更安全群組規則、網路 ACL、NAT 閘道及對等連線。
**設定連至 SAP HANA 的連線：**
1. 在 中 AWS Secrets Manager，使用您的 SAP HANA 登入資料建立秘密。若要在 Secrets Manager 中建立秘密，請遵循 AWS Secrets Manager 文件中[建立 AWS Secrets Manager 秘密](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html)中提供的教學課程。建立機密之後，請保留機密名稱 *secretName*，以便進行下一個步驟。
+ 在選取**鍵/值組**時，請使用 *saphanaUsername* 值來建立 `username/USERNAME` 金鑰對。
+ 在選取**鍵/值組**時，請使用 *saphanaPassword* 值來建立 `password/PASSWORD` 金鑰對。
1. 在 AWS Glue 主控台中，依照中的步驟建立連線[新增 AWS Glue 連線](console-connections.md)。建立連線之後，請保留連線名稱 *connectionName*，以便未來在 AWS Glue中使用。
+ 選取**連線類型**時，請選取 SAP HANA。
+ 提供 **SAP HANA URL** 時，請提供執行個體的 URL。
SAP HANA JDBC URL 會採用的格式為 `jdbc:sap://saphanaHostname:saphanaPort/?databaseName=saphanaDBname,ParameterName=ParameterValue`
AWS Glue 需要下列 JDBC URL 參數：
+ `databaseName`：要連線之 SAP HANA 的預設資料庫。
+ 選取 **AWS 機密**時，請提供 *secretName*。
建立 AWS Glue SAP HANA 連線後，您必須先執行下列步驟，才能執行 AWS Glue 任務：
+ 授予與您的 AWS Glue 任務相關聯的 IAM 角色讀取 *secretName* 的許可。
# 建立 SAP HANA 來源節點
## 必要先決條件
+ 使用 AWS Secrets Manager 秘密設定的 AWS Glue SAP HANA 連線，如上節所述：[建立 SAP HANA 連線](creating-saphana-connection.md)。
+ 針對您任務的適當許可，以讀取連線所使用的秘密。
+ 您想要讀取的 SAP HANA 資料表 *tableName* 或查詢 *targetQuery*。
您可以在表單 `schemaName.tableName` 中使用 SAP HANA 資料表名稱和結構描述名稱來指定資料表。如果資料表位於預設結構描述 "public" 中，則不需要結構描述名稱和 "." 分隔符號。呼叫此 *tableIdentifier*。請注意，在 `connectionName` 中，資料庫會以 JDBC URL 參數形式提供。
## 新增 SAP HANA 資料來源
**新增**資料來源 – SAP HANA** 節點：**
1. 選擇 SAP HANA 資料來源的連線。由於您已建立連線，其應可用於下拉式清單中。如果您需要建立連線，請選擇**建立 SAP HANA 連線**。如需詳細資訊，請參閱前一 [建立 SAP HANA 連線](creating-saphana-connection.md) 節。
選擇連線之後，您可以按一下**檢視屬性**來檢視連線屬性。
1. 選擇 **SAP HANA 來源**選項：
+ **選擇單一資料表**：從單一資料表存取所有資料。
+ **輸入自訂查詢**：根據自訂查詢從多個資料表存取資料集。
1. 如果您選擇單一資料表，請輸入 *tableName*。
如果您選擇**輸入自訂查詢**，請輸入 SQL SELECT 查詢。
1. 在**自訂 SAP HANA 屬性**中，視需要輸入參數和值。
# 建立 SAP HANA 目標節點
## 必要先決條件
+ 使用 AWS Secrets Manager 秘密設定的 AWS Glue SAP HANA 連線，如上節所述：[建立 SAP HANA 連線](creating-saphana-connection.md)。
+ 針對您任務的適當許可，以讀取連線所使用的秘密。
+ 您想要寫入的 SAP HANA 資料表 *tableName*。
您可以在表單 `schemaName.tableName` 中使用 SAP HANA 資料表名稱和結構描述名稱來指定資料表。如果資料表位於預設結構描述 "public" 中，則不需要結構描述名稱和 "." 分隔符號。呼叫此 *tableIdentifier*。請注意，在 `connectionName` 中，資料庫會以 JDBC URL 參數形式提供。
## 新增 SAP HANA 資料目標
**新增**資料目標 – SAP HANA** 節點：**
1. 選擇 SAP HANA 資料來源的連線。由於您已建立連線，其應可用於下拉式清單中。如果您需要建立連線，請選擇**建立 SAP HANA 連線**。如需詳細資訊，請參閱前一 [建立 SAP HANA 連線](creating-saphana-connection.md) 節。
選擇連線之後，您可以按一下**檢視屬性**來檢視連線屬性。
1. 透過提供 *tableName* 來設定**資料表名稱**。
1. 在**自訂 Teradata 屬性**中，視需要輸入參數和值。
## 進階選項
您可以在建立 SAP HANA 節點時提供進階選項。這些選項與 AWS Glue Spark 指令碼程式設計時可用的選項相同。
請參閱[SAP HANA 連線](aws-glue-programming-etl-connect-saphana-home.md)。