기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 커넥터 및 종속성 사용
<a name="how-zeppelin-connectors"></a>

커넥터를 사용하면 다양한 기술에서 데이터를 읽고 쓸 수 있습니다. Managed Service for Apache Flink는 Studio 노트북과 함께 세 개의 기본 커넥터를 번들로 제공합니다. 사용자 지정 커넥터를 사용할 수도 있습니다. 커넥터에 대한 자세한 내용은 Apache Flink 설명서의 [테이블 및 SQL 커넥터](https://ci.apache.org/projects/flink/flink-docs-release-1.13/docs/connectors/table/overview/)를 참조하세요.

## 기본 커넥터
<a name="zeppelin-default-connectors"></a>

 AWS Management Console 를 사용하여 Studio 노트북을 생성하는 경우 Managed Service for Apache Flink에는 기본적으로 및 사용자 지정 커넥터가 포함됩니다`flink-sql-connector-kinesis``flink-connector-kafka_2.12``aws-msk-iam-auth`. 이러한 사용자 지정 커넥터 없이 콘솔을 통해 Studio 노트북을 만들려면 **사용자 지정 설정으로 만들기** 옵션을 선택합니다. 그런 다음 **구성** 페이지로 이동하면 두 커넥터 옆에 있는 확인란의 선택을 취소하세요.

[CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html) API를 사용하여 Studio 노트북을 만드는 경우, `flink-sql-connector-flink` 및 `flink-connector-kafka` 커넥터는 기본적으로 포함되지 않습니다. 추가하려면 다음 예와 같이 `CustomArtifactsConfiguration` 데이터 유형에 `MavenReference`(으)로 지정하세요.

`aws-msk-iam-auth` 커넥터는 Amazon MSK에서 사용할 커넥터로, IAM으로 자동 인증하는 기능이 포함되어 있습니다.

**참고**  
다음 예제에 표시된 커넥터 버전은 지원되는 유일한 버전입니다.

```
For the Kinesis connector:

"CustomArtifactsConfiguration": [{
"ArtifactType": "DEPENDENCY_JAR",            
   "MavenReference": {
"GroupId": "org.apache.flink",

      "ArtifactId": "flink-sql-connector-kinesis",
      "Version": "1.15.4"

   }      
}]

For authenticating with AWS MSK through AWS IAM:

"CustomArtifactsConfiguration": [{
"ArtifactType": "DEPENDENCY_JAR",            
   "MavenReference": {
"GroupId": "software.amazon.msk",
      "ArtifactId": "aws-msk-iam-auth",
      "Version": "1.1.6"
   }      
}]
            
For the Apache Kafka connector:  

"CustomArtifactsConfiguration": [{
"ArtifactType": "DEPENDENCY_JAR",            
   "MavenReference": {
"GroupId": "org.apache.flink",

      "ArtifactId": "flink-connector-kafka",
      "Version": "1.15.4"

   }      
}]
```

기존 노트북에 이러한 커넥터를 추가하려면 [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html) API 작업을 사용하고 `CustomArtifactsConfigurationUpdate` 데이터 유형에 `MavenReference`(으)로 지정하세요.

**참고**  
테이블 API의 `flink-sql-connector-kinesis` 커넥터에 대해 `failOnError`을(를) true로 설정할 수 있습니다.

## 종속성 및 사용자 정의 커넥터 추가
<a name="zeppelin-custom-connectors"></a>

 AWS Management Console 를 사용하여 Studio 노트북에 종속성 또는 사용자 지정 커넥터를 추가하려면 다음 단계를 따릅니다.

1. 사용자 정의 커넥터 파일을 Amazon S3에 업로드합니다.

1. 에서 Studio 노트북**을 생성하기 위한 사용자 지정** 생성 옵션을 AWS Management Console선택합니다.

1. **구성** 단계에 도달할 때까지 Studio 노트북 제작 워크플로를 따르세요.

1. **사용자 지정 커넥터** 섹션에서 사용자 **지정 커넥터 추가**를 선택합니다.

1. 종속성 또는 사용자 지정 커넥터의 Amazon S3 위치를 지정합니다.

1. **변경 사항 저장**을 선택합니다.

[CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html) API를 사용하여 새 Studio 노트북을 생성할 때 종속성 JAR 또는 사용자 지정 커넥터를 추가하려면 종속성 JAR의 Amazon S3 위치 또는 `CustomArtifactsConfiguration` 데이터 유형에서 사용자 지정 커넥터를 지정하세요. 기존 Studio 노트북에 종속성 또는 사용자 지정 커넥터를 추가하려면 [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html) API 작업을 호출하고 종속성 JAR의 Amazon S3 위치 또는 `CustomArtifactsConfigurationUpdate` 데이터 유형의 사용자 지정 커넥터를 지정하세요.

**참고**  
종속성이나 사용자 지정 커넥터를 포함할 때는 종속성 또는 사용자 지정 커넥터에 번들로 제공되지 않은 모든 전이적 종속성도 포함해야 합니다.