Manage and edit connections

You can use the Connections page to add, edit, or delete your connections. Use this page to get a high-level view of the status of all of the connections in your account. You can also view additional details about specific connections, such as the amount of data that it is receiving and what streams are connected to it, by selecting the connection name.

Edit a connection

  1. Navigate to the Connections page.

  2. On the Connections page, select the row that corresponds to the connection that you want to edit. The Overview page for the connection opens.

  3. If the connection is running, stop the connection. You cannot edit a running connection.

  4. Update the connection as desired. The tabs that you see next to Overview depend on whether the connection supports connecting to multiple streams or not.

    1. If your connection supports writing or reading from multiple streams:

      1. Select Details to update the configuration of the connection. You must confirm your stream mappings after making any changes to the connector configuration.

      2. Select Stream Mappings to view or update the mappings between external tables and Decodable streams.

      3. Select Edit to add or remove mappings. A full list of available tables and streams appears, and you can select or remove the mappings that you want managed by the connection.

      4. If you need to modify the schema of one of the streams, navigate to the Streams page instead. See Schema migrations to learn about best practices when performing schema migrations.

    2. If your connection only supports reading or writing to a single stream:

      1. Select Details to update the configuration of the connection.

      2. Select Schema to update the schema of records that are flowing through this connection. Remember that the connection schema must be compatible with the schema of the stream.

      3. You can also use the Schema page to update the field(s) used as a primary or partition key, or update a field that’s enabled as a watermark. See Schema migrations to learn about best practices when performing schema migrations.

  5. Select Save to save your changes.

  6. Select Start to resume the connection. A modal appears with some additional configuration.

    Configuration option Description

    Task Size

    The amount of resources, such as how much CPU or Memory, to allocate for streaming data.

    Task Count

    The number of connection workers that perform data collection or processing.

    Discard State

    Select whether you want to discard state. By selecting this option, you are reactivating the connection without attempting to restore state from a save point or checkpoint. If you want data ingestion to start from the earliest offset, select this option.

    Note: When supported, the configuration for where to resume data ingestion upon activating a source connection is managed by the Scan Startup Mode connection setting. For example, for the Confluent Cloud connector, you specify the point at which data ingestion should resume by configuring the connector’s Scan Startup Mode.

    Earliest/Latest

    Where to resume data ingestion when a sink connection is activated. Select Earliest to start processing data from the earliest record available or Latest to start processing data from the latest record available.

    Only applicable for sink connections.