# AWS Glue Studio에서 Azure Cosmos DB에 연결
AWS Glue에서는 Azure Cosmos DB를 기본으로 지원합니다. AWS Glue Studio에서는 NoSQL의 Azure Cosmos DB에 연결하고, 데이터 통합 작업을 작성하며, 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 연결 생성
**사전 조건**
+ Azure에서는, AWS Glue, `cosmosKey`에서 사용할 Azure Cosmos DB 키를 식별하거나 생성해야 합니다. 자세한 내용은 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 DB 키를 사용하여 보안 암호를 생성합니다. Secrets Manager에서 보안 암호를 생성하려면 AWS Secrets Manager 설명서의 [Create an AWS Secrets Manager secret](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html)에서 제공하는 자습서를 따릅니다. 보안 암호를 생성한 후에는 다음 단계를 위해 보안 암호 이름, *secretName*을 유지합니다.
+ **키/값 페어**를 선택하면 값 *cosmosKey*가 포함된 키 `spark.cosmos.accountKey`에 대한 페어를 생성합니다.
1. AWS Glue 콘솔에서 [AWS Glue 연결 추가](console-connections.md)의 단계에 따라 연결을 생성합니다. 연결을 생성한 후에는 AWS Glue에서 이용하기 위해 연결 이름 *connectionName*을 유지합니다.
+ **연결 유형**을 선택할 때는 Azure Cosmos DB를 선택합니다.
+ **AWS 보안 암호**를 선택할 때 *secretName*을 입력합니다.
# Azure Cosmos DB 소스 노드 생성
## 필수 전제 조건
+ 이전 섹션 [Azure Cosmos DB 연결 생성](creating-azurecosmos-connection.md)에서 설명한 대로 AWS Secrets Manager 암호로 구성된 AWS Glue Azure Cosmos DB 연결입니다
+ 연결에 사용되는 보안 암호를 읽을 작업에 대한 적절한 권한.
+ 읽으려는 NoSQL 컨테이너용 Azure Cosmos 데이터베이스. 컨테이너의 식별 정보가 필요합니다.
NoSQL용 Azure Cosmos 컨테이너는 해당 데이터베이스 및 컨테이너로 식별됩니다. NoSQL API용 Azure Cosmos에 연결할 때 데이터베이스, *cosmosDBName*, 및 컨테이너너, *cosmosContainerName*, 이름을 제공해야 합니다.
## Azure Cosmos DB 데이터 소스 추가
****데이터 소스 - Azure Cosmos DB** 노드 추가하는 방법:**
1. Azure Cosmos DB 데이터 소스의 연결을 선택합니다. 생성했으므로 드롭다운에서 사용할 수 있을 것입니다. 연결을 생성해야 하는 경우 **Azure Cosmos DB 연결 생성**을 선택합니다. 자세한 내용은 이전[Azure Cosmos DB 연결 생성](creating-azurecosmos-connection.md) 섹션을 참조하세요.
연결을 선택한 후에는 **속성 보기**를 클릭하여 연결 속성을 볼 수 있습니다.
1. **Cosmos DB 데이터베이스 이름** 선택 - 읽으려는 *데이터베이스의 이름인 cosmosDBName*을 입력합니다.
1. **Azure Cosmos DB 컨테이너** 선택 - 읽으려는 컨테이너의 이름인 *cosmosContainerName*을 입력합니다.
1. 선택적으로 **Azure Cosmos DB 사용자 지정 쿼리**를 선택합니다. Azure Cosmos DB에서 특정 정보를 검색할 수 있는 SQL SELECT 쿼리를 제공합니다.
1. **사용자 지정 Azure Cosmos 속성**(선택 사항)에서 필요한 경우 파라미터와 값을 입력합니다.
# Azure Cosmos DB 대상 노드 생성
## 필수 전제 조건
+ 이전 섹션 [Azure Cosmos DB 연결 생성](creating-azurecosmos-connection.md)에서 설명한 대로 AWS Secrets Manager 암호로 구성된 AWS Glue Azure Cosmos DB 연결입니다
+ 연결에 사용되는 보안 암호를 읽을 작업에 대한 적절한 권한.
+ 쓰려는 Azure Cosmos DB 테이블. 컨테이너의 식별 정보가 필요합니다. **연결 방법을 호출하기 전에 컨테이너를 만들어야 합니다.**
NoSQL용 Azure Cosmos 컨테이너는 해당 데이터베이스 및 컨테이너로 식별됩니다. NoSQL API용 Azure Cosmos에 연결할 때 데이터베이스, *cosmosDBName*, 및 컨테이너너, *cosmosContainerName*, 이름을 제공해야 합니다.
## Azure Cosmos DB 데이터 대상 추가
****데이터 대상 - Azure Cosmos DB** 노드 추가 방법:**
1. Azure Cosmos DB 데이터 소스의 연결을 선택합니다. 생성했으므로 드롭다운에서 사용할 수 있을 것입니다. 연결을 생성해야 하는 경우 **Azure Cosmos DB 연결 생성**을 선택합니다. 자세한 내용은 이전[Azure Cosmos DB 연결 생성](creating-azurecosmos-connection.md) 섹션을 참조하세요.
연결을 선택한 후에는 **속성 보기**를 클릭하여 연결 속성을 볼 수 있습니다.
1. **Cosmos DB 데이터베이스 이름** 선택 - 읽으려는 *데이터베이스의 이름인 cosmosDBName*을 입력합니다.
1. **Azure Cosmos DB 컨테이너** 선택 - 읽으려는 컨테이너의 이름인 *cosmosContainerName*을 입력합니다.
1. **사용자 지정 Azure Cosmos 속성**(선택 사항)에서 필요한 경우 파라미터와 값을 입력합니다.
## 고급 옵션
Azure Cosmos DB 노드를 생성할 때 고급 옵션을 제공할 수 있습니다. 이 옵션은 Spark 스크립트에 대한 AWS Glue를 프로그래밍할 때 사용할 수 있는 옵션과 동일합니다.
[Azure Cosmos DB 연결](aws-glue-programming-etl-connect-azurecosmos-home.md)를 참조하세요.