Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Se ocorrer um problema enquanto um stream estiver transferindo dados de um banco de dados de origem
para um destino, o stream poderá entrar em um estado Failed ou Failed permanently.
Em ambos os casos, é possível corrigir o problema.
Clique no ícone Opções de exibição da coluna no canto superior direito da página. O ícone aparece como três colunas verticais.
Se não estiver selecionada, marque a caixa de seleção Status e clique em OK. O Datastream exibe os seguintes status:
Failed: para um erro que ocorre em uma transmissão Running. Esses erros
implicam que o stream ainda está ativo ou está continuamente tentando ser executado.
Failed permanently: para uma transmissão que não pode continuar sendo executada. Esses erros
podem causar perda de dados.
Clique no stream que você quer resolver. Todos os erros associados ao stream são exibidos na página Detalhes do stream.
Por exemplo, se o Datastream não conseguir se conectar ao banco de dados de origem, a mensagem de erro Não é possível usar as credenciais fornecidas para se conectar à fonte de dados aparecerá nesta página.
Corrija os erros. É possível resolver erros do stream ou do perfil de conexão.
Por exemplo, se houver erros associados aos objetos de dados de origem do stream ou às informações de configuração do destino, modifique o stream.
Se houver erros associados às informações de conectividade do stream, atualize as informações de configuração sobre o banco de dados de origem ou o destino de todos os perfis de conexão usados pelo stream.
Corrija o stream Failed para que ele possa ser retomado automaticamente ou recupere
o stream Failed permanently.
Recuperar uma transmissão
A primeira coisa a tentar ao recuperar um stream é recuperá-lo da posição
atual. Para mais informações sobre as opções de recuperação de stream, consulte Visão geral da recuperação de
stream.
Se a recuperação de um stream da posição atual falhar, tente o seguinte:
Exclua ou trunce as tabelas afetadas no destino. Isso é necessário
porque, enquanto o stream estava inativo, o Datastream pode ter perdido alguns
eventos DELETE. Os eventos DELETE não podem ser recuperados se você não truncar a tabela
antes de realizar o preenchimento.
Recuperar o stream da posição mais recente. No PostgreSQL, recrie o slot de replicação ou crie um novo.
Quando o fluxo estiver em execução, acione os preenchimentos para restaurar todos os dados históricos.
Para saber como acionar um preenchimento, consulte Iniciar preenchimento.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-12 UTC."],[[["\u003cp\u003eStreams transferring data can enter a \u003ccode\u003eFailed\u003c/code\u003e or \u003ccode\u003eFailed permanently\u003c/code\u003e state if an error occurs, both of which can be rectified.\u003c/p\u003e\n"],["\u003cp\u003eThe status of a stream can be checked on the \u003cstrong\u003eStreams\u003c/strong\u003e page in the Google Cloud Console, which will display either a \u003ccode\u003eFailed\u003c/code\u003e or \u003ccode\u003eFailed permanently\u003c/code\u003e status.\u003c/p\u003e\n"],["\u003cp\u003eErrors associated with a stream are displayed on the \u003cstrong\u003eStream details\u003c/strong\u003e page, such as Datastream being unable to connect to the source database, and can be addressed by modifying the stream or its connection profile.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eFailed\u003c/code\u003e streams can be fixed to automatically resume, while \u003ccode\u003eFailed permanently\u003c/code\u003e streams require recovery, starting with recovery from the current position.\u003c/p\u003e\n"],["\u003cp\u003eRecovering a \u003ccode\u003eFailed permanently\u003c/code\u003e stream may require dropping or truncating affected tables in the destination and triggering backfills to restore historical data.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot a stream\n\nIf a problem occurs while a stream is transferring data from a source database\ninto a destination, the stream can enter a `Failed` or `Failed permanently` state.\nIn both cases, you can rectify the problem.\n\nTroubleshoot a stream\n---------------------\n\n1. Go to the **Streams** page in the Google Cloud Console.\n\n [Go to the Streams page](https://console.cloud.google.com/datastream/streams)\n2. Click the **Column display options** icon in the upper-right corner of the page. The icon appears as three vertical columns.\n\n3. If it isn't selected, select the **Status** checkbox, and then click **OK**. Datastream displays the following statuses:\n\n - `Failed`: for an error that occurs on a `Running` stream. Such errors imply that the stream is still active or continuously attempting to run.\n - `Failed permanently`: for a stream that can't continue to run. Such errors might cause data loss.\n4. Click the stream that you want to troubleshoot. Any errors associated with the stream appear on the **Stream details** page.\n\n For example, if Datastream can't connect to the source database, then the **We can't use the credentials that you provided to connect to the data source.** error message appears on this page.\n5. Address the errors. You can resolve errors for either the stream or the connection profile.\n\n For example, if errors are associated with either the source data objects of the stream or its destination configuration information, then [modify the stream](/datastream/docs/modify-a-stream#modifyastream).\n\n If errors are associated with the connectivity information of the stream, then update the configuration information about the [source database](/datastream/docs/modify-a-stream#modifystreamsourceinfo) or the [destination](/datastream/docs/modify-a-stream#modifystreamdestinfo) for any connection profiles being used by the stream.\n | Any changes that you make to a single connection profile affect all streams using that connection profile.\n\n \u003cbr /\u003e\n\n6. Fix the `Failed` stream so that it can automatically resume, or [recover](/datastream/docs/recover-a-stream)\n the `Failed permanently` stream.\n\n### Recover a stream\n\nThe first thing to try when recovering a stream is to recover it from the current\nposition. For more information about stream recovery options, see [Stream recovery\noverview](/datastream/docs/recover-a-stream#recovery-overview).\n\nIf recovering a stream from the current position fails, then try the following:\n\n1. Drop or truncate the affected tables in the destination. You need to do this because while the stream was down, Datastream might have missed some `DELETE` events. `DELETE` events can't be recovered if you don't truncate the table before performing the backfill.\n2. Recover the stream from the most recent position. For PostgreSQL, recreate the replication slot or create a new replication slot.\n3. Once the stream is running, trigger backfills to restore all historical data. For information about how to trigger a backfill, see [Initiate backfill](/datastream/docs/manage-backfill-for-the-objects-of-a-stream#initiatebackfill).\n\nWhat's next\n-----------\n\n- To learn more about streams, see [Stream lifecycle](/datastream/docs/stream-states-and-actions).\n- To learn how to modify a stream, see [Modify a stream](/datastream/docs/modify-a-stream).\n- To learn how to recover a failed stream, see [Recover a stream](/datastream/docs/recover-a-stream)."]]
