As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Criar plug-ins personalizados
Um plugin é um AWS recurso que contém o código que define a lógica do seu conector. Você carrega um arquivo JAR (ou um arquivo ZIP contendo um ou mais arquivos JAR) em um bucket do S3 e especifica a localização do bucket ao criar o plug-in. Quando o plug-in é criado, o MSK Connect copia o conteúdo do objeto S3 naquele momento. Ele não mantém um link para o objeto do S3, portanto, quaisquer modificações subsequentes no objeto não afetarão o plug-in ou seus conectores. Ao criar um conector, você especifica o plug-in que deseja que o MSK Connect use para ele. A relação dos plug-ins com os conectores é de um para muitos: você pode criar um ou mais conectores a partir do mesmo plug-in.
Os plug-ins personalizados não podem ser atualizados no local. Para usar uma nova versão do código do plug-in, crie um novo plug-in personalizado que contenha o novo código e atualize seus conectores para usá-lo. Para obter mais informações sobre como atualizar as configurações do trabalhador, consulte Atualizar configurações do trabalhador.
Recomendamos que você inclua todos os arquivos JAR e dependências necessários para seu plug-in. Empacote seu conector como um dos seguintes:
Um arquivo ZIP que contém todos os arquivos JAR e dependências necessários para o plug-in.
Um único uber JAR que contém todos os arquivos de classe do plug-in e suas dependências.
Não agrupar suas dependências de plug-in pode afetar a disponibilidade ou a compatibilidade no ambiente de execução e causar erros inesperados.
A tabela a seguir mostra a versão Java Runtime usada para cada versão compatível do Apache Kafka Connect. Certifique-se de que seu plug-in personalizado seja compatível com a versão Java Runtime para a versão selecionada do Kafka Connect.
| Versão do Apache Kafka Connect | Runtime de Java |
|---|---|
| 2.7.1 | Java 11 |
| 3.7.x | Java 17 |
Para obter informações sobre como desenvolver o código para um conector, consulte o Guia de desenvolvimento de conectores
Criação de um plug-in personalizado usando o Console de gerenciamento da AWS
Abra o console do Amazon MSK em https://console.aws.amazon.com/msk/
. No painel esquerdo, em MSK Connect e escolha Plug-ins personalizados.
Escolha Criar plug-in personalizado.
-
Selecione Navegar no S3.
-
Na lista de buckets do S3, escolha o bucket que contém o arquivo JAR ou ZIP do plug-in.
-
Na lista de objetos, marque a caixa à esquerda do arquivo JAR ou ZIP do plug-in e clique em Escolher.
-
Escolha Criar plug-in personalizado.
Para usar a API MSK Connect para criar um plug-in personalizado, consulte CreateCustomPlugin.