Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Si un problème survient lorsqu'un flux transfère des données d'une base de données source vers une destination, le flux peut passer à l'état Failed ou Failed permanently.
Dans les deux cas, vous pouvez résoudre le problème.
Résoudre les problèmes liés à un flux
Accédez à la page Flux dans la Google Cloud console.
Cliquez sur l'icône Options d'affichage des colonnes dans le coin supérieur droit de la page. L'icône apparaît sous la forme de trois colonnes verticales.
Si ce n'est pas le cas, cochez la case Status (État), puis cliquez sur OK. Datastream affiche les états suivants:
Failed: pour une erreur qui se produit sur un flux Running. Ces erreurs impliquent que le flux est toujours actif ou qu'il tente de s'exécuter en continu.
Failed permanently: pour un flux qui ne peut pas continuer à s'exécuter. De telles erreurs peuvent entraîner une perte de données.
Cliquez sur le flux que vous souhaitez dépanner. Les erreurs associées au flux apparaissent sur la page Détails du flux.
Par exemple, si Datastream ne parvient pas à se connecter à la base de données source, le message d'erreur Nous ne pouvons pas utiliser les identifiants que vous avez fournis pour vous connecter à la source de données s'affiche sur cette page.
Corrigez les erreurs. Vous pouvez résoudre les erreurs de flux ou de profil de connexion.
Par exemple, si des erreurs sont associées aux objets de données sources du flux ou à ses informations de configuration de destination, modifiez le flux.
Si des erreurs sont associées aux informations de connectivité du flux, mettez à jour les informations de configuration concernant la base de données source ou la destination dans les profils de connexion utilisés par le flux.
Corrigez le flux Failed pour qu'il puisse reprendre automatiquement ou récupérez le flux Failed permanently.
Récupérer un flux
La première chose à essayer lors de la récupération d'un flux est de le récupérer à partir de la position actuelle. Pour en savoir plus sur les options de récupération des flux, consultez la section Présentation de la récupération des flux.
Si la récupération d'un flux à partir de la position actuelle échoue, procédez comme suit:
Supprimez ou tronquez les tables concernées dans la destination. Vous devez le faire, car lorsque le flux était indisponible, Datastream a peut-être manqué certains événements DELETE. Les événements DELETE ne peuvent pas être récupérés si vous ne tronquez pas la table avant d'effectuer le remplissage.
Récupérez le flux à partir de la position la plus récente. Pour PostgreSQL, recréez l'emplacement de réplication ou créez-en un.
Une fois le flux en cours d'exécution, déclenchez des remplissages en arrière-plan pour restaurer l'intégralité des données historiques.
Pour savoir comment déclencher un remplissage, consultez Déclencher un remplissage.
Pour savoir comment modifier un flux, consultez Modifier un flux.
Pour savoir comment récupérer un flux ayant échoué, consultez Récupérer un flux.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (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)."]]
