Pode converter um tópico de importação num tópico padrão ou, inversamente, um tópico padrão num tópico de importação.
Converta um tópico de importação num tópico padrão
Para converter um tópico de importação num tópico padrão, limpe as definições de carregamento. Siga estes passos:
Consola
Na Cloud de Confiance consola, aceda à página Tópicos.
Clique no tópico de importação.
Na página de detalhes do tópico, clique em Editar.
Desmarque a opção Ativar carregamento.
Clique em Atualizar.
gcloud
In the Cloud de Confiance console, activate Cloud Shell.
At the bottom of the Cloud de Confiance 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.
Execute o comando
gcloud pubsub topics update:gcloud pubsub topics update TOPIC_ID \ --clear-ingestion-data-source-settings
Substitua TOPIC_ID pelo ID do tópico.
Converta um tópico padrão num tópico de importação do Amazon Kinesis Data Streams
Para converter um tópico padrão num tópico de importação do Amazon Kinesis Data Streams, primeiro, verifique se cumpre todos os pré-requisitos.
Consola
-
Na Cloud de Confiance consola, aceda à página Tópicos.
-
Clique no tópico que quer converter num tópico de importação.
-
Na página de detalhes do tópico, clique em Editar.
-
Selecione a opção Ativar carregamento.
-
Para a origem da carregamento, selecione Amazon Kinesis Data Streams.
-
Introduza os seguintes detalhes:
-
ARN da stream do Kinesis: o ARN da stream de dados do Kinesis que planeia carregar para o Pub/Sub. O formato ARN é o seguinte:
arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}. -
ARN do consumidor do Kinesis: o ARN do recurso do consumidor que está registado no fluxo de dados do AWS Kinesis. O formato ARN é o seguinte:
arn:${Partition}:kinesis:${Region}:${Account}:${StreamType}/${StreamName}/consumer/${ConsumerName}:${ConsumerCreationTimpstamp}. -
ARN da função do AWS: o ARN da função do AWS. O formato ARN da função é o seguinte:
arn:aws:iam::${Account}:role/${RoleName}. -
Conta de serviço: a conta de serviço que criou.
-
-
Clique em Atualizar.
gcloud
-
In the Cloud de Confiance console, activate Cloud Shell.
At the bottom of the Cloud de Confiance 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.
Execute o comando
gcloud pubsub topics updatecom todos os sinalizadores mencionados no seguinte exemplo:gcloud pubsub topics update TOPIC_ID
--kinesis-ingestion-stream-arn KINESIS_STREAM_ARN
--kinesis-ingestion-consumer-arn KINESIS_CONSUMER_ARN
--kinesis-ingestion-role-arn KINESIS_ROLE_ARN
--kinesis-ingestion-service-account PUBSUB_SERVICE_ACCOUNTSubstitua o seguinte:
-
TOPIC_ID é o ID ou o nome do tópico. Não é possível atualizar este campo.
-
KINESIS_STREAM_ARN é o ARN para as streams de dados do Kinesis que planeia carregar para o Pub/Sub. O formato ARN é o seguinte:
arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}. -
KINESIS_CONSUMER_ARN é o ARN do recurso de consumidor registado nos AWS Kinesis Data Streams. O formato ARN é o seguinte:
arn:${Partition}:kinesis:${Region}:${Account}:${StreamType}/${StreamName}/consumer/${ConsumerName}:${ConsumerCreationTimpstamp}. -
KINESIS_ROLE_ARN é o ARN da função do AWS. O formato ARN da função é o seguinte:
arn:aws:iam::${Account}:role/${RoleName}. -
PUBSUB_SERVICE_ACCOUNT é a conta de serviço que criou.
-
Ir
O exemplo seguinte usa a versão principal da biblioteca de cliente Go Pub/Sub (v2). Se ainda estiver a usar a biblioteca v1, consulte o guia de migração para a v2. Para ver uma lista de exemplos de código da v1, consulte os exemplos de código descontinuados.
Antes de experimentar este exemplo, siga as instruções de configuração do Go em Início rápido: usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go do Pub/Sub.
Java
Antes de experimentar este exemplo, siga as instruções de configuração do Java no artigo Início rápido: usar bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Java do Pub/Sub.
Node.js
Antes de experimentar este exemplo, siga as instruções de configuração do Node.js em Início rápido: usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js do Pub/Sub.
Python
Antes de experimentar este exemplo, siga as instruções de configuração do Python em Início rápido: usar bibliotecas cliente. Para mais informações, consulte a documentação de referência da API Python Pub/Sub.
C++
Antes de experimentar este exemplo, siga as instruções de configuração do C++ no artigo Início rápido: usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C++ do Pub/Sub.
Node.js
Antes de experimentar este exemplo, siga as instruções de configuração do Node.js em Início rápido: usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js do Pub/Sub.
Para mais informações sobre ARNs, consulte os artigos Nomes de recursos da Amazon (ARNs) e Identificadores do IAM.
Converta um tópico padrão num tópico de importação do Cloud Storage
Para converter um tópico padrão num tópico de importação do Cloud Storage, primeiro, verifique se cumpre todos os pré-requisitos.
Consola
-
Na Cloud de Confiance consola, aceda à página Tópicos.
-
Clique no tópico que quer converter num tópico de importação do Cloud Storage.
-
Na página de detalhes do tópico, clique em Editar.
-
Selecione a opção Ativar carregamento.
-
Para a origem da carregamento, selecione Google Cloud Storage.
-
Para o contentor do Cloud Storage, clique em Procurar.
É aberta a página Selecionar contentor. Selecione uma das seguintes opções:
-
Selecione um contentor existente de qualquer projeto adequado.
-
Clique no ícone de criação e siga as instruções no ecrã para criar um novo contentor. Depois de criar o contentor, selecione-o para o tópico de importação do Cloud Storage.
-
-
Quando especifica o contentor, o Pub/Sub verifica se existem as autorizações adequadas no contentor para a conta de serviço do Pub/Sub. Se existirem problemas de autorizações, é apresentada uma mensagem de erro relacionada com as autorizações.
Se tiver problemas de autorização, clique em Definir autorizações. Para mais informações, consulte Conceda autorizações do Cloud Storage à conta de serviço do Pub/Sub.
-
Para Formato do objeto, selecione Texto, Avro ou Pub/Sub Avro.
Se selecionar Texto, pode especificar opcionalmente um Delimitador com o qual dividir os objetos em mensagens.
Para mais informações sobre estas opções, consulte o artigo Formato de entrada.
- Opcional. Pode especificar um tempo mínimo de criação de objetos para o seu tópico. Se estiver definido, apenas são carregados objetos criados após a hora de criação mínima do objeto.
Para mais informações, consulte Tempo mínimo de criação de objetos.
- Tem de especificar um padrão glob. Para carregar todos os objetos no contentor,
use
**como o padrão glob. Só são carregados objetos que correspondem ao padrão fornecido.Para mais informações, consulte Faça corresponder um padrão glob.
- Manter as outras predefinições.
- Clique em Atualizar tópico.
gcloud
-
In the Cloud de Confiance console, activate Cloud Shell.
At the bottom of the Cloud de Confiance 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.
Para evitar perder as definições do tópico de importação, certifique-se de que inclui todas as definições sempre que atualizar o tópico. Se omitir algo, o Pub/Sub repõe a definição para o respetivo valor predefinido original.
Execute o comando
gcloud pubsub topics updatecom todos os sinalizadores mencionados no seguinte exemplo:gcloud pubsub topics update TOPIC_ID \ --cloud-storage-ingestion-bucket=BUCKET_NAME\ --cloud-storage-ingestion-input-format=INPUT_FORMAT\ --cloud-storage-ingestion-text-delimiter=TEXT_DELIMITER\ --cloud-storage-ingestion-minimum-object-create-time=MINIMUM_OBJECT_CREATE_TIME\ --cloud-storage-ingestion-match-glob=MATCH_GLOB
Substitua o seguinte:
-
TOPIC_ID é o ID ou o nome do tópico. Não é possível atualizar este campo.
-
BUCKET_NAME: especifica o nome de um contentor existente. Por exemplo,
prod_bucket. O nome do contentor não pode incluir o ID do projeto. Para criar um contentor, consulte o artigo Crie contentores. -
INPUT_FORMAT: especifica o formato dos objetos carregados. Pode ser
text,avrooupubsub_avro. Para mais informações sobre estas opções, consulte o artigo Formato de entrada. -
TEXT_DELIMITER: Especifica o delimitador com o qual dividir os objetos de texto em mensagens do Pub/Sub. Tem de ser um único caráter e só tem de ser definido quando
INPUT_FORMATétext. A predefinição é o caráter de nova linha (\n).Quando usar a CLI gcloud para especificar o delimitador, preste muita atenção ao processamento de carateres especiais, como a nova linha
\n. Use o formato'\n'para garantir que o delimitador é interpretado corretamente. A utilização simples de\nsem aspas nem carateres de escape resulta num delimitador de"n". -
MINIMUM_OBJECT_CREATE_TIME: especifica o tempo mínimo em que um objeto foi criado para que seja carregado. Deve estar em UTC no formato
YYYY-MM-DDThh:mm:ssZ. Por exemplo,2024-10-14T08:30:30Z.Qualquer data, passada ou futura, de
0001-01-01T00:00:00Za9999-12-31T23:59:59Z, inclusive, é válida. -
MATCH_GLOB: especifica o padrão glob a corresponder para que um objeto seja carregado. Quando usa a CLI gcloud, um padrão glob com carateres
*tem de ter o carater*formatado como carater de escape no formato\*\*.txtou todo o padrão glob tem de estar entre aspas"**.txt"ou'**.txt'. Para ver informações sobre a sintaxe suportada para padrões glob, consulte a documentação do Cloud Storage.
-