你可以暫停、繼續、停止或重新啟動連接器,藉此控制連接器的運作。您可透過這些動作管理資料流及解決問題,不必刪除並重新建立連接器。
如要暫停、恢復、停止或重新啟動 Connect 叢集中的連接器,可以使用 Google Cloud 控制台、gcloud CLI、Managed Service for Apache Kafka 用戶端程式庫或 Managed Kafka API。您無法使用開放原始碼 Apache Kafka API 變更連接器狀態。
暫停、繼續、停止或重新啟動連接器所需的角色和權限
如要取得暫停、繼續、停止或重新啟動連接器所需的權限,請要求管理員在包含 Connect 叢集的專案中,授予您 Managed Kafka Connector 編輯者 (roles/managedkafka.connectorEditor) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備暫停、繼續、停止或重新啟動連接器所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
如要暫停、繼續、停止或重新啟動連接器,您必須具備下列權限:
-
在要求的連接器上授予暫停連接器權限:
managedkafka.connectors.pause -
在要求的連接器上授予繼續執行連接器權限:
managedkafka.connectors.resume -
在要求的連接器上授予重新啟動連接器權限:
managedkafka.connectors.restart -
在要求的連接器上授予停止連接器權限:
managedkafka.connectors.stop
暫停連接器
暫停連接器時,系統會保留其狀態。也就是說,連接器會記住上次處理訊息或資料的進度。訊息處理作業就會停止,直到連接器重新啟用。您可以繼續先前暫停的連接器,並從暫停處繼續執行。這項功能有助於進行疑難排解或維護,同時保留連接器的設定。
控制台
前往 Google Cloud 控制台的「Connect Clusters」(連結叢集) 頁面。
按一下要暫停連接器的 Connect 叢集。
系統隨即會顯示「Connect cluster details」(連線叢集詳細資料) 頁面。
在「資源」分頁中,找出清單中的連結器,然後按一下連結器名稱。
系統會將您重新導向至「連接器詳細資料」頁面。
按一下「暫停」。
gcloud
-
在 Google Cloud 控制台中啟用 Cloud Shell。
Google Cloud 主控台底部會開啟一個 Cloud Shell 工作階段,並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境,並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。
使用
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 Clusters」(連結叢集) 頁面。
按一下要恢復的連接器所在的 Connect 叢集。
系統隨即會顯示「Connect cluster details」(連線叢集詳細資料) 頁面。
在「資源」分頁中,找出清單中已暫停的連結器,然後按一下其名稱。
系統會將您重新導向至「連接器詳細資料」頁面。
按一下「繼續」。
gcloud
-
在 Google Cloud 控制台中啟用 Cloud Shell。
Google Cloud 主控台底部會開啟一個 Cloud Shell 工作階段,並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境,並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。
使用
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 控制台的「Connect Clusters」(連結叢集) 頁面。
按一下要停止連接器的 Connect 叢集。
系統隨即會顯示「Connect cluster details」(連結叢集詳細資料) 頁面。
在「資源」分頁中,找出清單中的連結器,然後按一下連結器名稱。
系統會將您重新導向至「連接器詳細資料」頁面。
按一下「停止」。
gcloud
-
在 Google Cloud 控制台中啟用 Cloud Shell。
Google Cloud 主控台底部會開啟一個 Cloud Shell 工作階段,並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境,並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。
使用
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 控制台的「Connect Clusters」(連結叢集) 頁面。
按一下要重新啟動連接器的 Connect 叢集。
系統隨即會顯示「Connect cluster details」(連結叢集詳細資料) 頁面。
在「資源」分頁中,找出清單中的連結器,然後按一下連結器名稱。
系統會將您重新導向至「連接器詳細資料」頁面。
按一下 [Restart]。
gcloud
-
在 Google Cloud 控制台中啟用 Cloud Shell。
Google Cloud 主控台底部會開啟一個 Cloud Shell 工作階段,並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境,並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。
使用
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」。