MicroStrategy ONE

MySQL データベースから PostgreSQL データベースへのデータ移行

  • Windows
  • Linux

Platform Analytics データ移行ツールは、既存のお客様が MySQL のデータを新しくサポートされた PostgreSQL リポジトリに移行するために使用できます。このツールは、新しいバージョンと古いバージョン両方の MySQL ダンプ ファイルを最新バージョンの Platform Analytics に移行するのに役立ちます。

バックアップの前提条件:

  • C:\Program Files (x86)\MicroStrategy\Platform Analytics\PAConsumerConfig.yaml入力:

    warehouseDbConnection:

    • WHホスト：127.0.0.1
    • whUser: root
    • whPasswd: encrypted_password
    • WH ポート：3306
    • whDb: platform_analytics_wh
  • mysql-connector-java.jar は PlatformAnalytics\lib ディレクトリにあります。
  • MySQL platform_analytics_wh データベースのバックアップを格納するのに十分なディスク空き容量。

復元の前提条件:

  • 以下の情報が設定された PAConsumerConfig.yaml

    pgWarehouseDbConnection:

    • pgWHhost：127.0.0.1

    • pgWhUser: postgres

    • pgWhPasswd: encrypted password

    • pgWHポート：5432

    • pgWhDb:platform_analytics_wh

  • 前の platform_analytics_wh のバックアップからの .csv ファイルへのパス。

  • MySQL からバックアップされた .csv ファイルを PostgreSQL が復元するために十分なディスク空き容量。

Platform Analytics データ移行ツールの起動

  1. Platform Analytics ホーム ディレクトリの bin ディレクトリに移動します。

    C:\Program Files (x86)\MicroStrategy\Platform Analytics\bin

  2. 次のスクリプトを呼び出します。

    platform-analytics-data-migration-tool.bat

  3. 次のプロンプトが表示されます。

    コピー 
    This is the Platform Analytics Data Migration Tool. The purpose of this tool is to help migrate your data from an existing Mysql Warehouse to a new PostgreSQL Warehouse.
    Please select from the following options:
    1) Backup
    2) Restore
    3) Backup and Restore
    0) Exit

移行ワークフロー

バックアップ

  1. MySQL バックアップが保管されるディレクトリのパスを提供します。

  2. ツールはMySQLのバックアップを開始します。プラットフォーム分析あなたのPAコンシューマ構成.yamlファイルを作成し、指定したパスにバックアップを配置します。

復元

  1. MySQL バックアップが保管されているディレクトリのパスを提供します。

  2. ツールはPostgreSQLを削除しても問題ないか再度確認を求めます。プラットフォーム分析スキーマ。

  3. はいを選択した場合、プラットフォーム分析スキーマは削除され、MySQL ダンプのバージョンに合わせて再作成されます。

  4. バックアップデータは新しく作成されたプラットフォーム分析スキーマ。

  5. のプラットフォーム分析スキーマは Platform Analytics の最新バージョンにアップグレードされます。

推奨されるアップグレード手順

直接アップグレード

直接アップグレードを行う場合、ベスト プラクティスの手順は以下の通りです。

  1. Platform Analytics Consumer が停止されていることを確認します。新しいエントリを処理中にデータ移行ツールを実行してはなりません。
  2. PAConsumerConfig.yaml に、上の前提条件に記載した MySQL および PostgreSQL 情報が含まれていることを確認します。
  3. Platform Analytics の bin ディレクトリに移動し、platform-analytics-data-migration-tool.bat ファイルを呼び出します。
  4. 「(3) Backup and Restore」のオプションを選択します。
  5. バックアップ先およびリストア元データベースのディレクトリのフルパスを入力します。
  6. バックアップが完了するのを待ちます。PostgreSQL ウェアハウスを再作成するかどうか確認するプロンプトが表示されたら、イエスを選択します。
  7. MySQL バックアップ ファイルが新しい PostgreSQL ウェアハウスに復元され、データ移行が完了します。

  8. Workstation およびサービス登録をインストールしている場合は、サービスのグループと依存関係情報がMicroStrategy Workstation のトポロジ ビューを更新する必要があります。トポロジーが更新されない場合、このビューでは、Consumer が Repository (MySQL) など他の 5 つのサービスに依存しているものとして表示されます。

    Workstation でトポロジーを更新するには、次のようにします。

    1. の検索場所: MicroStrategy配布された java パス。デフォルトでは、この場所は C:\Program Files (x86)\Common Files\MicroStrategy\JRE\180_222 です。
    2. Services Registration のインストール先ディレクトリの場所を確認します。デフォルトでは、この場所は C:\Program Files (x86)\MicroStrategy\Services Registration\jar です。

    3. 次のコマンドを実行します。

      コピー 
      "C:\Program Files (x86)\Common Files\MicroStrategy\JRE\180_222\Win64\bin\java" -jar 
      "C:\Program Files (x86)\MicroStrategy\Services Registration\jar\svcsreg-admin.jar" migrate MicroStrategy-Platform-Analytics-Consumer MySQL PostgreSQL
    4. Workstation を開き、[Topology] タブを選択します。今度は、Consumer が Store (PostgreSQL) に依存、所属しているものとして表示されます。

並列アップグレード

  1. 新しいバージョン(Undefined variable: Company_ProductNames.ReleaseName)コンピューターに接続し、 PAConsuerConfig.yamlには、上記の前提条件に示した MySQL および PostgreSQL の情報が含まれます。

  2. 旧インストール ディレクトリの mysql-connector-java.jar を、新しいマシン上の Platform Analytics\lib ディレクトリにコピーします。
  3. Platform Analytics の bin ディレクトリに移動し、platform-analytics-data-migration-tool.bat ファイルを呼び出します。
  4. 「(3) Backup and Restore」のオプションを選択します。
  5. バックアップ先およびリストア元データベースのディレクトリのフルパスを入力します。
  6. バックアップが完了するのを待ちます。PostgreSQL ウェアハウスを再作成するかどうか確認するプロンプトが表示されたら、イエスを選択します。
  7. MySQL バックアップ ファイルが新しい PostgreSQL ウェアハウスに復元され、データ移行が完了します。

  8. Workstation およびサービス登録をインストールしている場合は、サービスのグループと依存関係情報がMicroStrategy Workstation のトポロジ ビューを更新する必要があります。トポロジーが更新されない場合、このビューでは、Consumer が Repository (MySQL) など他の 5 つのサービスに依存しているものとして表示されます。

    Workstation でトポロジーを更新するには、次のようにします。

    1. の検索場所: MicroStrategy配布された java パス。デフォルトでは、この場所は C:\Program Files (x86)\Common Files\MicroStrategy\JRE\180_222 です。
    2. Services Registration のインストール先ディレクトリの場所を確認します。デフォルトでは、この場所は C:\Program Files (x86)\MicroStrategy\Services Registration\jar です。

    3. 次のコマンドを実行します。

      コピー 
      "C:\Program Files (x86)\Common Files\MicroStrategy\JRE\180_222\Win64\bin\java" -jar 
      "C:\Program Files (x86)\MicroStrategy\Services Registration\jar\svcsreg-admin.jar" migrate MicroStrategy-Platform-Analytics-Consumer MySQL PostgreSQL
    4. Workstation を開き、[Topology] タブを選択します。今度は、Consumer が Store (PostgreSQL) に依存、所属しているものとして表示されます。

Platform Analytics データ移行ツールは、既存のお客様が MySQL のデータを新しくサポートされた PostgreSQL リポジトリに移行するために使用できます。このツールは、新しいバージョンと古いバージョン両方の MySQL ダンプ ファイルを最新バージョンの Platform Analytics に移行するのに役立ちます。

バックアップの前提条件:

  • /MicroStrategy/install/PlatformAnalytics/PAConsumerConfig.yaml入力:

    warehouseDbConnection:

    • WHホスト：127.0.0.1
    • whUser: root
    • whPasswd: encrypted_password
    • WH ポート：3306
    • whDb: platform_analytics_wh
  • mysql-connector-java.jar は PlatformAnalytics/lib ディレクトリにあります。
  • MySQL platform_analytics_wh データベースのバックアップを格納するのに十分なディスク空き容量。

復元の前提条件:

  • 以下の情報が設定された PAConsumerConfig.yaml

    pgWarehouseDbConnection:

    • pgWHhost：127.0.0.1

    • pgWhUser: postgres

    • pgWhPasswd: encrypted password

    • pgWHポート：5432

    • pgWhDb:platform_analytics_wh

  • 前の platform_analytics_wh のバックアップからの .csv ファイルへのパス。

  • MySQL からバックアップされた .csv ファイルを PostgreSQL が復元するために十分なディスク空き容量。

Platform Analytics データ移行ツールの起動

  1. Platform Analytics ホーム ディレクトリの bin ディレクトリに移動します。

    /opt/mstr/MicroStrategy/PlatformAnalytics/bin

  2. 次のスクリプトを実行してください。

    ./platform-analytics-data-migration-tool.sh

  3. 次のプロンプトが表示されます。

    コピー 
    This is the Platform Analytics Data Migration Tool. The purpose of this tool is to help migrate your data from an existing Mysql Warehouse to a new PostgreSQL Warehouse.
    Please select from the following options:
    1) Backup
    2) Restore
    3) Backup and Restore
    0) Exit

移行ワークフロー

バックアップ

  1. MySQL バックアップが保管されるディレクトリのパスを提供します。

  2. ツールはMySQLのバックアップを開始します。プラットフォーム分析あなたのPAコンシューマ構成.yamlファイルを作成し、指定したパスにバックアップを配置します。

復元

  1. MySQL バックアップが保管されているディレクトリのパスを提供します。

  2. ツールはPostgreSQLを削除しても問題ないか再度確認を求めます。プラットフォーム分析スキーマ。

  3. はいを選択した場合、プラットフォーム分析スキーマは削除され、MySQL ダンプのバージョンに合わせて再作成されます。

  4. バックアップデータは新しく作成されたプラットフォーム分析スキーマ。

  5. のプラットフォーム分析スキーマは Platform Analytics の最新バージョンにアップグレードされます。

推奨されるアップグレード手順

直接アップグレード

直接アップグレードを行う場合、ベスト プラクティスの手順は以下の通りです。

  1. Platform Analytics Consumer が停止されていることを確認します。新しいエントリを処理中にデータ移行ツールを実行してはなりません。
  2. PAConsumerConfig.yaml に、上の前提条件に記載した MySQL および PostgreSQL 情報が含まれていることを確認します。
  3. PlatformAnalytics/bin ディレクトリに移動し、platform-analytics-data-migration-tool.sh ファイルを呼び出します。
  4. 「(3) Backup and Restore」のオプションを選択します。
  5. バックアップ先およびリストア元データベースのディレクトリのフルパスを入力します。
  6. バックアップが完了するのを待ちます。PostgreSQL ウェアハウスを再作成するかどうか確認するプロンプトが表示されたら、イエスを選択します。
  7. MySQL バックアップ ファイルが新しい PostgreSQL ウェアハウスに復元され、データ移行が完了します。

  8. サービスのグループ化と依存関係情報は、 で更新する必要がありますMicroStrategy Workstation のトポロジ ビュー。トポロジーが更新されない場合は、Telemetry Consumer が Store (PostgreSQL) に依存していないものとして表示されます。

    Workstation でトポロジーを更新するには、次のようにします。

    1. の所有者を見つけますMicroStrategyインストール ディレクトリです。デフォルトでは、所有者は mstr のユーザーです。
    2. の検索場所: MicroStrategy配布された java パス。デフォルトでは、この場所は /opt/MicroStrategy/_jre です。
    3. Services Registration のインストール先ディレクトリの場所を確認します。デフォルトでは、この場所は /opt/MicroStrategy/ServicesRegistration です。

    4. 次のコマンドを実行します。

      コピー 
      $ su - mstr
      $ /opt/MicroStrategy/_jre/bin/java -jar /opt/MicroStrategy/ServicesRegistration/jar/svcsreg-admin.jar migrate MicroStrategy-Platform-Analytics-Consumer MySQL PostgreSQL

    5. を開くMicroStrategy Workstation を選択して、[トポロジ] タブを選択します今度は、Consumer が Store (PostgreSQL) に依存しているものとして表示されるはずです。

並列アップグレード

  1. 新しいバージョン(Undefined variable: Company_ProductNames.ReleaseName)コンピューターに接続し、 PAConsuerConfig.yamlには、上記の前提条件に示した MySQL および PostgreSQL の情報が含まれます。

  2. 旧インストール ディレクトリの mysql-connector-java.jar を、新しいマシン上の PlatformAnalytics/lib ディレクトリにコピーします。
  3. PlatformAnalytics/bin ディレクトリに移動し、platform-analytics-data-migration-tool.sh ファイルを呼び出します。
  4. 「(3) Backup and Restore」のオプションを選択します。
  5. バックアップ先およびリストア元データベースのディレクトリのフルパスを入力します。
  6. バックアップが完了するのを待ちます。PostgreSQL ウェアハウスを再作成するかどうか確認するプロンプトが表示されたら、イエスを選択します。
  7. MySQL バックアップ ファイルが新しい PostgreSQL ウェアハウスに復元され、データ移行が完了します。

  8. サービスのグループ化と依存関係情報は、 で更新する必要がありますMicroStrategy Workstation のトポロジ ビュー。トポロジーが更新されない場合は、Telemetry Consumer が Store (PostgreSQL) に依存していないものとして表示されます。

    Workstation でトポロジーを更新するには、次のようにします。

    1. の所有者を見つけますMicroStrategyインストール ディレクトリです。デフォルトでは、所有者は mstr のユーザーです。
    2. の検索場所: MicroStrategy配布された java パス。デフォルトでは、この場所は /opt/MicroStrategy/_jre です。
    3. Services Registration のインストール先ディレクトリの場所を確認します。デフォルトでは、この場所は /opt/MicroStrategy/ServicesRegistration です。

    4. 次のコマンドを実行します。

      コピー 
      $ su - mstr
      $ /opt/MicroStrategy/_jre/bin/java -jar /opt/MicroStrategy/ServicesRegistration/jar/svcsreg-admin.jar migrate MicroStrategy-Platform-Analytics-Consumer MySQL PostgreSQL

    5. を開くMicroStrategy Workstation を選択して、[トポロジ] タブを選択します今度は、Consumer が Store (PostgreSQL) に依存しているものとして表示されるはずです。