MySQLインスタンスのエクスポート

MySQLシェルのdumpInstanceユーティリティを使用して、MySQLインスタンスをオブジェクト・ストレージ・バケットにエクスポートします。

1. CLI構成ファイルを含むクライアント・マシンでMySQLシェルを実行します。
2. \jsと入力して[Enter]を押し、JavaScript入力タイプに切り替えます。
3. 次のコマンドを実行して、MySQLインスタンスに接続してグローバル・セッションを開始します。

   \c <UserName>@<MySQLIPAddress>

   • \c: 新しい接続を確立するためのシェル・コマンドを指定します。
   • <UserName>: MySQLインスタンスのユーザー名を指定します。
   • <MySQLIPAddress>: MySQLインスタンスのIPアドレスまたはホスト名を指定します。
4. (推奨されるオプション・ステップ)次のコマンドを実行して、MySQLインスタンス全体のエクスポートの実行をテストします。DBシステムの互換性の問題をチェックし、それらの問題を、推奨される解決策とともに出力にリストします。

   util.dumpInstance("", {mode: "dryrun", ocimds: true})

   見つかった問題を削除する互換性オプションを特定します。ocimdsオプションが有効になっている場合、MySQLインスタンスを正常にエクスポートするには、これらの互換性オプションを含める必要があります。
5. 次のコマンドを実行して、MySQLインスタンス全体をオブジェクト・ストレージ・バケットにエクスポートします:

   util.dumpInstance("<BucketPrefix>", {osBucketName: "<MDSBucket>", threads: <ThreadSize>, ocimds: true, 
       compatibility: ["<comma separated list of compatibility options>], bytesPerChunk: "<ChunkSize>"})

   • util.dumpInstance: MySQLインスタンス全体をエクスポートするコマンドを指定します。
   • <BucketPrefix>: (オプション)バケットにアップロードされるファイルに接頭辞を追加します。これを指定すると、ファイル・パスと同様に、<BucketPrefix>/filename形式の接頭辞が付いたファイルが、定義されたバケットにアップロードされます。たとえば、<BucketPrefix>をtestに設定すると、定義されたバケット<MDSBucket>にアップロードされるすべてのファイルは、test/filenameとして実行されます。ファイルをダウンロードする場合、接頭辞はダウンロードの際にはフォルダとして扱われます。ローカル・エクスポートでは、このパラメータはエクスポート先のローカル・ディレクトリへのパスになります。

     このパラメータの内容はオプションですが、引用符はオプションではありません。接頭辞を使用しない場合でも、コマンドの構文に引用符を含める必要があります。

   • osBucketName: エクスポート先のオブジェクト・ストレージ・バケットの名前を大/小文字を区別して指定します。MySQLシェルは、configファイルに定義されたテナンシおよびユーザー情報を使用します。
   • threads: (オプション)このタスクに使用する処理スレッドの数を指定します。デフォルト値は4です。最適なパフォーマンスを得るには、このパラメータをデータベース・サーバーのCPUコア数に設定することをお薦めします。
   • ocimds: データにMySQL HeatWave Serviceとの互換性があるかどうかをチェックします。これをtrueに設定すると、MySQL HeatWaveサービスと互換性のないインスタンスはエクスポートできません。
     ノート
     
     util.loadDumpユーティリティを使用してMySQL HeatWave DBシステムにデータをインポートするには、ocimdsオプションを使用してダンプを作成する必要があります。
   • compatibility: エクスポートされたデータに対してどの変更を実行するかを指定するパラメータをリストします。ドライラン・モードで推奨される互換性オプションのリストを指定する必要があります。Compatibility Checksを参照してください。
   • bytesPerChunk: (オプション)大きいデータセットの場合は、このパラメータを使用して、大きいチャンクを定義することをお薦めします。デフォルトのチャンク・サイズは64MBです。たとえば、bytesPerChunk: 128M,ではチャンク・サイズ128MBが指定されます。

MySQL HeatWaveサービスには、MySQLインスタンスに存在しないセキュリティ関連の制限がいくつかあります。ダンプされたデータに対して互換性チェックを実行するには、ダンプユーティリティーの ocimdsオプションを使用します。問題がある場合、ユーティリティーはダンプを中止し、問題の詳細なリストを生成して、それらを修正する手順を提案します。

次のコマンドは、dryrunモードで ocimdsオプションを使用して互換性チェックを実行する方法を示しています。ocimdsオプションで検出された問題によっては、MySQL HeatWave Serviceにロードする前にスキーマを手動で編集する必要があります。

util.dumpInstance("", {mode: "dryrun", ocimds: true})

互換性の問題および互換性オプションを特定したら、データをエクスポートするコマンドでオプションを指定できます。

util.dumpInstance("<BucketPrefix>", {osBucketName: "<MDSBucket>", ocimds: true, 
    compatibility: ["force_innodb", "strip_definers", "strip_restricted_grants", 
    "skip_invalid_accounts", "strip_tablespaces", "ignore_missing_pks"] } )

次のカンマ区切りの互換性オプションを使用して、エクスポートされたデータを自動的に変更できます。これにより、これらの互換性の問題の一部が解決されます。

• force_innodb: MySQL HeatWaveサービスでは、InnoDBストレージ・エンジンのみがサポートされます。このオプションは、互換性のないストレージ・エンジンを使用するCREATE TABLE文のENGINE句を変更し、InnoDBで置き換えます。
• strip_definers: ビュー、ルーチン、イベント、トリガーから、"DEFINER=account"句を削除します。MySQL HeatWaveサービスでは、スキーマをロードするユーザー以外の定義者を使用してこれらのオブジェクトを作成するには、特別な権限が必要です。DEFINER句を削除すると、それらのオブジェクトはそのデフォルト定義者によって作成されます。ビューおよびルーチンのSQL SECURITY句は、DEFINERからINVOKERに変更されます。これによって、それらを作成したユーザーのアクセス権限のかわりに、これらの問い合せやコールを行うアカウントのアクセス権限が使用されるようになります。データベースのセキュリティ・モデルで、呼出し元よりも多くの権限がビューやルーチンに必要な場合は、スキーマをロードする前に手動で変更してください。DEFINERおよびSQLのセキュリティを参照してください。
• strip_restricted_grants: 特定の権限がMySQL HeatWave Serviceで制限されます。RELOAD、FILE、SUPER、BINLOG_ADMIN、SET_USER_IDなどの権限です。これらの権限を付与してユーザーを作成することはできません。このオプションは、ダンプされたGRANT文からこれらの権限を削除します。
• skip_invalid_accounts: パスワードが定義されていないユーザーはエクスポートできません。このオプションは、そのようなユーザーをスキップします。
• strip_tablespaces: MySQL HeatWaveサービスでは、表領域にいくつかの制限があります。このオプションでは、CREATE TABLE文からTABLESPACEオプションを削除し、すべての表がデフォルトの表領域に作成されるようにします。
• 主キー・フラグ:
  • create_invisible_pks: 高可用性DBシステムでは主キーが必要です。高可用性DBシステムで使用するためにデータをエクスポートする場合は、主キーが表に定義されていない場合は、主キーを追加します。この互換性フラグによって、各表に必要な非表示の主キーが追加されます。前提条件を参照してください。
  • ignore_missing_pks: 高可用性DBシステムにインポートする予定がない場合、この互換性フラグはダンプ内の欠落している主キーを無視します。

また、ocimdsオプションが有効になっている場合、CREATE TABLE文のDATA DIRECTORY、INDEX DIRECTORYおよびENCRYPTIONオプションは常にDDLスクリプトでコメント・アウトされます。