

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Uso de conectores y dependencias
<a name="how-zeppelin-connectors"></a>

Los conectores permiten leer y escribir datos en diversas tecnologías. Managed Service para Apache Flink incluye tres conectores predeterminados en su cuaderno de Studio. También puede usar conectores personalizados. Para obtener más información sobre conectores, consulte [Table & SQL Connectors](https://ci.apache.org/projects/flink/flink-docs-release-1.13/docs/connectors/table/overview/) en la documentación de Apache Flink.

## Conectores por defecto
<a name="zeppelin-default-connectors"></a>

Si utiliza el Consola de administración de AWS para crear su bloc de notas Studio, Managed Service for Apache Flink incluye los siguientes conectores personalizados de forma predeterminada:`flink-sql-connector-kinesis`, `flink-connector-kafka_2.12` y`aws-msk-iam-auth`. Para crear un cuaderno de Studio a través de la consola sin estos conectores personalizados, seleccione la opción **Crear con ajustes personalizados**. A continuación, cuando llegue a la página de **configuraciones**, desactive las casillas de verificación situadas junto a los dos conectores.

Si utilizas la [CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html)API para crear tu bloc de notas Studio, los `flink-connector-kafka` conectores `flink-sql-connector-flink` y no se incluyen de forma predeterminada. Para añadirlos, debe especificarlos como `MavenReference` en el tipo de datos `CustomArtifactsConfiguration`, como se muestra en los siguientes ejemplos.

El conector `aws-msk-iam-auth` es el conector que se utilizará con Amazon MSK e incluye la característica de autenticarse automáticamente con IAM. 

**nota**  
Las versiones de conector que se muestran en el siguiente ejemplo son las únicas versiones que admitimos.

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

   }      
}]
```

Para añadir estos conectores a un bloc de notas existente, usa la operación [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html)API y especifícalos como `MavenReference` en el tipo de `CustomArtifactsConfigurationUpdate` datos.

**nota**  
Se puede establecer el valor true `failOnError` para el conector `flink-sql-connector-kinesis` en la API de la tabla.

## Agregación de dependencias y conectores personalizados
<a name="zeppelin-custom-connectors"></a>

Para usar el Consola de administración de AWS para añadir una dependencia o un conector personalizado a tu bloc de notas de Studio, sigue estos pasos:

1. Cargue el archivo del conector personalizado en Amazon S3.

1. En el Consola de administración de AWS, elige la opción de creación **personalizada para crear** tu bloc de notas de Studio.

1. Siga el flujo de trabajo de creación de cuadernos de Studio hasta llegar al paso de **configuración**.

1. En la sección **Conectores personalizados**, seleccione **Añadir conector personalizado**.

1. Especifique la ubicación de Amazon S3 de la dependencia o del conector personalizado.

1. Seleccione **Save changes (Guardar cambios)**.

Para añadir un JAR de dependencia o un conector personalizado al crear un nuevo bloc de notas de Studio mediante la [CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html)API, especifique la ubicación en Amazon S3 del JAR de dependencia o del conector personalizado en el tipo de `CustomArtifactsConfiguration` datos. Para añadir una dependencia o un conector personalizado a un bloc de notas de Studio existente, invoque la operación de [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html)API y especifique la ubicación en Amazon S3 del JAR de la dependencia o del conector personalizado en el tipo de `CustomArtifactsConfigurationUpdate` datos.

**nota**  
Cuando incluye una dependencia o un conector personalizado, también debe incluir todas sus dependencias transitivas que no estén incluidas en él.