サイトのエクスポートまたはインポート

注: Tableau Server から Tableau Cloud へのサイトの移行の詳細については、「Tableau Cloud マニュアル移行ガイド」(新しいウィンドウでリンクが開く)を参照してください。

別のサイトから情報をインポート (移行) して、新しい Tableau Server サイトをプロビジョニングすることができます。これを行うには、既存サイト (ソース サイト) の情報をファイルにエクスポートします。その後、その情報を検証し、ターゲット サイトにインポートする手順を完了します。

サイト移行オプション

次のいずれかの方法を実行して、サイトを移行できます。

• 同じ Tableau Server インスタンス上の別のサイトへ

• 別の Tableau Server インスタンス上のサイトへ

• Tableau Server Windows上から Tableau ServerLinux上に、またはその逆に。

注: Tableau Server のインスタンス間でサイトを移行する場合、移行先サイトは、移行元サイトの Tableau Server のバージョンと同じかそれ以降の Tableau Server のバージョン上にある必要があります。移行元サイトと移行先サイトの両方が、サポートされているバージョンの Tableau Server からのものである必要があります。

サイト移行に関する制限事項

サイトエクスポートで保持される情報と保持情報

• 作成したエクスポート ファイルには、ワークブック、プロジェクト、データ ソース、およびユーザーが保持されます。これには、コンテンツに対して設定されたパーミッション、ユーザーのお気に入りリスト、およびサイト容量が含まれます。

• ユーザーのカスタム ビューは保持されますが、サイト移行のタイプによってはカスタム ビューの URL が変わり、ユーザーのビューに対するブックマークが機能しなくなる場合があります。

• サイトを Tableau Server にエクスポートして別の Tableau Server サイトにインポートする場合は、サブスクリプションおよび抽出の更新スケジュールが保持されます。

サイトエクスポートで保持されない情報

• サイトの管理ビューに表示される利用状況データは保持されません。たとえば、ビューとデータ ソースの数、ユーザー アクション、およびパフォーマンス データです。

• サイトをエクスポート中でも進行中のバックグラウンダー ジョブはエクスポートされず、インポートの完了後は新しいサイトに表示されなくなります。

• データ接続に埋め込まれた OAuth アクセス トークンはリセットされます。これらのデータ ソースでは、接続を編集して参照元データに再認証する必要があります。

• Prep フローとフロー スケジュールは含まれません。これらは手動で移行する必要があります。

ソースサイトとターゲットサイトの準備

サイトをエクスポートする前に、次のチェックリストを完成させて両方の環境を準備します。手順の一部は、両方のサイトが同じサーバー インスタンス上にあるか別のインスタンス上にあるかで異なります。

古くなったコンテンツの削除

ソース サイトには新しいサイトにインポートする内容だけが含まれるようにします。ベスト プラクティスとして、新しいサイトに含めたくないものは、エクスポート/インポートに含まれるか、手動で移行する必要があるかに関係なく、ソース サイトから削除します。使用していないワークブック、データ ソース、プロジェクトは削除してください。使用しなくなった Prep フローまたはフロー スケジュールがある場合は、これらも削除します。

使用されなくなったユーザーの削除

すべてのサーバー ユーザーがライセンスを持っていることを確認し、使用されなくなったアカウントは削除します。インポート プロセス中にユーザーを削除することはできないため、2 つのサイトが同じサーバー インスタンス上にある場合、ソース サイトからエクスポートしたすべてのユーザーがターゲット サイトにインポートされます。

ターゲットサイトの作成または識別

サイト ファイルは、ターゲット Tableau Server インスタンス上に既に存在するサイトにインポートする必要があります。インポート プロセスでは、インポート ファイルに含まれていないすべてのデータがターゲット サイトから削除されるため、空のサイトにインポートすることをお勧めします。詳細については、「サイトの追加または編集」を参照してください。

パブリッシュされたデータ ソースを使用するワークブックがソース サイトに含まれている場合、そのワークブック内のデータ接続は引き続きソース サイト名を参照します。ワークブックを再パブリッシュせずにこれらの接続を維持するには、ターゲット サイトとソース サイトの名前が一致するようにします。

サイト ID を見つける

サイトのエクスポートやインポートに使用する tsm コマンドには、サイト ID を取り出すパラメーターが必要です。サイト ID は、Web ブラウザーでサイトにサインインする際の URL から入手できます。

サーバー上に存在するサイトが 1 つだけである場合、サイトの名前は "既定" です。"既定" サイトにサインインすると、ブラウザーの URL は次のようになります。

https://server-name/#/projects

URL に /site パラメーターがない場合は、これが既定のサイトであることを示しています。既定サイトのサイト ID は "Default" (二重引用符なし) です。

マルチサイトの Tableau Server 展開では、ブラウザー URL で #/site/ に続いてサイト ID が含まれています。サイト ID が finance であるサイトで [ビュー] ページに移動すると、次の URL が表示されます。

https://localhost/#/site/finance/views

アイデンティティストアを確認する

同じタイプのユーザー アイデンティティ ストアを使用していないサイトからのエクスポートや、そうしたサイトへのインポートを行うことができますが、インポートに使用するマッピング ファイルを変更する必要があります。この手順はインポート プロセスに組み込まれており、ステップ 3 :サイト設定が正しくマッピングされたことを確認するで説明されています。

必要に応じてターゲットサーバーでユーザーを作成する

サイトのインポート プロセスではユーザーがターゲット サイトに割り当てられます。ソース サイトが ターゲット サイトと異なる Tableau Server インスタンス上にある場合は、インポートを実行する前にターゲット サーバー上でユーザーを作成する必要があります。2 つのサイトが同じ Tableau Server インスタンス上にある場合は、ターゲット サイトから既存のユーザーにアクセスできるため、この手順をスキップできます。

ターゲットサーバーでのサブスクリプション配信の構成

サブスクリプションはインポートされますが、配信するようにサーバーを構成する必要があります。詳細については、サブスクリプションのサーバー設定を参照してください。

スケジュールの確認

[スケジュール] ページには、抽出更新およびサブスクリプションに使用する既存のスケジュールが一覧表示されます。

ある Tableau Server サイトから別のサイトへの移行の場合、ソース サイトの既定のスケジュールに割り当てられた更新およびサブスクリプションは、ターゲット サイトの同じスケジュールにマッピングされます。ターゲット サイトに存在しないスケジュールがソース サイトにあり、ターゲット サイトが別の Tableau Server インスタンス上にある場合は、ソース スケジュールをマッピングするターゲット サイトでスケジュールを作成する必要があります。この処理が期待どおりに実行されるよう、マッピング ファイルを編集できます。

ユーザーやスケジュールが少ないターゲットにインポートするためのヒント

ターゲット サイトのユーザーやスケジュールがソース サイトより少ない場合、多対 1 のインポートはサポートされません。これに対処する方法は、ソース サイトとターゲット サイトが同じ Tableau Server インスタンス上にあるかどうかで異なります。

次のアプローチのうち、お使いのサイトの移行使用事例に適したものを実行できます。

• エクスポートする前に余分なユーザーやスケジュールをソース サイトから削除します。これは、2 つのサイトが同じサーバー インスタンス上にある場合に推奨されるオプションです。

• インポートを開始する前に、欠落したユーザーやスケジュールをターゲット サイトに追加します。ターゲット サイトが別のサーバー インスタンス上にある場合は、これを実行する必要があります。

• インポート プロセスの途中で、欠落したユーザーやスケジュールをターゲット サイトに追加し、手動でマッピング ファイルを更新します。これは、2 つのサイトが同じサーバー インスタンス上にある場合にのみ実行できるオプションです。

• インポート プロセスの途中にユーザーやスケジュールをターゲット サイトの異なるユーザーやスケジュールに手動でマッピングします。サーバー間でユーザー名が異なる場合にはこれを実行する必要があります (たとえば、adavis@company.com という名前のエクスポートされたユーザーが、ターゲット サイトでは davisa と定義されている場合)。

サイトの移行

サイトの移行プロセスを完了するには、tsm sitesコマンドを使用する必要があります。次の手順では、ソース サイトから情報をエクスポートし、サイト設定をマッピングし、マップされたファイルをターゲット サイトにインポートします。

ステップ 1: サイトをエクスポートする

ステップ2 : インポート マッピング ファイルを生成する

ターゲット サイト用のインポート ファイルを生成するには、ステップ 1: サイトをエクスポートするの手順を完了した際に作成した .zip ファイルが必要です。

1. ターゲット Tableau Server マシンで、エクスポートされた .zip ファイルを、Tableau Server がインポート用のファイルを検索するディレクトリにコピーします。例は次のとおりです。

   C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

2. インポート プロセスでは新しいサイトが作成されないので、ターゲット サイトが Tableau Server に既に存在することを確認します。詳細については、ソースサイトとターゲットサイトの準備を参照してください。

3. ターゲット Tableau Server マシンで次のコマンドを実行します (Tableau Server が実行されている必要があります)。

   tsm sites import --site-id <target-siteID> --file <export-file.zip>

   このコマンドにより、ソース サイト設定がターゲット サイトにマッピングされる方法を示す .csv ファイルのセットが生成されます。この記事の次のセクションで説明する手順では、これらのマッピングを確認し、必要に応じて調整します。

   既定では、、これらの .csv ファイルは siteimports の下に作成される mappings ディレクトリに生成されます。例は次のとおりです。

   C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_<id>_<date-time>\mappings

   詳細については、tsm ファイル パスを参照してください。

ステップ 3 :サイト設定が正しくマッピングされたことを確認する

前のセクションで生成した .csv ファイルには、インポートの完了時にソース サイトのリソースをターゲット サイトに割り当てる方法が記述されています。Tableau Server がマッピングできなかったために編集する必要があるファイル内のアイテムは、一連の疑問符 (???) で示されています。インポート プロセスを完了する前に、疑問符をターゲット サイト上の有効な割り当てに置き換える必要があります。

重要:ユーザー、スケジュール、およびパブリッシュされたコンテンツ リソースのマッピングには、特にソース サイトとターゲット サイトが別の Tableau Server インスタンス上にある場合に、いくつかの要件が適用されます。詳細については、この記事の前の部分にあるソースサイトとターゲットサイトの準備を参照してください。

マッピング ファイルを検証するには

1. tsm sites import コマンドによって生成された .csv マップ ファイルが含まれるディレクトリに移動します。既定のディレクトリは次のとおりです。

   C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_<id>_<date-time>\mappings

2. お気に入りのテキスト エディターを使用して mappings ディレクトリ内にある .csv ファイルのいずれかを開き、次のようにします。

   1. マッピングが正しいことを確認します。

   2. エントリに一連の疑問符 (???) が表示される場合は、有効な値で置き換えてください。

      これらの各ファイル内の設定については、この記事の後の部分のマッピングファイルの内容リファレンスにある表を参照してください。

   3. 変更を保存し、CSV ファイルの書式設定を保護します。

   残りの .csv ファイルについてこのプロセスを繰り返します。

ステップ 4: 正しくマッピングされたファイルをターゲット サイトにインポートする

.csv ファイル内のサイト マッピングを検証した後は、設定を新しいサイトにインポートして移行プロセスを完了できます。

1. ターゲット Tableau Server マシンで次のコマンドを実行します：

   tsm sites import-verified --import-job-dir <import-id-directory> --site-id <target-siteID>

   例は次のとおりです。

   tsm sites import-verified --import-job-dir "C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457"
--site-id new-site

2. 正常に処理されたことを通知するメッセージが表示されたら、新しいサイトにサインインし、予測どおりにすべてインポートされたことを確認します。

注: tsm sites import および tsm sites export コマンドは、エラーが発生した場合に、サイトをロック状態のままにすることができます。サイトをロック解除するには、tsm sites unlock コマンドを使用します。

マッピングファイルの内容リファレンス

次の表は、tsm site import コマンドの実行時に作成される各マッピング ファイル内の列を示しています。

CSV ファイル名:mappingsDomainMapperForGroups

CSV ファイル名:mappingsScheduleMapper

CSV ファイル名:mappingsSiteMapper

CSV ファイル名:mappingsSystemUserNameMapper

CSV ファイル名: MappingsScheduleRecurrenceMapperWithAutoCreation

このファイルを更新する必要はありません。