[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-09-04 (世界標準時間)。"],[[["\u003cp\u003eSubmitting Dataflow jobs from an unsupported SDK version leads to interruptions and reduced throughput for long-running batch or streaming jobs.\u003c/p\u003e\n"],["\u003cp\u003eUsers can temporarily use a token to resubmit a job with an unsupported SDK, or use a token to resume a disrupted job, although these are not permanent solutions.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading to a supported SDK version is the preferred method to resolve issues caused by unsupported SDKs and avoid future disruptions.\u003c/p\u003e\n"],["\u003cp\u003eTokens for unsupported SDKs expire, and resumed jobs will return to a disrupted state once the temporary token expires.\u003c/p\u003e\n"],["\u003cp\u003eJobs using an unsupported SDK version may be subject to a complete cancellation after the SDK's supported date.\u003c/p\u003e\n"]]],[],null,["# Using an unsupported SDK\n\nSubmitting jobs from an SDK version past its supported date results in interruptions and a reduction in throughput for long-running batch or streaming jobs. To mitigate potential issues, do the following:\n\n- [Upgrade the SDK version](/dataflow/docs/guides/installing-beam-sdk#installing-sdk-releases). (Preferred)\n- [Resubmit the job using a temporary token](#starting_jobs_with_unsupported_sdk_versions).\n- [Resume the disrupted job](#resuming_disrupted_jobs).\n\n| **Note:** All available SDK versions can be found on the [support status page](/dataflow/docs/support/sdk-version-support-status#apache-beam-2.x-sdks).\n\n### Starting jobs with unsupported SDK versions\n\nWhen you submit a Dataflow job from an SDK version past its supported date, you will receive an error message directing you to either [upgrade your SDK version](/dataflow/docs/guides/installing-beam-sdk#installing-sdk-releases) or to use a temporary token when you submit your job.\n\nThe token value in the error message contains the datetime when the token expires as well as the token itself. The expiration date is set for two weeks in the future.\n\nIf you want to use the token, resubmit your job using the `unsupported_sdk_temporary_override_token` experiment flag and token value. \n\n```bash\n--experiments=unsupported_sdk_temporary_override_token=TOKEN\n```\n\nIf you submit a job using the token after it expires, you will receive a different error message informing you of the expired status. You can can either upgrade to a supported SDK version or resubmit your job without the token to get a new token.\n| **Note:** Tokens are applied at the individual job level, so if you have multiple jobs scheduled, each job must use a unique token.\n\nTokens should not be used as a permanent way to keep using an unsupported SDK. At some time after the unsupported date of an SDK, all tokens will be revoked and all jobs using that unsupported SDK version are rejected. For more details on the support status of each SDK, see [SDK version support status](/dataflow/docs/support/sdk-version-support-status).\n\n### Resuming disrupted jobs\n\nLong-running Dataflow jobs that use unsupported SDKs, such as streaming jobs, will also be disrupted and have their throughput significantly reduced. These disrupted jobs can be identified through the following error message in the job logs:\n\u003e The workflow was automatically disrupted by the service because it uses an unsupported SDK Apache Beam SDK for Python 2.3.0. Please upgrade to the latest SDK version. To resume the disrupted job temporarily, please use `gcloud alpha dataflow jobs resume-unsupported-sdk --token=TOKEN --region=REGION JOB_ID`. Note that the resumed job by this token will be disrupted again on 2020-08-28T11:21:58-07:00. For a list of supported SDK versions, see: https://cloud.google.com/dataflow/support#support-status-for-dataflow-sdk-releases.\n\nAs the error suggests, the disruption can be mitigated using the [resume-unsupported-sdk](/sdk/gcloud/reference/alpha/dataflow/jobs/resume-unsupported-sdk) command. Resuming a disrupted job is a temporary solution. Instead, you should [upgrade](/dataflow/docs/guides/installing-beam-sdk#installing-sdk-releases) your SDK version to avoid further deprecation actions in the future.\n| **Note:** Previously resumed jobs will return to the disrupted state once the temporary token expires. Any future disruptions can be resumed in the same way; however, jobs running on unsupported SDK versions could be automatically cancelled at some time after the unsupported date."]]
