Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utiliser les connecteurs et les dépendances
<a name="how-zeppelin-connectors"></a>

Les connecteurs vous permettent de lire et d’écrire des données à travers différentes technologies. Le service géré pour Apache Flink intègre trois connecteurs par défaut à votre bloc-notes Studio. Vous pouvez également utiliser des connecteurs personnalisés. Pour plus d’informations sur les connecteurs, consultez [Table & SQL Connectors](https://ci.apache.org/projects/flink/flink-docs-release-1.13/docs/connectors/table/overview/) dans la documentation Apache Flink.

## Connecteurs par défaut
<a name="zeppelin-default-connectors"></a>

Si vous utilisez le AWS Management Console pour créer votre bloc-notes Studio, Managed Service for Apache Flink inclut par défaut les connecteurs personnalisés suivants : `flink-sql-connector-kinesis` `flink-connector-kafka_2.12` et`aws-msk-iam-auth`. Pour créer un bloc-notes Studio via la console sans ces connecteurs personnalisés, choisissez l’option **Créer avec des paramètres personnalisés**. Ensuite, lorsque vous arrivez sur la page **Configurations**, décochez les cases à côté des deux connecteurs.

Si vous utilisez l'[CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html)API pour créer votre bloc-notes Studio, les `flink-connector-kafka` connecteurs `flink-sql-connector-flink` et ne sont pas inclus par défaut. Pour les ajouter, spécifiez-les en tant que `MavenReference` dans le type de données `CustomArtifactsConfiguration`, comme indiqué dans les exemples suivants.

Le connecteur `aws-msk-iam-auth` est le connecteur à utiliser avec Amazon MSK qui inclut la fonctionnalité d’authentification automatique auprès d’IAM. 

**Note**  
Les versions de connecteur présentées dans l’exemple suivant sont les seules que nous prenons en charge.

```
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"

   }      
}]
```

Pour ajouter ces connecteurs à un bloc-notes existant, utilisez l'opération [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html)API et spécifiez-les `MavenReference` en tant que type de `CustomArtifactsConfigurationUpdate` données.

**Note**  
Vous pouvez définir `failOnError` sur true pour le connecteur `flink-sql-connector-kinesis` dans l’API de table.

## Ajoutez des dépendances et des connecteurs personnalisés
<a name="zeppelin-custom-connectors"></a>

Pour utiliser le AWS Management Console pour ajouter une dépendance ou un connecteur personnalisé à votre bloc-notes Studio, procédez comme suit :

1. Chargez le fichier de votre connecteur personnalisé sur Amazon S3.

1. Dans le AWS Management Console, choisissez l'option de création **personnalisée pour créer** votre bloc-notes Studio.

1. Suivez le processus de création du bloc-notes Studio jusqu’à ce que vous arriviez à l’étape **Configurations**.

1. Dans la section **Connecteurs personnalisés**, choisissez **Ajouter un connecteur personnalisé**.

1. Spécifiez l’emplacement Amazon S3 de la dépendance ou du connecteur personnalisé.

1. Sélectionnez **Enregistrer les modifications**.

Pour ajouter un fichier JAR de dépendance ou un connecteur personnalisé lorsque vous créez un nouveau bloc-notes Studio à l'aide de l'[CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html)API, spécifiez l'emplacement Amazon S3 du fichier JAR de dépendance ou du connecteur personnalisé dans le type de `CustomArtifactsConfiguration` données. Pour ajouter une dépendance ou un connecteur personnalisé à un bloc-notes Studio existant, appelez l'opération d'[UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html)API et spécifiez l'emplacement Amazon S3 du JAR de dépendance ou du connecteur personnalisé dans le type de `CustomArtifactsConfigurationUpdate` données.

**Note**  
Lorsque vous incluez une dépendance ou un connecteur personnalisé, vous devez également inclure toutes ses dépendances transitives qui ne sont pas regroupées en son sein.