É possível controlar a operação de um conector pausando, retomando, interrompendo ou reiniciando. Essas ações permitem gerenciar o fluxo de dados e resolver problemas sem excluir e recriar o conector.
Para pausar, retomar, interromper ou reiniciar um conector em um cluster do Connect, use o console Google Cloud , a CLI gcloud, a biblioteca de cliente do Serviço gerenciado para Apache Kafka ou a API Managed Kafka. Não é possível usar a API de código aberto do Apache Kafka para mudar os estados do conector.
Funções e permissões necessárias para pausar, retomar, parar ou reiniciar um conector
Para receber as permissões necessárias para pausar, retomar, interromper ou reiniciar um conector,
peça ao administrador para conceder a você o
papel do IAM Editor do conector gerenciado do Kafka (roles/managedkafka.connectorEditor)
no projeto que contém o cluster do Connect.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esse papel predefinido contém as permissões necessárias para pausar, retomar, interromper ou reiniciar um conector. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para pausar, retomar, interromper ou reiniciar um conector:
-
Conceda a permissão de pausa do conector no conector solicitado:
managedkafka.connectors.pause -
Conceda a permissão de conector de currículo no conector solicitado:
managedkafka.connectors.resume -
Conceda a permissão de reinicialização do conector no conector solicitado:
managedkafka.connectors.restart -
Conceda a permissão de parada no conector solicitado:
managedkafka.connectors.stop
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Para mais informações sobre a função de editor do conector gerenciado do Kafka, consulte Funções predefinidas do Serviço Gerenciado para Apache Kafka.
Pausar um conector
Quando você pausa um conector, o estado dele é preservado. Isso significa que o conector lembra de onde parou no processamento de mensagens ou dados. O processamento de mensagens é interrompido até que o conector seja retomado. É possível retomar um conector pausado, e ele continua de onde parou. Isso é útil para solucionar problemas ou realizar manutenção sem perder a configuração do conector.
Console
No console do Google Cloud , acesse a página Conectar clusters.
Clique no cluster de conexão que hospeda o conector que você quer pausar.
A página Detalhes do cluster de conexão é exibida.
Na guia Recursos, encontre o conector na lista e clique no nome dele.
Você será redirecionado para a página Detalhes do conector.
Clique em Pausar.
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.
Use o comando
gcloud managed-kafka connectors pausepara pausar um conector:gcloud managed-kafka connectors pause CONNECTOR_ID \ --location=LOCATION \ --connect-cluster=CONNECT_CLUSTER_IDSubstitua:
- CONNECTOR_ID: obrigatório. O ID do conector que você quer pausar.
- LOCATION: obrigatório. O local do cluster do Connect que contém o conector.
- CONNECT_CLUSTER_ID: obrigatório. O ID do cluster do Connect que contém o conector.
Go
Antes de testar este exemplo, siga as instruções de configuração do Go em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go do serviço gerenciado para Apache Kafka.
Para autenticar o Managed Service para Apache Kafka, configure o Application Default Credentials(ADC). Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java do serviço gerenciado para Apache Kafka.
Para autenticar o serviço gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Python
Antes de testar esta amostra, siga as instruções de configuração do Python em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Python do serviço gerenciado para Apache Kafka.
Para autenticar o serviço gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Retomar um conector
A retomada de um conector pausado reinicia a operação de onde ela parou.
Console
No console do Google Cloud , acesse a página Conectar clusters.
Clique no cluster do Connect que hospeda o conector que você quer retomar.
A página Detalhes do cluster de conexão é exibida.
Na guia Recursos, encontre o conector pausado na lista e clique no nome dele.
Você será redirecionado para a página Detalhes do conector.
Clique em Retomar.
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.
Use o comando
gcloud managed-kafka connectors resumepara retomar um conector:gcloud managed-kafka connectors resume CONNECTOR_ID \ --location=LOCATION \ --connect-cluster=CONNECT_CLUSTER_IDSubstitua:
- CONNECTOR_ID: obrigatório. O ID do conector que você quer retomar.
- LOCATION: obrigatório. O local do cluster do Connect que contém o conector.
- CONNECT_CLUSTER_ID: obrigatório. O ID do cluster do Connect que contém o conector.
Go
Antes de testar este exemplo, siga as instruções de configuração do Go em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go do serviço gerenciado para Apache Kafka.
Para autenticar o Managed Service para Apache Kafka, configure o Application Default Credentials(ADC). Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java do serviço gerenciado para Apache Kafka.
Para autenticar o serviço gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Python
Antes de testar esta amostra, siga as instruções de configuração do Python em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Python do serviço gerenciado para Apache Kafka.
Para autenticar o serviço gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Parar um conector
A interrupção de um conector interrompe todas as tarefas dele. Interromper um conector preserva o estado dele. Para que o conector volte a funcionar, reinicie-o. Os registros e as métricas também são armazenados de maneira durável.
Console
No console do Google Cloud , acesse a página Conectar clusters.
Clique no cluster de conexão que hospeda o conector que você quer interromper.
A página Detalhes do cluster de conexão é exibida.
Na guia Recursos, encontre o conector na lista e clique no nome dele.
Você será redirecionado para a página Detalhes do conector.
Clique em Interromper.
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.
Use o comando
gcloud managed-kafka connectors stoppara interromper um conector:gcloud managed-kafka connectors stop CONNECTOR_ID \ --location=LOCATION \ --connect-cluster=CONNECT_CLUSTER_IDSubstitua:
- CONNECTOR_ID: obrigatório. O ID do conector que você quer interromper.
- LOCATION: obrigatório. O local do cluster do Connect que contém o conector.
- CONNECT_CLUSTER_ID: obrigatório. O ID do cluster do Connect que contém o conector.
Go
Antes de testar este exemplo, siga as instruções de configuração do Go em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go do serviço gerenciado para Apache Kafka.
Para autenticar o Managed Service para Apache Kafka, configure o Application Default Credentials(ADC). Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java do serviço gerenciado para Apache Kafka.
Para autenticar o serviço gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Python
Antes de testar esta amostra, siga as instruções de configuração do Python em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Python do serviço gerenciado para Apache Kafka.
Para autenticar o serviço gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Reiniciar um conector
Reiniciar um conector interrompe e reinicia completamente as tarefas dele. Isso pode ser útil para atualizar o estado do conector ou aplicar mudanças de configuração.
Observação:reiniciar um conector pode causar uma breve interrupção no fluxo de dados.
Console
No console do Google Cloud , acesse a página Conectar clusters.
Clique no cluster do Connect que hospeda o conector que você quer reiniciar.
A página Detalhes do cluster de conexão é exibida.
Na guia Recursos, encontre o conector na lista e clique no nome dele.
Você será redirecionado para a página Detalhes do conector.
Clique em Reiniciar.
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.
Use o comando
gcloud managed-kafka connectors restartpara reiniciar um conector:gcloud managed-kafka connectors restart CONNECTOR_ID \ --location=LOCATION \ --connect-cluster=CONNECT_CLUSTER_IDSubstitua:
- CONNECTOR_ID: obrigatório. O ID do conector que você quer reiniciar.
- LOCATION: obrigatório. O local do cluster do Connect que contém o conector.
- CONNECT_CLUSTER_ID: obrigatório. O ID do cluster do Connect que contém o conector.
Go
Antes de testar este exemplo, siga as instruções de configuração do Go em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go do serviço gerenciado para Apache Kafka.
Para autenticar o Managed Service para Apache Kafka, configure o Application Default Credentials(ADC). Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java do serviço gerenciado para Apache Kafka.
Para autenticar o serviço gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Python
Antes de testar esta amostra, siga as instruções de configuração do Python em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Python do serviço gerenciado para Apache Kafka.
Para autenticar o serviço gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.