Jira バックアップ エクスポートから Jira Cloud への部分的または選択的なインポート

プラットフォームの注記: Cloud のみ - This article only applies to Atlassian apps on the クラウド プラットフォーム上のアトラシアン製品にのみ適用されます。

要約

エクスポート ファイルを作成してそれを現在の Jira Cloud サイトにアップロードすることで、他の Jira Cloud サイトまたは Jira Server インスタンスのバックアップをインポートできます。

既定では、エクスポート ファイル内のすべてのコンテンツが Jira Cloud サイトにインポートされ、既存のすべてのデータが上書きされます。

ソリューション

バックアップ ファイルを Jira Cloud にインポートする前に次の事項をご確認ください。

  • Important: Importing a database backup file containing activeobjects.xml and entities.xml will erase all existing data and replace it with data from your backup.A backup import overwrites existing data in the target Jira Cloud site. It is not a way to merge one project into a live site. Back up the target and confirm the intended restore scope before uploading a modified archive.

  • 同様に、attachments、avatars、または logos ディレクトリを含むメディア ファイルをインポートすると、対応するそれぞれのデータ (添付ファイル、アバター、ロゴ) が上書きされます。

  • You can't use this process to import a specific space while maintaining your existing site data

ゴール

Prepare the archive as described in the existing article

Database plus media restore

Keep the database file containing activeobjects.xml and entities.xml, with media as needed; upload through Settings → System → Restore system.

Selective filesystem import

Unzip the backup, remove the directories or database files for content you do not want, re-compress the modified directory, and upload it through Restore system.

Media-only import

Create a media-only directory containing the data directory, omit activeobjects.xml and entities.xml, and split media into 2–5 GB files when needed.

エクスポートしたバックアップ ファイルを分割する

インポートする前に、クラウド バックアップ ファイルを次のように分割することをお勧めします。

  1. activeobjects.xml と entities.xml を含むデータベース ファイル

  2. 添付ファイルやその他のメディア用の個別のファイル

これによってタイムアウト エラーを防いで、インポート時の問題のリスクを軽減できます。

選択的インポートのためにクラウド バックアップからファイルを削除する

バックアップから一部のデータのみをインポートする場合は、インポートする前に、エクスポートされたファイルシステムを手動で調整する必要があります。

  1. Jira Cloud で生成されたバックアップ ファイルを解凍する

    1. クラウド バックアップは次のような構造を持ちます。

      JIRA-backup-20161021 ├── activeobjects.xml ├── entities.xml ├── data │ ├── attachments │ └── avatars └── logos

      When unzipping the file, please make sure that all attachments have only an ID as the name. If the filename differs, (such as ID_name.extension) please edit it and keep the existing format or the attachments won't be properly imported.

      例:

      ✔️ 正しい形式:

      ├── data │ ├── attachments │ └── PKEY | └── PKEY-1 |               └── 10000

      ❌誤った形式:

      ├── data │ ├── attachments │ └── PKEY | └── PKEY-1 |               └── 10000_SQLExport.sql
  2. インポートから除外するエンティティ タイプを削除する

    • インポートに含めない対象に応じ、次のようになります。

      • 添付ファイル: attachments ディレクトリを削除します。

      • アバター: avatars ディレクトリを削除します。

      • ロゴ: logos ディレクトリを削除します。

      • データベース データ:activeobjects.xml と entities.xml ファイルの両方を削除します。

  3. 変更済みのディレクトリを圧縮します。

  4. ターゲット Jira Cloud サイトで、[設定] > [システム] > [システムの復元] に移動して、変更したファイルをアップロードします。

添付ファイルと他のメディアのみをインポート

データベース バックアップ (entities.xml および activeobjects.xml ファイル) をインポートしてからメディア (添付ファイル、プロジェクト アバター、およびロゴ) をインポートすることを推奨します。

メディア ファイルのみをインポートするには、次の手順を利用します。

  1. エクスポートした .zip バックアップファイルを解凍します

  2. バックアップ ディレクトリの外部に、次の名前のディレクトリを作成します。 media-only

  3. data ディレクトリをバックアップディレクトリから media-only ディレクトリにドラッグまたはコピーします。

  4. メディア ファイルが 5 GB を超える場合、ファイルを 2 - 5 GB の複数のメディア ファイルに分割して個別にインポートすることをお勧めします

    1. 後述の手順を参照してください。

  5. In your target Jira Cloud site, go to Settings >System > Restore system to upload the file

    1. 前のステップでメディアを複数の小さなファイルに分割した場合は、各ファイルに対してこのステップを繰り返す必要があります。

オプション: メディアを小さなディレクトリに分割する

上記のようにメディア ファイルが 5 GB を超える場合、次の手順に従って複数のファイルに分割します。

  1. エクスポートした .zip バックアップファイルを解凍します

  2. バックアップ ディレクトリの外部に、media-only-1、media-only-2 などのディレクトリを作成します。

  3. バックアップディレクトリから media-only-1 ディレクトリに data ディレクトリをドラッグまたはコピーします。

  4. media-only-2 に data ディレクトリを作成し、その配下に media ディレクトリを作成します。

  5. プロジェクト フォルダの一部を media-only-1 から media-only-2 に移動します

  6. 両方の media-only ディレクトリを ZIP 形式で圧縮します。

圧縮ファイルは次のような構造になります。

media-only-1.zip └─── data ├── attachments │ ├── ProjectKey │ │ └── 10000 │ │ ├── IssueKey-1 │ │ ├── IssueKey-2 │ │ └── IssueKey-3 │ └─── ProjectKey2 └── avatars media-only-2.zip └─── data └─── attachments ├── ProjectKey3 │ └── 30000 │ ├── IssueKey-1 │ ├── IssueKey-2 │ └── IssueKey-3 └─── ProjectKey4

圧縮済みの ZIP ファイルのサイズを再確認します。インポートしようとしているメディア ディレクトリがファイル単位で引き続き 5 GB を超える場合は、タイムアウト エラーを防ぐためにさらに分割することを検討してください。

Once split, you can visit your target Jira Cloud site, go to Settings >System > Restore system to upload the files.

更新日時: October 7, 2026

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。