すべてのプロダクト
Search
ドキュメントセンター

Realtime Compute for Apache Flink:プロジェクトのクローン作成

最終更新日:Feb 06, 2026

「プロジェクトのクローン作成」機能では、同一リージョン内で、ソースプロジェクトからターゲットプロジェクトへエンティティおよび構成情報を迅速にコピーできます。これにより、重複した開発作業が削減され、リソース効率が向上するとともに、ディザスタリカバリ用のコールドバックアップも実現します。本トピックでは、プロジェクトのクローン作成の適用範囲、操作手順、および重要な注意事項について説明します。

利用シーン

タイプ

利用シーン

推奨事項

データバックアップ

  • 障害発生時のデータ損失を防止するため、重要データを定期的にバックアップします。

  • プロジェクトライフサイクルのさまざまな段階で独立したデータスナップショットを作成し、トレーサビリティやロールバックに備えます。

  • ターゲットプロジェクトが空の場合:ソースプロジェクトのデータを新しい空のターゲットプロジェクトにクローンします。これにより、バックアップの独立性が確保され、既存データとの競合を回避できます。

  • 完全バックアップ:各クローン操作は完全バックアップを生成します。増分データを手動でフィルターする必要はありません。システムが最新の完全なデータ状態を自動的に取得します。

  • バージョン管理:ターゲットプロジェクトの名前を日付またはバージョン番号で付与し、データのバージョンを管理します。たとえば、Backup_20241001 および Backup_20241015 は、異なるタイミングで取得されたバックアップを表しており、後続の照会および回復作業を容易にします。

リソースのクローン作成と共有

  • リソースの再利用:既存プロジェクトに多数の履歴リソースがすでに存在する場合、それらをクローンすることで新規リソースを迅速に導入できます。ゼロから再構築する必要はありません。

  • チーム間連携:共有リソースを複数のチームに分散させるために、それぞれのプロジェクトへクローンします。

  • 環境の隔離:テスト、開発、本番環境向けに、隔離された一貫したリソースのコピーを作成します。

  • ターゲットプロジェクトに既にデータが存在する場合:データバックアップとは異なり、ターゲットプロジェクトには通常他のリソースが含まれています。クローン操作により、ソースデータが既存のリソース構成にシームレスに統合されます。

  • 権限管理:クローン操作時に権限管理を活用し、ターゲットプロジェクト内のリソースへのアクセスおよび変更を許可されたユーザーのみが行えるようにします。

ストレージまたはデータ移行

  • 自己管理の OSS ストレージからフルマネージドサービスに移行します。

  • テストプロジェクトから本番プロジェクトにデータを移行します。

ストレージの権限:OSS からフルマネージドストレージへクローンする場合、プロジェクトに紐づくバケットに対して、arn:sts::1060219998962774:assumed-role/aliyunstreamasidefaultrole/refresh_token(フルマネージドアカウント)に読み取り専用(ListObject を含む)権限を付与します。詳細については、「バケットポリシーおよび承認ポリシーの設定」をご参照ください。

制限事項

  • リージョン制限:プロジェクト間のクローン作成は、同一リージョン内でのみサポートされています。クロスリージョンのクローン作成はサポートされていません。

  • クローン粒度:プロジェクト単位でのみクローン可能です。ワークスペース全体のクローンはサポートされていません。

  • 除外対象:タスクオーケストレーション、キュー、権限、アラート構成はクローンされません。

  • バージョンポリシー:開発モードでは最新のドラフトのみ、O&M モードでは公開済みのジョブのみがクローンされます。開発モードにおける過去のバージョンは無視されます。

  • 同時操作:1 対 1 のクローンのみをサポートしています。1 つのソースプロジェクトを複数のターゲットプロジェクトに同時にクローンしたり、複数のソースプロジェクトを 1 つのターゲットプロジェクトに同時にクローンしたりすることはできません。

  • ストレージ互換性:ソースワークスペースがフルマネージドストレージを使用している場合、ターゲットワークスペースもフルマネージドストレージを使用する必要があります。OSS をターゲットとして使用することはできません。

  • アーキテクチャ互換性:同一アーキテクチャ間でのみクローンがサポートされています。クロスアーキテクチャ(例:x86 から ARM など)のクローンはサポートされていません。

  • ステートフルクローン:チェックポイントまたはセーブポイントを伴うステートフルクローンは、Ververica Runtime (VVR) 6.0.2 以降でのみサポートされています。

重要な注意事項

必要な権限を取得する
ターゲットワークスペースに対するクローン権限がアカウントに付与されていることを確認してください。クロスプロジェクト移行を有効化できるのは Owner ロールのみです。詳細については、「開発コンソールでの権限付与」をご参照ください。

クローンの制限

  • リソースのロック:クローン中は、リソース構成の変更ができません。

  • ロールバック不可:クローン操作は元に戻せません。クローンを中断した場合は、クローンされたリソースを手動で削除してください。

  • 重複の回避:同一のターゲットプロジェクトに対して複数回クローンを実行すると、重複したリソースが作成されます。

  • ストレージの権限:OSS からフルマネージドストレージへクローンする場合、プロジェクトに紐づくバケットに対して、arn:sts::1060219998962774:assumed-role/aliyunstreamasidefaultrole/refresh_token(フルマネージドアカウント)に読み取り専用権限(ListObject を含む)を付与します。詳細については、「バケットポリシーおよび承認ポリシーの設定」をご参照ください。

スナップショットを手動で作成する

システムは、ジョブが実行中・完了・停止のいずれであっても、各ジョブの最新のスナップショットまたはチェックポイントのみをクローンします。最新のデータが確実にコピーされるよう、クローン前に手動でスナップショットをトリガーしてください。

重複するエンティティ名の処理
システムがターゲットプロジェクト内で重複するエンティティ名を自動的にリネームします。「クローン履歴」でリネーム一覧を確認できます。

カタログ名の手動更新
ジョブ内で構成または参照されているカタログ名は、自動で更新されません。ジョブのコードおよび構成を編集してカタログ名を更新してください。更新しないと、ジョブが失敗します。

クローン済みジョブのテスト
クローン後、ジョブおよび Session クラスターは停止状態のままとなります。依存関係の構成が不足しているなどの理由により、クローン済みジョブは即座に実行されない場合があります。以下の手順を実施してください:

  1. ジョブのドラフトをテストします。

  2. 依存ファイルが期待通りであることを確認します。

  3. ジョブの依存関係構成を調整します。

手順

  1. ソースプロジェクトおよびターゲットワークスペース・プロジェクトを準備します。詳細については、「Realtime Compute for Apache Flink の有効化」または「プロジェクトの管理」をご参照ください。

  2. プロジェクトのエンティティおよび構成情報をクローンします。

    1. Realtime Compute Management Console にログインします。

    2. クローンを作成するワークスペースの[その他]列で、[ワークスペースのクローンを作成] > [クローンの開始]をクリックします。

    3. クローン構成を入力します。

      1. クローン対象のワークスペースを選択します。

      2. クローン対象のオブジェクトを選択します。

      3. クローン戦略を構成します。

        構成

        構成オプション

        説明

        ステートフルストリーミングジョブのクローン戦略

        ステートフル

        最新のスナップショットまたはシステムチェックポイントをクローンします。これにより、既に処理済みのデータが再処理されることを防ぎます。

        ステートレス

        ジョブ構成およびコードのみをクローンします。スナップショットおよびシステムチェックポイントはクローンしません。

        実行中のストリーミングジョブのクローン戦略

        スキップ

        クローン中に実行中のストリーミングジョブを自動的にスキップします。これにより、ソースジョブによって新たに生成された状態によるデータ干渉を回避します。移行用途に推奨されます。

        スキップしない

        選択されたすべてのストリーミングジョブおよびその最新スナップショットまたはシステムチェックポイントをクローンします。バックアップ用途に推奨されます。

        エラー処理戦略

        スキップして続行

        失敗した項目をログに記録し、残りの処理を続行します。

        クローンを停止

        いずれかの項目のクローンに失敗した場合、タスク全体を停止します。

        ステートレスクローンを許可

        ステートフルクローンが失敗した場合、ステートレスクローンへフォールバックして続行します。

    4. クローン開始 をクリックします。

  3. クローンの進行状況および完了状態を確認します。

    • クローン中

      クローン開始 をクリック後、ワークスペース一覧の上部にメッセージが表示されます。クローンの進行状況を表示 をクリックして進捗を監視できます。クローンには時間がかかる場合がありますが、バックグラウンドで継続実行できます。

      image

    • クローン完了後

      対象のワークスペースの [その他] 列で、[ワークスペースのクローン] > [履歴のクローン] をクリックします。その後、[詳細] をクリックします。クローンされたエンティティタイプ、合計数、および失敗数を表示できます。名前変更リストも表示されます。

リファレンス

SQL ジョブおよび DataStream ジョブのバックアップについては、「ジョブのバックアップおよび新規ジョブのデプロイ」をご参照ください。