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

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

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

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

# 建立 Azure Cosmos DB 連線
<a name="creating-azurecosmos-connection"></a>

**先決條件：**
+ 在 Azure 中，您將需要識別或產生 Azure Cosmos 資料庫金鑰以供 AWS Glue使用`cosmosKey`。如需詳細資訊，請參閱《Azure 文件》中的[安全存取 Azure Cosmos DB 中的資料](https://learn.microsoft.com/en-us/azure/cosmos-db/secure-access-to-data?tabs=using-primary-key)。

**設定連至 Azure Cosmos DB 的連線：**

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

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

# 建立 Azure Cosmos DB 來源節點
<a name="creating-azurecosmos-source-node"></a>

## 必要先決條件
<a name="creating-azurecosmos-source-node-prerequisites"></a>
+  AWS Glue Azure Cosmos 資料庫連線，使用 AWS Secrets Manager 秘密設定，如上節所述：[建立 Azure Cosmos DB 連線](creating-azurecosmos-connection.md)。
+ 針對您任務的適當許可，以讀取連線所使用的秘密。
+ 您想要讀取的 Azure Cosmos DB for NoSQL 容器。您將需要容器的識別資訊。

  An Azure Cosmos NoSQL 容器由資料庫和容器識別。連線至 Azure Cosmos for NoSQL API 時，您必須提供資料庫名稱 *cosmosDBName* 和容器名稱 *cosmosContainerName*。

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

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

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

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

1. 選擇 **Cosmos DB 資料庫名稱**：提供您想要讀取的資料庫名稱 *cosmosDBName*。

1. 選擇 **Azure Cosmos 資料庫容器**：提供您想要讀取的容器名稱 *cosmosContainerName*。

1. 或者，選擇 **Azure Cosmos DB 自訂查詢**：提供 SQL SELECT 查詢，以便從 Azure Cosmos DB 擷取特定資訊。

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

# 建立 Azure Cosmos DB 目標節點
<a name="creating-azurecosmos-target-node"></a>

## 必要先決條件
<a name="creating-azurecosmos-target-node-prerequisites"></a>
+  AWS Glue Azure Cosmos 資料庫連線，使用 AWS Secrets Manager 秘密設定，如上節所述：[建立 Azure Cosmos DB 連線](creating-azurecosmos-connection.md)。
+ 針對您任務的適當許可，以讀取連線所使用的秘密。
+ 您想要寫入的 Azure Cosmos DB 資料表。您將需要容器的識別資訊。**您必須先建立容器，再呼叫連線方法。**

  An Azure Cosmos NoSQL 容器由資料庫和容器識別。連線至 Azure Cosmos for NoSQL API 時，您必須提供資料庫名稱 *cosmosDBName* 和容器名稱 *cosmosContainerName*。

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

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

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

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

1. 選擇 **Cosmos DB 資料庫名稱**：提供您想要讀取的資料庫名稱 *cosmosDBName*。

1. 選擇 **Azure Cosmos 資料庫容器**：提供您想要讀取的容器名稱 *cosmosContainerName*。

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

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

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

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