您可以通过暂停、恢复、停止或重启连接器来控制其运行。通过这些操作,您可以管理数据流并解决问题,而无需删除并重新创建连接器。
如需暂停、恢复、停止或重启 Connect 集群中的连接器,您可以使用 Google Cloud 控制台、gcloud CLI、Managed Service for Apache Kafka 客户端库或 Managed Kafka API。您无法使用开源 Apache Kafka API 来更改连接器状态。
暂停、恢复、停止或重启连接器所需的角色和权限
如需获得暂停、恢复、停止或重启连接器所需的权限,请让管理员为您授予包含 Connect 集群的项目的 Managed Kafka Connector Editor (roles/managedkafka.connectorEditor) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含暂停、恢复、停止或重启连接器所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
您需要具备以下权限才能暂停、恢复、停止或重启连接器:
-
授予对所请求连接器的暂停连接器权限:
managedkafka.connectors.pause -
授予对所请求连接器的恢复连接器权限:
managedkafka.connectors.resume -
授予对所请求连接器的重启连接器权限:
managedkafka.connectors.restart -
授予对所请求连接器的停止连接器权限:
managedkafka.connectors.stop
如需详细了解 Managed Kafka Connector Editor 角色,请参阅 Managed Service for Apache Kafka 预定义角色。
暂停连接器
暂停连接器时,其状态会保留。这意味着连接器会记住它在处理消息或数据时中断的位置。消息处理会暂停,直到连接器恢复为止。您可以恢复已暂停的连接器,它会从暂停的位置继续运行。这对于在不丢失连接器设置的情况下进行问题排查或执行维护非常有用。
控制台
在 Google Cloud 控制台中,前往连接集群页面。
点击托管要暂停的连接器的已连接集群。
系统会显示连接集群详情页面。
在资源标签页中,找到列表中的连接器,然后点击其名称。
系统会将您重定向到连接器详情页面。
点击暂停。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
使用
gcloud managed-kafka connectors pause命令暂停连接器:gcloud managed-kafka connectors pause CONNECTOR_ID \ --location=LOCATION \ --connect-cluster=CONNECT_CLUSTER_ID替换以下内容:
- CONNECTOR_ID:必填。您要暂停的连接器的 ID。
- LOCATION:必填。包含连接器的 Connect 集群的位置。
- CONNECT_CLUSTER_ID:必填。包含连接器的 Connect 集群的 ID。
Go
在尝试此示例之前,请按照 安装客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Go API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据(ADC)。 如需了解详情,请参阅为本地开发环境设置 ADC。
Java
在尝试此示例之前,请按照 安装客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Java API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅 为本地开发环境设置 ADC。
Python
在尝试此示例之前,请按照 安装客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Python API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置 ADC。
恢复连接器
恢复暂停的连接器会从上次中断的位置重新开始运行。
控制台
在 Google Cloud 控制台中,前往连接集群页面。
点击托管要恢复的连接器的 Connect 集群。
系统会显示连接集群详情页面。
在资源标签页中,找到列表中的已暂停连接器,然后点击其名称。
系统会将您重定向到连接器详情页面。
点击继续。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
使用
gcloud managed-kafka connectors resume命令恢复连接器:gcloud managed-kafka connectors resume CONNECTOR_ID \ --location=LOCATION \ --connect-cluster=CONNECT_CLUSTER_ID替换以下内容:
- CONNECTOR_ID:必填。您要恢复的连接器的 ID。
- LOCATION:必填。包含连接器的 Connect 集群的位置。
- CONNECT_CLUSTER_ID:必填。包含连接器的 Connect 集群的 ID。
Go
在尝试此示例之前,请按照 安装客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Go API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据(ADC)。 如需了解详情,请参阅为本地开发环境设置 ADC。
Java
在尝试此示例之前,请按照 安装客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Java API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅 为本地开发环境设置 ADC。
Python
在尝试此示例之前,请按照 安装客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Python API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置 ADC。
停止连接器
停止连接器会停止连接器的所有任务。停止连接器会保留其状态。如需让连接器再次运行,请重启连接器。日志和指标也会持久存储。
控制台
在 Google Cloud 控制台中,前往连接集群页面。
点击托管要停止的连接器的已连接集群。
系统会显示连接集群详情页面。
在资源标签页中,找到列表中的连接器,然后点击其名称。
系统会将您重定向到连接器详情页面。
点击停止。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
使用
gcloud managed-kafka connectors stop命令停止连接器:gcloud managed-kafka connectors stop CONNECTOR_ID \ --location=LOCATION \ --connect-cluster=CONNECT_CLUSTER_ID替换以下内容:
- CONNECTOR_ID:必填。要停止的连接器的 ID。
- LOCATION:必填。包含连接器的 Connect 集群的位置。
- CONNECT_CLUSTER_ID:必填。包含连接器的 Connect 集群的 ID。
Go
在尝试此示例之前,请按照 安装客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Go API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据(ADC)。 如需了解详情,请参阅为本地开发环境设置 ADC。
Java
在尝试此示例之前,请按照 安装客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Java API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅 为本地开发环境设置 ADC。
Python
在尝试此示例之前,请按照 安装客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Python API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置 ADC。
重启连接器
重启连接器会完全停止并重新启动其任务。这对于刷新连接器的状态或应用配置更改非常有用。
注意:重新启动连接器可能会导致数据流短暂中断。
控制台
在 Google Cloud 控制台中,前往连接集群页面。
点击要重启的连接器所在的已连接集群。
系统会显示连接集群详情页面。
在资源标签页中,找到列表中的连接器,然后点击其名称。
系统会将您重定向到连接器详情页面。
点击重新启动。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
使用
gcloud managed-kafka connectors restart命令重启连接器:gcloud managed-kafka connectors restart CONNECTOR_ID \ --location=LOCATION \ --connect-cluster=CONNECT_CLUSTER_ID替换以下内容:
- CONNECTOR_ID:必填。要重启的连接器的 ID。
- LOCATION:必填。包含连接器的 Connect 集群的位置。
- CONNECT_CLUSTER_ID:必填。包含连接器的 Connect 集群的 ID。
Go
在尝试此示例之前,请按照 安装客户端库中的 Go 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Go API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据(ADC)。 如需了解详情,请参阅为本地开发环境设置 ADC。
Java
在尝试此示例之前,请按照 安装客户端库中的 Java 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Java API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅 为本地开发环境设置 ADC。
Python
在尝试此示例之前,请按照 安装客户端库中的 Python 设置说明进行操作。如需了解详情,请参阅 Managed Service for Apache Kafka Python API 参考文档。
如需向 Managed Service for Apache Kafka 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置 ADC。