本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立 連接器
<a name="mkc-create-connector-intro"></a>

此程序說明如何使用 建立連接器 AWS 管理主控台。

**使用 建立連接器 AWS 管理主控台**

1. 開啟位於 [https://console.aws.amazon.com/msk/](https://console.aws.amazon.com/msk/) 的 Amazon MSK 主控台。

1. 在左窗格的 **MSK Connect** 下，選擇**連接器**。

1. 選擇 **Create connector (建立連接器)**。

1. 您可選擇使用現有的自訂外掛程式來建立連接器，或先建立新的自訂外掛程式。如需有關自訂外掛程式以及如何建立的相關資訊，請參閱 [建立自訂外掛程式](msk-connect-plugins.md)。在此過程中，請假設您具有要使用的自訂外掛程式。在自訂外掛程式清單中，找到您要使用的外掛程式，然後選取其左側的方塊，然後選擇**下一步**。

1. 輸入名稱，以及描述 (非必要)。

1. 選擇您要連線到的叢集。

1. 在**連接器網路設定**區段中，針對網路類型選擇下列其中一項：
   + **IPv4** （預設） - 僅適用於透過 IPv4 連線至目的地
   + **雙堆疊** - 用於透過 IPv4 和 IPv6 連線至目的地 （僅當子網路具有與其相關聯的 IPv4 和 IPv6 CIDR 區塊時可用）

1. 指定連接器組態。您需要指定的組態參數會依據您要建立的連接器類型而定。然而，有部分參數是所有連接器都要指定的，例如 `connector.class` 和 `tasks.max` 參數。以下是 [Confluent Amazon S3 目的地連接器](https://www.confluent.io/hub/confluentinc/kafka-connect-s3)的範例組態。

   ```
   connector.class=io.confluent.connect.s3.S3SinkConnector
   tasks.max=2
   topics=my-example-topic
   s3.region=us-east-1
   s3.bucket.name=amzn-s3-demo-bucket
   flush.size=1
   storage.class=io.confluent.connect.s3.storage.S3Storage
   format.class=io.confluent.connect.s3.format.json.JsonFormat
   partitioner.class=io.confluent.connect.storage.partitioner.DefaultPartitioner
   key.converter=org.apache.kafka.connect.storage.StringConverter
   value.converter=org.apache.kafka.connect.storage.StringConverter
   schema.compatibility=NONE
   ```

1. 接下來，您需設定連接器容量。您可在兩種容量模式中選擇其一：佈建和自動擴展。如需關於這兩個選項的詳細資訊，請參閱[了解連接器容量](msk-connect-capacity.md)。

1. （選用） 在**最大自動擴展任務計數**區段中，使用最大自動擴展任務計數欄位，輸入要在自動擴展操作期間配置給連接器的任務數量上限。值必須至少等於您的工作者計數上限。如果您未指定值，連接器會無任何限制地使用標準計算。如需詳細資訊，請參閱[了解自動擴展任務計數上限](msk-connect-max-autoscaling-task-count.md)。

1. 在預設工作程序組態或自訂工作程序組態中選擇其一。如需有關建立自訂工作程序組態的詳細資訊，請參閱 [了解 MSK Connect 工作者](msk-connect-workers.md)。

1. 接下來，您需指定服務執行角色。這必須是 MSK Connect 可以擔任的 IAM 角色，並授予連接器存取必要 AWS 資源所需的所有許可。這些許可會依連接器的邏輯而定。如需如何建立此角色的資訊，請參閱 [了解服務執行角色](msk-connect-service-execution-role.md)。

1. 選擇**下一步**，檢閱安全性資訊，然後再次選擇**下一步**。

1. 指定所需的記錄選項，然後選擇**下一步**。如需日誌記錄的相關資訊，請參閱[MSK Connect 的日誌](msk-connect-logging.md)。

1. 在**檢閱和建立**頁面上，檢閱您的連接器組態，然後選擇**建立連接器**。

若要使用 MSK Connect API 建立連接器，請參閱 [CreateConnector](https://docs.aws.amazon.com/MSKC/latest/mskc/API_CreateConnector.html)。

您可以使用 `UpdateConnector` API 來修改連接器的組態。如需詳細資訊，請參閱[更新連接器](mkc-update-connector.md)。