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

# 在 AWS Glue Studio 中連線至 Azure SQL
<a name="connecting-to-data-azuresql"></a>

 AWS Glue 會提供 Azure SQL 的內建支援。AWS Glue Studio 會提供視覺化介面以連線至 Azure SQL、撰寫資料整合任務，以及在 AWS Glue Studio 無伺服器 Spark 執行期上執行此類任務。

**Topics**
+ [建立 Azure SQL 連線](creating-azuresql-connection.md)
+ [建立 Azure SQL 來源節點](creating-azuresql-source-node.md)
+ [建立 Azure SQL 目標節點](creating-azuresql-target-node.md)
+ [進階選項](#creating-azuresql-connection-advanced-options)

# 建立 Azure SQL 連線
<a name="creating-azuresql-connection"></a>

若要從 連線至 Azure SQL AWS Glue，您需要在 AWS Secrets Manager 秘密中建立並存放 Azure SQL 登入資料，然後將該秘密與 Azure SQL AWS Glue 連線建立關聯。

**設定連至 Azure SQL 的連線：**

1. 在 中 AWS Secrets Manager，使用您的 Azure SQL 登入資料建立秘密。若要在 Secrets Manager 中建立秘密，請遵循 AWS Secrets Manager 文件中[建立 AWS Secrets Manager 秘密](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html)中提供的教學課程。建立機密之後，請保留機密名稱 *secretName*，以便進行下一個步驟。
   + 在選取**鍵/值組**時，請使用 *azuresqlUsername* 值來建立 `user` 金鑰對。
   + 在選取**鍵/值組**時，請使用 *azuresqlPassword* 值來建立 `password` 金鑰對。

1. 在 AWS Glue 主控台中，依照中的步驟建立連線[新增 AWS Glue 連線](console-connections.md)。建立連線之後，請保留連線名稱 *connectionName*，以便未來在 AWS Glue中使用。
   + 選取**連線類型**時，請選取 Azure SQL。
   + 提供 **Azure SQL URL**時，請提供 JDBC 端點 URL。

      此 URL 必須採用下列格式：`jdbc:sqlserver://databaseServerName:databasePort;databaseName=azuresqlDBname;`。

     AWS Glue 需要下列 URL 屬性：
     + `databaseName`：要連線之 Azure SQL 的預設資料庫。

     如需有關 Azure SQL 受控執行個體之 JDBC URL 的詳細資訊，請參閱 [Microsoft 文件](https://learn.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url?view=azuresqldb-mi-current)。
   + 選取 **AWS 機密**時，請提供 *secretName*。

# 建立 Azure SQL 來源節點
<a name="creating-azuresql-source-node"></a>

## 必要先決條件
<a name="creating-azuresql-source-node-prerequisites"></a>
+ 使用 AWS Secrets Manager 秘密設定的 AWS Glue Azure SQL 連線，如上節所述：[建立 Azure SQL 連線](creating-azuresql-connection.md)。
+ 針對您任務的適當許可，以讀取連線所使用的秘密。
+ 您想要讀取的 Azure SQL 資料表 *tableName*。

  Azure SQL 資料表由資料庫、結構描述及資料表名稱識別。連線至 Azure SQL 時，您必須提供資料庫名稱和資料表名稱。如果結構描述不是預設的 "public"，您也必須提供結構描述。資料庫會透過 *connectionName* 中的 URL 屬性提供，而結構描述和資料表名稱會透過 `dbtable` 提供。

## 新增 Azure SQL 資料來源
<a name="creating-azuresql-source-node-add"></a>

**新增**資料來源 – Azure SQL** 節點：**

1.  選擇 Azure SQL 資料來源的連線。由於您已建立連線，其應可用於下拉式清單中。如果您需要建立連線，請選擇**建立 Azure SQL 連線**。如需詳細資訊，請參閱前一 [建立 Azure SQL 連線](creating-azuresql-connection.md) 節。

    選擇連線之後，您可以按一下**檢視屬性**來檢視連線屬性。

1.  選擇 **Azure SQL 來源**選項：
   +  **選擇單一資料表**：從單一資料表存取所有資料。
   +  **輸入自訂查詢**：根據自訂查詢從多個資料表存取資料集。

1.  如果您選擇單一資料表，請輸入 *tableName*。

    如果您選擇**輸入自訂查詢**，請輸入 TransactSQL SELECT 查詢。

1.  在**自訂 Azure SQL 屬性**中，視需要輸入參數和值。

# 建立 Azure SQL 目標節點
<a name="creating-azuresql-target-node"></a>

## 必要先決條件
<a name="creating-azuresql-target-node-prerequisites"></a>
+ 使用 AWS Secrets Manager 秘密設定的 AWS Glue Azure SQL 連線，如上節所述：[建立 Azure SQL 連線](creating-azuresql-connection.md)。
+ 針對您任務的適當許可，以讀取連線所使用的秘密。
+ 您想要寫入的 Azure SQL 資料表 *tableName*。

  Azure SQL 資料表由資料庫、結構描述及資料表名稱識別。連線至 Azure SQL 時，您必須提供資料庫名稱和資料表名稱。如果結構描述不是預設的 "public"，您也必須提供結構描述。資料庫會透過 *connectionName* 中的 URL 屬性提供，而結構描述和資料表名稱會透過 `dbtable` 提供。

## 新增 Azure SQL 資料目標
<a name="creating-azuresql-target-node-add"></a>

**新增**資料目標 – Azure SQL** 節點：**

1.  選擇 Azure SQL 資料來源的連線。由於您已建立連線，其應可用於下拉式清單中。如果您需要建立連線，請選擇**建立 Azure SQL 連線**。如需詳細資訊，請參閱前一 [建立 Azure SQL 連線](creating-azuresql-connection.md) 節。

    選擇連線之後，您可以按一下**檢視屬性**來檢視連線屬性。

1. 透過提供 *tableName* 來設定**資料表名稱**。

1.  在**自訂 Azure SQL 屬性**中，視需要輸入參數和值。

## 進階選項
<a name="creating-azuresql-connection-advanced-options"></a>

您可以在建立 Azure SQL 節點時提供進階選項。這些選項與 AWS Glue Spark 指令碼程式設計時可用的選項相同。

請參閱[Azure SQL 連線](aws-glue-programming-etl-connect-azuresql-home.md)。